开发工具CLIAI 应用【免费下载链接】zcfZero-Config Code Flow for Claude code Codex项目地址https://gitcode.com/gh_mirrors/zc/zcf点击查看免费下载本篇技术指南围绕仓库内计划文档 ccc-init.md 所规划的Claude Code Config (CCC) 自动化配置工具展开剖析其如何落地为 ZCFZero-Config Code Flow的init命令npx zcf init/zcf i。读完本文你将掌握一键配置 Claude Code 的完整交互流程双语言选择、安装检测、配置文件复制与合并、智能 API 配置、冲突备份处理以及面向 CI/CD 的全参数非交互模式。计划溯源ccc-init 与 ZCF 的演化关系ccc-init.md 是一份工具实现计划文档其核心诉求是将项目重构为 npm 包支持通过一条命令一键配置 Claude Code。计划中的命令名是npx cccCCC Claude Code Config而在当前仓库中这一目标以更完整的形式落地为zcf包的init命令。从 package.json 可以看到最终成果包名zcf描述为Zero-Config Code Flow - One-click configuration tool for Code Clibin字段将可执行命令注册为zcfbin/zcf.mjs 由 package.json 的 bin 字段指向CLI 框架选用caccatalog:cli依赖组与计划文档中的技术选型一致构建工具采用unbuild TypeScriptbuild: unbuild同样与计划一致。计划文档定义的五大核心功能均在 src/commands/init.ts 中得到完整实现交互式双语言选择脚本语言 配置语言自动检测并安装 Claude Code复制完整配置文件到用户目录智能 API 配置官方登录 / 自定义 / CCR 代理 / 跳过配置文件冲突处理备份 / 合并 / 跳过 / 仅文档。CLI 的注册入口位于 src/cli.ts 与 src/cli-setup.tscli cac(zcf)创建实例setupCommands(cli)注册全部子命令其中init命令注册了别名icli.command(init, ...).alias(i)见 cli-setup.ts。交互式双语言选择脚本语言与配置语言分离计划文档要求交互式双语言选择脚本语言 配置语言即ZCF 的交互界面语言脚本语言与写入用户目录的配置模板语言配置语言是两个独立的维度。脚本语言ZCF 界面语言首次运行时ZCF 需要确定自身界面使用哪种语言。逻辑位于 prompts.ts 的 selectScriptLanguage若已存在~/.ufomiao/zcf/config.toml中的preferredLang配置直接复用若命令行传入了--lang参数直接采用否则通过 inquirer 弹出选择列表选项来自 constants.ts 中的 SUPPORTED_LANGS[zh-CN, en]选择结果通过updateZcfConfig({ version, preferredLang })持久化到 ZCF 自身的 TOML 配置。由于 i18n 在此阶段尚未初始化该提示使用硬编码的双语文案Select ZCF display language / 选择ZCF显示语言见源码注释说明。配置语言模板语言配置语言决定复制到~/.claude/目录下的 CLAUDE.md、工作流、Agent 模板使用中文还是英文。选择逻辑在 resolveTemplateLanguage解析优先级为命令行参数--config-lang或-cZCF 配置中保存的templateLang历史兼容的preferredLang交互式弹窗询问selectTemplateLanguage。对应语言模板真实存在于仓库 templates/claude-code/zh-CN 与 templates/claude-code/en 两个目录下各自包含 workflow/common/agents、workflow/plan/agents 等完整模板树。统一语言参数 --all-langinit命令还提供了--all-lang, -g lang统一语言参数在 validateSkipPromptOptions 中处理当值为zh-CN或en时同时设置configLang与aiOutputLang传入其他值时配置语言固定为enAI 输出语言使用传入值。自动检测并安装 Claude Code计划文档要求自动检测并安装 Claude Code。该能力由 src/utils/installer.ts 实现入口在 init 流程的 Step 4init.ts。检测逻辑安装检测基于命令存在性判断export async function isClaudeCodeInstalled(): Promiseboolean { return await commandExists(claude) }见 installer.ts。随后通过getInstallationStatus()区分全局安装与本地安装当两者同时存在例如全局 npm 安装 项目本地 node_modules 安装并存时交互模式会调用handleMultipleInstallations让用户决定保留哪个非交互模式--skip-prompt则自动优先全局安装、移除本地副本见 installation-manager.ts 与 init.ts 中对应分支init.ts。安装方式未检测到安装时交互模式会弹出确认并让用户选择安装方式npm 全局安装、Homebrew、其他系统包管理器的推荐方式由平台探测给出--skip-prompt模式则直接执行npm install -g anthropic-ai/claude-code --forceinstaller.ts。安装命令通过wrapCommandWithSudo包装需要时自动追加 sudo 并给出提示安装完成后调用verifyInstallation校验并处理 cask 安装缺失 symlink 的场景。环境适配installer 内部对运行环境做了针对性探测platform.tsTermuxAndroid 终端输出${prefix}/bin/node、${prefix}/bin/npm路径信息与安装提示WSL输出发行版信息与~/.claude/路径提示Windows在后续 MCP 配置阶段输出 Windows 环境提示并调用fixWindowsMcpConfig修正 Windows 下的 MCP 命令格式init.ts 与 claude-config.ts。已安装时还会调用 checkClaudeCodeVersionAndPrompt 提示是否有可用更新仅在已有安装时触发刚安装完则跳过。复制配置文件到用户目录智能合并而非粗暴覆盖计划文档的第三项核心功能是复制完整配置文件到用户目录。实现的真实路径为~/.claude/由 constants.ts 中的 CLAUDE_DIR 定义join(homedir(), .claude)配置文件为~/.claude/settings.jsonSETTINGS_FILE。copyConfigFilesconfig.ts在复制 settings.json 时不是简单覆盖而是调用mergeSettingsFileconfig.ts做智能合并合并规则明确写于源码目标文件不存在 → 直接写入模板目标存在 → 读取模板与现有配置做deepMergeenv 变量特殊处理{ ...templateSettings.env, ...existingSettings.env }即用户已有的环境变量API Key 等永远优先保留permissions.allow数组通过 mergeAndCleanPermissions 去重并清理无效条目。同时init 流程还会在复制前执行ensureClaudeDir()config.ts保证目标目录存在。复制完成后工作流模板如 sixStepsWorkflow、featPlanUx、gitWorkflow、bmadWorkflow由 workflow-installer.ts 的selectAndInstallWorkflows按用户选择写入。智能 API 配置四种模式 增量管理计划文档的第四项功能智能 API 配置免费/自定义在演进后扩展为更丰富的模式。交互模式下init 会弹出 API 配置模式选择init.ts 的 selectApiConfigurationMode模式行为关键实现official官方登录清除全部第三方 API 配置回退到官方账号登录switchToOfficialLogin删除 settings.json 中的ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKEN/ANTHROPIC_API_KEY并同步清除~/.claude/config.json中的primaryApiKeycustom自定义无已有配置时让用户选择Auth Token或API Key并填写 URL/Key/模型configureApiCompletely已有配置时提供部分修改 / 全部重配 / 保留现有三选一ccrCCR 代理安装并配置 Claude Code Router 代理把模型路由交给 CCRinstaller.ts 与 config.ts并通过ClaudeCodeConfigManager.switchToCcr()同步状态skip跳过不配置 API—自定义配置的落盘核心是 configureApiapi_key类型写入env.ANTHROPIC_API_KEY并删除ANTHROPIC_AUTH_TOKENauth_token类型写入env.ANTHROPIC_AUTH_TOKEN并删除ANTHROPIC_API_KEY提供 URL 时写入env.ANTHROPIC_BASE_URL完成后调用setPrimaryApiKey()Claude Code 2.0 的第三方 API 要求并写入hasCompletedOnboarding标记。对于 Claude Code 目标自定义配置走 claude-code-incremental-manager.ts 的增量配置管理configureIncrementalManagement避免破坏用户已有配置init.ts。此外--provider预设参数支持302ai、glm、minimax、kimi、custom等供应商预设见 config/api-providers.ts一键带入 baseUrl、authType 与默认模型族primary / Haiku / Sonnet / Opus模型参数对应--api-model、--api-haiku-model、--api-sonnet-model、--api-opus-model。AI 输出语言指令API 配置之外init 还会把AI 输出语言写为 CLAUDE.md 顶部的语言指令。applyAiLanguageDirectiveconfig.ts根据 constants.ts 的 AI_OUTPUT_LANGUAGES 映射生成指令例如zh-CN→Always respond in Chinese-simplifieden→Always respond in English自定义语言字符串 →Always respond in 语言名配置文件冲突处理备份 / 合并 / 跳过计划文档的第五项功能配置文件冲突处理备份/合并/跳过是防止破坏用户现有配置的关键设计。当检测到~/.claude/settings.json已存在且未传--force时init 弹出现有配置处理选择init.ts选项行为backup默认备份后全新写入docs-only仅更新文档类文件CLAUDE.md 等不动 agents/commandsmerge合并模式保留用户配置skip跳过直接退出backupExistingConfigconfig.ts的执行细节const timestamp dayjs().format(YYYY-MM-DD_HH-mm-ss) const backupDir join(CLAUDE_DIR, backup, backup_${timestamp})即备份目录为~/.claude/backup/backup_时间戳/使用 dayjs 生成精确到秒的时间戳且复制时通过 filter 排除 backup 目录自身避免递归嵌套备份。备份成功后控制台会输出✔ 已备份至: backupDir。非交互模式下--config-action参数接管该决策取值范围为new | backup | merge | docs-only | skip默认backup在 validateSkipPromptOptions 中设置默认值。非交互模式面向 CI/CD 的完整参数体系原计划的交互式工具在实际演进中增加了强大的--skip-prompt非交互模式让npx zcf init可以嵌入脚本与 CI/CD 流水线。完整参数表如下注册于 cli-setup.ts参数简写说明默认值--lang-lZCF 界面语言配置文件preferredLang--config-lang-c配置模板语言同上或交互询问--ai-output-lang-aAI 输出语言同上或交互询问--all-lang-g统一设置语言参数—--force-f覆盖已有配置false--skip-prompt-s跳过全部交互false--config-action-r配置处理new/backup/merge/docs-only/skipbackup--api-type-tAPI 类型auth_token/api_key/ccr_proxy/skip—--api-key-kAPI Key两种认证类型共用—--api-url-u自定义 API URLhttps://api.anthropic.com--api-model-M主模型如 claude-sonnet-4-5—--api-haiku-model-HHaiku 模型—--api-sonnet-model-SSonnet 模型—--api-opus-model-OOpus 模型—--provider-p供应商预设302ai/glm/minimax/kimi/custom—--mcp-services-mMCP 服务列表或 skip/all全部免 Key 服务--workflows-w工作流列表或 skip/all全部工作流--output-styles-o输出风格列表或 skip/all全部自定义风格--default-output-style-d默认输出风格engineer-professional--code-type-T目标工具claude-code/codexcc/cx 缩写claude-code--install-cometix-line-x是否安装状态栏工具true--api-configs—多 API 配置 JSON 字符串—--api-configs-file—多 API 配置 JSON 文件路径—非交互模式下所有参数会先经过 validateSkipPromptOptions 的严格校验provider 合法性、configAction 枚举、apiType 枚举、模型参数类型、MCP 服务 ID、工作流 ID、输出风格合法性以及apiConfigs与apiConfigsFile互斥约束等任一不合法即抛出带 i18n 错误文案的异常。典型用法示例取自 cli-setup.ts 的 help 示例# 交互式完整初始化 npx zcf init # 一键完成 API Key 配置含自定义 URL 与模型 npx zcf i --skip-prompt --api-type api_key --api-key sk-ant-... --api-url https://... # 中文配置 API Key npx zcf i --skip-prompt --all-lang zh-CN --api-type api_key --api-key key # CCR 代理配置 npx zcf i --skip-prompt --api-type ccr_proxy多配置与 Codex 支持超越原计划的扩展init 在演进中还支持了多 API 配置与Codex目标工具--code-type codex/cx这两点已超出原计划的单工具单配置范畴。多配置注入通过--api-configs JSON或--api-configs-file path可一次性注入多个 API 配置handleMultiConfigurations。每项配置经 validateApiConfigs 校验后Claude Code 目标 → 通过 ClaudeCodeConfigManager.addProfile 写入多配置文件可指定default标记切换默认 ProfileCodex 目标 → 通过 codex-provider-manager.ts 的addProviderToExisting添加 provider支持default标记自动切换。Codex 完整初始化--code-type codex时init 转而调用 runCodexFullInit并针对 Codex 做语言选择的去重优化避免重复弹出语言询问init.ts最终把选定语言与工具类型持久化到 ZCF 配置。后续流程扩展初始化收尾阶段还包括MCP 服务选择与合并写入mcp-selector.ts claude-config.ts 的 mergeMcpServers、输出风格安装output-style.ts风格模板位于 templates/common/output-styles、CCometixLine 状态栏工具安装cometix/installer.ts以及把version / preferredLang / templateLang / aiOutputLang / codeToolType持久化到~/.ufomiao/zcf/config.tomlinit.ts 的 Step 12。技术架构与源码结构原计划的架构选型与最终实现的对照关系如下计划选型最终实现证据CLI 框架 caccacpackage.jsoncac依赖 src/cli.ts交互组件 posva/promptsinquirer inquirer-togglepackage.json 依赖init.ts 中的 inquirer.prompt 调用构建 unbuild TypeScriptunbuild TypeScriptpackage.jsonbuild: unbuild、typecheck: tsc --noEmit平台兼容 Windows/macOS/Linux兼容 Termux/WSL 特化src/utils/platform.ts源码模块与计划的目录映射为计划中的bin/ccc.mjs↔ bin/zcf.mjspackage.json bin 指向src/cli.ts↔ src/cli.tssrc/commands/init.ts↔ src/commands/init.tssrc/utils/↔ src/utils安装、配置、MCP、CCR、Codex 等子模块templates/zh-CN与templates/en↔ templates/claude-code/zh-CN 与 templates/claude-code/en。国际化方面界面文案基于 i18next i18next-fs-backend语言资源位于 src/i18n/locales/en 与 src/i18n/locales/zh-CN每个功能域一个 JSON 命名空间api、configuration、installation、mcp、errors 等由 src/i18n/index.ts 统一初始化。测试验证与质量保障计划的待完成任务安装依赖并测试、修复类型错误、编写文档在仓库中均有对应落地其中测试由 Vitest 承载vitest.config.tsinit.test.ts 覆盖 init 的完整行为树语言选择、Claude Code 安装检测未安装/已安装触发版本检查/无安装跳过版本检查、已有配置处理、完整初始化流程、错误处理、Codex 专属初始化banner、语言去重、aiOutputLang 回退链、Claude Code 专属初始化等init.edge.test.ts 补充边界场景cli.test.ts 与 cli-main.test.ts 验证命令装配与入口init-multi-config.test.ts、init-api-provider.test.ts、init-model-config.test.ts 分别验证多配置注入、供应商预设与模型参数。从这些测试结构可以看出init 被设计为可通过InitOptions对象直接调用的纯逻辑函数init(options)交互行为集中在 inquirer 层从而保证了可测试性与可嵌入性。设计原则的落地印证计划文档声明的四条设计原则在源码中均有对应KISS默认命令直接展示交互菜单npx zcfinit只暴露一个入口参数帮助信息完整内建于zcf --helpcustomizeHelpYAGNI配置动作收敛为 backup/docs-only/merge/skip 四个明确语义未堆砌多余选项SOLID安装installer.ts、配置config.ts、平台探测platform.ts、错误处理error-handler.ts、国际化src/i18n各自独立成模块单一职责清晰DRY已有配置的备份、MCP 合并、settings 智能合并等逻辑被抽为可复用函数供 init、update、config-switch 等命令共享如 claude-code-config-manager.ts。使用建议与局限说明交互式初始化适用于个人开发者首次配置--skip-prompt全参数模式适用于团队脚本化配置与 CI/CD 环境备份目录~/.claude/backup/backup_时间戳/是回滚手段误操作后可从此恢复settings.json的 env 合并策略保证用户已有 API Key 不会被覆盖但若确实需要强制全新配置需显式使用--force或在交互中选择backup后的全新写入分支多配置、CCR 代理与 Codex 支持属于计划之上的扩展能力按--code-type与--provider参数逐步引入使用时请先通过npx zcf --help查看当前版本实际支持范围。赞分享开发工具CLIAI 应用【免费下载链接】zcfZero-Config Code Flow for Claude code Codex项目地址https://gitcode.com/gh_mirrors/zc/zcf点击查看免费下载相关推荐ZCF 交互菜单系统详解npx zcf 一键配置 Claude Code 与 CodexZCF 交互菜单系统详解npx zcf 一键配置 Claude Code 与 Codex 本文基于仓库文档 主菜单日文版 https://link.git开发工具CLIAI 应用离线翻译 5 分钟跑通Argos Translate 新手完全教程离线翻译 5 分钟跑通Argos Translate 新手完全教程 Argos Translate 是一个用 Python 编写的开源免费离线翻译库翻译全部开发工具CLIAI 应用ZCF入门指南如何使用npx zcf一键配置AI开发环境ZCF入门指南如何使用npx zcf一键配置AI开发环境 ZCFZero Config Code Flow是专为Claude Code和Codex设计的零开发工具CLIAI 应用上一篇在 Bifrost 中编写只实现 LLMPlugin 接口的插件llm-only 示例深度解析下一篇终极tmate安装指南5分钟学会终端即时共享创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考