跳转到主要内容
failproofai policies --install [policy-names...] [options]
将钩子条目写入 Claude Code 的 settings.json,使 failproofai 能够拦截工具调用。 别名:failproofai p -i

选项

标志描述
--scope user安装到 ~/.claude/settings.json(默认 - 适用于所有会话)
--scope project安装到当前目录的 .claude/settings.json
--scope local安装到当前目录的 .claude/settings.local.json
--custom <path> / -c包含自定义钩子策略的 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
提供 --custom <path> 时,文件将立即被验证 - 它必须至少调用一次 customPolicies.add()。解析后的路径将以 customPoliciesPath 的形式保存到 policies-config.json 中。