AI 含量说明
本文由 AI (Claude) 辅助生成，内容经过人工审核与编辑。部分描述可能存在简化表述，请读者结合实际使用体验参考。
选读
本文为 Part 2 选读内容，适合希望进一步定制 Claude Code 工作流的读者。如果你刚完成基础安装，可先跳过本文，待对 Claude Code 有一定使用经验后再回来阅读。
zcf 是什么
zcf（Zero-Config Code Flow）是一个开源 CLI 工具，目标是用一条命令完成 Claude Code 的端到端环境配置。
手动配置 Claude Code 并不复杂，但当你需要同时处理工作流模板安装、MCP 服务注册、第三方 API 接入、模型路由设置等多项任务时，重复的操作会消耗大量时间，在切换设备或重置环境时尤为明显。zcf 将这些步骤整合成交互式菜单和单行命令，让环境搭建从「折腾」变成「开箱即用」。
项目地址：https://github.com/UfoMiao/zcf 文档站：https://zcf.ufomiao.com/
核心功能
1. 一键完整初始化
运行以下命令，zcf 会通过交互式菜单引导你完成：
- Claude Code 本体的安装或更新
- 结构化工作流模板的写入
- API Provider 和 CCR（模型路由）的配置
- MCP 服务的批量注册
# 推荐方式：交互式菜单（无需安装，直接运行）
npx zcf
# 一步完成全部初始化（适合熟悉选项后的快速复用）
npx zcf i如果你使用第三方 API（如 302.AI），可以直接通过参数跳过交互：
npx zcf i -s -p 302ai -k "sk-xxx"
提示
npx zcf 无需提前全局安装，每次都会拉取最新版本。如果你在多台设备上使用 Claude Code，这个命令可以让你在几分钟内恢复完整环境。
2. 结构化工作流模板
zcf 内置多套工作流模板，本质上是写入 CLAUDE.md 或 Skills 文件的结构化提示词，用于规范 Claude Code 的行为模式：
| 工作流 | 适用场景 |
|---|---|
| 六阶段结构化工作流 | 通用开发任务（研究→构思→计划→执行→优化→评审） |
| Feat 功能开发流 | 新功能开发，强调完整开发流程 |
| BMad 敏捷流程 | 敏捷开发方法论集成 |
| Spec 工作流 | 规范驱动开发（先写规格再实现） |
运行以下命令更新或重新安装工作流：
npx zcf u # 仅更新工作流，不触碰其他配置对学术科研用户的建议
六阶段结构化工作流适合科研编程场景——它要求 Claude Code 在动手之前先理解需求、提出方案并等待确认，避免了「直接开干然后方向跑偏」的常见问题。
3. MCP 服务集成
MCP（Model Context Protocol）让 Claude Code 能够调用外部工具，zcf 内置了一批实用的 MCP 服务，初始化时可一键注册：
| MCP 服务 | 功能说明 |
|---|---|
| Context7 | 获取各类库的最新文档和代码示例 |
| Open Web Search | 实时网络搜索 |
| DeepWiki | 深度读取 GitHub 仓库文档 |
| Playwright | 浏览器自动化（网页操作、截图等） |
| Serena | 语义级代码分析和编辑 |
| Spec Workflow | 规范驱动开发辅助工具 |
通过 zcf 初始化后，这些服务会自动写入 Claude Code 的 MCP 配置，无需手动编辑配置文件。
INFO
MCP 服务的详细介绍可参考 Claude Code 官方文档中的 MCP 章节。本博客后续文章也将专门介绍 MCP 的实际用法。
4. CCR 模型路由管理
CCR（Claude Code Router） 是一个运行在本地的透明代理工具，在 Claude Code 和远端 API 之间插入一层路由层，根据任务类型将请求自动分发给最合适的模型或 Provider。它支持 DeepSeek、OpenRouter、Gemini、Ollama 等多种供应商——这也是 CCR 真正的价值所在：不只是换不同档位的 Claude 模型，而是可以将不同类型的任务（常规编码、后台任务、深度推理、超长上下文）路由给完全不同的服务商。详细介绍见 Part 3。
zcf 提供了专属的 CCR 管理菜单，通过以下命令进入：
npx zcf ccr # 直接进入 CCR 管理菜单
# 或：npx zcf 后在主菜单选择 "R. CCR Management"菜单涵盖 CCR 的常用操作：初始化配置、启动/停止/重启服务、打开 Web UI、查看运行状态。zcf 的配置切换功能（zcf cs）也内置了"CCR Proxy"配置类型，切换后直接运行 claude 命令即可，不需要用 ccr code（详见下节）。
5. 多配置快速切换
zcf 支持保存多套 API Provider 配置（例如官方 API、302.AI、GLM、CCR 等），在它们之间一键切换，不用每次手动改环境变量或配置文件。
npx zcf cs # 进入配置切换菜单，选择要激活的配置
多 API 账号场景下（比如工作账号和个人账号分开，或按任务类型选用不同供应商），比手动切换方便不少。
与 CCR 联动
zcf 的配置切换内置了"CCR Proxy"配置类型，与直连官方 API、第三方 Provider 等并列。切换到 CCR Proxy 后，zcf 会更新 ~/.claude/settings.json 中的 Profile，此时直接运行 claude 命令重启 Claude Code 即可通过 CCR 路由请求，无需使用 ccr code。CCR 服务本身通过 npx zcf ccr 菜单管理。
小结
zcf 解决的问题就是环境配置的重复劳动。它本身不改变 Claude Code 的使用方式，而是帮你把「把 Claude Code 配置好」这一过程自动化。刚迁移到新设备、或者想统一团队 Claude Code 配置的时候，用它可以省不少事。
如果你只想体验一下，从这条命令开始：
npx zcf按照交互式菜单的引导操作即可，整个过程通常在 5 分钟内完成。