站点图标 Linux-技术共享

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

Linux网站管理员

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

 

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

🚀 快速开始

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

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

菜单选项包括：

或者，直接使用命令：

🆕 首次使用 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）是企业级的工作流系统，提供：

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

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

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

访问 CCR 功能：

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

检查更新（v2.8.1+）：

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

CCR 菜单选项：

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

初始化流程

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

使用方式

配置完成后：

PS:

  • feat 和 workflow 这两套各有优势，可以都试试比较一下
  • 生成的文档位置默认都是项目根目录下的 .claude/xxx.md，可以把 .claude/ 加入项目的 .gitignore 里

✨ ZCF 工具特性

🌏 多语言支持

🔧 智能安装

📦 完整配置

🔐 API 配置

💾 配置管理

📖 使用说明

交互式菜单（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 增强）

🤖 专业代理

⚡ 命令系统

🔧 智能配置

🎯 开发工作流

六阶段工作流

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

🛠️ 开发

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

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

# 构建项目
pnpm build

# 本地测试
node bin/zcf.mjs
 

💡 最佳实践

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

🔧 故障排除

如果遇到问题，可以：

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

跨平台支持

Windows 平台

ZCF 已完全支持 Windows 平台：

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

Termux 支持（v2.1 新增）

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

安全特性（v2.3 新增）

危险操作确认机制

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

 

退出移动版