zcf 是什么?

ZCF(Zero-Config Code Flow)是一个零配置、一键为 Claude Code 与 Codex 做初始化设置的工具:支持中英双语,帮你一次性安装并配置工作流、API/CCR(Claude Code Router 类路由)、MCP,以及智能体系统与个性化 AI 助手。用 npx zcf 打开交互菜单选择所需即可。许可为 MIT,TypeScript,约 6,007 stars,有完整文档站。它是面向 Claude Code/Codex 用户的「开箱配置」助手,降低初始设置成本。

⭐ 5,868 Stars 🍴 411 Forks TypeScript MIT 作者: UfoMiao
来源:README.md(描述、Quick Start);GitHub 仓库元数据(stars=6007、license=MIT、language=TypeScript) 查看 GitHub 仓库 →

为什么值得关注

Claude Code/Codex 要用好需要配置工作流、MCP、API/路由等,新手或换机时设置繁琐。ZCF 用一条 npx 命令把这些一键搞定、双语、含智能体与个性化助手预设,省时省心,因而受关注。截至数据采集约 6,007 stars。需提示:其部分 provider 预设与赞助商为第三方 API 中转/代充服务,使用应走合规渠道。

来源:README.md(描述、Quick Start、Sponsors);GitHub 仓库元数据(stars=6007)

核心功能

零配置一键初始化

npx zcf i 一次性完成 Claude Code/Codex 的安装、工作流、API/CCR 与 MCP 配置;zcf u 仅更新工作流。

来源:README.md(Quick Start)
双语 + 智能体/个性化助手

支持中英双语界面(--lang),预置智能体系统与个性化 AI 助手,开箱即用。

来源:README.md(描述、Quick Start 的 --lang)
Provider 预设与 CCR/MCP 配置

支持非交互式 provider 预设(如 302ai)与 key 注入,并配置 CCR(Claude Code Router)路由与 MCP 服务。

来源:README.md(Quick Start 的非交互示例、API/CCR + MCP)

技术架构

ZCF 是 TypeScript 的 CLI(npm 包 zcf),通过 npx zcf 交互菜单或子命令运行:zcf i 做完整初始化(安装 + 工作流 + API/CCR + MCP),zcf u 仅更新工作流,--lang 切换界面语言,并支持非交互式 provider 预设(如 -p 302ai -k )。它为 Claude Code 与 Codex 写入工作流、配置 API 或 CCR(Claude Code Router)路由与 MCP,并预置智能体系统与个性化 AI 助手。支持中英双语。具体选项与工作流见文档站。其 README 列出 GLM、PatewayAI、302.AI 等赞助/provider,其中部分为第三方 API 中转服务。

来源:README.md(Quick Start 命令、非交互示例、描述、Sponsors)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Claude Code / Codex(配置对象)Claude Code /… CCR(Claude Code Router)、MCPCCR(Claude Co… 各 provider(用你自己的 key)各 provider(用… 零配置一键初始化 双语 + 智能体/个性化助手双语 + 智能体/个性化… Provider 预设与 CCR/MCP 配置Provider 预设与 CCR… zcf 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript(Node.js)框架CLI(npm 包 zcf)
Claude Code / Codex(配置对象)CCR(Claude Code Router)、MCP各 provider(用你自己的 key)
npx zcf 运行;文档站 zcf.ufomiao.com
来源:README.md(Quick Start、描述);GitHub 仓库元数据(language=TypeScript)

快速上手

推荐:npx zcf 打开交互菜单按需选择。常用命令:npx zcf i 做完整初始化(安装 + 工作流 + API/CCR + MCP),npx zcf u 仅更新工作流,npx zcf --lang zh-CN 切换语言;非交互式可用 provider 预设如 npx zcf i -s -p 302ai -k "sk-xxx"。更多选项与工作流见文档站 zcf.ufomiao.com。注意:provider 预设/赞助商中包含第三方 API 中转/代充服务,建议用官方或合规渠道并遵守各模型服务条款。
来源:README.md(Quick Start、Sponsors);合规判断

使用场景

适合 Claude Code/Codex 用户想快速、零配置地搭好工作流、MCP、API/路由与智能体预设:新机初始化、团队统一配置、或想要双语界面与个性化助手。它把繁琐的初始设置一键化,适合不想手动折腾配置的人。接入模型用你自己的 key、走合规 provider 即可。

来源:README.md(描述、Quick Start)

优势与局限

优势

  • 零配置一键搭好 Claude Code/Codex 的工作流/MCP/API/CCR,省时
  • 中英双语、预置智能体与个性化助手,开箱即用
  • npx 即用、支持非交互 provider 预设,便于批量/团队配置
  • MIT 开源、文档完善、社区活跃

局限

  • 部分 provider 预设/赞助商为第三方 API 中转/代充,建议走官方合规渠道
  • 是配置/设置工具,模型能力与成本取决于所接服务
  • 强绑定 Claude Code/Codex 生态
  • 一键配置之外的深度定制仍需理解各自配置
来源:README.md(Quick Start、Sponsors、描述);合规判断

最新版本

本页未列出具体版本号;ZCF 以 npm 包持续迭代(README 带 npm 版本/下载徽章),围绕 Claude Code/Codex 的零配置初始化、工作流、CCR/MCP 与 provider 预设完善。更新以扩展配置能力与工作流为主。

来源:README.md(npm 徽章、Quick Start)

总结评价

ZCF 把「用好 Claude Code/Codex 前的繁琐配置」一键化:零配置安装工作流、MCP、API/CCR 路由,外加双语界面、智能体与个性化助手预设,npx 即用、可批量/团队配置。对不想手动折腾配置的 Claude Code/Codex 用户很省心。要中立看待它部分 provider 预设/赞助商是第三方 API 中转/代充(建议走官方合规渠道)、它是配置工具、强绑定 CC/Codex 生态。作为 Claude Code/Codex 的零配置设置助手,它实用、上手快。

来源:综合 README.md 的零配置定位、命令与第三方 provider 考量
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 14:31. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件