[![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 美元。它允许在 10 多种主流 AI 编程工具（如 Claude Code、Cline、Roo Code 等）中使用其旗舰模型 GLM-4.7 及仅限 Pro 用户使用的 GLM-5，为开发者提供顶级、快速且稳定的编程体验。 GLM CODING PLAN 9 折优惠链接：https://z.ai/subscribe?ic=8JVLJQFSKB

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

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

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

感谢 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 群组以获取支持、讨论和更新信息：

🙏 致谢

本项目灵感来源于以下项目，并整合了其中的工作成果：

感谢以上社区贡献者的分享！

❤️ 支持与赞助

如果您觉得本项目对您有帮助，请考虑赞助开发。您的支持将不胜感激！

我们的赞助商

非常感谢所有赞助商的慷慨支持！

【企业赞助商】

302.AI (首位企业赞助商 🤠)
GLM (首位 AI 模型赞助商 🤖)
PackyCode (首位 API 代理服务赞助商 🧝🏻‍♀️)
AICodeMirror (官方高稳定性中转服务赞助商 🪞)
UUCode (赞助了 100 美元代理额度 💰)
Crazyrouter (AI API 聚合网关赞助商 🚀)

【个人赞助商】

Tc (首位个人赞助者)
Argolinhas (首位 ko-fi 赞助者)

UfoMiao/zcf