npx -y cc-safety-net@latest install --codex。它会添加 cc-marketplace 市场,并安装 cc-safety-net@cc-marketplace 插件。然后在 Codex 的 /hooks 菜单中信任该 hook,因为在你信任它之前,Codex 不会运行它。
在 Codex 中安装 CC Safety Net
1
运行安装程序
2
信任 hook
启动 Codex,打开
/hooks,选择 cc-safety-net PreToolUse hook,然后按 t 信任它。3
确认插件已生效
doctor 输出中 Codex 一行显示 Detected 和 Configured。
Codex 安装会改动什么
安装程序从kenryu42/cc-marketplace 添加 cc-marketplace 市场,并安装 cc-safety-net@cc-marketplace 插件。
该插件还附带 /cc-safety-net 技能。
Codex hook 检查什么
插件的 hook 在 Codex 的PreToolUse 事件上运行 cc-safety-net hook --codex(短选项 -cx)。
Codex 的覆盖限制
- 输入的文本。 命令打开 shell 会话时,Codex 会发送
PreToolUse事件,但write_stdin不会触发该事件。因此 CC Safety Net 只检查打开会话的那条命令。模型之后向运行中的会话输入的文本会未经检查直达 shell,也不会留下审计记录。这个缺口只有 Codex 能修补。 - 工作目录。 Codex 在调用的
workdir中运行命令,但不会把workdir发送给 hook。CC Safety Net 只能改用当前轮次的工作目录分析命令,于是相对路径以及涉及工作目录外路径的规则,都会以错误的目录为基准解析。这可能会阻止一条安全的命令,也可能放行一条规则本应阻止的命令。
Codex 检查失败时会怎样
Codex 的 hook 是 fail open 的。hook 崩溃、超时(默认 600 秒)、无法启动或输出无效时,Codex 会把这次 hook 运行标记为失败,并照常执行工具调用。CC Safety Net 自己捕获的错误仍会阻止调用,因为此时 hook 会输出拒绝。从 Codex 卸载 CC Safety Net
Codex 故障排除
-
Codex 一行显示
Not configured。 插件已安装但未启用,请在 Codex 中启用它。显示Not detected则表示插件未安装。 -
doctor输出信任提醒。 只要 Codex 一行显示Configured,doctor每次运行都会输出这条提醒,因为它无法检查信任状态。这并不表示缺少信任,也不会改变退出码。