Zero-Config Code Flow for Claude code & Codex
深入了解 zcf 的功能与特性
✨ 快速链接: Codex 支持 | BMad 工作流 | Spec 工作流 | 开放网络搜索 | CCR 路由器 | CCometixLine | AI 输出样式 | 多配置管理
零配置、一键设置 Claude Code 和 Codex，支持双语、智能代理系统和个性化 AI 助手
npx zcf # 打开交互式菜单，根据需要选择操作
菜单选项包括：
1 完整初始化 (相当于 zcf i)2 导入工作流 (相当于 zcf u)3 配置 API 或 CCR - API 配置或 CCR 代理设置4 配置 MCP - MCP 服务配置和管理发现更多类似的优秀工具
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
The all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
5 配置默认模型 - 设置默认模型 (opus/sonnet/sonnet 1m/自定义)6 配置 AI 记忆 - 配置 AI 输出语言和全局输出样式7 配置环境权限 - 导入环境变量和权限R Claude Code 路由器管理 (v2.8.1 增强)U ccusage - Claude Code 使用情况分析L CCometixLine - 高性能状态栏工具，集成 Git 和实时使用追踪 (v2.9.9+ 新增)+ 检查更新 - 检查并更新 Claude Code、CCR 和 CCometixLine 版本 (v2.9.9+ 增强)模型配置 (选项 5): 灵活配置您的默认 Claude 模型：
AI 记忆配置 (选项 6): 个性化您的 AI 助手：
npx zcf i # 直接执行完整初始化：安装 Claude Code + 导入工作流 + 配置 API + 设置 MCP 服务
# 或
npx zcf → 选择 1 # 通过菜单执行完整初始化
npx zcf u # 仅更新工作流：快速添加 AI 工作流和命令系统
# 或
npx zcf → 选择 2 # 通过菜单执行工作流更新
注意:
- 从 v2.0 开始，
zcf默认打开交互式菜单，提供可视化操作界面- 您可以通过菜单选择操作，或直接使用命令快速执行
zcf i= 完整初始化，zcf u= 仅更新工作流
ZCF 支持双语操作，所有命令自动切换语言：
# 使用中文进行所有操作
npx zcf --lang zh-CN # 中文交互式菜单
npx zcf init --lang zh-CN # 中文界面初始化
npx zcf ccr --all-lang zh-CN # 中文配置 CCR
# 语言参数优先级 (从高到低)：
# --all-lang > --lang > 保存的用户偏好 > 交互式提示
语言参数：
--lang, -l: ZCF 界面语言 (适用于所有命令)--all-lang, -g: 一次性设置所有语言参数 (最方便)--config-lang, -c: 模板文件语言 (仅限 init/update 命令)--ai-output-lang, -a: AI 助手输出语言 (仅限 init 命令)适用于 CI/CD 和自动化设置，使用 --skip-prompt 配合参数：
# 简写版本
npx zcf i -s -g zh-CN -t api_key -k "sk-xxx" -u "https://xxx.xxx"
# 完整版本
npx zcf i --skip-prompt --all-lang zh-CN --api-type api_key --api-key "sk-xxx" --api-url "https://xxx.xxx"
# 简写版本 (带自定义模型)
npx zcf i -s -t api_key -k "sk-xxx" -M "claude-sonnet-4-5" -F "claude-haiku-4-5"
# 完整版本 (带自定义模型)
npx zcf i --skip-prompt \
--api-type api_key \
--api-key "sk-xxx" \
--api-url "https://xxx.xxx" \
--api-model "claude-sonnet-4-5" \
--api-fast-model "claude-haiku-4-5"
使用 --skip-prompt 时，可用以下参数：
| 参数 | 描述 | 值 | 必需 | 默认值 |
|---|---|---|---|---|
--skip-prompt, -s | 跳过所有交互式提示 | - | 是 (非交互模式) | - |
--lang, -l | ZCF 显示语言 (适用于所有命令) | zh-CN, en | 否 | en 或用户保存的偏好 |
--config-lang, -c | 配置语言 (模板文件语言) | zh-CN, en | 否 | en |
--ai-output-lang, -a | AI 输出语言 | zh-CN, en, 自定义字符串 | 否 | en |
--all-lang, -g | 设置所有语言参数 (适用于所有命令) | zh-CN, en, 自定义字符串 | 否 | - (优先级：--all-lang > --lang > 保存的用户偏好 > 交互式提示。自定义字符串将 AI 输出语言设置为自定义，而交互和配置语言保持 'en') |
--config-action, -r | 配置处理 | new, backup, merge, docs-only, skip | 否 | backup |
--api-type, -t | API 配置类型 | auth_token, api_key, ccr_proxy, skip | 否 | skip |
--api-key, -k | API 密钥 (适用于 API 密钥和认证令牌类型) | 字符串 | 当 api-type 不是 skip 时必需 | - |
--api-url, -u | 自定义 API URL | URL 字符串 | 否 | 官方 API |
--api-model, -M | 主要 API 模型 | 字符串 (例如 claude-sonnet-4-5) | 否 | - |
--api-fast-model, -F | 快速 API 模型 (仅限 Claude Code) | 字符串 (例如 claude-haiku-4-5) | 否 | - |
--mcp-services, -m | 要安装的 MCP 服务 (多选，逗号分隔) | context7, open-websearch, spec-workflow, mcp-deepwiki, Playwright, exa, serena, 或 skip 表示不安装 | 否 | all |
--workflows, -w | 要安装的工作流 (多选，逗号分隔) | commonTools, sixStepsWorkflow, featPlanUx, gitWorkflow, bmadWorkflow, 或 skip 表示不安装 | 否 | all |
--output-styles, -o | 要安装的输出样式 (多选，逗号分隔) | engineer-professional, nekomata-engineer, laowang-engineer, ojousama-engineer, 或 skip 表示不安装 | 否 | all |
--default-output-style, -d | 默认输出样式 | 与输出样式相同，加上内置：default, explanatory, learning | 否 | engineer-professional |
--install-cometix-line, -x | 安装 CCometixLine 状态栏工具 | true, false | 否 | true |
Codex 是 OpenAI 官方的代码生成 CLI 工具。ZCF 现在支持完整的 Codex 集成，提供与 Claude Code 相同的配置便利性。
主要特性：
开始使用 Codex：
在 ZCF 主菜单中切换到 Codex 模式：
npx zcf → 选择 S # 在 Claude Code 和 Codex 之间切换
或直接访问 Codex 功能：
# 完整 Codex 初始化
npx zcf → 选择 1 (切换到 Codex 模式后)
# 单独 Codex 配置
npx zcf → 选择 3 # 配置 Codex API 提供商
npx zcf → 选择 4 # 配置 Codex MCP 服务
配置选项：
API 提供商配置：
系统提示样式：
工作流集成：
/workflow 命令无法直接传递参数。先使用 /workflow，然后在后续消息中提供任务描述MCP 服务: 完全兼容现有 MCP 服务，包括：
文件位置：
~/.codex/config.toml~/.codex/auth.json~/.codex/AGENTS.md~/.codex/prompts/~/.codex/backup/工具间迁移：
ZCF 允许在 Claude Code 和 Codex 之间无缝切换，同时保留您的偏好和工作流配置。两个工具共享相同的 MCP 服务和工作流模板，提供一致的开发体验。
ZCF 现在支持可定制的 AI 输出样式，个性化您的 Claude Code 体验：
可用输出样式：
engineer-professional: 遵循 SOLID、KISS、DRY、YAGNI 原则的专业软件工程师nekomata-engineer: 专业的猫娘工程师 UFO Nya，结合严谨工程与可爱猫娘特质laowang-engineer: 老王暴躁技术风格，从不容忍代码错误和非标准代码ojousama-engineer: 傲娇金发大小姐程序员 Halley-chan，结合严谨工程卓越与傲娇大小姐特质default, explanatory, learning (始终可用)特性：
使用技巧：
/output-style 命令随时切换项目级输出样式重要：
npx zcf check 进行更新。engineer-professional 输出样式，解决了令牌使用过多和 AI 忘记全局记忆的问题。BMad (BMad 方法：通用 AI 代理框架) 是一个企业级工作流系统，提供：
安装后，在项目中使用 /bmad-init 初始化 BMad 工作流。
Spec 工作流 是一个全面的 MCP 服务，提供从需求到实现的结构化功能开发工作流：
Spec Workflow MCP 提供可选仪表板用于工作流可视化。用户可以手动启动仪表板：
npx -y @pimzino/spec-workflow-mcp@latest --dashboard
或者，您可以安装 VS Code 扩展 进行集成的工作流管理。
使用指南: 详细使用说明和最佳实践，请参阅 官方 Spec 工作流文档。
开放网络搜索 是一个多功能网络搜索 MCP 服务，提供对多个搜索引擎的访问：
CCR 是一个强大的代理路由器，支持：
访问 CCR 功能：
npx zcf ccr # 打开 CCR 管理菜单
# 或
npx zcf → 选择 R
CCR 菜单选项：
CCR 设置后，ZCF 自动配置 Claude Code 使用 CCR 作为 API 代理。
CCometixLine 是一个基于 Rust 的高性能状态栏工具，提供：
CCometixLine 菜单选项 (通过 npx zcf → L 访问)：
1 安装或更新 - 使用 npm 安装或更新 CCometixLine2 打印默认配置 - 显示当前 CCometixLine 配置3 自定义配置 - TUI 配置模式 - 交互式终端 UI 用于自定义设置v2.9.9 用户重要提示: 如果您之前使用过 ZCF v2.9.9 设置环境，请重新运行初始化过程以确保正确添加 CCometixLine 配置。运行
npx zcf并选择适当的设置选项，使用 CCometixLine 支持更新您的配置。
npx zcf check-updates # 检查并更新 Claude Code、CCR 和 CCometixLine 到最新版本
# 或
npx zcf → 选择 +
完整初始化 (npx zcf) 将自动：
配置后：
/init-project 生成 CLAUDE.md，以便 AI 更好地理解项目架构<任务描述> - 直接执行，无需工作流，遵循 SOLID、KISS、DRY 和 YAGNI 原则，适用于小任务如错误修复/feat <任务描述> - 开始新功能开发，分为计划和 UI 阶段/workflow <任务描述> - 执行完整开发工作流，非自动化，从多个解决方案选项开始，在每个步骤询问用户反馈，允许计划修改，最大控制附注:
- feat 和 workflow 各有优势，可以都试试比较
- 生成的文档默认位于项目根目录的
.claude/xxx.md，您可以将.claude/添加到项目的.gitignore
为 Claude Code 和 Codex 提供统一、增量、交互式管理：- Claude Code：管理 API 配置文件（添加/编辑/删除、默认配置、重复检测）
~/.claude/settings.json 并在需要时重启 CCR~/.ufomiao/zcf/config.toml（备份文件为 config.backup.YYYY-MM-DD_HH-mm-ss.toml）明确选择工具类型：
# -T 接受：claude-code|codex 或短别名 cc|cx
npx zcf cs --list -T cc # 列出 Claude Code 配置文件
npx zcf cs --list -T cx # 列出 Codex 提供商
npx zcf cs -l -T cc # --list 的短选项
npx zcf cs -l -T cx # --list 的短选项
Claude Code 用法：
# 快速切换
npx zcf cs official -T cc # 切换到官方登录
npx zcf cs ccr -T cc # 切换到 CCR 代理
npx zcf cs my-profile -T cc
Codex 用法：
# 列出并切换提供商
npx zcf cs --list -T cx
npx zcf cs my-provider -T cx
# 切换到官方登录（交互式选择）
npx zcf config-switch -T cx
注意：
ANTHROPIC_API_KEY，认证令牌 → ANTHROPIC_AUTH_TOKEN，基础 URL → ANTHROPIC_BASE_URL。-T cc/cx。$ npx zcf
ZCF - 零配置代码流
? 选择 ZCF 显示语言 / Select ZCF display language:
❯ 简体中文
English
选择功能：
-------- Claude Code --------
1. 完整初始化 - 安装 Claude Code + 导入工作流 + 配置 API 或 CCR 代理 + 配置 MCP 服务
2. 导入工作流 - 仅导入/更新工作流相关文件
3. 配置 API - 配置 API URL 和认证（支持 CCR 代理）
4. 配置 MCP - 配置 MCP 服务（包含 Windows 修复）
5. 配置默认模型 - 设置默认模型（opus/sonnet/sonnet 1m/自定义）
6. 配置 Claude 全局记忆 - 配置 AI 输出语言和输出风格
7. 导入推荐环境变量和权限 - 导入隐私保护环境变量和系统权限
--------- 其他工具 ----------
R. CCR - Claude Code 路由器管理
U. ccusage - Claude Code 使用情况分析
L. CCometixLine - 高性能状态栏工具，集成 Git 和实时使用情况跟踪
------------ ZCF ------------
0. 选择显示语言 / 更改显示语言 - 更改 ZCF 界面语言
-. 卸载 - 从系统中移除 Claude Code 配置和工具
+. 检查更新 - 检查并更新 Claude Code、CCR 和 CCometixLine 版本
Q. 退出
输入您的选择：_
zcf i）? 选择 Claude Code 配置语言：
❯ English (en) - 英语（推荐，Token 消耗更低）
简体中文 (zh-CN) - 中文（便于中文用户自定义）
日本語 (ja) - 日语（面向日本用户）
? 选择 AI 输出语言：
AI 将使用此语言回复您
❯ English
简体中文
日本語
自定义
（支持法语、德语等更多语言）
? 未找到 Claude Code。是否自动安装？(Y/n)
✔ Claude Code 安装成功
? 检测到现有配置。如何处理？
❯ 备份并覆盖 - 将现有配置备份到 ~/.claude/backup/
仅更新文档 - 仅更新工作流和文档，保留现有 API 配置
合并配置 - 与现有配置合并，保留用户自定义设置
跳过 - 跳过配置更新
? 选择 API 认证方式
❯ 使用官方登录
使用官方认证系统，无需配置 API
使用认证令牌（OAuth 认证）
适用于通过 OAuth 或浏览器登录获取的令牌
使用 API 密钥（密钥认证）
适用于从 Anthropic 控制台获取的 API 密钥
配置 CCR 代理（Claude Code 路由器）
通过代理路由使用多个 AI 模型以降低成本并探索可能性
跳过（稍后手动配置）
? 输入 API URL：https://api.anthropic.com
? 输入认证令牌或 API 密钥：xxx
? 选择要安装的输出风格：
❯ 工程师专业版 - 遵循 SOLID、KISS、DRY、YAGNI 原则的专业软件工程师
猫娘工程师 - 专业的猫娘工程师 UFO Nya，结合严谨工程学与可爱猫娘特质
老王暴躁技术风 - 老王暴躁技术风格，绝不容忍代码错误和非规范代码
大小姐工程师 - 傲娇金发大小姐程序员 Halley-chan，结合严谨工程卓越与傲娇大小姐特质
? 选择全局默认输出风格：
❯ 工程师专业版
? 选择要安装的工作流（空格选择，回车确认）：
❯ ◉ 常用工具（init-project + init-architect + get-current-datetime）- 必要的项目初始化和实用命令
◉ 六步工作流（workflow）- 完整的六阶段开发流程
◉ 功能规划与 UX 设计（feat + planner + ui-ux-designer）- 结构化功能开发
◉ Git 命令（commit + rollback + cleanBranches + worktree）- 简化的 Git 操作
◉ BMAD 方法扩展安装器 - 企业级敏捷开发工作流
✔ 正在安装工作流...
✔ 已安装命令：zcf/workflow.md
✔ 已安装命令：zcf/feat.md
✔ 已安装代理：zcf/plan/planner.md
✔ 已安装代理：zcf/plan/ui-ux-designer.md
✔ 已安装命令：zcf/git/git-commit.md
✔ 已安装命令：zcf/git/git-rollback.md
✔ 已安装命令：zcf/git/git-cleanBranches.md
✔ 已安装命令：zcf/git/git-worktree.md
✔ 已安装命令：zcf/bmad-init.md
✔ 工作流安装成功
? 配置 MCP 服务？(Y/n)
? 选择要安装的 MCP 服务（空格选择，回车确认）：
❯ ◉ Context7 文档查询 - 查询最新库文档和代码示例
◉ DeepWiki - 查询 GitHub 仓库文档和示例
◉ Playwright 浏览器控制 - 直接浏览器自动化控制
◉ Exa AI 搜索 - 使用 Exa AI 进行网络搜索
◉ Serena 助手 - 类似 IDE 的语义化代码检索和编辑
◯ 安装所有服务
✔ MCP 服务已配置
? 安装 CCometixLine 状态栏工具？(Y/n)
✔ 设置完成！Claude Code 环境已准备就绪
🎉 设置完成！使用 'claude' 命令启动。
| 命令 | 别名 | 描述 |
|---|---|---|
zcf | - | 显示交互式菜单（v2.0 默认命令） |
zcf init | zcf i | 初始化 Claude Code 配置 |
zcf update | zcf u | 更新工作流相关的 md 文件并备份 |
zcf ccu | - | 运行 Claude Code 使用情况分析工具 - ccusage |
zcf ccr | - | 打开 CCR（Claude Code 路由器）管理菜单 |
zcf config-switch | zcf cs | Claude Code 和 Codex 的 API 提供商/配置切换（-T cc / -T cx） |
zcf uninstall | - | Claude Code 配置和工具的交互式卸载工具 |
zcf check-updates | - | 检查并更新 Claude Code、CCR 和 CCometixLine 版本 |
# 指定配置语言
npx zcf --config-lang zh-CN
npx zcf -c zh-CN # 使用短选项
# 强制覆盖现有配置
npx zcf --force
npx zcf -f # 使用短选项
# 更新工作流相关的 md 文件并备份（保留 API 和 MCP 配置）
npx zcf u # 使用 update 命令
npx zcf update # 完整命令
# 显示帮助信息
npx zcf --help
npx zcf -h
# 显示版本
npx zcf --version
npx zcf -v
# 显示交互式菜单（默认）
npx zcf
# 首次安装，完整初始化
npx zcf i
npx zcf init # 完整命令
# 更新工作流相关的 md 文件并备份，保留 API 和 MCP 配置
npx zcf u
npx zcf update # 完整命令
# 强制重新初始化，使用中文配置
npx zcf i --config-lang zh-CN --force
npx zcf i -c zh-CN -f # 使用短选项
# 更新为英文提示（Token 消耗更低）
npx zcf u --config-lang en
npx zcf u -c en # 使用短选项
# 运行 Claude Code 使用情况分析工具（由 ccusage 提供支持）
npx zcf ccu # 每日使用情况（默认），或使用：monthly, session, blocks
# Codex API 提供商切换（v3.0.0+ 新增）
npx zcf config-switch # 交互式提供商选择
npx zcf cs # 使用别名
npx zcf cs provider-name # 直接切换到指定提供商
npx zcf cs --list # 列出所有可用提供商
zcf/
├── README.md # 文档
├── package.json # npm 包配置
├── bin/
│ └── zcf.mjs # CLI 入口点
├── src/ # 源代码
│ ├── cli.ts # CLI 主逻辑
│ ├── commands/ # 命令实现
│ ├── utils/ # 工具函数
│ └── constants.ts # 常量定义
├── templates/ # 配置模板
│ ├── CLAUDE.md # 项目级配置（v2.0 新增）
│ ├── settings.json # 基础配置（包含隐私环境变量）
│ ├── en/ # 英文版本
│ │ ├── rules.md # 核心原则（原 CLAUDE.md）
│ │ ├── output-styles/ # AI 输出风格（v2.12+ 新增）
│ │ ├── mcp.md # MCP 服务指南（v2.0 新增）
│ │ ├── agents/ # AI 代理
│ │ └── commands/ # 命令定义
│ └── zh-CN/ # 中文版本
│ └── ...（相同结构）
└── dist/ # 构建输出
/feat）：结构化的新功能开发/workflow）：完整的六阶段开发工作流/git-commit：智能提交，自动暂存和生成提交信息/git-rollback：安全回滚到之前的提交并备份/git-cleanBranches：清理已合并分支，维护仓库整洁/git-worktree：管理 Git 工作树，集成 IDE 和内容迁移/bmad-init）：为企业开发初始化 BMad 工作流
# 克隆项目
git clone https://github.com/UfoMiao/zcf.git
cd zcf
# 安装依赖（使用 pnpm）
pnpm install
# 构建项目
pnpm build
# 本地测试
node bin/zcf.mjs
.claude/plan/ 目录中如果遇到问题：
npx zcf 重新配置~/.claude/ 目录中的配置文件rg）进行文件搜索以获得更好性能ZCF 完全支持 Windows 平台：
cmd /c npx 格式如果在 Windows 上遇到 MCP 连接问题，运行 npx zcf 将自动修复配置格式。
ZCF 现在为 Windows Subsystem for Linux（WSL）提供全面支持：
如果在 WSL 中运行，ZCF 将自动检测环境并显示适当的安装消息。
ZCF 现在支持在 Android Termux 环境中运行：
为保护用户数据安全，以下操作需要明确确认：
git commit、git push、git reset --hard本项目受以下开源项目启发并整合了其内容：
感谢这些社区贡献者的分享！