Skip to main content
Forge 采用一棵树，三个入口的设计：插件清单、加固过的安装脚本 和 npm 的 bin 全都指向同一份 global/ + source/ 树。 选一个适合你工具的通道。

​
选择一个通道

Plugin（推荐）

面向 Claude Code 和 Codex。护栏自动接通；无需手动合并。

npm 全局

面向任何工具。从公共 npm 注册表获取 forge CLI。

github: 安装

不需要注册表 —— 直接从仓库安装。

贡献者 / 本地开发

克隆 + npm link，或者用 bash install.sh 走软链接方案。

​
环境要求

  • Node.js >= 20
  • 零运行时依赖 —— 一切都是 Node 内置。可选层 （FORGE_EMBED 向量嵌入、uicheck visual 用的 Playwright）是按需开启，不会加进 必需依赖。

​
插件市场

对 Claude Code 和 Codex 推荐这条路径，不需要 token 也不需要克隆：
插件通过 ${CLAUDE_PROJECT_DIR} 把护栏接通，所以动作前门和 完成门在后台就会触发。

​
npm 全局

面向任何工具，来自公共 npm：

​
不走注册表的 github: 安装

​
贡献者 / 本地开发

安装脚本经过加固：幂等、基于软链接、带备份，没有 curl | sh。

​
验证

不管你用了哪个通道，都可以确认安装状态：
forge doctor 也会为 git 克隆版本给出一条不烦人的”落后上游多少提交”的提示。 设置 FORGE_NO_UPDATE_CHECK=1 可以让它安静下来。所有路径都是 fail-open —— 离线或 detached HEAD 都会报告”unknown”，永远不会报错。

​
保持 Forge 最新

现在去配置一个仓库

去快速开始，运行 forge init 和你的第一次基底检查。