📖 前言 - 什么是ZCF？

🎯 ZCF (Zero-Config Code Flow) 新手配置完全指南

📖 前言 - 什么是ZCF？

ZCF = Zero-Config Code Flow 是一个"零配置"工具，专门为Claude Code设计。简单说：

它帮你一键安装和配置 Claude Code

提供智能工作流，让你写代码更高效

支持中文界面，对新手超友好

完全免费开源，安全可靠

🚀 快速开始 - 3分钟搞定

✅ 第一步：检查前提条件

打开您的终端（Windows叫命令提示符），输入：

# 检查是否有Node.js（需要有v18以上版本）

node --version

# 检查是否有npm（一般都会有）

npm --version

如果没有Node.js怎么办？

访问 nodejs.org

下载LTS版本（推荐）

安装后重新打开终端

🎯 第二步：一键安装ZCF

在终端输入这个魔法命令：

npx zcf

📱 手机用户注意： 如果您在Termux上操作，也完全支持！

🎮 交互式菜单操作指南

运行npx zcf后会看到彩色菜单，像这样：

ZCF - Zero-Config Code Flow

? 选择ZCF显示语言:

❯ 简体中文 ← 推荐选这个

English

请选择功能:

-------- Claude Code --------

1. 完整初始化 - 安装Claude Code + 导入工作流 + 配置API + 配置MCP服务

2. 导入工作流 - 仅导入/更新工作流相关文件

3. 配置API - 配置API网址和身份验证

4. 配置MCP - 配置MCP服务

5. 配置默认模型 - 设置默认模型

6. 配置Claude全局记忆 - 配置AI输出语言和输出风格

7. 导入推荐的环境变量和权限

--------- 其他工具 ----------

R. CCR - Claude Code路由器管理

U. ccusage - Claude Code使用分析

L. CCometixLine - 高性能状态栏工具

------------ ZCF ------------

0. 选择显示语言

-. 卸载

+. 检查更新

Q. 退出

🎯 新手推荐操作流程：

第一次使用Claude Code的用户：

选择语言 → 选择1（完整初始化）→ 按提示操作 → 完成！

已经安装过Claude Code的用户：

选择语言 → 选择2（导入工作流）→ 按提示操作 → 完成！

📋 详细配置步骤（手把手教学）

🔧 第一步：完整初始化（选择1）

1️⃣ 选择配置语言

? 选择Claude Code配置语言:

❯ English (en) - 英文（推荐，token消耗更低）

简体中文 (zh-CN) - 中文（中文用户自定义更方便）

日本語 (ja) - 日文

新手建议： 选"简体中文"，后续操作更直观

2️⃣ 选择AI输出语言

? 选择AI输出语言:

AI将用此语言回复您

❯ English

简体中文

日本語

自定义

建议： 选"简体中文"，AI会用中文回答您

3️⃣ 安装Claude Code

? 未发现Claude Code，是否自动安装？ (Y/n)

直接按回车 选择是(Y)

4️⃣ 处理现有配置

? 检测到现有配置，如何处理？

❯ 备份并覆盖 - 备份现有配置到 ~/.claude/backup/

仅更新文档 - 仅更新工作流和文档，保留现有API配置

合并配置 - 与现有配置合并，保留用户自定义

跳过 - 跳过配置更新

建议： 选择"备份并覆盖"（默认选项）

5️⃣ 配置API（超重要！）

这里有几个选择，我详细解释：

? 选择API身份验证方法

❯ 使用官方登录

使用官方认证系统，无需API配置

使用Auth Token (OAuth认证)

适用于通过OAuth或浏览器登录获得的令牌

使用API密钥 (密钥认证)

适用于Anthropic控制台获得的API密钥

配置CCR代理 (Claude Code路由器)

通过代理路由使用多种AI模型，降低成本并探索可能性

跳过 (稍后手动配置)

新手推荐选择：

选项1：使用官方登录 ⭐⭐⭐⭐⭐

最简单，不需要找API密钥

直接浏览器登录即可

适合完全的新手

选项2：使用API密钥 ⭐⭐⭐⭐

需要到Anthropic官网获取API密钥

稳定性更好

适合有一定经验的用户

选项3：配置CCR代理 ⭐⭐⭐⭐⭐

可以免费使用多种AI模型

成本最低

推荐使用

6️⃣ 选择输出风格（v2.12+新功能）

? 选择要安装的输出风格:

❯ ◉ Engineer Professional - 专业软件工程师，遵循SOLID、KISS、DRY、YAGNI原则

◯ Nekomata Engineer - 专业猫娘工程师UFO喵，结合严格工程与可爱猫娘特质

◯ 老王工程师 - 老王暴躁技术风，绝不容忍代码错误和不规范代码

◯ 大小姐工程师 - 傲娇金发大小姐程序员Halley酱，结合严格工程卓越与傲娇大小姐特质

建议： 选择"Engineer Professional"（专业工程师风格）

7️⃣ 选择工作流

? 选择要安装的工作流 (空格选择，回车确认):

❯ ◉ 常用工具 (init-project + init-architect + get-current-datetime) - 项目初始化和实用命令

◉ 六步工作流 (workflow) - 完整6阶段开发流程

◉ 功能规划与UX设计 (feat + planner + ui-ux-designer) - 结构化功能开发

◉ Git命令 (commit + rollback + cleanBranches + worktree) - 简化Git操作

◉ BMAD-方法扩展安装器 - 企业级敏捷开发工作流

建议： 全部选择（按空格键选中所有）

8️⃣ 配置MCP服务

? 配置MCP服务？ (Y/n)

选择是(Y)，然后选择：

? 选择要安装的MCP服务:

❯ ◉ Context7文档查询 - 查询最新库文档和代码示例

◉ DeepWiki - 查询GitHub仓库文档和示例

◉ Playwright浏览器控制 - 直接浏览器自动化控制

◉ Exa AI搜索 - 使用Exa AI进行网页搜索

◉ Serena助手 - 类似IDE的语义代码检索和编辑

建议： 全部选择，功能很强大

9️⃣ 安装CCometixLine状态栏工具

? 安装CCometixLine状态栏工具？ (Y/n)

选择是(Y)，这个工具可以实时显示API使用情况

🎉 完成！看到这条消息就成功了：

✅ 设置完成！使用 'claude' 命令启动。

🎯 快速命令参考（收藏这个）

常用ZCF命令：

# 打开交互式菜单（最常用）

npx zcf

# 完整初始化（第一次用）

npx zcf i

# 仅更新工作流（已安装过）

npx zcf u

# 检查更新

npx zcf check-updates

# 使用分析

npx zcf ccu

# CCR管理

npx zcf ccr

Claude Code命令（配置好后用）：

# 启动Claude Code

claude

# 直接执行任务

claude "创建一个React组件"

# 使用工作流

claude /workflow "开发一个待办事项应用"

🌍 多语言支持详解

ZCF支持3种语言切换：

界面语言设置：

# 中文界面

npx zcf --lang zh-CN

# 英文界面

npx zcf --lang en

AI输出语言设置：

在初始化时选择，或在菜单中选择选项6修改

🔐 API配置详解（超重要）

方式1：官方登录（最简单）

不需要API密钥

浏览器登录即可

适合新手

方式2：API密钥（推荐）

访问 Anthropic Console

注册账号

创建API密钥

在ZCF中输入密钥

方式3：CCR代理（最经济）

支持免费模型

成本最低

功能强大

API提供商预设（v3.3.0+新功能）：

# 使用302.AI

npx zcf i -s -p 302ai -k "你的API密钥"

# 使用GLM

npx zcf i -s -p glm -k "你的API密钥"

# 使用MiniMax

npx zcf i -s -p minimax -k "你的API密钥"

# 使用Kimi

npx zcf i -s -p kimi -k "你的API密钥"

🛠️ 故障排除指南

常见问题1：安装失败

# 解决方法

npm cache clean --force

npx zcf --force

常见问题2：Claude Code找不到

# 手动安装Claude Code

npm install -g @anthropic-ai/claude-code

常见问题3：API配置错误

# 重新配置API

npx zcf → 选择3 → 重新配置

常见问题4：权限问题（Linux/Mac）

# 修复权限

sudo chown -R $(whoami) ~/.claude

📱 平台特殊说明

Windows用户：

完全支持，无需额外配置

自动检测并使用兼容格式

路径包含空格会自动处理

WSL用户：

自动检测WSL环境

显示专门的安装消息

完整功能支持

Termux（Android）用户：

自动适配Termux环境

智能识别可用命令

完整功能体验

🎨 高级功能详解

输出风格（v2.12+）：

Engineer Professional - 专业工程师，代码规范

Nekomata Engineer - 猫娘工程师，可爱风格

Laowang Engineer - 暴躁老王，严格要求

Ojou-sama Engineer - 傲娇大小姐，独特风格

工作流系统：

六步工作流 - 完整开发流程

功能开发 - 结构化功能开发

Git集成 - 简化Git操作

BMAD方法 - 企业级开发流程

MCP服务：

Context7 - 文档查询

DeepWiki - GitHub文档

Playwright - 浏览器控制

Exa AI - 网页搜索

Serena - 代码检索

🚀 最佳实践建议

新手建议：

先完整初始化 - 选择1，全套配置

用中文界面 - 降低学习成本

从简单任务开始 - 逐步熟悉功能

多尝试工作流 - 体验不同开发方式

进阶建议：

配置多个API - 备用和成本优化

使用CCR代理 - 降低成本

自定义输出风格 - 个性化体验

定期更新 - 获取最新功能

📚 学习资源

官方资源：

ZCF GitHub

Claude Code文档

社区资源：

302.AI - API服务

CCR路由器

CCometixLine

🎯 总结

使用ZCF配置Claude Code，您将获得：

✅ 零配置 - 一键安装，无需复杂设置

✅ 多语言 - 中文界面，对新手友好

✅ 工作流 - 专业开发流程

✅ 成本低 - 支持免费模型

✅ 功能强 - MCP服务扩展

记住这个万能命令：

npx zcf

有任何问题，重新运行这个命令，菜单会引导您解决！

🎉 恭喜！ 现在您已经掌握了ZCF的完整配置方法，开始您的高效编程之旅吧！