安装策略 - FailproofAI

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 中。