将 Claude Code 转变为完整的开发环境

快速入门 • 开发工作流 • Claude Forge 包含什么 • 安装指南 • 架构 • 自定义 • 韩语

Claude Forge 是什么？

Claude Forge 是一个面向 Claude Code 的开源开发环境，提供了 11 个专用代理、40 条斜杠命令、15 种技能工作流以及 15 个自动化钩子。它常被形容为“Claude Code 的 oh-my-zsh”，能够将 Claude Code 从一个基础的命令行界面转变为功能齐全的开发环境。只需一次安装，你就能获得代理、命令、技能、钩子以及 9 个规则文件——全部预先配置好，开箱即用。

可以把它想象成 Claude Code 的 oh-my-zsh：就像 oh-my-zsh 能够增强你的终端体验一样，Claude Forge 也能大幅提升你的 AI 编程助手的功能。

⚡ 快速入门

作为插件安装（推荐）

Claude Forge 已在 Anthropic 官方插件市场 上架，可以直接从 Claude Code 中安装：

# 方案 A：从官方市场安装（待审核通过后）
/plugin install claude-forge@claude-plugins-official

# 方案 B：从 Claude Forge 市场安装
/plugin marketplace add sangrokjung/claude-forge
/plugin install claude-forge@claude-forge

# 方案 C：直接从 GitHub 安装
claude plugin install github:sangrokjung/claude-forge

更新时：

/plugin marketplace update claude-forge

注意：Claude Forge 已提交至 Anthropic 官方插件目录，目前正处于审核中。在此期间，请使用上述方案 B 或 C。

通过 Git 克隆安装

若需进行开发或自定义，可克隆仓库：

# 1. 克隆
git clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git
cd claude-forge

# 2. 安装（创建到 ~/.claude 的符号链接）
./install.sh

# 3. 启动 Claude Code
claude

install.sh 会将所有内容符号链接到 ~/.claude/ 目录下，因此执行 git pull 即可即时更新。

如果你觉得 Claude Forge 很有用，请考虑给它点个 星标——这有助于更多人发现这个项目。

v2.2 新增内容

刚接触 Claude Forge？

如果你是开发新手或刚接触 Claude Code，可以从以下步骤开始：

或者直接输入 /auto login page，让 Claude Forge 为你处理从计划到 PR 提交的完整流程。

🔄 开发工作流

将命令、代理和技能串联起来的真实世界工作流。

功能开发

采用先规划、再测试的方法构建新功能：

/plan → /tdd → /code-review → /handoff-verify → /commit-push-pr → /sync

graph LR
    P["/plan<br><small>设计与风险分析</small>"] --> T["/tdd<br><small>先写测试，再写代码</small>"]
    T --> CR["/code-review<br><small>质量与安全检查</small>"]
    CR --> HV["/handoff-verify<br><small>全新上下文验证</small>"]
    HV --> CPR["/commit-push-pr<br><small>提交、推送、创建PR并合并</small>"]
    CPR --> S["/sync<br><small>同步项目文档</small>"]

    style P fill:#533483,stroke:#fff,color:#fff
    style T fill:#0f3460,stroke:#fff,color:#fff
    style CR fill:#0f3460,stroke:#fff,color:#fff
    style HV fill:#e94560,stroke:#fff,color:#fff
    style CPR fill:#1a1a2e,stroke:#fff,color:#fff
    style S fill:#16213e,stroke:#fff,color:#fff

Bug修复

通过自动重试实现快速的Bug修复流程：

/explore → /tdd → /verify-loop → /quick-commit → /sync

安全审计

结合CWE和STRIDE进行全面的安全分析：

/security-review → /stride-analysis-patterns → /security-compliance

团队协作

针对复杂任务的多代理并行执行：

/orchestrate → Agent Teams (并行工作) → /commit-push-pr

为什么选择Claude Forge？

大多数开发者要么不加任何定制就使用Claude Code，要么花费数小时手动配置各个插件。而Claude Forge只需5分钟即可为您提供生产就绪的环境。

📦 Claude Forge包含哪些内容？

📥 Claude Forge安装指南

前置条件

macOS / Linux

git clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git
cd claude-forge
./install.sh

安装程序：

1. 检查依赖项（Node.js、Git、jq）
2. 初始化Git子模块（CC CHIPS状态栏）
3. 如果存在，则备份现有的~/.claude/
4. 为7个目录及settings.json创建指向~/.claude/的符号链接
5. 应用CC CHIPS自定义覆盖层
6. 可选地安装MCP服务器和外部技能
7. 添加Shell别名（cc → claude，ccr → claude --resume）

由于使用符号链接，因此在仓库中执行git pull即可立即更新所有内容。

Windows

# 以管理员身份运行PowerShell
.\install.ps1

Windows使用文件副本而非符号链接。在执行git pull后，请重新运行install.ps1以更新。

MCP服务器设置

自定义

无需修改受版本控制的文件即可覆盖设置：

cp setup/settings.local.template.json ~/.claude/settings.local.json
vim ~/.claude/settings.local.json

settings.local.json会自动与settings.json合并。

🏗 Claude Forge 架构

graph TB
    subgraph REPO["claude-forge (git 仓库)"]
        A["agents/ (11)"]
        C["commands/ (40)"]
        S["skills/ (15)"]
        H["hooks/ (15)"]
        R["rules/ (9)"]
        SC["scripts/"]
        CC["cc-chips/"]
        K["knowledge/"]
        REF["reference/"]
        SET["settings.json"]
    end

    INSTALL["./install.sh"]
    REPO --> INSTALL

    subgraph HOME["~/.claude/ (符号链接)"]
        HA["agents/"]
        HC["commands/"]
        HS["skills/"]
        HH["hooks/"]
        HR["rules/"]
        HSC["scripts/"]
        HCC["cc-chips/"]
        HSET["settings.json"]
    end

    INSTALL -->|符号链接| HOME

    CLAUDE["claude (CLI)"]
    HOME --> CLAUDE

    style REPO fill:#1a1a2e,stroke:#e94560,color:#fff
    style HOME fill:#0f3460,stroke:#16213e,color:#fff
    style INSTALL fill:#e94560,stroke:#fff,color:#fff
    style CLAUDE fill:#533483,stroke:#fff,color:#fff

claude-forge/
  ├── agents/               代理定义 (11 个 .md 文件)
  ├── cc-chips/             状态栏子模块
  ├── cc-chips-custom/      自定义状态栏叠加层
  ├── commands/             斜杠命令 (32 个 .md + 8 个技能目录)
  ├── docs/                 截图、示意图
  ├── hooks/                事件驱动的 Shell 脚本 (15 个)
  ├── knowledge/            知识库条目
  ├── reference/            参考文档
  ├── rules/                自动加载的规则文件 (9 个)
  ├── scripts/              实用脚本
  ├── setup/                安装指南 + 模板
  ├── skills/               多步骤技能流程 (15 个)
  ├── install.sh            macOS/Linux 安装程序 (符号链接)
  ├── install.ps1           Windows 安装程序 (复制)
  ├── mcp-servers.json      MCP 服务器配置
  ├── settings.json         Claude Code 设置
  ├── CONTRIBUTING.md       贡献指南
  ├── SECURITY.md           安全策略
  └── LICENSE               MIT 许可证

🔀 代理路由系统

代理路由是一个强制委托系统，它确保由专门的代理处理其领域的任务，而不是让 Claude 直接处理所有事情。如果没有这个系统，Claude 默认会自行处理所有任务——即使有专门的代理能够产生更好的结果。

工作原理

graph LR
    U["用户消息"] --> SP["using-superpowers<br><small>1% 规则：必须检查技能</small>"]
    SP --> AR["agent-router<br><small>领域匹配检查</small>"]
    AR -->|"匹配找到"| A["Agent Tool<br><small>启动专家代理</small>"]
    AR -->|"未匹配"| D["直接响应"]
    A --> R["专家代理结果"]

    style U fill:#1a1a2e,stroke:#fff,color:#fff
    style SP fill:#e94560,stroke:#fff,color:#fff
    style AR fill:#533483,stroke:#fff,color:#fff
    style A fill:#0f3460,stroke:#fff,color:#fff
    style D fill:#16213e,stroke:#fff,color:#fff
    style R fill:#0f3460,stroke:#fff,color:#fff

强制链条

路由表（33 个代理）

团队子代理（ad-compass、ad-scout-google、ad-scout-meta、action-architect、folder-hunter、mail-scout）由其父团队代理管理，不会直接被路由。

防止递归保护

using-superpowers 和 agent-router 都包含 <SUBAGENT-STOP> 保护措施，以防止在代理已经运行于子代理上下文中时发生无限递归。

自定义

编辑 commands/agent-router.md，将您自己的代理添加到路由表中：

| 我的自定义关键词 | 我的自定义代理 |

路由器会自动将匹配的请求委派给您的代理。

🛡 Claude Code 自动化钩子

安全钩子

实用钩子

🤖 Claude 代码代理

每个代理在 UI 中都有一个 颜色，以便快速视觉识别：

Opus 代理（6 个）——深度分析与规划

Sonnet 代理（5 个）——快速执行与自动化

颜色语义

📋 所有 Claude Forge 命令

🧩 所有 Claude Forge 技能

常见问题解答

🤝 贡献

请参阅 CONTRIBUTING.md，了解如何添加代理、命令、技能和钩子的指南。

使用 Claude Forge？展示一下吧！

[![由 Claude Forge 构建](https://img.shields.io/badge/Built_with-Claude_Forge-orange?style=flat-square)](https://github.com/sangrokjung/claude-forge)

将此徽章添加到你的项目 README 中，让其他人知道你正在使用 Claude Forge。

贡献者

📄 许可证

MIT——你可以自由使用、分叉或在此基础上进行开发。

如果 Claude Forge 改善了你的工作流程，给它一颗星（star）可以帮助更多人发现它。

_{由 QJC（量子跃迁俱乐部） 用心打造}

Claude Forge 快速上手指南

Claude Forge 是一个专为 Claude Code 打造的开源开发环境增强工具。它被誉为"Claude Code 的 oh-my-zsh"，通过预置的 11 个智能体（Agents）、40 个斜杠命令、15 个技能工作流和自动化钩子，将基础的 CLI 升级为全功能的生产级开发环境。

1. 环境准备

在开始之前，请确保您的系统满足以下要求：

注意：如果您尚未安装 Claude Code CLI，请先前往官方渠道完成安装。

2. 安装步骤

您可以选择以下两种方式之一进行安装。推荐使用 插件方式（最简单），若需深度定制或开发则使用 Git 克隆方式。

方式 A：作为插件安装（推荐）

直接在 Claude Code 中运行以下命令即可安装。由于官方市场审核可能需要时间，建议优先使用 GitHub 源安装：

# 直接从 GitHub 安装（最快生效）
claude plugin install github:sangrokjung/claude-forge

更新插件命令：

/plugin marketplace update claude-forge

方式 B：通过 Git 克隆安装（适合开发者）

此方式通过软链接将配置映射到本地，便于通过 git pull 实时更新。

macOS / Linux:

# 1. 克隆仓库（包含子模块）
git clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git
cd claude-forge

# 2. 运行安装脚本（自动创建 ~/.claude 的软链接）
./install.sh

# 3. 启动 Claude Code
claude

Windows (PowerShell):

# 以管理员身份运行 PowerShell
.\install.ps1

注意：Windows 版本使用文件复制而非软链接，更新时需重新运行 install.ps1。

3. 基本使用

安装完成后，重启终端或运行 claude 进入交互界面。

🚀 新手入门

输入以下命令开启交互式引导（约 3 分钟）：

/guide

⚡ 核心工作流示例

Claude Forge 的核心优势在于将复杂的开发流程简化为单个命令。

场景 1：从零开发一个新功能 (Plan-to-PR) 只需一条命令，AI 将自动执行规划、测试驱动开发 (TDD)、代码审查、验证并提交 PR：

/auto login page

(上述命令将自动处理从需求分析到生成 Pull Request 的全流程)

场景 2：手动分步执行标准开发流 如果您希望控制每个环节，可以按顺序执行：

/plan              # 生成实施计划并等待确认
/tdd               # 先写测试，再写代码
/code-review       # 进行质量和安全检查
/handoff-verify    # 自动验证构建、测试和 lint
/commit-push-pr    # 提交、推送并创建 PR

场景 3：快速修复 Bug

/explore           # 定位 bug 位置
/tdd               # 编写复现测试并修复
/verify-loop       # 自动重试构建/测试（最多 3 次）
/quick-commit      # 快速提交修复

💡 常用命令速查

• /orchestrate: 启动多智能体并行协作模式。
• /security-review: 执行 CWE 和 STRIDE 安全审计。
• /sync: 同步项目文档（如 prompt_plan.md, CLAUDE.md 等）。

现在，您已拥有了一套生产级的 AI 开发环境，可以尝试输入 /auto <您的任务> 开始体验了。