ZCF - 零配置代码流程
为 Claude Code 与 Codex 提供零配置、一键式设置，支持双语、智能代理系统和个性化 AI 助手的工具。
- 源仓库
- UfoMiao/zcf
- Star 数
- ★ 6.1k
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 51/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 开发者在首次使用 Claude Code 时，希望快速设置环境，避免手动配置每次的 API 密钥和工作流。
- 不适合
- 只使用 Claude Code 和 Codex 之外工具的开发者
- 不愿让初始化脚本修改项目文件的团队
- 源码审查
- 51/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
ZCF (Zero-Config Code Flow) 是一个用于 Claude Code 和 Codex 的 CLI 工具，旨在通过自动化初始化、工作流配置、API/CCR 集成和 MCP 设置来简化 AI 编码环境的搭建。它主要通过 npx zcf 命令运行，提供交互式菜单和预设配置，支持中文、英文和日文界面。该项目借鉴了 CCR、BMad Method 等社区成果，并集成了多个 API 中继服务作为赞助商。ZCF 适用于开发者快速配置和优化其 AI 编码工作流，减少手动配置时间。
ZCF 通过命令行提供不同的操作：npx zcf i 执行完整初始化，包括安装、工作流、API/CCR 和 MCP（模型上下文协议）设置；npx zcf u 仅更新工作流；npx zcf --lang zh-CN 切换语言。它还支持非交互式模式，如 npx zcf i -s -p 302ai -k sk-xxx，用于指定服务提供商和 API 密钥。工具会读取当前项目并生成或修改配置文件，以集成 Claude Code 和 Codex。ZCF 可能调用外部 API 服务，并支持多个赞助商提供的 API 中继。
- 开发者在首次使用 Claude Code 时，希望快速设置环境，避免手动配置每次的 API 密钥和工作流。
- 团队需要统一不同成员的 Claude Code 配置，确保工作流一致。
- 用户想要切换不同的 API 提供商（如 302.ai、AICodeMirror）以优化成本或速度。
- 使用 Codex 的用户希望简化初始化过程，并自动配置相关的 MCP 服务器。
- 需要多语言界面的开发者，如中文或日文用户，希望使用母语操作。
- 希望通过非交互式脚本自动部署 AI 编码环境的 CI/CD 场景。
如何安装或部署这个 Agent？
可以通过 npm 安装或直接使用 npx 运行。推荐使用 npx zcf 启动交互式菜单，无需全局安装。也可以全局安装：npm install -g zcf。
如何使用这个 Agent？
运行 npx zcf 打开交互式菜单，选择所需功能。常用命令：npx zcf i 进行完整初始化，npx zcf u 仅更新工作流。若要指定语言，使用 npx zcf --lang zh-CN。非交互式示例：npx zcf i -s -p 302ai -k "sk-xxx"。需要 Node.js 环境和网络连接。
这个 Agent 有哪些优点和局限？
- 零配置一键初始化，极大减少手动设置时间。
- 支持多种 API 提供商，可通过预设或自定义集成。
- 提供完整文档和交互式 CLI，易于初学者使用。
- 多语言支持（中、英、日），适合国际开发者。
- 集成了社区最佳实践（如 CCR、BMad Method），增强工作流。
- 主要针对 Claude Code 和 Codex，对其他工具支持有限。
- 依赖外部 API 提供商，部分功能可能需要付费服务。
- 初始化过程可能修改项目文件，需要谨慎操作。
- 项目文档和社区支持主要基于 GitHub 和 Telegram。
这个 Agent 与同类方案有什么区别？
与直接在 Claude Code 中手动配置不同，ZCF 提供了自动化流程。它与 CCR (Claude Code Router) 类似，但更注重零配置和一体化设置。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| ZCF - 零配置代码流程 当前 | 51 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 6.1k | 1 个月前 | TypeScript | Codex · Claude Code |
| OSpec | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 396 | 1 个月前 | JavaScript | Codex · Claude Code |
| Puppetmaster | 68 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 468 | 今天 | Python | Codex · Claude Code |
| Maestro-Flow | 52 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 566 | 3 天前 | TypeScript | Codex · Claude Code · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：CLI工具通过交互式菜单和命令行参数执行操作，需要用户输入API密钥（如`-k`参数），但未明确说明权限最小化原则。用户确认机制存在（交互式菜单），但非交互模式下可能自动执行。数据流透明度不足，未详细说明数据如何被处理或传输。敏感数据处理方面，API密钥作为参数传递，但未说明存储或保护措施。依赖安全方面，使用pnpm catalog管理依赖，但未提供依赖审计或漏洞扫描证据。外部影响方面，工具会修改用户配置文件（如安装工作流），但未明确提示或征得同意。回滚方面，未提供明确的回滚机制。来源归属方面，README中致谢了多个开源项目，但未提供详细的代码来源追溯。扣分原因：权限最小化、用户确认、数据流透明度、敏感数据处理、依赖安全、外部影响、回滚均缺乏详细证据或实现说明。
证据显示：代码结构清晰，测试覆盖了边界条件和错误处理，但测试多为模拟，未验证真实环境行为。依赖可用性方面，使用`npx`调用外部工具（如ccusage），依赖网络和外部服务可用性。失败消息方面，错误处理函数（如handleGeneralError）提供了错误输出，但具体消息内容未在提供的文件中展示。扣分原因：依赖外部服务，未提供离线或降级方案；失败消息的具体内容未验证。
证据显示：README提供了多种使用场景（如`npx zcf i`、`npx zcf u`），支持多语言（中英日），并提供了非交互式示例。能力边界方面，未明确说明工具支持或限制的功能范围。触发精度方面，命令参数（如`-s`、`-p`）有文档说明，但未详细说明所有选项。环境适配方面，支持多平台（CI测试覆盖Windows、macOS、Linux），但未说明特定环境要求。扣分原因：能力边界和触发精度描述不完整。
证据显示：README提供了快速开始、完整文档链接、赞助商列表、社区链接等，信息架构清晰。安装说明简单（`npx zcf`），但未提供详细的安装步骤或系统要求。命名稳定性方面，项目名称和命令稳定，但版本号未在README中明确。示例和FAQ方面，提供了基本命令示例，但缺少FAQ。已知限制方面，未明确列出。许可证为MIT，版本管理和变更日志存在（CHANGELOG.md），维护责任明确（作者和贡献者）。扣分原因：已知限制未说明，安装说明不够详细。
证据显示：工具提供了一键配置功能，简化了Claude Code和Codex的设置流程，输出为配置文件和工作流，具有实用性。边际价值方面，相比手动配置，节省时间，但依赖外部服务。成本效益方面，免费开源，但可能产生API调用费用。扣分原因：未提供实际使用效果的数据或用户反馈。
证据显示：README中的声明（如功能、赞助）有链接支持，但未提供详细的实现文档。跨来源验证方面，测试和CI配置提供了部分验证，但未独立验证。事实与推断分离方面，README中区分了事实（如命令）和推断（如“智能”），但不够明确。扣分原因：声明缺乏详细证据，跨来源验证不足。
- API密钥通过命令行参数传递，可能被shell历史记录或进程列表泄露，建议使用环境变量或配置文件。
- 工具会修改用户配置文件，建议在非交互模式下明确提示并征得用户同意。
- 依赖外部服务（如npx ccusage），网络不可用时可能失败，建议提供离线或降级方案。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Patch Changes - ## New Features - Introduce built-in code-tool adapter/registry and migrate Claude Code / Codex command handlers to adapter dispatch - Add MiniMax China (minimax-cn) API provider preset 新功能 - 引入内置 code-tool adapter/registry 架构，将 Claude Code / Codex 命令处理迁移为 adapter 分发 - 新增 MiniMax 国内版（minimax-cn）API 提供商预设 Optimization - Derive Claude/Codex paths, leftover cleanup, and provider contracts from adapter definitions - Align Claude/Codex CLI with main for skip/output-style, illegal -T fallback, menu update, and provider import feedback 优化 …在 GitHub 查看 ↗ -
发布说明摘录
Patch Changes - ## Fixes - Skip special filesystem entries (e.g. sockets) during recursive directory copy to avoid copy failures 修复 - 递归复制目录时跳过特殊文件系统条目（如 socket），避免复制失败 Documentation - Update Claude API sponsor links to console.apito.ai - Update AICodeMirror sponsor links to aicodemirror.ai 文档 - 将 Claude API 赞助商链接更新为 console.apito.ai - 将 AICodeMirror 赞助商链接更新为 aicodemirror.ai在 GitHub 查看 ↗ -
发布说明摘录
Patch Changes - ## Fixes - Correct MiniMax API provider preset base URL and default models - Prevent Codex init from overwriting Claude Code CLAUDE.md during workflow import - Route Codex language directives to AGENTS.md only and preserve existing AGENTS.md when user declines changes - Hoist configAction skip to runCodexFullInit so API/MCP steps are skipped with workflow import 修复 - 修正 MiniMax API 提供商预设的 base URL 与默认模型 - 修复 Codex 初始化时工作流导入误覆盖 Claude Code CLAUDE.md 的问题 - Codex 语言指令仅写入 AGENTS.md，用户拒绝系统提示变更时保留现有 AGENTS.md …在 GitHub 查看 ↗