跳转到主要内容
Forge 遵循一棵树,三扇前门的设计:插件清单、加固过的安装器和 npm 二进制都引用同一棵 global/ + source/ 树。选择适合你工具的通道即可。

​
选择一个通道

插件(推荐)

适用于 Claude Code 和 Codex。护栏自动接线;无需合并任何东西。

npm 全局

适用于任何工具。从公开 npm registry 安装的 forge CLI。

github: 安装

不需要 registry——直接从仓库安装。

贡献者 / 本地开发

克隆 + npm link,或运行 bash install.sh 使用 symlink 方案。

​
系统要求

  • Node.js >= 20
  • 零运行时依赖——一切都用 Node 内置模块。可选层(FORGE_EMBED 嵌入、uicheck visual 所需的 Playwright)是可选的,不引入必需依赖。

​
插件市场

给 Claude Code 和 Codex 用的推荐路径,不需要 token 也不需要克隆:
插件通过 ${CLAUDE_PROJECT_DIR} 接线护栏,让行动前关卡和完成关卡在后台自动生效。

​
npm 全局安装

任何工具都能用,来自公开 npm:

​
免注册表的 github: 安装

​
贡献者 / 本地开发

安装器是加固过的:幂等、基于 symlink、有备份、且不使用 curl | sh。

​
验证

不论你走了哪个通道,都要确认安装成功:
forge doctor 还会对 git checkout 用户显示一条不烦人的“落后上游 N 个 commit”提示。设置 FORGE_NO_UPDATE_CHECK=1 可将其静默。所有路径都是 fail-open——离线或 detached HEAD 会报告 “unknown”,绝不会报错。

​
保持 Forge 最新

现在去配置一个仓库

前往快速开始,运行 forge init 与第一次基座检查。