什么是 ZCF?
ZCF (Zero-Config Code Flow) 是一个强大的 CLI 工具,专为简化 Claude Code 和 Codex 的配置和安装而设计。
核心理念: ZCF 通过智能化的交互式菜单和自动化流程,让开发者无需手动配置复杂的文件和环境变量,即可快速启用 AI 编码助手。无论是首次安装还是更新配置,ZCF 都能提供流畅的体验。
一键安装流程
ZCF 提供完整的自动化安装流程,只需一条命令即可完成所有配置:
核心特性
ZCF 为开发者提供全方位的配置和管理功能
零配置安装
一键完成 Claude Code 和 Codex 的安装和配置。自动检测系统环境,智能选择最优配置方案,无需手动编辑配置文件。
多语言支持
完整的 i18next 国际化系统,支持中文、英文、日语界面。可自定义 AI 输出语言,配置文件语言独立切换,满足全球开发者需求。
交互式菜单
友好的交互式菜单系统,清晰展示所有功能选项。支持键盘快捷操作,可视化配置流程,降低使用门槛。
智能配置管理
智能配置合并和备份系统。支持增量更新、部分修改、配置回滚,保护用户自定义设置,避免配置丢失。
跨平台支持
完整支持 Windows、macOS、Linux、WSL、Termux。智能识别平台特性,自动适配路径和命令格式,确保跨平台一致性。
AI 个性化
多种 AI 输出风格可选:专业工程师、猫娘工程师、老王工程师、大小姐工程师。支持自定义 AI 人格,打造个性化编码体验。
MCP 服务集成
集成 Context7、DeepWiki、Playwright、Exa、Open Web Search、Spec Workflow 等多种 MCP 服务,扩展 AI 能力边界。
工作流系统
预置六步开发工作流、特性规划流程、Git 命令集、BMad 企业敏捷流程等专业工作流,提升开发效率和代码质量。
CCR 代理支持
集成 Claude Code Router 代理管理。支持免费模型路由、成本优化、自定义规则,显著降低 API 使用成本。
使用分析工具
集成 CCusage 和 CCometixLine 工具。实时监控 API 使用情况,展示 Git 状态,提供高性能状态栏显示。
自动更新检查
自动检查 Claude Code、CCR、CCometixLine 版本更新。一键更新所有工具,确保始终使用最新功能和修复。
智能卸载系统
完整的卸载功能,支持完全卸载、自定义卸载、交互式卸载。跨平台回收站集成,冲突解决,安全删除配置和工具。
快速开始
只需一条命令即可开始使用 ZCF
推荐方式:使用交互式菜单
npx zcf # 打开交互式菜单,根据需要选择操作菜单选项包括:
- 1 - 完整初始化 (等同于
zcf i) - 2 - 导入工作流 (等同于
zcf u) - 3 - 配置 API 或 CCR - API 配置或 CCR 代理设置
- 4 - 配置 MCP - MCP 服务配置和管理
- 5 - 配置默认模型 - 设置默认模型(opus/sonnet/sonnet 1m/自定义)
- 6 - 配置 AI 记忆 - 配置 AI 输出语言和全局输出风格
- 7 - 配置环境权限 - 导入环境变量和权限
- R - Claude Code Router 管理
- U - ccusage - Claude Code 使用分析
- L - CCometixLine - 高性能状态栏工具
- + - 检查更新 - 检查并更新 Claude Code、CCR 和 CCometixLine 版本
首次使用
npx zcf i # 执行完整初始化:安装 Claude Code + 导入工作流 + 配置 API + 设置 MCP 服务
# 或
npx zcf → 选择 1 # 通过菜单执行完整初始化已安装 Claude Code
npx zcf u # 仅更新工作流:快速添加 AI 工作流和命令系统
# 或
npx zcf → 选择 2 # 通过菜单执行工作流更新多语言支持
# 使用中文进行所有操作
npx zcf --lang zh-CN # 中文交互式菜单
npx zcf init --lang zh-CN # 使用中文界面初始化
npx zcf ccr --allLang 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)
# 简写版本
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"命令参考
ZCF 提供的所有命令和别名
| 命令 | 别名 | 描述 |
|---|---|---|
zcf |
- | 显示交互式菜单(v2.0 默认命令) |
zcf init |
zcf i |
初始化 Claude Code 配置 |
zcf update |
zcf u |
更新工作流相关 md 文件并备份 |
zcf ccu |
- | 运行 Claude Code 使用分析工具 - ccusage |
zcf ccr |
- | 打开 CCR(Claude Code Router)管理菜单 |
zcf config-switch |
zcf cs |
Codex API 提供商切换工具 - 在官方登录和自定义提供商之间切换 |
zcf uninstall |
- | Claude Code 配置和工具的交互式卸载工具 |
zcf check-updates |
- | 检查并更新 Claude Code、CCR 和 CCometixLine 版本 |
Codex 支持 (v3.0.0+ 新功能)
ZCF 现在支持 OpenAI 的官方代码生成 CLI 工具 Codex 的完整集成
双工具架构: ZCF 允许在 Claude Code 和 Codex 之间无缝切换,同时保留你的偏好和工作流配置。两个工具共享相同的 MCP 服务和工作流模板,提供一致的开发体验。
统一工具管理
通过 ZCF 菜单在 Claude Code 和 Codex 之间无缝切换。统一的配置界面,一致的使用体验。
智能配置
自动安装 Codex CLI、配置 API 提供商、集成 MCP 服务。所有配置都包含时间戳备份和恢复功能。
多提供商支持
配置多个 API 提供商(OpenAI、自定义端点),轻松切换。支持官方登录和自定义 API 密钥。
系统提示集成
安装专业的 AI 人格(工程师、猫娘工程师、老王工程师)。自定义 Codex 的输出风格和行为。
开始使用 Codex
# 在 ZCF 主菜单中切换到 Codex 模式
npx zcf → 选择 S # 在 Claude Code 和 Codex 之间切换
# 或直接访问 Codex 功能
npx zcf → 选择 1 (切换到 Codex 模式后) # 完整 Codex 初始化
npx zcf → 选择 3 # 配置 Codex API 提供商
npx zcf → 选择 4 # 配置 Codex MCP 服务
# Codex API 提供商切换(v3.0.0+ 新功能)
npx zcf config-switch # 交互式提供商选择
npx zcf cs # 使用别名
npx zcf cs provider-name # 直接切换到指定提供商
npx zcf cs --list # 列出所有可用提供商AI 输出风格 (v2.12+ 新功能)
自定义 AI 个性,打造专属编码体验
专业工程师
engineer-professional
遵循 SOLID、KISS、DRY、YAGNI 原则的专业软件工程师风格。注重代码质量和最佳实践。
猫娘工程师
nekomata-engineer
专业的猫娘工程师 UFO Nya,结合严谨的工程标准和可爱的猫娘特质。技术与萌的完美结合。
老王工程师
laowang-engineer
老王暴躁技术风格,绝不容忍代码错误和不规范代码。直率的技术交流,追求极致质量。
大小姐工程师
ojousama-engineer
傲娇金发大小姐程序员 Halley-chan,结合严谨的工程卓越性和傲娇大小姐特质。
使用提示
- 使用
/output-style命令随时切换项目级别的输出风格 - 或在 ZCF 菜单选项 6 中修改全局输出风格
- Claude Code 版本必须大于 1.0.81 才能支持 output-style。使用
npx zcf check更新 - 内置风格:default、explanatory、learning(始终可用)
工作流系统
预置专业开发工作流,提升代码质量和开发效率
常用工具
Common Tools
包含 init-project、init-architect、get-current-datetime 等基础项目初始化和实用命令。
六步工作流
Six Steps Workflow
完整的 6 阶段开发流程:研究 → 构思 → 规划 → 执行 → 优化 → 审查。结构化开发方法。
特性规划与 UX
Feature Planning and UX
包含 feat、planner、ui-ux-designer。结构化的特性开发流程,从规划到实现。
Git 命令集
Git Commands
简化的 Git 操作:commit、rollback、cleanBranches、worktree。智能提交和分支管理。
BMad 工作流
BMAD-Method
企业级敏捷开发工作流系统。完整的专业 AI 智能体团队(PO、PM、架构师、开发、QA 等)。
Spec 工作流
Spec Workflow
从需求到实现的结构化特性开发工作流。需求分析、设计阶段、任务管理、审批系统。
工作流使用
# 项目首次使用,强烈建议运行 /init-project 生成 CLAUDE.md
# 以便 AI 更好地理解项目架构
# 执行任务(不使用工作流)
<任务描述> # 适合小任务如 bug 修复
# 启动新特性开发
/feat <任务描述> # 分为规划和 UI 阶段
# 执行完整开发工作流
/workflow <任务描述> # 提供多个解决方案选项,每步询问用户反馈集成工具
ZCF 集成了多种强大的工具,增强 Claude Code 体验
CCR - Claude Code Router
强大的代理路由器,支持免费模型访问(如 Gemini、DeepSeek)、自定义路由规则、成本优化。显著降低 API 使用成本。
npx zcf ccr
CCusage - 使用分析
Claude Code 使用分析工具。监控 API 使用情况,生成详细的使用报告,帮助优化成本和使用策略。
npx zcf ccu
CCometixLine - 状态栏
高性能 Rust 编写的状态栏工具。实时使用跟踪、Git 集成、终端状态栏显示、TUI 配置界面、自动更新。
npx zcf → L
MCP 服务
Model Context Protocol 服务扩展 AI 能力
Context7
查询最新的库文档和代码示例。快速获取技术文档,提升开发效率。
DeepWiki
查询 GitHub 仓库文档和示例。深入了解开源项目,快速学习和参考。
Playwright
直接浏览器自动化控制。进行端到端测试,自动化 Web 交互。
Exa AI Search
使用 Exa AI 进行 Web 搜索。智能搜索引擎,快速找到相关信息。
Open Web Search
多引擎支持(DuckDuckGo、Bing、Brave)。注重隐私的搜索引擎,无需 API 密钥。
Spec Workflow
从需求到实现的综合 MCP 服务。结构化需求收集、技术设计、任务管理、交互式仪表板。
技术栈
ZCF 构建使用的现代化技术和工具
社区与支持
加入社区,一起让 ZCF 变得更好
报告问题
在 GitHub Issues 中报告 bug 或提出功能建议。我们会认真对待每一个反馈。
贡献代码
欢迎提交 Pull Request。查看 CONTRIBUTING.md 了解如何开始贡献代码。
改进文档
帮助完善文档,编写教程和使用指南,让更多人从 ZCF 中受益。
Star 项目
如果 ZCF 对你有帮助,请在 GitHub 上给项目一个 Star,支持开源发展。
致谢
ZCF 的发展离不开以下开源项目和社区的支持: