项目概述
一款专为 Claude Code 和 Codex 设计的零配置工具，让 AI 编程配置变得简单
ZCF（Zero-Config Code Flow）是一款革命性的 CLI 配置工具，专为简化 Claude Code 和 Codex 的配置流程而设计。它提供了零配置、一键设置的体验，支持双语操作（中英文）、智能代理系统和个性化 AI 助手，让开发者能够快速上手 AI 辅助编程。
无论你是初次使用 Claude Code 的新手，还是需要快速配置多个环境的专业开发者，ZCF 都能为你提供最便捷的解决方案。通过交互式菜单和智能配置系统，你可以在几分钟内完成从安装到配置的全部流程。
核心特性
强大的功能集合，让 AI 编程配置更加智能和高效
零配置安装
一键安装 Claude Code 或 Codex，自动检测系统环境，智能配置所有必要文件，无需手动操作。
多语言支持
完整的中英日三语支持，包括界面语言、配置文件语言和 AI 输出语言，满足全球开发者需求。
智能代理系统
内置专业 AI 代理，包括任务规划器、UI/UX 设计师、BMad 敏捷开发团队等，提升开发效率。
个性化输出风格
支持多种 AI 输出风格，包括专业工程师、猫娘工程师、老王技术风格、大小姐工程师等，让 AI 更有个性。
API 提供商预设
支持 302.AI、GLM、MiniMax、Kimi 等多个 API 提供商预设，简化配置流程，只需提供商和密钥两个参数。
MCP 服务集成
一键配置 Context7、DeepWiki、Playwright、Exa、Serena 等 MCP 服务，扩展 AI 能力。
CCR 路由支持
集成 Claude Code Router，支持免费模型访问、自定义路由规则、成本优化等高级功能。
实时使用追踪
CCometixLine 状态栏工具，实时监控 API 使用情况、Git 状态和分支信息，性能优化。
工作流模板
内置六步开发工作流、特性规划、Git 命令、BMad 方法等专业工作流模板，规范开发流程。
快速开始
三种方式快速上手 ZCF
交互式菜单（推荐）
使用交互式菜单，根据需求选择操作，最简单直观的方式。
npx zcf # 打开交互式菜单，根据需求选择操作菜单选项包括：完整初始化、导入工作流、配置 API、配置 MCP、配置默认模型、配置 AI 记忆、CCR 管理、使用分析等。
首次使用 Claude Code
如果你是第一次使用 Claude Code，执行完整初始化。
npx zcf i # 执行完整初始化
# 或通过菜单
npx zcf → 选择 1 # 通过菜单执行完整初始化完整初始化包括：安装 Claude Code、导入工作流、配置 API、设置 MCP 服务等所有必要步骤。
已安装 Claude Code
如果已经安装了 Claude Code，只需更新工作流。
npx zcf u # 仅更新工作流
# 或通过菜单
npx zcf → 选择 2 # 通过菜单执行工作流更新更新工作流会快速添加 AI 工作流和命令系统，保留现有的 API 和 MCP 配置。
高级功能
探索 ZCF 的强大能力
API 提供商预设
v3.3.0+ 新功能，支持快速配置多个 API 提供商，自动填充 baseUrl 和模型配置。
# 使用 302.AI 提供商
npx zcf i -s -p 302ai -k "sk-xxx"
# 使用 GLM 提供商
npx zcf i -s -p glm -k "sk-xxx"
# 使用自定义提供商
npx zcf i -s -p custom -k "sk-xxx" -u "https://api.example.com"Codex 支持
v3.0.0+ 新功能，完整支持 OpenAI 的 Codex CLI 工具，统一管理多个代码工具。
# 切换到 Codex 模式
npx zcf → 选择 S
# 配置 Codex
npx zcf → 选择 1（切换到 Codex 模式后）Spec Workflow
v2.12.4+ 新功能，结构化特性开发工作流，从需求到实现的完整流程管理。
# 启动 Spec Workflow 仪表板
npx -y @pimzino/spec-workflow-mcp@latest --dashboardOpen Web Search
v2.12.9+ 新功能，多引擎网络搜索 MCP 服务，支持 DuckDuckGo、Bing、Brave 等。
# 在 ZCF 菜单中选择安装 MCP 服务
npx zcf → 选择 4 → 选择 Open Web SearchBMad 工作流
v2.7+ 新功能，企业级敏捷开发工作流系统，包含完整的专业 AI 代理团队。
# 初始化 BMad 工作流
/bmad-initCCometixLine
v2.9.9+ 新功能，高性能 Rust 状态栏工具，实时追踪 API 使用和 Git 状态。
# 访问 CCometixLine 菜单
npx zcf → 选择 L使用示例
常见使用场景和命令示例
# 使用 API 提供商预设（简化版）
npx zcf i -s -p 302ai -k "sk-xxx"
# 传统方式（完整参数）
npx zcf i -s -g zh-CN -t api_key -k "sk-xxx" -u "https://xxx.xxx"
# 使用预设并自定义模型
npx zcf i -s -p 302ai -k "sk-xxx" -M "claude-sonnet-4-5" -F "claude-haiku-4-5"
# 多 API 配置（JSON 字符串）
npx zcf i -s --api-configs '[
{"provider":"302ai","key":"sk-xxx"},
{"provider":"glm","key":"sk-yyy"},
{"name":"custom","type":"api_key","key":"sk-zzz","url":"https://custom.api.com","default":true}
]'
# 多 API 配置（JSON 文件）
npx zcf i -s --api-configs-file ./api-configs.json# 使用中文进行所有操作
npx zcf --lang zh-CN # 中文交互式菜单
npx zcf init --lang zh-CN # 中文初始化界面
npx zcf ccr --all-lang zh-CN # 中文配置 CCR
# 语言参数优先级（从高到低）：
# --all-lang > --lang > 保存的用户偏好 > 交互式提示# 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 # 切换到指定提供商# 检查并更新 Claude Code、CCR 和 CCometixLine
npx zcf check-updates
# 或通过菜单
npx zcf → 选择 +技术架构
现代化的技术栈和项目结构
核心技术
- TypeScript - 类型安全的开发体验
- Node.js - 跨平台运行环境
- pnpm - 高效的包管理器
- Vitest - 现代化测试框架
- unbuild - 零配置构建工具
CLI 工具
- cac - 命令行参数解析
- inquirer - 交互式命令行界面
- ora - 优雅的加载动画
- ansis - 终端颜色输出
- i18next - 国际化支持
项目结构
- bin/ - CLI 入口点
- src/ - 源代码目录
- templates/ - 配置模板
- tests/ - 测试文件
- dist/ - 构建输出
社区支持
加入我们的社区，获取帮助和分享经验