跳转到主要内容
failproofai policies --install [policy-names...] [options]
将 hook 条目写入已安装的 agent CLI 的配置文件（Claude Code、OpenAI Codex 或 GitHub Copilot CLI (beta)），以便 failproofai 拦截工具调用。 别名：failproofai p -i

​
选项

标志描述
--cli claude|codex|copilot要安装的 Agent CLI，用空格分隔（例如 --cli claude codex copilot）或重复指定。省略则自动检测已安装的 CLI 并提示选择。
--scope user安装到用户级别的配置文件（Claude：~/.claude/settings.json；Codex：~/.codex/hooks.json；Copilot：~/.copilot/hooks/failproofai.json）。默认值。
--scope project安装到项目级别的配置文件（Claude：<cwd>/.claude/settings.json；Codex：<cwd>/.codex/hooks.json；Copilot：<cwd>/.github/hooks/failproofai.json）。
--scope local仅限 Claude — 安装到 <cwd>/.claude/settings.local.json。Codex 和 Copilot 没有 local 作用域。
--custom <path> / -c包含自定义 hook 策略的 JS 文件路径

​
行为说明

  • 不指定策略名称 — 打开交互式提示以选择策略
  • 指定具体名称 — 启用对应策略（追加到已启用的策略中）
  • all — 启用所有可用策略
安装操作是累加的：再次运行 --install 会添加新策略，而不会移除已有策略。

​
示例

# 以交互方式全局安装所有默认策略
failproofai policies --install

# 为当前项目安装特定策略
failproofai policies --install block-sudo sanitize-api-keys --scope project

# 一次性启用所有策略
failproofai policies --install all

# 使用自定义策略文件进行安装
failproofai policies --install --custom ./my-policies.js

# 为 OpenAI Codex 安装（项目作用域）
failproofai policies --install --cli codex --scope project

# 为 GitHub Copilot CLI (beta) 安装到当前项目
failproofai policies --install --cli copilot --scope project

# 同时为三个 CLI 安装
failproofai policies --install --cli claude codex copilot
提供 --custom <path> 时，文件会立即经过验证 — 它必须至少调用一次 customPolicies.add()。解析后的路径将作为 customPoliciesPath 保存到 policies-config.json 中。