[![npm version][npm-version-src]][npm-version-href] [![npm downloads][npm-downloads-src]][npm-downloads-href] [![License][license-src]][license-href] [![Claude Code][claude-code-src]][claude-code-href] [![codecov][codecov-src]][codecov-href] [![JSDocs][jsdocs-src]][jsdocs-href] [![Ask DeepWiki][deepwiki-src]][deepwiki-href]

ZCF - Zero-Config Code Flow

English | 中文 | 日本語 | 更新日志

✨ 完整文档: ZCF Docs

为 Claude Code 和 Codex 提供零配置、一键安装方案，支持双语、智能代理系统及个性化 AI 助手。

♥️ 赞助商

本项目由 Z.ai 赞助，支持我们的 GLM CODING PLAN。 GLM CODING PLAN 是一项专为 AI 编程设计的订阅服务，每月仅需 10 美元起。它提供对旗舰模型 GLM-4.7 和 Pro 用户专属的 GLM-5 的访问权限，支持 10 多种主流 AI 编程工具（如 Claude Code、Cline、Roo Code 等），为开发者提供顶尖、快速且稳定的编程体验。获取 GLM CODING PLAN 9 折优惠：https://z.ai/subscribe?ic=8JVLJQFSKB

PatewayAI 是一家高质量的模型 API 中转服务提供商，专注于为严肃的 AI 开发者提供官方直连服务，提供全系列 Claude 和 Codex 模型。100% 官方源供货，无掺杂，可随时核查。账单透明，支持 Token 级明细审计。提供企业级并发支持，拥有专门的企业客户管理平台，支持正式合同和开票。PatewayAI 为 ZCF 用户提供专属福利：通过此链接注册即可获得 3 美元免费试用金，充值低至 6 折，双向邀请奖励最高可达 150 美元！

302.AI 是一家按需付费的企业级 AI 资源枢纽，提供市面上最新、最全的 AI 模型和 API，以及多种即开即用的在线 AI 应用。

感谢 PackyCode 对本项目的赞助！PackyCode 是一家可靠且高效的 API 中转服务提供商，提供 Claude Code、Codex、Gemini 等模型的中转服务。PackyCode 为我们的软件用户提供特别优惠：通过此链接注册并在充值时输入优惠码 "zcf" 即可享受 9 折优惠。

感谢 APIKEY.FUN 对本项目的赞助！APIKEY.FUN 是一个专业的企业级 AI 中转平台，致力于为公司和个人开发者提供稳定、高效、低成本的 API 访问。平台支持包括 Claude、OpenAI 和 Gemini 在内的热门模型，价格低至官方费率的 7%。通过此链接注册，即可享受永久 95 折的独家充值优惠。

感谢 AICodeMirror 对本项目的赞助！AICodeMirror 为 Claude Code/Codex/Gemini CLI 提供高稳定性官方中转服务，支持企业级高并发、快速开票以及 7x24 小时专属技术支持。Claude Code/Codex/Gemini 官方渠道折扣低至 3.8 折/2 折/10.9 折，充值还有额外折扣！AICodeMirror 为 ZCF 用户提供特别优惠：通过此链接注册的用户首充可享 8 折优惠，企业客户最高可享 75 折优惠！

感谢 Crazyrouter 对本项目的赞助！Crazyrouter 是一个高性能 AI API 聚合网关，一个 API Key 即可使用 300+ 模型（GPT、Claude、Gemini、DeepSeek 等）。所有模型价格仅为官方价格的 55%，支持自动故障转移、智能路由和无限并发。完全兼容 OpenAI，可与 Claude Code、Codex 和 Gemini CLI 无缝协作。Crazyrouter 为 ZCF 用户提供独家福利：通过此链接注册立即获得 2 美元免费额度！

🚀 快速开始

推荐方式：运行 npx zcf 打开交互式菜单 —— 按需选择即可。
常用命令：

npx zcf i        # 全量初始化：安装 + 工作流 + API/CCR + MCP
npx zcf u        # 仅更新工作流
npx zcf --lang zh-CN  # 切换界面语言（示例）

非交互式示例（服务商预设）：

npx zcf i -s -p 302ai -k "sk-xxx"

更多用法、选项和工作流，请参考文档。

📖 完整文档

https://zcf.ufomiao.com/

💬 社区

加入我们的 Telegram 群组以获取支持、讨论和更新：

🙏 致谢