claude-forge
sangrokjung/claude-forge加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
Claude Code 是 Anthropic 官方推出的 AI 编程助手，它的上下文理解能力和代码生成质量在业界首屈一指。但用过的人都知道，当项目复杂度上升——多模块协作、架构重构、安全审计、端到端测试——单靠一个 Agent 往往力不从心，频繁切换指令、反复交代上下文令人疲惫。
sangrokjung/claude-forge 就是来解决这个问题的。它将 Claude Code 从一个"聪明的打字员"升级为一支"AI 开发团队"：11 个专业 Agent 各司其职，36 条命令开箱即用，15 个 Skill 覆盖日常开发场景，6 层安全 Hook 兜底风险边界。一行命令完成安装，5 分钟内把你的 Claude Code 打造成完整开发环境。
图1：Claude Forge Banner## 背景：从单 Agent 到 Multi-Agent 协作
Claude Forge 的作者 sangrokjung 是一名长期使用 Claude Code 的开发者，在 GitHub 上提交了大量 Claude Code 插件类项目。在实际使用中，他发现 Claude Code 在处理复杂任务时存在两个核心瓶颈：
上下文漂移（Context Drift）：当对话轮次超过 20+ 时，Agent 容易遗忘早期设定的架构约束，导致代码风格不一致或设计决策前后矛盾。
能力边界模糊：Claude Code 本身不区分"架构设计""安全审计""代码审查"等不同任务类型，一个 Agent 试图做所有事，容易在专业领域给出浅层答案。
Claude Forge 的解决思路借鉴了 oh-my-zsh 的插件框架哲学——不是重新发明轮子，而是通过标准化的扩展机制，让社区贡献的专业能力自由组合。项目在 2025 年初发布后迅速获得关注，2026 年 5 月发布 v3.0（对齐 Anthropic 2026 标准），目前 star 数接近 750，是 Claude Code 生态中最活跃的插件框架之一。## 类比：给 Claude Code 装上"瑞士军刀"
如果把 Claude Code 比作一把锋利的单刃刀，Claude Forge 就是它的全套配件盒：
| Claude Code（裸机） | Claude Forge（升级版） |
|---|---|
| 一个通用 Agent | 11 个专业 Agent 分工 |
| 手动调用工具 | 36 条命令一键触发 |
| 安全靠提醒 | 6 层 Hook 自动拦截 |
| 无上下文共享 | 知识库持久化记忆 |
| 基础 MCP 支持 | 4 个内置 MCP 服务器 |
简单来说，Claude Forge 让你拥有了一支 AI 开发团队，每个成员都是某个领域的专家，随时听候调遣。## 核心功能详解
Claude Forge 内置 11 个专业 Agent，每个 Agent 通过 YAML frontmatter 定义身份、能力边界和调用策略：
这些 Agent 使用 Claude 的 opus 模型（v3.0 起支持 maxTurns 限制对话长度，isolation: worktree 隔离 Git worktree 防止污染主分支），支持 memory: project 持久化项目上下文。
图2：Claude Forge Agent Teams 架构示意### 4.2 36 条命令（Commands）
Commands 是 Claude Forge 的另一核心组件，通过 / 前缀在 Claude Code 中直接调用。典型的命令包括：
/plan — 触发 planner agent 生成实施计划/code-review — 调用 code-reviewer 审查当前文件/e2e — 启动端到端测试流程/build-fix — 自动修复构建错误/orchestrate — 多 Agent 协作编排/checkpoint — 任务检查点保存与恢复/init-project — 初始化新项目结构/commit-push-pr — 一键提交、推送并创建 PR命令设计遵循"声明即执行"原则：用户无需关心内部调用细节，只需发出高层次的业务指令。
Skills 基于 Claude Code 原生 Skill 机制，补充了 15 个常用技能，覆盖从"写测试"到"生成 API 文档"的日常场景。
Claude Forge 的安全体系是其最具差异化的特性，通过 6 层 Hook 在不同阶段拦截风险操作：
{
"PreToolUse": [
{ "matcher": "Bash", "hooks": ["remote-command-guard.sh", "rate-limiter.sh"] }
],
"PostToolUse": ["mcp-usage-tracker.sh"]
}
关键 Hook 包括：
v3.0 将 Hook 事件从 5 个扩展到 21 个，覆盖 SessionEnd、SubagentStart、ConfigChange 等新事件。
Claude Forge v3.0 捆绑了 4 个经过验证的 MCP 服务器，通过 settings.json 的 enabledMcpjsonServers 字段启用：
图3：Claude Forge 功能网格## 上手门槛与使用方式
Claude Forge 提供两种安装路径：
方式 A（推荐/完整安装）：一行命令完成所有配置
curl -fsSL https://raw.githubusercontent.com/sangrokjung/claude-forge/main/install.sh | bash
安装内容：11 agents + 33 commands + 24 skills + 15 hooks + 9 rules + 4 MCP servers
方式 B（轻量/插件模式）：在 Claude Code 会话内运行
/plugin marketplace add sangrokjung/claude-forge
/plugin install claude-forge
仅安装插件层，不修改全局配置。
| 维度 | 评估 |
|---|---|
| 前置要求 | Claude Code >= 2.1.110 + Git + curl |
| 操作系统 | macOS（主要）、Linux（bash） |
| 硬件需求 | 无 GPU，1GB RAM 即可 |
| 学习曲线 | 中等（需了解 Agent 分工逻辑） |
| 卸载难度 | 低（支持 upgrade 模式保留 symlink） |
注意：目前对 Windows 原生支持较弱（install.ps1 功能有限），主要面向 macOS/Linux 用户。## 局限与争议
Claude Forge 在设计上做出了几个有意的权衡，了解这些限制有助于理性评估：
1. 模型成本：所有 Agent 默认使用 opus 模型，相比 sonnet 成本更高。v3.0 支持 maxTurns 限制来控制 Token 消耗，但用户需要主动配置。
2. Agent 协作复杂度：多 Agent 同时运行时的上下文竞争和消息路由，目前没有图形化界面可观察，调试依赖日志。
3. 安全性依赖社区维护：6 层 Hook 中部分依赖社区贡献的脚本，安全性取决于上游更新速度。SECURITY.md 文档存在但不够详尽。
4. 平台锁定：完全依赖 Claude Code，对使用 Copilot、Cursor 等其他工具的用户无直接价值。
5. 中文文档稀缺：README 已有韩语翻译，但中文社区资料较少，对国内用户有一定门槛。## 行业意义与趋势
Claude Forge 的出现代表了 AI 编程工具从"单 Agent 助手"向"Multi-Agent 协作平台"演进的趋势：
Multi-Agent 架构正在成为主流：AutoGPT、LangChain Agents、Microsoft Copilot Studio 等产品都在探索多 Agent 协作。Claude Forge 的独特之处在于它基于 Claude Code 这一成熟产品，用"插件"而非"新建系统"的方式实现扩展，降低了迁移成本。
开发者工具的"oh-my-zsh 时刻"：Claude Code 的插件生态正在复制当年 Zsh 的成功路径——核心工具足够好，社区通过标准化扩展机制贡献能力。Claude Forge 是这个生态中目前最完善的插件框架。
安全左移的新范式：传统安全审计在 CI/CD 阶段进行，而 Claude Forge 将安全 Hook 内置到开发者的每次交互中，实现"边写边审"，这是传统静态分析工具无法做到的体验。
图4：Claude Forge 整体架构
总结：Claude Forge 是一个高度工程化的 Claude Code 插件框架，通过 11 个专业 Agent、36 条命令、6 层安全 Hook 构建了一个 AI 开发团队。它适合已深度使用 Claude Code、追求工程化开发体验的团队。安装门槛低（5 分钟）、无硬件要求，但需要一定的 Agent 协作理解成本。随着 Claude Code 生态的发展，Claude Forge 有望成为该平台最具影响力的插件之一。