zcf — Zero-Config Setup for Claude Code & Codex

简介

Claude Code/Codex 的零配置初始化器：一条 npx zcf i 即可完成工作流、路由与可选 MCP 组件的安装配置，并支持双语界面、常用预设与一键更新，让环境从 0 到可用更快、更稳。

• 适合谁： 想把 Claude Code/Codex 本地环境搭建做成可复用的一键流程的开发者
• 可搭配： Node.js、Claude Code/Codex 工具链；按选择可包含路由与 MCP 组件
• 准备时间： 10–25 分钟

实战建议

• 量化建议：固定 3 条命令（npx zcf/i/u），在全新机器上测量从 0 到首次跑通的耗时。
• 量化建议：统计初始化改动的配置文件数量；可控的“变更面”通常意味着更少的后续故障。

“零配置”落地应该是什么样

把它当作可重复执行的安装器：

• 可反复运行（更新不应覆盖你的定制）。
• 只生成少量、命名清晰的文件。
• 失败要“可见且可修复”（日志清楚 + 下一步明确）。

团队化采用方式

1. 先在 sandbox 仓库试跑。
2. 只提交你确实希望团队共享的最小配置/工作流产物。
3. 写明回滚步骤：删哪些文件可以回到干净状态。

不适用场景

如果组织已有统一 bootstrap 工具，建议保持单一事实来源；把 zcf 作为可选模块集成，而不是并行两套安装器。

FAQ

必须用 npx 吗？ 答：README 推荐 npx 作为最简单路径；确保 Node.js 在 PATH 中即可。

怎么保留自定义配置？ 答：只提交共享产物，并明确哪些文件由 zcf 管、哪些由仓库自己维护。

优先测试什么？ 答：全新环境从 0 安装 + 一键更新路径是否稳定可用。