这个好!ZCF 零配置 Claude-Code 流程

2025-08-12 分类：AI人工智能作者：Linux网站管理员阅读（767）

这个好！ ZCF - 零配置 Claude-Code 流程
一键搞定 Claude Code 环境设置 - 支持中英文双语配置、智能代理系统和个性化 AI 助手。
地址: https://github.com/UfoMiao/zcf

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

screenshot

🚀 快速开始

🎯 推荐：使用交互式菜单（v2.0 新增）

npx zcf          # 打开交互式菜单，根据你的需求选择操作

菜单选项包括：

1 完整初始化（等同于 zcf i）
2 导入工作流（等同于 zcf u）
3-7 配置管理（API/CCR、MCP、模型设置、AI 个性等）
R Claude Code Router 管理（v2.8.1 增强）
U ccusage - Claude Code 用量分析
更多功能选项...

或者，直接使用命令：

🆕 首次使用 Claude Code

npx zcf i        # 直接执行完整初始化：安装 Claude Code + 导入工作流 + 配置 API 或 CCR 代理 + 设置 MCP 服务
# 或
npx zcf → 选择 1  # 通过菜单执行完整初始化

🔄 已有 Claude Code 环境

npx zcf u        # 仅更新工作流：快速添加 AI 工作流和命令系统
# 或
npx zcf → 选择 2  # 通过菜单执行工作流更新

提示：

v2.0 起，zcf 默认打开交互式菜单，提供可视化操作界面

你可以通过菜单选择操作，也可以直接使用命令快捷执行

zcf i = 完整初始化，zcf u = 仅更新工作流

🎯 BMad 工作流（v2.7 新功能）

BMad（BMad-Method: Universal AI Agent Framework）是企业级的工作流系统，提供：

完整的专业 AI 代理团队（PO、PM、架构师、开发、QA 等）
结构化的开发流程与质量关卡
自动化文档生成
支持全新项目（greenfield）和现有项目（brownfield）

安装后，使用 /bmad-init 在项目中初始化 BMad 工作流。

🚀 CCR (Claude Code Router) 支持（v2.8+ 增强版）

CCR 是一个强大的代理路由器，可以实现：

免费模型接入：通过 Claude Code 界面使用免费 AI 模型（如 Gemini、DeepSeek）
自定义路由：根据规则将不同类型的请求路由到不同的模型
成本优化：通过为不同任务使用合适的模型，显著降低 API 成本
便捷管理：提供交互式菜单进行 CCR 配置和服务控制
自动更新：CCR 和 Claude Code 的自动版本检查和更新（v2.8.1+）

访问 CCR 功能：

npx zcf ccr      # 打开 CCR 管理菜单
# 或
npx zcf → 选择 R

检查更新（v2.8.1+）：

npx zcf check-updates  # 检查并更新 Claude Code 和 CCR 到最新版本

CCR 菜单选项：

初始化 CCR - 安装并配置 CCR，支持预设提供商
启动 UI - 启动 CCR Web 界面进行高级配置
服务控制 - 启动/停止/重启 CCR 服务
检查状态 - 查看当前 CCR 服务状态

CCR 设置完成后，ZCF 会自动配置 Claude Code 使用 CCR 作为 API 代理。

初始化流程

完整初始化（npx zcf）会自动：

✅ 检测并安装 Claude Code
✅ 选择 AI 输出语言（新增）
✅ 配置 API 密钥或 CCR 代理
✅ 选择并配置 MCP 服务
✅ 设置所有必要的配置文件

使用方式

配置完成后：

项目第一次使用强烈建议先运行 /init 进行初始化，生成 CLAUDE.md 便于 AI 理解项目架构
<任务描述> - 不使用任何工作流直接执行，会遵循 SOLID、KISS、DRY 和 YAGNI 原则，适合修复 Bug 等小任务
/feat <任务描述> - 开始新功能开发，分为 plan 和 ui 两个阶段
/workflow <任务描述> - 执行完整开发工作流，不是自动化，开始会给出多套方案，每一步会询问用户意见，可随时修改方案，掌控力 MAX

PS:

feat 和 workflow 这两套各有优势，可以都试试比较一下

生成的文档位置默认都是项目根目录下的 .claude/xxx.md，可以把 .claude/ 加入项目的 .gitignore 里

✨ ZCF 工具特性

🌏 多语言支持

脚本交互语言：控制安装过程的提示语言
配置文件语言：决定安装哪套配置文件（zh-CN/en）
AI 输出语言：选择 AI 回复使用的语言（支持简体中文、English 及自定义语言）
AI 个性化：支持多种预设人格（专业助手、猫娘助手、友好助手、导师模式）或自定义

🔧 智能安装

自动检测 Claude Code 安装状态
使用 npm 进行自动安装（确保兼容性）
跨平台支持（Windows/macOS/Linux/Termux）
自动配置 MCP 服务
智能配置合并和部分修改支持（v2.0 新增）
增强的命令检测机制（v2.1 新增）
危险操作确认机制（v2.3 新增）

📦 完整配置

CLAUDE.md 系统指令
settings.json 设置文件
commands 自定义命令
agents AI 代理配置

🔐 API 配置

支持两种认证方式：
- Auth Token：适用于通过 OAuth 或浏览器登录获取的令牌
- API Key：适用于从 Anthropic Console 获取的 API 密钥
自定义 API URL 支持
支持稍后在 claude 命令中配置
部分修改功能：仅更新需要的配置项（v2.0 新增）

💾 配置管理

智能备份现有配置（所有备份保存在 ~/.claude/backup/）
配置合并选项（v2.0 增强：支持深度合并）
安全的覆盖机制
MCP 配置修改前自动备份
默认模型配置（v2.0 新增）
AI 记忆管理（v2.0 新增）
ZCF 缓存清理（v2.0 新增）

📖 使用说明

交互式菜单（v2.0）

$ npx zcf

 ZCF - Zero-Config Claude-Code Flow

? Select ZCF display language / 选择ZCF显示语言:
  ❯ 简体中文
    English

请选择功能:
  -------- Claude Code --------
  1. 完整初始化 - 安装 Claude Code + 导入工作流 + 配置 API 或 CCR 代理 + 配置 MCP 服务
  2. 导入工作流 - 仅导入/更新工作流相关文件
  3. 配置 API - 配置 API URL 和认证信息（支持 CCR 代理）
  4. 配置 MCP - 配置 MCP 服务（含 Windows 修复）
  5. 配置默认模型 - 设置默认模型（opus/sonnet）
  6. 配置 Claude 全局记忆 - 配置 AI 输出语言和角色风格
  7. 导入推荐环境变量和权限配置 - 导入隐私保护环境变量和系统权限配置

  --------- 其他工具 ----------
  R. CCR 管理 - Claude Code Router 管理
  U. CCUsage - Claude Code 用量分析工具

  ------------ ZCF ------------
  0. 更改显示语言 / Select display language - 更改 ZCF 界面语言
  -. 清除偏好缓存 - 清除偏好语言等缓存
  Q. 退出

请输入选项，回车确认（不区分大小写）: _

完整初始化流程（选择 1 或使用 zcf i）

? 选择 Claude Code 配置语言:
  ❯ 简体中文 (zh-CN) - 中文版（便于中文用户自定义）
    English (en) - 英文版（推荐，token 消耗更低）

? 选择 AI 输出语言:
  AI 将使用此语言回复你的问题
  ❯ 简体中文
    English
    Custom
    （支持日语、法语、德语等多种语言）

? 选择 AI 个性化设置:
  ❯ 专业助手(默认)
    猫娘助手
    友好助手
    导师模式
    自定义

? 检测到 Claude Code 未安装，是否自动安装？(Y/n)

✔ Claude Code 安装成功

? 选择 API 认证方式
  ❯ 使用 Auth Token (OAuth 认证)
    适用于通过 OAuth 或浏览器登录获取的令牌
    使用 API Key (密钥认证)
    适用于从 Anthropic Console 获取的 API 密钥
    配置 CCR 代理（Claude Code Router）
    使用免费模型和自定义路由，降低成本，探索Claude Code 的可能性
    跳过（稍后手动配置）

? 请输入 API URL: https://api.anthropic.com
? 请输入 Auth Token 或 API Key: xxx

? 检测到已有配置文件，如何处理？
  ❯ 备份并覆盖全部
    仅更新工作流相关md并备份旧配置
    合并配置
    跳过

✔ 已备份所有配置文件到 ~/.claude/backup/xxx
✔ 配置文件已复制到 ~/.claude

? 选择要安装的工作流（空格选择，回车确认）
  ❯ ◉ 六步工作流 (workflow) - 完整的六阶段开发流程
    ◉ 功能规划和 UX 设计 (feat + planner + ui-ux-designer) - 结构化新功能开发
    ◉ Git 指令 (commit + rollback + cleanBranches) - 简化的 Git 操作
    ◉ BMAD-Method 扩展安装器 - 企业级敏捷开发工作流

✔ 正在安装工作流...
  ✔ 已安装命令: zcf/workflow.md
  ✔ 已安装命令: zcf/feat.md
  ✔ 已安装代理: zcf/plan/planner.md
  ✔ 已安装代理: zcf/plan/ui-ux-designer.md
  ✔ 已安装命令: zcf/git/git-commit.md
  ✔ 已安装命令: zcf/git/git-rollback.md
  ✔ 已安装命令: zcf/git/git-cleanBranches.md
  ✔ 已安装命令: zcf/bmad-init.md
✔ 工作流安装成功

✔ API 配置完成

? 是否配置 MCP 服务？(Y/n)

? 选择要安装的 MCP 服务（空格选择，回车确认）
  ❯ ◯ 全部安装
    ◯ Context7 文档查询 - 查询最新的库文档和代码示例
    ◯ DeepWiki - 查询 GitHub 仓库文档和示例
    ◯ Playwright 浏览器控制 - 直接控制浏览器进行自动化操作
    ◯ Exa AI 搜索 - 使用 Exa AI 进行网页搜索

? 请输入 Exa API Key（可从 https://dashboard.exa.ai/api-keys 获取）

✔ MCP 服务已配置

🎉 配置完成！使用 'claude' 命令开始体验。

命令行参数

命令速查表

命令	缩写	说明
zcf	-	显示交互式菜单（v2.0 默认命令）
zcf init	zcf i	初始化 Claude Code 配置
zcf update	zcf u	更新 Prompt 文档并备份旧配置
zcf ccu	-	运行 Claude Code 用量分析工具 - ccusage
zcf ccr	-	打开 CCR (Claude Code Router) 管理菜单

常用选项

# 指定配置语言
npx zcf --config-lang zh-CN
npx zcf -c zh-CN            # 使用缩写

# 强制覆盖现有配置
npx zcf --force
npx zcf -f                 # 使用缩写

# 更新 Prompt 文档并备份旧配置（保留 API 和 MCP 配置）
npx zcf u                  # 使用 update 命令
npx zcf update             # 完整命令

# 查看帮助信息
npx zcf --help
npx zcf -h

# 查看版本
npx zcf --version
npx zcf -v

使用示例

# 显示交互式菜单（默认）
npx zcf

# 首次安装，完整初始化
npx zcf i
npx zcf init              # 完整命令

# 更新 Prompt 文档并备份旧配置，保留 API 和 MCP 配置
npx zcf u
npx zcf update            # 完整命令

# 强制使用中文配置重新初始化
npx zcf i --config-lang zh-CN --force
npx zcf i -c zh-CN -f      # 使用缩写

# 更新到英文版 Prompt（降低 token 消耗）
npx zcf u --config-lang en
npx zcf u -c en            # 使用缩写

# 运行 Claude Code 用量分析工具（由 ccusage 提供支持）
npx zcf ccu               # 每日用量（默认），或使用: monthly, session, blocks

📁 项目结构

zcf/
├── README.md              # 说明文档
├── package.json           # npm 包配置
├── bin/
│   └── zcf.mjs           # CLI 入口
├── src/                  # 源代码
│   ├── cli.ts           # CLI 主逻辑
│   ├── commands/        # 命令实现
│   ├── utils/           # 工具函数
│   └── constants.ts     # 常量定义
├── templates/            # 配置模板
│   ├── CLAUDE.md        # 项目级配置（v2.0新增）
│   ├── settings.json    # 基础配置（含隐私保护环境变量）
│   ├── en/              # 英文版
│   │   ├── rules.md     # 核心原则（原CLAUDE.md）
│   │   ├── personality.md # AI个性化（v2.0新增）
│   │   ├── mcp.md       # MCP服务说明（v2.0新增）
│   │   ├── agents/      # AI 代理
│   │   └── commands/    # 命令定义
│   └── zh-CN/           # 中文版
│       └── ... (相同结构)
└── dist/                # 构建输出

✨ 核心特性（v2.0 增强）

🤖 专业代理

任务规划师：将复杂任务拆解为可执行步骤
UI/UX 设计师：提供专业界面设计指导
AI 个性化：支持多种预设人格和自定义（v2.0 新增）
BMad 团队（新增）：完整的敏捷开发团队，包括：
- 产品负责人（PO）：需求挖掘和优先级排序
- 项目经理（PM）：计划和协调
- 系统架构师：技术设计和架构
- 开发工程师：实施和编码
- QA 工程师：测试和质量保证
- Scrum Master（SM）：流程促进
- 业务分析师：需求分析
- UX 专家：用户体验设计

⚡ 命令系统

功能开发 (/feat)：结构化新功能开发
工作流 (/workflow)：完整的六阶段开发流程
Git 指令：简化的 Git 操作
- /git-commit：智能提交，自动暂存和生成提交信息
- /git-rollback：安全回滚到之前的提交，带备份功能
- /git-cleanBranches：清理已合并的分支，保持仓库整洁
BMad 工作流 (/bmad-init)：初始化企业级开发的 BMad 工作流
- 支持全新项目（greenfield）和现有项目（brownfield）
- 提供 PRD、架构文档、用户故事的完整模板
- 集成质量关卡和检查清单系统

🔧 智能配置

API 密钥管理（支持部分修改）
细粒度权限控制
多种 Claude 模型支持（可配置默认模型）
交互式菜单系统（v2.0 新增）
AI 记忆管理（v2.0 新增）

🎯 开发工作流

六阶段工作流

[模式：研究] - 理解需求
[模式：构思] - 设计方案
[模式：计划] - 制定详细计划
[模式：执行] - 实施开发
[模式：优化] - 提升质量
[模式：评审] - 最终评估

🛠️ 开发

# 克隆项目
git clone https://github.com/UfoMiao/zcf.git
cd zcf

# 安装依赖（使用 pnpm）
pnpm install

# 构建项目
pnpm build

# 本地测试
node bin/zcf.mjs

💡 最佳实践

任务分解：保持任务独立可测试
代码质量：遵循 SOLID、KISS、DRY 和 YAGNI 原则
文档管理：计划存储在项目根目录的.claude/plan/ 目录下

🔧 故障排除

如果遇到问题，可以：

重新运行 npx zcf 重新配置
检查 ~/.claude/ 目录下的配置文件
确保 Claude Code 已正确安装
如果路径包含空格，ZCF 会自动处理引号包裹
优先使用 ripgrep (rg) 进行文件搜索以获得更好性能

跨平台支持

Windows 平台

ZCF 已完全支持 Windows 平台：

自动检测：在 Windows 系统上会自动使用兼容的 cmd /c npx 格式
配置修复：现有的错误配置会在更新时自动修复
零配置：Windows 用户无需任何额外操作，与 macOS/Linux 体验一致

如果在 Windows 上遇到 MCP 连接问题，运行 npx zcf 会自动修复配置格式。

Termux 支持（v2.1 新增）

ZCF 现已支持在 Android Termux 环境中运行：

自动适配：自动检测 Termux 环境并使用兼容配置
增强检测：智能识别可用命令，确保在受限环境中正常工作
完整功能：在 Termux 中享受与桌面系统相同的完整功能

安全特性（v2.3 新增）

危险操作确认机制

为保护用户数据安全，以下操作需要明确确认：

文件系统：删除文件/目录、批量修改、移动系统文件
代码提交：git commit、git push、git reset --hard
系统配置：修改环境变量、系统设置、权限变更
数据操作：数据库删除、模式更改、批量更新
网络请求：发送敏感数据、调用生产环境 API
包管理：全局安装/卸载、更新核心依赖

「梦想一旦被付诸行动，就会变得神圣，如果觉得我的文章对您有用，请帮助本站成长」

赞(0) *** 在线联系博主***

标签：

AI 个性等） R Claude Code Router 管理（v2.8.1 增强） U ccusage - Claude Code 用量分析更多功能选项... 或者 MCP 一键搞定 Claude Code 环境设置 - 支持中英文双语配置地址: https://github.com/UfoMiao/zcf 零配置智能代理系统和个性化 AI 助手智能代理系统和个性化 AI 助手 🚀 快速开始 🎯 推荐：使用交互式菜单（v2.0 新增） npx zcf # 打开交互式菜单根据你的需求选择操作菜单选项包括： 1 完整初始化（等同于 zcf i） 2 导入工作流（等同于 zcf u） 3-7 配置管理（API/CCR 模型设置这个好！ ZCF - 零配置 Claude-Code 流程一键搞定 Claude Code 环境设置 - 支持中英文双语配置这个好!ZCF 零配置 Claude-Code 流程

上一篇：n8n自动化工作流,直接导入即可使用

下一篇：《门阀》：成大事者慢半拍

博客简介

本站CDN采用VmShell免费提供离中国大陆最近的香港CMI高速网络做支撑,ToToTel打造全球最快速的边沿网络支撑服务，具体详情请见 :https://vmshell.com/ 以及 https://tototel.com/,网站所有的文件和内容禁止大陆网站搬迁复制,谢谢,VPS营销投稿邮箱: admin@linuxxword.com，我们免费帮大家发布，不收取任何费用,请提供完整测试文稿!

文章总数： 3144 篇
草稿数目： 0 篇
分类数目： 9 个
独立页面： 0 个
评论总数： 2 条
链接总数： 0 个
标签总数： 48282 个
注册用户： 139 人
访问总量： 8,654,693 次
最近更新： 2025年12月6日