1 line
40 KiB
JSON
1 line
40 KiB
JSON
{"repo": "benedictking/ccx-kit", "files": {"docs/zh-CN/features/claude-code.md": {"786ed5900a84f70e3b2cab79dfe2a79609ecaebc": {"t": 1785747364.6773489, "n": 6334, "h": "5c0522656737620e", "c": "---\ntitle: Claude Code 配置能力\n---\n\n# Claude Code 配置能力\n\nZCF 为 Claude Code 提供完整的零配置体验，通过 `ccx-kit init` 命令可以一键完成从环境初始化到工作流导入的全部配置。\n\n## 核心特性\n\nZCF 针对 Claude Code 的配置包括以下核心能力：\n\n| 功能模块 | 说明 | 配置文件位置 |\n|---------|------|------------|\n| **API 配置** | 支持官方登录、API Key、CCR 代理三种模式 | `~/.claude/settings.json` |\n| **工作流命令** | 预置六阶段、Feat、Git、BMAD 等命令 | `~/.claude/commands/ccx-kit/` |\n| **工作流智能体** | 规划、UX 等智能体 | `~/.claude/agents/ccx-kit/` |\n| **输出风格** | 多种 AI 个性化输出风格 | `~/.claude/output-styles/` |\n| **MCP 服务** | 集成 Context7、Open Web Search 等 | `~/.claude/settings.json` |\n| **系统提示** | 全局 AI 记忆和指令配置 | `~/.claude/CLAUDE.md` |\n\n## 目录结构与备份\n\n### 自动创建的目录结构\n\n执行 `ccx-kit init` 后，ZCF 会自动创建以下目录结构：\n\n```\n~/.claude/\n├── settings.json # Claude Code 主配置文件（API、MCP、权限等）\n├── CLAUDE.md # 系统提示和 AI 记忆配置\n├── commands/ # 工作流命令目录\n│ └── ccx-kit/\n│ ├── init-project.md\n│ ├── workflow.md # 六阶段工作流命令\n│ ├── feat.md # 功能开发工作流命令\n│ ├── git-commit.md\n│ ├── git-rollback.md\n│ ├── git-cleanBranches.md\n│ ├── git-worktree.md\n│ └── bmad-init.md\n├── agents/ # 工作流智能体目录\n│ └── ccx-kit/\n│ ├── common/\n│ │ ├── init-architect.md\n│ │ └── get-current-datetime.md\n│ └── plan/\n│ ├── planner.md\n│ └── ui-ux-designer.md\n├── output-styles/ # 输出风格模板\n└── backup/ # 配置备份目录\n └── backup_YYYY-MM-DD_HH-mm-ss/\n```\n\n### 备份机制\n\nZCF 提供完善的备份机制，确保您的配置安全：\n\n- **自动备份**：每次修改配置时自动创建时间戳备份\n- **备份位置**：`~/.claude/backup/YYYY-MM-DD_HH-mm-ss/`\n- **备份内容**：包含所有配置文件、工作流和自定义设置\n- **兼容性**：兼容旧版 `~/.claude.json`、`.ccx-kit-config.json` 等遗留文件\n\n> 💡 **恢复配置**：如果需要恢复之前的配置，可以从备份目录中复制相应文件。\n\n### 配置处理策略\n\n当检测到已有配置时，ZCF 提供多种处理策略：\n\n| 策略 | 说明 | 适用场景 |\n|------|------|---------|\n| **备份并覆盖** | 创建备份后覆盖现有配置 | 想要全新配置时 |\n| **合并配置** | 智能合并新旧配置 | 保留自定义内容时 |\n| **仅更新文档** | 只更新工作流和文档 | 只想更新模板时 |\n| **跳过** | 不进行任何更新 | 临时跳过某次更新 |\n\n## API 与模型管理\n\n### API 配置模式\n\nZCF 支持三种 API 配置模式：\n\n#### 1. 官方登录\n\n最简单的方式，无需配置 API Key：\n\n```\n? 选择 API 认证方式\n ❯ 使用官方登录\n```\n\n> ✅ **优点**：无需管理 API Key，使用官方认证系统\n\n#### 2. API Key 模式\n\n适合使用第三方 API 提供商：\n\n```bash\n# 使用提供商预设（推荐）\nnpx ccx-kit i -s -p 302ai -k \"sk-xxx\"\n\n# 自定义 API 端点\nnpx ccx-kit i -s -t api_key -k \"sk-xxx\" -u \"https://api.example.com\"\n```\n\n支持的提供商预设：\n- `302ai` - [302.AI](https://share.302.ai/gAT9VG) API 服务\n- `glm` - GLM（智谱AI）\n- `minimax` - MiniMax API 服务\n- `kimi` - Kimi（月之暗面）\n\n#### 3. CCR 代理模式\n\n通过 Claude Code Router 代理使用多个模型：\n\n```bash\nnpx ccx-kit i -s -t ccr_proxy\n# 或先配置 CCR\nnpx ccx-kit ccx\n```\n\n> 💡 **CCR 优势**：\n> - 支持免费模型接入（Gemini、DeepSeek）\n> - 成本优化（为不同任务选择合适模型）\n> - 灵活的路由规则配置\n\n### 模型配置\n\nZCF 支持配置多个模型：\n\n```bash\n# 配置主模型和快速模型\nnpx ccx-kit i -s -p 302ai -k \"sk-xxx\" \\\n --api-model \"claude-sonnet-4-5\" \\\n --api-fast-model \"claude-haiku-4-5\"\n```\n\n- **主模型**：用于主要任务（如代码生成、复杂分析）\n- **快速模型**：用于快速任务（如代码补全、简单查询）\n\n### 多 API 配置\n\nZCF 支持配置多个 API，方便在不同场景下切换：\n\n```bash\nnpx ccx-kit i -s --api-configs '[\n {\"provider\":\"302ai\",\"key\":\"sk-xxx\",\"default\":true},\n {\"provider\":\"glm\",\"key\":\"sk-yyy\"},\n {\"name\":\"custom\",\"type\":\"api_key\",\"key\":\"sk-zzz\",\"url\":\"https://custom.api.com\"}\n]'\n```\n\n> 📖 **切换配置**：使用 `npx ccx-kit config-switch` 在多个配置之间切换。\n\n## 工作流系统\n\nZCF 提供丰富的工作流模板，帮助标准化开发流程。\n\n### 默认工作流\n\n| 工作流 | 命令 | 说明 |\n|--------|------|------|\n| **六阶段工作流** | `/zcf:workflow` | 完整的六阶段开发流程（研究→构思→计划→执行→优化→评审） |\n| **功能开发工作流** | `/zcf:feat` | 新功能设计与实现，包含规划和 UI/UX 设计 |\n| **通用工具** | `/init-project` | 项目初始化工具 |\n| **Git 工作流** | `/git-commit` 等 | Git 操作自动化命令 |\n| **BMad 工作流** | `/bmad-init` | 企业级敏捷开发流程 |\n\n### 工作流安装\n\n```bash\n# 安装所有工作流（默认）\nnpx ccx-kit i -s --workflows all\n\n# 选择性安装\nnpx ccx-kit i -s --workflows commonTools,sixStepsWorkflow,featPlanUx\n\n# 跳过工作流安装\nnpx ccx-kit i -s --workflows skip\n```\n\n> 📚 **工作流详解**：详细使用说明请参考 [工作流详解](../workflows/) 章节。\n\n## 输出风格系统\n\nZCF 支持多种 AI 输出风格，个性化您的 AI 助手体验。\n\n### 可用的输出风格\n\n| 风格 ID | 名称 | 特点 |\n|---------|------|------|\n| `engineer-professional` | 工程师专业版 | 严格遵循 SOLID、KISS、DRY、YAGNI 原则 |\n| `nekomata-engineer` | 猫娘工程师 | 专业猫娘工程师幽浮喵，结合严谨工程技术与可爱猫娘特质 |\n| `laowang-engineer` | 老王暴躁技术流 | 暴脾气技术流，绝不容忍代码错误和不规范代码 |\n| `ojousama-engineer` | 大小姐工程师 | 傲娇蓝发双马尾大小姐程序员哈雷酱 |\n\n### 安装与使用\n\n```bash\n# 安装多个输出风格\nnpx ccx-kit i -s --output-styles engineer-professional,nekomata-engineer\n\n# 设置默认输出风格\nnpx ccx-kit i -s --default-output-style engineer-professional\n```\n\n### 项目级切换\n\n在 Claude Code 中，可以通过命令切换项目级的输出风格：\n\n```\n/output-style engineer-professional # 切换到专业工程师\n/output-style nekomata-engineer # 切换到猫娘工程师\n```\n\n> ⚠️ **版本要求**：Claude Code 版本需要大于 1.0.81 才支持 output-style，可使用 `npx ccx-kit check-updates` 进行更新。\n\n## MCP 服务集成\n\nZCF 内置常用 MCP 服务配置，支持一键安装和管理。\n\n### 默认 MCP 服务列表\n\n| 服务 ID | 类型 | 说明 | 是否需要 API Key |\n|---------|------|------|-----------------|\n| `context7` | stdio | 上下文检索与库文档查询 | ❌ |\n| `open-websearch` | stdio | DuckDuckGo/Bing/Brave 搜索 | ❌ |\n| `spec-workflow` | stdio | Spec 工作流 MCP 服务 | ❌ |\n| `mcp-deepwiki` | stdio | DeepWiki 文档检索 | ❌ |\n| `Playwright` | stdio | Playwright 浏览器操作 | ❌ |\n| `exa` | stdio | Exa 网络搜索 | ✅ 需要 `EXA_API_KEY` |\n| `serena` | uvx | Serena IDE 助手 | ❌ |\n\n### MCP 服务配置\n\n```bash\n# 安装所有 MCP 服务（推荐）\nnpx ccx-kit i -s --mcp-services all\n\n# 选择性安装\nnpx ccx-kit i -s --mcp-services context7,open-websearch,spec-workflow\n\n# 跳过 MCP 服务安装\nnpx ccx-kit i -s --mcp-services skip\n```\n\n### 配置位置\n\n- **Claude Code**：`~/.claude/settings.json` 中的 `mcpServers`\n- **Windows 特殊处理**：ZCF 会自动修正 Windows 路径格式\n\n### 重新配置\n\n如果需要重新配置 MCP 服务：\n\n```bash\nnpx ccx-kit\n# 选择 4. 配置 MCP\n```\n\n## 其他能力\n\n### CCometixLine 状态栏\n\nCCometixLine 是一个基于 Rust 的高性能状态栏工具：\n\n- **实时用量追踪**：实时监控 Claude Code API 使用情况\n- **Git 集成**：显示 Git 状态和分支信息\n- **性能优化**：资源消耗极低\n\n```bash\n# 安装 CCometixLine（默认启用）\nnpx ccx-kit i -s --install-cometix-line true\n\n# 通过菜单安装\nnpx ccx-kit → 选择 L\n```\n\n### 环境变量与权限\n\nZCF 可以导入推荐的环境变量和权限配置：\n\n```bash\nnpx ccx-kit\n# 选择 7. 导入推荐环境变量和权限配置\n```\n\n这包括：\n- 隐私保护环境变量\n- 系统权限配置模板\n- 安全相关设置\n\n## 配置复用与更新\n\n### 保存配置偏好\n\n所有配置选择会写入 `~/.ccx-kit/config.toml`，包括：\n- 语言偏好\n- 默认工具类型\n- 最近安装选项\n\n### 增量更新\n\n使用 `ccx-kit update` 可以更新工作流和模板，同时保留现有配置：\n\n```bash\n# 更新工作流和模板，保留 API 和 MCP 配置\nnpx ccx-kit update\n\n# 指定语言更新\nnpx ccx-kit update -g zh-CN\n```\n\n> 💡 **最佳实践**：\n> - 首次使用 `ccx-kit init` 完成完整初始化\n> - 后续使用 `ccx-kit update` 更新工作流和模板\n> - 通过菜单选项单独更新特定配置\n\n## 下一步\n\n了解更多 Claude Code 相关功能：\n\n- 📚 [工作流详解](../workflows/) - 了解各种工作流的使用\n- 🔧 [配置管理](../advanced/configuration.md) - 深入学习配置管理\n- 🎯 [MCP 服务集成](mcp.md) - 详细了解 MCP 服务\n- 🚀 [CCR 代理](ccr.md) - 了解 CCR 代理配置\n"}, "0c85640ba699b503c579adeea2556f12101b86dc": {"t": 1785772822.5916684, "n": 6334, "h": "5c0522656737620e", "c": "---\ntitle: Claude Code 配置能力\n---\n\n# Claude Code 配置能力\n\nZCF 为 Claude Code 提供完整的零配置体验，通过 `ccx-kit init` 命令可以一键完成从环境初始化到工作流导入的全部配置。\n\n## 核心特性\n\nZCF 针对 Claude Code 的配置包括以下核心能力：\n\n| 功能模块 | 说明 | 配置文件位置 |\n|---------|------|------------|\n| **API 配置** | 支持官方登录、API Key、CCR 代理三种模式 | `~/.claude/settings.json` |\n| **工作流命令** | 预置六阶段、Feat、Git、BMAD 等命令 | `~/.claude/commands/ccx-kit/` |\n| **工作流智能体** | 规划、UX 等智能体 | `~/.claude/agents/ccx-kit/` |\n| **输出风格** | 多种 AI 个性化输出风格 | `~/.claude/output-styles/` |\n| **MCP 服务** | 集成 Context7、Open Web Search 等 | `~/.claude/settings.json` |\n| **系统提示** | 全局 AI 记忆和指令配置 | `~/.claude/CLAUDE.md` |\n\n## 目录结构与备份\n\n### 自动创建的目录结构\n\n执行 `ccx-kit init` 后，ZCF 会自动创建以下目录结构：\n\n```\n~/.claude/\n├── settings.json # Claude Code 主配置文件（API、MCP、权限等）\n├── CLAUDE.md # 系统提示和 AI 记忆配置\n├── commands/ # 工作流命令目录\n│ └── ccx-kit/\n│ ├── init-project.md\n│ ├── workflow.md # 六阶段工作流命令\n│ ├── feat.md # 功能开发工作流命令\n│ ├── git-commit.md\n│ ├── git-rollback.md\n│ ├── git-cleanBranches.md\n│ ├── git-worktree.md\n│ └── bmad-init.md\n├── agents/ # 工作流智能体目录\n│ └── ccx-kit/\n│ ├── common/\n│ │ ├── init-architect.md\n│ │ └── get-current-datetime.md\n│ └── plan/\n│ ├── planner.md\n│ └── ui-ux-designer.md\n├── output-styles/ # 输出风格模板\n└── backup/ # 配置备份目录\n └── backup_YYYY-MM-DD_HH-mm-ss/\n```\n\n### 备份机制\n\nZCF 提供完善的备份机制，确保您的配置安全：\n\n- **自动备份**：每次修改配置时自动创建时间戳备份\n- **备份位置**：`~/.claude/backup/YYYY-MM-DD_HH-mm-ss/`\n- **备份内容**：包含所有配置文件、工作流和自定义设置\n- **兼容性**：兼容旧版 `~/.claude.json`、`.ccx-kit-config.json` 等遗留文件\n\n> 💡 **恢复配置**：如果需要恢复之前的配置，可以从备份目录中复制相应文件。\n\n### 配置处理策略\n\n当检测到已有配置时，ZCF 提供多种处理策略：\n\n| 策略 | 说明 | 适用场景 |\n|------|------|---------|\n| **备份并覆盖** | 创建备份后覆盖现有配置 | 想要全新配置时 |\n| **合并配置** | 智能合并新旧配置 | 保留自定义内容时 |\n| **仅更新文档** | 只更新工作流和文档 | 只想更新模板时 |\n| **跳过** | 不进行任何更新 | 临时跳过某次更新 |\n\n## API 与模型管理\n\n### API 配置模式\n\nZCF 支持三种 API 配置模式：\n\n#### 1. 官方登录\n\n最简单的方式，无需配置 API Key：\n\n```\n? 选择 API 认证方式\n ❯ 使用官方登录\n```\n\n> ✅ **优点**：无需管理 API Key，使用官方认证系统\n\n#### 2. API Key 模式\n\n适合使用第三方 API 提供商：\n\n```bash\n# 使用提供商预设（推荐）\nnpx ccx-kit i -s -p 302ai -k \"sk-xxx\"\n\n# 自定义 API 端点\nnpx ccx-kit i -s -t api_key -k \"sk-xxx\" -u \"https://api.example.com\"\n```\n\n支持的提供商预设：\n- `302ai` - [302.AI](https://share.302.ai/gAT9VG) API 服务\n- `glm` - GLM（智谱AI）\n- `minimax` - MiniMax API 服务\n- `kimi` - Kimi（月之暗面）\n\n#### 3. CCR 代理模式\n\n通过 Claude Code Router 代理使用多个模型：\n\n```bash\nnpx ccx-kit i -s -t ccr_proxy\n# 或先配置 CCR\nnpx ccx-kit ccx\n```\n\n> 💡 **CCR 优势**：\n> - 支持免费模型接入（Gemini、DeepSeek）\n> - 成本优化（为不同任务选择合适模型）\n> - 灵活的路由规则配置\n\n### 模型配置\n\nZCF 支持配置多个模型：\n\n```bash\n# 配置主模型和快速模型\nnpx ccx-kit i -s -p 302ai -k \"sk-xxx\" \\\n --api-model \"claude-sonnet-4-5\" \\\n --api-fast-model \"claude-haiku-4-5\"\n```\n\n- **主模型**：用于主要任务（如代码生成、复杂分析）\n- **快速模型**：用于快速任务（如代码补全、简单查询）\n\n### 多 API 配置\n\nZCF 支持配置多个 API，方便在不同场景下切换：\n\n```bash\nnpx ccx-kit i -s --api-configs '[\n {\"provider\":\"302ai\",\"key\":\"sk-xxx\",\"default\":true},\n {\"provider\":\"glm\",\"key\":\"sk-yyy\"},\n {\"name\":\"custom\",\"type\":\"api_key\",\"key\":\"sk-zzz\",\"url\":\"https://custom.api.com\"}\n]'\n```\n\n> 📖 **切换配置**：使用 `npx ccx-kit config-switch` 在多个配置之间切换。\n\n## 工作流系统\n\nZCF 提供丰富的工作流模板，帮助标准化开发流程。\n\n### 默认工作流\n\n| 工作流 | 命令 | 说明 |\n|--------|------|------|\n| **六阶段工作流** | `/zcf:workflow` | 完整的六阶段开发流程（研究→构思→计划→执行→优化→评审） |\n| **功能开发工作流** | `/zcf:feat` | 新功能设计与实现，包含规划和 UI/UX 设计 |\n| **通用工具** | `/init-project` | 项目初始化工具 |\n| **Git 工作流** | `/git-commit` 等 | Git 操作自动化命令 |\n| **BMad 工作流** | `/bmad-init` | 企业级敏捷开发流程 |\n\n### 工作流安装\n\n```bash\n# 安装所有工作流（默认）\nnpx ccx-kit i -s --workflows all\n\n# 选择性安装\nnpx ccx-kit i -s --workflows commonTools,sixStepsWorkflow,featPlanUx\n\n# 跳过工作流安装\nnpx ccx-kit i -s --workflows skip\n```\n\n> 📚 **工作流详解**：详细使用说明请参考 [工作流详解](../workflows/) 章节。\n\n## 输出风格系统\n\nZCF 支持多种 AI 输出风格，个性化您的 AI 助手体验。\n\n### 可用的输出风格\n\n| 风格 ID | 名称 | 特点 |\n|---------|------|------|\n| `engineer-professional` | 工程师专业版 | 严格遵循 SOLID、KISS、DRY、YAGNI 原则 |\n| `nekomata-engineer` | 猫娘工程师 | 专业猫娘工程师幽浮喵，结合严谨工程技术与可爱猫娘特质 |\n| `laowang-engineer` | 老王暴躁技术流 | 暴脾气技术流，绝不容忍代码错误和不规范代码 |\n| `ojousama-engineer` | 大小姐工程师 | 傲娇蓝发双马尾大小姐程序员哈雷酱 |\n\n### 安装与使用\n\n```bash\n# 安装多个输出风格\nnpx ccx-kit i -s --output-styles engineer-professional,nekomata-engineer\n\n# 设置默认输出风格\nnpx ccx-kit i -s --default-output-style engineer-professional\n```\n\n### 项目级切换\n\n在 Claude Code 中，可以通过命令切换项目级的输出风格：\n\n```\n/output-style engineer-professional # 切换到专业工程师\n/output-style nekomata-engineer # 切换到猫娘工程师\n```\n\n> ⚠️ **版本要求**：Claude Code 版本需要大于 1.0.81 才支持 output-style，可使用 `npx ccx-kit check-updates` 进行更新。\n\n## MCP 服务集成\n\nZCF 内置常用 MCP 服务配置，支持一键安装和管理。\n\n### 默认 MCP 服务列表\n\n| 服务 ID | 类型 | 说明 | 是否需要 API Key |\n|---------|------|------|-----------------|\n| `context7` | stdio | 上下文检索与库文档查询 | ❌ |\n| `open-websearch` | stdio | DuckDuckGo/Bing/Brave 搜索 | ❌ |\n| `spec-workflow` | stdio | Spec 工作流 MCP 服务 | ❌ |\n| `mcp-deepwiki` | stdio | DeepWiki 文档检索 | ❌ |\n| `Playwright` | stdio | Playwright 浏览器操作 | ❌ |\n| `exa` | stdio | Exa 网络搜索 | ✅ 需要 `EXA_API_KEY` |\n| `serena` | uvx | Serena IDE 助手 | ❌ |\n\n### MCP 服务配置\n\n```bash\n# 安装所有 MCP 服务（推荐）\nnpx ccx-kit i -s --mcp-services all\n\n# 选择性安装\nnpx ccx-kit i -s --mcp-services context7,open-websearch,spec-workflow\n\n# 跳过 MCP 服务安装\nnpx ccx-kit i -s --mcp-services skip\n```\n\n### 配置位置\n\n- **Claude Code**：`~/.claude/settings.json` 中的 `mcpServers`\n- **Windows 特殊处理**：ZCF 会自动修正 Windows 路径格式\n\n### 重新配置\n\n如果需要重新配置 MCP 服务：\n\n```bash\nnpx ccx-kit\n# 选择 4. 配置 MCP\n```\n\n## 其他能力\n\n### CCometixLine 状态栏\n\nCCometixLine 是一个基于 Rust 的高性能状态栏工具：\n\n- **实时用量追踪**：实时监控 Claude Code API 使用情况\n- **Git 集成**：显示 Git 状态和分支信息\n- **性能优化**：资源消耗极低\n\n```bash\n# 安装 CCometixLine（默认启用）\nnpx ccx-kit i -s --install-cometix-line true\n\n# 通过菜单安装\nnpx ccx-kit → 选择 L\n```\n\n### 环境变量与权限\n\nZCF 可以导入推荐的环境变量和权限配置：\n\n```bash\nnpx ccx-kit\n# 选择 7. 导入推荐环境变量和权限配置\n```\n\n这包括：\n- 隐私保护环境变量\n- 系统权限配置模板\n- 安全相关设置\n\n## 配置复用与更新\n\n### 保存配置偏好\n\n所有配置选择会写入 `~/.ccx-kit/config.toml`，包括：\n- 语言偏好\n- 默认工具类型\n- 最近安装选项\n\n### 增量更新\n\n使用 `ccx-kit update` 可以更新工作流和模板，同时保留现有配置：\n\n```bash\n# 更新工作流和模板，保留 API 和 MCP 配置\nnpx ccx-kit update\n\n# 指定语言更新\nnpx ccx-kit update -g zh-CN\n```\n\n> 💡 **最佳实践**：\n> - 首次使用 `ccx-kit init` 完成完整初始化\n> - 后续使用 `ccx-kit update` 更新工作流和模板\n> - 通过菜单选项单独更新特定配置\n\n## 下一步\n\n了解更多 Claude Code 相关功能：\n\n- 📚 [工作流详解](../workflows/) - 了解各种工作流的使用\n- 🔧 [配置管理](../advanced/configuration.md) - 深入学习配置管理\n- 🎯 [MCP 服务集成](mcp.md) - 详细了解 MCP 服务\n- 🚀 [CCR 代理](ccr.md) - 了解 CCR 代理配置\n"}, "d0331a101b6528a0b6439a758d9edede6052343a": {"t": 1785772824.1468456, "n": 6210, "h": "f7cf3aced533ef23", "c": "---\ntitle: Claude Code 配置能力\n---\n\n# Claude Code 配置能力\n\nZCF 为 Claude Code 提供完整的零配置体验，通过 `zcf init` 命令可以一键完成从环境初始化到工作流导入的全部配置。\n\n## 核心特性\n\nZCF 针对 Claude Code 的配置包括以下核心能力：\n\n| 功能模块 | 说明 | 配置文件位置 |\n|---------|------|------------|\n| **API 配置** | 支持官方登录、API Key、CCR 代理三种模式 | `~/.claude/settings.json` |\n| **工作流命令** | 预置六阶段、Feat、Git、BMAD 等命令 | `~/.claude/commands/zcf/` |\n| **工作流智能体** | 规划、UX 等智能体 | `~/.claude/agents/zcf/` |\n| **输出风格** | 多种 AI 个性化输出风格 | `~/.claude/output-styles/` |\n| **MCP 服务** | 集成 Context7、Open Web Search 等 | `~/.claude/settings.json` |\n| **系统提示** | 全局 AI 记忆和指令配置 | `~/.claude/CLAUDE.md` |\n\n## 目录结构与备份\n\n### 自动创建的目录结构\n\n执行 `zcf init` 后，ZCF 会自动创建以下目录结构：\n\n```\n~/.claude/\n├── settings.json # Claude Code 主配置文件（API、MCP、权限等）\n├── CLAUDE.md # 系统提示和 AI 记忆配置\n├── commands/ # 工作流命令目录\n│ └── zcf/\n│ ├── init-project.md\n│ ├── workflow.md # 六阶段工作流命令\n│ ├── feat.md # 功能开发工作流命令\n│ ├── git-commit.md\n│ ├── git-rollback.md\n│ ├── git-cleanBranches.md\n│ ├── git-worktree.md\n│ └── bmad-init.md\n├── agents/ # 工作流智能体目录\n│ └── zcf/\n│ ├── common/\n│ │ ├── init-architect.md\n│ │ └── get-current-datetime.md\n│ └── plan/\n│ ├── planner.md\n│ └── ui-ux-designer.md\n├── output-styles/ # 输出风格模板\n└── backup/ # 配置备份目录\n └── backup_YYYY-MM-DD_HH-mm-ss/\n```\n\n### 备份机制\n\nZCF 提供完善的备份机制，确保您的配置安全：\n\n- **自动备份**：每次修改配置时自动创建时间戳备份\n- **备份位置**：`~/.claude/backup/YYYY-MM-DD_HH-mm-ss/`\n- **备份内容**：包含所有配置文件、工作流和自定义设置\n- **兼容性**：兼容旧版 `~/.claude.json`、`.zcf-config.json` 等遗留文件\n\n> 💡 **恢复配置**：如果需要恢复之前的配置，可以从备份目录中复制相应文件。\n\n### 配置处理策略\n\n当检测到已有配置时，ZCF 提供多种处理策略：\n\n| 策略 | 说明 | 适用场景 |\n|------|------|---------|\n| **备份并覆盖** | 创建备份后覆盖现有配置 | 想要全新配置时 |\n| **合并配置** | 智能合并新旧配置 | 保留自定义内容时 |\n| **仅更新文档** | 只更新工作流和文档 | 只想更新模板时 |\n| **跳过** | 不进行任何更新 | 临时跳过某次更新 |\n\n## API 与模型管理\n\n### API 配置模式\n\nZCF 支持三种 API 配置模式：\n\n#### 1. 官方登录\n\n最简单的方式，无需配置 API Key：\n\n```\n? 选择 API 认证方式\n ❯ 使用官方登录\n```\n\n> ✅ **优点**：无需管理 API Key，使用官方认证系统\n\n#### 2. API Key 模式\n\n适合使用第三方 API 提供商：\n\n```bash\n# 使用提供商预设（推荐）\nnpx zcf i -s -p 302ai -k \"sk-xxx\"\n\n# 自定义 API 端点\nnpx zcf i -s -t api_key -k \"sk-xxx\" -u \"https://api.example.com\"\n```\n\n支持的提供商预设：\n- `302ai` - [302.AI](https://share.302.ai/gAT9VG) API 服务\n- `glm` - GLM（智谱AI）\n- `minimax` - MiniMax API 服务\n- `kimi` - Kimi（月之暗面）\n\n#### 3. CCR 代理模式\n\n通过 Claude Code Router 代理使用多个模型：\n\n```bash\nnpx zcf i -s -t ccr_proxy\n# 或先配置 CCR\nnpx zcf ccr\n```\n\n> 💡 **CCR 优势**：\n> - 支持免费模型接入（Gemini、DeepSeek）\n> - 成本优化（为不同任务选择合适模型）\n> - 灵活的路由规则配置\n\n### 模型配置\n\nZCF 支持配置多个模型：\n\n```bash\n# 配置主模型和快速模型\nnpx zcf i -s -p 302ai -k \"sk-xxx\" \\\n --api-model \"claude-sonnet-4-5\" \\\n --api-fast-model \"claude-haiku-4-5\"\n```\n\n- **主模型**：用于主要任务（如代码生成、复杂分析）\n- **快速模型**：用于快速任务（如代码补全、简单查询）\n\n### 多 API 配置\n\nZCF 支持配置多个 API，方便在不同场景下切换：\n\n```bash\nnpx zcf i -s --api-configs '[\n {\"provider\":\"302ai\",\"key\":\"sk-xxx\",\"default\":true},\n {\"provider\":\"glm\",\"key\":\"sk-yyy\"},\n {\"name\":\"custom\",\"type\":\"api_key\",\"key\":\"sk-zzz\",\"url\":\"https://custom.api.com\"}\n]'\n```\n\n> 📖 **切换配置**：使用 `npx zcf config-switch` 在多个配置之间切换。\n\n## 工作流系统\n\nZCF 提供丰富的工作流模板，帮助标准化开发流程。\n\n### 默认工作流\n\n| 工作流 | 命令 | 说明 |\n|--------|------|------|\n| **六阶段工作流** | `/zcf:workflow` | 完整的六阶段开发流程（研究→构思→计划→执行→优化→评审） |\n| **功能开发工作流** | `/zcf:feat` | 新功能设计与实现，包含规划和 UI/UX 设计 |\n| **通用工具** | `/init-project` | 项目初始化工具 |\n| **Git 工作流** | `/git-commit` 等 | Git 操作自动化命令 |\n| **BMad 工作流** | `/bmad-init` | 企业级敏捷开发流程 |\n\n### 工作流安装\n\n```bash\n# 安装所有工作流（默认）\nnpx zcf i -s --workflows all\n\n# 选择性安装\nnpx zcf i -s --workflows commonTools,sixStepsWorkflow,featPlanUx\n\n# 跳过工作流安装\nnpx zcf i -s --workflows skip\n```\n\n> 📚 **工作流详解**：详细使用说明请参考 [工作流详解](../workflows/) 章节。\n\n## 输出风格系统\n\nZCF 支持多种 AI 输出风格，个性化您的 AI 助手体验。\n\n### 可用的输出风格\n\n| 风格 ID | 名称 | 特点 |\n|---------|------|------|\n| `engineer-professional` | 工程师专业版 | 严格遵循 SOLID、KISS、DRY、YAGNI 原则 |\n| `nekomata-engineer` | 猫娘工程师 | 专业猫娘工程师幽浮喵，结合严谨工程技术与可爱猫娘特质 |\n| `laowang-engineer` | 老王暴躁技术流 | 暴脾气技术流，绝不容忍代码错误和不规范代码 |\n| `ojousama-engineer` | 大小姐工程师 | 傲娇蓝发双马尾大小姐程序员哈雷酱 |\n\n### 安装与使用\n\n```bash\n# 安装多个输出风格\nnpx zcf i -s --output-styles engineer-professional,nekomata-engineer\n\n# 设置默认输出风格\nnpx zcf i -s --default-output-style engineer-professional\n```\n\n### 项目级切换\n\n在 Claude Code 中，可以通过命令切换项目级的输出风格：\n\n```\n/output-style engineer-professional # 切换到专业工程师\n/output-style nekomata-engineer # 切换到猫娘工程师\n```\n\n> ⚠️ **版本要求**：Claude Code 版本需要大于 1.0.81 才支持 output-style，可使用 `npx zcf check-updates` 进行更新。\n\n## MCP 服务集成\n\nZCF 内置常用 MCP 服务配置，支持一键安装和管理。\n\n### 默认 MCP 服务列表\n\n| 服务 ID | 类型 | 说明 | 是否需要 API Key |\n|---------|------|------|-----------------|\n| `context7` | stdio | 上下文检索与库文档查询 | ❌ |\n| `open-websearch` | stdio | DuckDuckGo/Bing/Brave 搜索 | ❌ |\n| `spec-workflow` | stdio | Spec 工作流 MCP 服务 | ❌ |\n| `mcp-deepwiki` | stdio | DeepWiki 文档检索 | ❌ |\n| `Playwright` | stdio | Playwright 浏览器操作 | ❌ |\n| `exa` | stdio | Exa 网络搜索 | ✅ 需要 `EXA_API_KEY` |\n| `serena` | uvx | Serena IDE 助手 | ❌ |\n\n### MCP 服务配置\n\n```bash\n# 安装所有 MCP 服务（推荐）\nnpx zcf i -s --mcp-services all\n\n# 选择性安装\nnpx zcf i -s --mcp-services context7,open-websearch,spec-workflow\n\n# 跳过 MCP 服务安装\nnpx zcf i -s --mcp-services skip\n```\n\n### 配置位置\n\n- **Claude Code**：`~/.claude/settings.json` 中的 `mcpServers`\n- **Windows 特殊处理**：ZCF 会自动修正 Windows 路径格式\n\n### 重新配置\n\n如果需要重新配置 MCP 服务：\n\n```bash\nnpx zcf\n# 选择 4. 配置 MCP\n```\n\n## 其他能力\n\n### CCometixLine 状态栏\n\nCCometixLine 是一个基于 Rust 的高性能状态栏工具：\n\n- **实时用量追踪**：实时监控 Claude Code API 使用情况\n- **Git 集成**：显示 Git 状态和分支信息\n- **性能优化**：资源消耗极低\n\n```bash\n# 安装 CCometixLine（默认启用）\nnpx zcf i -s --install-cometix-line true\n\n# 通过菜单安装\nnpx zcf → 选择 L\n```\n\n### 环境变量与权限\n\nZCF 可以导入推荐的环境变量和权限配置：\n\n```bash\nnpx zcf\n# 选择 7. 导入推荐环境变量和权限配置\n```\n\n这包括：\n- 隐私保护环境变量\n- 系统权限配置模板\n- 安全相关设置\n\n## 配置复用与更新\n\n### 保存配置偏好\n\n所有配置选择会写入 `~/.ufomiao/zcf/config.toml`，包括：\n- 语言偏好\n- 默认工具类型\n- 最近安装选项\n\n### 增量更新\n\n使用 `zcf update` 可以更新工作流和模板，同时保留现有配置：\n\n```bash\n# 更新工作流和模板，保留 API 和 MCP 配置\nnpx zcf update\n\n# 指定语言更新\nnpx zcf update -g zh-CN\n```\n\n> 💡 **最佳实践**：\n> - 首次使用 `zcf init` 完成完整初始化\n> - 后续使用 `zcf update` 更新工作流和模板\n> - 通过菜单选项单独更新特定配置\n\n## 下一步\n\n了解更多 Claude Code 相关功能：\n\n- 📚 [工作流详解](../workflows/) - 了解各种工作流的使用\n- 🔧 [配置管理](../advanced/configuration.md) - 深入学习配置管理\n- 🎯 [MCP 服务集成](mcp.md) - 详细了解 MCP 服务\n- 🚀 [CCR 代理](ccr.md) - 了解 CCR 代理配置\n"}, "e6dbbd7bd293f0c04271681347b3fee0442450d7": {"t": 1785772828.9515116, "n": 5754, "h": "fc2d823959b8deeb", "c": "---\ntitle: Claude Code 配置能力\n---\n\n# Claude Code 配置能力\n\nZCF 为 Claude Code 提供完整的零配置体验，通过 `zcf init` 命令可以一键完成从环境初始化到工作流导入的全部配置。\n\n## 核心特性\n\nZCF 针对 Claude Code 的配置包括以下核心能力：\n\n| 功能模块 | 说明 | 配置文件位置 |\n|---------|------|------------|\n| **API 配置** | 支持官方登录、API Key、CCR 代理三种模式 | `~/.claude/settings.json` |\n| **工作流系统** | 预置六阶段工作流、Feat 工作流、BMad 等 | `~/.claude/workflows/` |\n| **输出风格** | 多种 AI 个性化输出风格 | `~/.claude/prompts/output-style/` |\n| **MCP 服务** | 集成 Context7、Open Web Search 等 | `~/.claude/settings.json` |\n| **系统提示** | 全局 AI 记忆和指令配置 | `~/.claude/CLAUDE.md` |\n\n## 目录结构与备份\n\n### 自动创建的目录结构\n\n执行 `zcf init` 后，ZCF 会自动创建以下目录结构：\n\n```\n~/.claude/\n├── CLAUDE.md # 系统提示和 AI 记忆配置\n├── settings.json # Claude Code 主配置文件\n├── workflows/ # 工作流目录\n│ ├── zcf/\n│ │ ├── workflow.md # 六阶段工作流\n│ │ ├── feat.md # 功能开发工作流\n│ │ └── ...\n│ └── ...\n├── prompts/ # 提示词目录\n│ └── output-style/ # 输出风格模板\n└── backup/ # 配置备份目录\n └── YYYY-MM-DD_HH-mm-ss/\n```\n\n### 备份机制\n\nZCF 提供完善的备份机制，确保您的配置安全：\n\n- **自动备份**：每次修改配置时自动创建时间戳备份\n- **备份位置**：`~/.claude/backup/YYYY-MM-DD_HH-mm-ss/`\n- **备份内容**：包含所有配置文件、工作流和自定义设置\n- **兼容性**：兼容旧版 `~/.claude.json`、`.zcf-config.json` 等遗留文件\n\n> 💡 **恢复配置**：如果需要恢复之前的配置，可以从备份目录中复制相应文件。\n\n### 配置处理策略\n\n当检测到已有配置时，ZCF 提供多种处理策略：\n\n| 策略 | 说明 | 适用场景 |\n|------|------|---------|\n| **备份并覆盖** | 创建备份后覆盖现有配置 | 想要全新配置时 |\n| **合并配置** | 智能合并新旧配置 | 保留自定义内容时 |\n| **仅更新文档** | 只更新工作流和文档 | 只想更新模板时 |\n| **跳过** | 不进行任何更新 | 临时跳过某次更新 |\n\n## API 与模型管理\n\n### API 配置模式\n\nZCF 支持三种 API 配置模式：\n\n#### 1. 官方登录\n\n最简单的方式，无需配置 API Key：\n\n```\n? 选择 API 认证方式\n ❯ 使用官方登录\n```\n\n> ✅ **优点**：无需管理 API Key，使用官方认证系统\n\n#### 2. API Key 模式\n\n适合使用第三方 API 提供商：\n\n```bash\n# 使用提供商预设（推荐）\nnpx zcf i -s -p 302ai -k \"sk-xxx\"\n\n# 自定义 API 端点\nnpx zcf i -s -t api_key -k \"sk-xxx\" -u \"https://api.example.com\"\n```\n\n支持的提供商预设：\n- `302ai` - [302.AI](https://share.302.ai/gAT9VG) API 服务\n- `glm` - GLM（智谱AI）\n- `minimax` - MiniMax API 服务\n- `kimi` - Kimi（月之暗面）\n\n#### 3. CCR 代理模式\n\n通过 Claude Code Router 代理使用多个模型：\n\n```bash\nnpx zcf i -s -t ccr_proxy\n# 或先配置 CCR\nnpx zcf ccr\n```\n\n> 💡 **CCR 优势**：\n> - 支持免费模型接入（Gemini、DeepSeek）\n> - 成本优化（为不同任务选择合适模型）\n> - 灵活的路由规则配置\n\n### 模型配置\n\nZCF 支持配置多个模型：\n\n```bash\n# 配置主模型和快速模型\nnpx zcf i -s -p 302ai -k \"sk-xxx\" \\\n --api-model \"claude-sonnet-4-5\" \\\n --api-fast-model \"claude-haiku-4-5\"\n```\n\n- **主模型**：用于主要任务（如代码生成、复杂分析）\n- **快速模型**：用于快速任务（如代码补全、简单查询）\n\n### 多 API 配置\n\nZCF 支持配置多个 API，方便在不同场景下切换：\n\n```bash\nnpx zcf i -s --api-configs '[\n {\"provider\":\"302ai\",\"key\":\"sk-xxx\",\"default\":true},\n {\"provider\":\"glm\",\"key\":\"sk-yyy\"},\n {\"name\":\"custom\",\"type\":\"api_key\",\"key\":\"sk-zzz\",\"url\":\"https://custom.api.com\"}\n]'\n```\n\n> 📖 **切换配置**：使用 `npx zcf config-switch` 在多个配置之间切换。\n\n## 工作流系统\n\nZCF 提供丰富的工作流模板，帮助标准化开发流程。\n\n### 默认工作流\n\n| 工作流 | 命令 | 说明 |\n|--------|------|------|\n| **六阶段工作流** | `/zcf:workflow` | 完整的六阶段开发流程（研究→构思→计划→执行→优化→评审） |\n| **功能开发工作流** | `/zcf:feat` | 新功能设计与实现，包含规划和 UI/UX 设计 |\n| **通用工具** | `/init-project` | 项目初始化工具 |\n| **Git 工作流** | `/git-commit` 等 | Git 操作自动化命令 |\n| **BMad 工作流** | `/bmad-init` | 企业级敏捷开发流程 |\n\n### 工作流安装\n\n```bash\n# 安装所有工作流（默认）\nnpx zcf i -s --workflows all\n\n# 选择性安装\nnpx zcf i -s --workflows commonTools,sixStepsWorkflow,featPlanUx\n\n# 跳过工作流安装\nnpx zcf i -s --workflows skip\n```\n\n> 📚 **工作流详解**：详细使用说明请参考 [工作流详解](../workflows/) 章节。\n\n## 输出风格系统\n\nZCF 支持多种 AI 输出风格，个性化您的 AI 助手体验。\n\n### 可用的输出风格\n\n| 风格 ID | 名称 | 特点 |\n|---------|------|------|\n| `engineer-professional` | 工程师专业版 | 严格遵循 SOLID、KISS、DRY、YAGNI 原则 |\n| `nekomata-engineer` | 猫娘工程师 | 专业猫娘工程师幽浮喵，结合严谨工程技术与可爱猫娘特质 |\n| `laowang-engineer` | 老王暴躁技术流 | 暴脾气技术流，绝不容忍代码错误和不规范代码 |\n| `ojousama-engineer` | 大小姐工程师 | 傲娇蓝发双马尾大小姐程序员哈雷酱 |\n\n### 安装与使用\n\n```bash\n# 安装多个输出风格\nnpx zcf i -s --output-styles engineer-professional,nekomata-engineer\n\n# 设置默认输出风格\nnpx zcf i -s --default-output-style engineer-professional\n```\n\n### 项目级切换\n\n在 Claude Code 中，可以通过命令切换项目级的输出风格：\n\n```\n/output-style engineer-professional # 切换到专业工程师\n/output-style nekomata-engineer # 切换到猫娘工程师\n```\n\n> ⚠️ **版本要求**：Claude Code 版本需要大于 1.0.81 才支持 output-style，可使用 `npx zcf check-updates` 进行更新。\n\n## MCP 服务集成\n\nZCF 内置常用 MCP 服务配置，支持一键安装和管理。\n\n### 默认 MCP 服务列表\n\n| 服务 ID | 类型 | 说明 | 是否需要 API Key |\n|---------|------|------|-----------------|\n| `context7` | stdio | 上下文检索与库文档查询 | ❌ |\n| `open-websearch` | stdio | DuckDuckGo/Bing/Brave 搜索 | ❌ |\n| `spec-workflow` | stdio | Spec 工作流 MCP 服务 | ❌ |\n| `mcp-deepwiki` | stdio | DeepWiki 文档检索 | ❌ |\n| `Playwright` | stdio | Playwright 浏览器操作 | ❌ |\n| `exa` | stdio | Exa 网络搜索 | ✅ 需要 `EXA_API_KEY` |\n| `serena` | uvx | Serena IDE 助手 | ❌ |\n\n### MCP 服务配置\n\n```bash\n# 安装所有 MCP 服务（推荐）\nnpx zcf i -s --mcp-services all\n\n# 选择性安装\nnpx zcf i -s --mcp-services context7,open-websearch,spec-workflow\n\n# 跳过 MCP 服务安装\nnpx zcf i -s --mcp-services skip\n```\n\n### 配置位置\n\n- **Claude Code**：`~/.claude/settings.json` 中的 `mcpServers`\n- **Windows 特殊处理**：ZCF 会自动修正 Windows 路径格式\n\n### 重新配置\n\n如果需要重新配置 MCP 服务：\n\n```bash\nnpx zcf\n# 选择 4. 配置 MCP\n```\n\n## 其他能力\n\n### CCometixLine 状态栏\n\nCCometixLine 是一个基于 Rust 的高性能状态栏工具：\n\n- **实时用量追踪**：实时监控 Claude Code API 使用情况\n- **Git 集成**：显示 Git 状态和分支信息\n- **性能优化**：资源消耗极低\n\n```bash\n# 安装 CCometixLine（默认启用）\nnpx zcf i -s --install-cometix-line true\n\n# 通过菜单安装\nnpx zcf → 选择 L\n```\n\n### 环境变量与权限\n\nZCF 可以导入推荐的环境变量和权限配置：\n\n```bash\nnpx zcf\n# 选择 7. 导入推荐环境变量和权限配置\n```\n\n这包括：\n- 隐私保护环境变量\n- 系统权限配置模板\n- 安全相关设置\n\n## 配置复用与更新\n\n### 保存配置偏好\n\n所有配置选择会写入 `~/.ufomiao/zcf/config.toml`，包括：\n- 语言偏好\n- 默认工具类型\n- 最近安装选项\n\n### 增量更新\n\n使用 `zcf update` 可以更新工作流和模板，同时保留现有配置：\n\n```bash\n# 更新工作流和模板，保留 API 和 MCP 配置\nnpx zcf update\n\n# 指定语言更新\nnpx zcf update -g zh-CN\n```\n\n> 💡 **最佳实践**：\n> - 首次使用 `zcf init` 完成完整初始化\n> - 后续使用 `zcf update` 更新工作流和模板\n> - 通过菜单选项单独更新特定配置\n\n## 下一步\n\n了解更多 Claude Code 相关功能：\n\n- 📚 [工作流详解](../workflows/) - 了解各种工作流的使用\n- 🔧 [配置管理](../advanced/configuration.md) - 深入学习配置管理\n- 🎯 [MCP 服务集成](mcp.md) - 详细了解 MCP 服务\n- 🚀 [CCR 代理](ccr.md) - 了解 CCR 代理配置\n"}}}} |