零配置，一键搞定 Claude Code 环境设置

ZCF（Zero-Config Claude-Code Flow）是一款提供零配置、一键搭建 Claude Code 环境的工具，支持中英文双语、智能代理（CCR）系统和个性化 AI 助手。它通过交互式菜单或命令行执行安装、更新、配置等操作，极大简化 workflows 的设置流程。

ZHANZHAOZZZ

875人浏览 · 2025-08-15 22:14:23

ZHANZHAOZZZ · 2025-08-15 22:14:23 发布

零配置，一键搞定 Claude Code 环境设置 - 支持中英文双语配置、智能代理系统和个性化 AI 助手

1. 简介

ZCF（Zero-Config Claude-Code Flow） 是一款提供零配置、一键搭建 Claude Code 环境的工具，支持中英文双语、智能代理（CCR）系统和个性化 AI 助手。它通过交互式菜单或命令行执行安装、更新、配置等操作，极大简化 workflows 的设置流程。

2. 安装与配置

推荐方式：交互式菜单安装（v2.0+）

1.安装zcf工具克隆项目

git clone https://github.com/UfoMiao/zcf.git
cd zcf

# 1. 切换到项目目录

cd D:\workSpace\zcf

# 2. 确保安装了 pnpm（如果还没装）

npm install -g pnpm

# 3. 安装依赖

pnpm install

# 4. 构建项目（假设有 build 脚本）

pnpm run build

# 5. 尝试运行 CLI 工具

npx zcf

运行：

npx zcf

即可启动图形化菜单界面，选择操作项执行安装与配置。

菜单选项包括：

1 全量初始化（等价于 zcf i）：安装 Claude Code、导入 workflows、配置 API 或 CCR、设置 MCP 服务。
2 导入 workflows（等价于 zcf u）：仅更新 workflows 文件。
3–7 配置项：单独配置 API、MCP、模型、AI 个性等。
R：CCR 管理（Claude Code Router 路由器），支持安装、UI 启动、服务控制等功能。
U：运行 ccusage 命令，查看 Claude Code 使用统计。
+：检查并更新 Claude Code 与 CCR 版本。

快速命令方式

目的	命令
初次安装／全量初始化	`npx zcf i` 或通过菜单选择“1”
更新 workflows	`npx zcf u`
CCR 管理界面	`npx zcf ccr` 或菜单“R”
检查更新	`npx zcf check-updates` 或菜单“+”

备注：zcf i 等同于 interactive menu (zcf 后选 1)；zcf u 相当于选择 2。

3. 安装流程详解（以全量初始化为例）

执行 npx zcf i 或通过菜单 1 操作，流程如下：

选择 Claude Code 的配置语言（中文 zh-CN 或英文 en）。
选择 AI 输出语言（支持中文、英文、自定义，涵盖日语、法语、德语等）。
选择 AI 个性（专业助手、猫娘助手、友好助手、导师模式、自定义）。
安装 Claude Code／确认是否安装。
配置身份认证方式：

- 使用 Auth Token（OAuth）
- 使用 API Key（Anthropic 提供）
- 使用 CCR 代理（可接入免费模型）
- 跳过（稍后手动配置）

检测是否已有配置，选择操作：备份覆盖、仅更新 workflow 文件、合并配置、跳过。
安装 workflows 文件，包括：

- workflow.md、feat.md
- 计划器 agent（planner、ui-ux-designer）
- Git 命令支持（commit、rollback、cleanBranches、worktree）
- bmad-init.md（启动 BMad 工作流程）。

配置 MCP 服务选择（如 Context7 文档查询、DeepWiki、Playwright 浏览器控制、Exa AI 搜索等）。
安装完成后生成对应配置文件（如备份到 ~/.claude/backup/xxx，主配置存储于 ~/.claude/）。

4. 基础 Usage 指令

安装完成后，可使用以下指令与功能：

/init：首次使用建议运行，生成 CLAUDE.md，帮助 AI 理解项目结构。
<任务描述>：直接输入任务描述即可执行任务（适合小型任务，如修 bug，规范参考 SOLID、KISS、DRY、YAGNI）。
/feat <任务描述>：执行一个完整 feature 的规划和 UI 两阶段流程。
/workflow <任务描述>：整个工作流程方式执行，从多方案生成、用户反馈到最终控制，适合复杂任务。

生成的文档默认放在项目根目录 .claude/xxx.md，建议将 .claude/ 添加到 .gitignore。

5. 核心功能与亮点

多语言支持：界面语言、配置语言、AI 输出语言、AI 个性均可配置。
智能安装：自动识别是否已安装 Claude Code；支持跨平台（Windows／macOS／Linux／Termux）；MCP 服务自动配置；支持 smart merge 和确认机制。
完整配置管理：包含 CLAUDE.md 系统说明、settings.json、commands、agents 配置，支持智能备份与合并、cache 清理等。
API 配置灵活：支持 Auth Token、API Key、CCR 代理、可定制 API URL，允许后期修改和细项更新。
配置安全机制：备份配置至 ~/.claude/backup/，支持深度合并、自动备份、覆盖控制，新增默认模型及 AI 记忆配置等功能。

6. 进阶命令选项参考

命令	作用
`npx zcf --config-lang zh-CN` 或 `-c zh-CN`	设置配置语言为中文
`npx zcf --force` 或 `-f`	强制重新初始化
`npx zcf u --config-lang en` 或 `-c en`	更新 workflows 并使用英文配置
`npx zcf --help` 或 `-h`	查看帮助信息
`npx zcf --version` 或 `-v`	查看版本号
`npx zcf ccu`	运行 ccusage（Claude Code 使用统计工具）

7. 项目结构一览

zcf/
├── README.md
├── package.json
├── bin/
│   └── zcf.mjs
├── src/
│   ├── cli.ts
│   ├── commands/
│   ├── utils/
│   └── constants.ts
└── templates/

CLI 的逻辑、命令实现在 src/cli.ts 和 commands/ 目录中。项目模板存储于 templates/ 目录。