npx -y cc-safety-net@latest install,然后从列表中选择你的编码智能体。安装程序会以插件、扩展或 hook 的形式,把 CC Safety Net 添加到你选中的每个智能体中。部分智能体随后需要重启或确认信任。运行 npx cc-safety-net doctor 确认保护已生效。
安装前须知
- 安装 Node.js 22 或更高版本。本页的命令都使用
npx。Node.js 18 和 20 已停止维护,不再受支持。 - 确认你的智能体在当前平台上受支持:
Amp 官方手册只列出 macOS、Linux 和 WSL,不包括原生 Windows。
使用交互式选择器安装
1
启动安装程序
2
选择智能体
按
Space 选择智能体,按 Enter 确认。其他按键见目标选择器按键。3
完成智能体自身的步骤
如果你的智能体需要重启或确认信任后 hook 才会运行,现在就完成这一步。为单个智能体安装中的“额外步骤”一列列出了这些步骤。
4
确认保护已生效
doctor 会检查每个受支持的智能体,并告诉你如何修复失败的项目。
安装命令中请保留 @latest。npx 会把下载的软件包保存在缓存中,不带版本的 cc-safety-net 可能会从缓存中重新运行旧副本,而不是当前发布版本。
为单个智能体安装
只为一个智能体安装时(例如在脚本中),请传入下表中该智能体的目标选项。每个智能体的页面会说明安装改动了什么、该智能体的 hook 检查什么,以及如何卸载。
安装命令可以放心重复运行。对已配置的智能体再次运行,最终只会保留一个托管条目。
更新 CC Safety Net
update 会刷新你机器上已安装的所有集成,但从不安装新的集成。它对每个智能体做了什么,见 update。
从 v1 或 2.2 及更早版本升级
- 从 v1 升级。 运行
update,把每个已安装的集成迁移到当前版本。如果你在 v1 的内联配置中定义了自定义规则,请完成旧配置迁移。然后运行npx cc-safety-net doctor,确认运行时为ready。 - 从 2.2 或更早版本升级,且使用了来自 GitHub 的 rulebook。 升级后,按范围各运行一次
rule sync,用户范围的来源需加上--global。运行之前,这些规则不会生效,status和doctor会把相应来源报告为 degraded。
卸载 CC Safety Net
运行安装程序的卸载选择器,或传入一个目标选项:全局安装 CLI
如果你经常使用 CLI,可以全局安装。全局安装会附带ccsn,它是同一组命令的短别名:
npx 运行时,仍使用完整的 cc-safety-net 名称。
从旧插件标识符迁移
早期版本中,Claude Code 和 Codex 使用的插件标识符是safety-net@cc-marketplace,GitHub Copilot CLI 使用的是 copilot-safety-net。运行对应智能体的常规安装命令就会删除旧插件,无需手动删除。新配置请使用当前标识符 cc-safety-net@cc-marketplace。