♥️ 赞助商

本项目由 Z.ai 赞助，他们通过 GLM 编码计划支持我们。GLM 编码计划是一项专为 AI 编码设计的订阅服务，每月仅需 10 美元起。它使开发者能够访问其旗舰模型 GLM-4.7（GLM-5 仅对 Pro 用户开放），并集成到 10 多种流行的 AI 编码工具中（如 Claude Code、Cline、Roo Code 等），为开发者提供顶级、快速且稳定的编码体验。 享受 GLM 编码计划 10% 折扣：https://z.ai/subscribe?ic=8JVLJQFSKB

---

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

---

	感谢 PackyCode 对本项目的赞助！PackyCode 是一家可靠高效的 API 中继服务提供商，为 Claude Code、Codex、Gemini 等提供中继服务。PackyCode 为我们的软件用户提供特别折扣：使用 此链接 注册，并在充值时输入优惠码 “zcf”，即可享受 10% 的折扣。
	感谢 AICodeMirror 对本项目的赞助！AICodeMirror 为 Claude Code/Codex/Gemini CLI 提供官方高稳定性中继服务，支持企业级高并发、快速开票以及 7x24 小时专属技术支持。Claude Code/Codex/Gemini 的官方渠道可享受低至 38%/2%/10.9% 的折扣，叠加充值优惠！AICodeMirror 为 ZCF 用户提供特别福利：通过 此链接 注册的用户首次充值可享 20% 折扣，企业客户最高可享 25% 折扣！
	感谢 Crazyrouter 对本项目的赞助！Crazyrouter 是一款高性能的 AI API 聚合网关——只需一个 API 密钥即可访问 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 群组，获取支持、讨论和最新动态：

🙏 致谢

本项目受到以下项目和工作的启发，并整合了其中的部分内容：

• LINUX DO - 新理想社区
• CCR
• CCometixLine
• ccusage
• BMad 方法

感谢这些社区贡献者们的分享！

❤️ 支持与赞助

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

我们的赞助商

衷心感谢所有赞助商的慷慨支持！

【企业赞助商】

• 302.AI（首个企业赞助 🤠）
• GLM（首个 AI 模型赞助 🤖）
• PackyCode（首个 API 代理服务赞助 🧝🏻‍♀️）
• AICodeMirror（官方高稳定性中继服务赞助 🪞）
• UUCode（赞助 100 美元代理积分 💰）
• Crazyrouter（AI API 聚合网关赞助 🚀）

【个人赞助商】

• Tc（首位赞助人）
• Argolinhas（首位 ko-fi 赞助人 ٩(•̤̀ᵕ•̤́๑)）
• r*r（首位匿名赞助人 🤣）
• **康（首位 KFC 赞助人 🍗）
• *东（首位咖啡赞助人 ☕️）
• 炼*3（首位 Termux 用户赞助 📱）
• chamo101（首位 GitHub issue 赞助人 🎉）
• 初屿贤（首位 Codex 用户赞助 🙅🏻‍♂️）
• Protein（首位 1688 赞助人 😏）
• musistudio（首位开源项目作者赞助，CCR 的作者 🤩）
• *年（首位 100 元人民币赞助 💴）
• BeatSeat（社区专家 😎，提供了价值 1000 元的 Claude 积分）
• wenwen（社区专家 🤓，每天提供价值 100 元的 Claude 和 GPT 积分）
• 16°C coffee（我最好的朋友 🤪，赠送了 ChatGPT Pro 价值 200 美元的套餐）

感谢推广

感谢以下作者对本项目的推广：

• 逛逛 GitHub，文章：https://mp.weixin.qq.com/s/phqwSRb16MKCHHVozTFeiQ
• Geek，推文：https://x.com/geekbb/status/1955174718618866076

📄 许可证

MIT 许可证

---

🚀 贡献者

⭐️ 星标历史

如果这个项目对您有帮助，请为我点个 ⭐️ 星吧！

ZCF 快速上手指南

ZCF (Zero-Config Code Flow) 是一款专为 Claude Code 和 Codex 打造的零配置初始化工具。它支持一键安装、工作流配置、API/CCR 设置及 MCP 集成，并提供双语界面与智能代理系统。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows (WSL 推荐)。
• 运行时依赖：已安装 Node.js (建议 v18 或更高版本) 和 npm。
  • 国内用户若下载 Node.js 较慢，推荐使用 cnpm 镜像或 nvm 进行安装。
• 目标工具：本地已安装 claude (Claude Code) 或 codex CLI 工具（ZCF 可辅助初始化，但需确保基础环境可用）。

安装步骤

ZCF 无需全局安装，推荐直接使用 npx 运行最新版本的交互式菜单。

方式一：交互式安装（推荐）

运行以下命令打开交互菜单，根据提示选择所需功能：

npx zcf

方式二：命令行快速初始化

如果您希望跳过交互菜单，直接执行全套初始化（安装 + 工作流 + API/CCR + MCP），请使用：

npx zcf i

方式三：指定服务商非交互式安装

若您已有 API Key 并希望指定服务商（例如使用 302.AI），可直接传入参数：

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

请将 "sk-xxx" 替换为您实际的 API Key。

基本使用

安装完成后，您可以通过以下常用命令管理您的 AI 编码环境：

• 更新工作流：仅更新现有的工作流配置，不重新安装其他组件。

  npx zcf u
  

• 切换语言：切换工具界面语言（例如切换为简体中文）。

  npx zcf --lang zh-CN
  

• 查看完整文档：更多高级用法、自定义工作流及配置选项，请访问官方文档：

  • https://zcf.ufomiao.com/

• 社区交流：遇到问题或需要讨论，可加入 Telegram 群组：

  • https://t.me/ufomiao_zcf