SuperAPI AI 工具集

claude-code-config-trailofbits

安全与审计

查看项目

更新于 10-16 11:36

技能介绍

用途

本技能提供 Trail of Bits 对 Claude Code 的一套「有主见」的配置方案,覆盖沙箱、权限拒绝规则、生命周期钩子、状态栏、全局 CLAUDE.md 以及推荐工具,帮助用户按该组织的默认设置安装并配置 Claude Code,以实现安全、高吞吐的 AI 辅助开发。

主要能力

  • 隐私优先设置:禁用遥测(DISABLE_TELEMETRY)、错误上报(DISABLE_ERROR_REPORTING)和反馈调查(CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY)。
  • 安全加固:权限拒绝规则阻止读取 SSH 密钥、GPG、云凭据(AWS/Azure/Kube/Docker)、npm/pypi/gem 凭据、git 凭据、gh 配置、钥匙串及浏览器登录数据与 Cookie;同时阻止编辑 ~/.bashrc、~/.zshrc、~/.bash_profile、~/.zprofile。
  • 生命周期钩子:PreToolUse 钩子拦截 rm -rf(提示改用 trash)和直接向 main/master 推送(提示使用分支和 PR);PostToolUse 和 Stop 钩子也可用于注入上下文或完成前检查。
  • 状态栏:两行终端状态栏,显示模型、当前目录、Git 分支、上下文用量、费用、耗时和缓存命中率。
  • 全局 CLAUDE.md:包含开发哲学、代码质量硬性限制(函数长度 50 行、圈复杂度 10、行宽 100、参数 5、嵌套深度 4)以及 Python、Node/TypeScript、Rust、Bash 的语言工具链约定。
  • 沙箱指南:内置 /sandbox、devcontainer 和远程 droplet 三种方案。
  • 推荐工具:Ghostty 终端、ruff、ast-grep、oxlint、cargo-deny 等。

使用方式

前置条件:安装 Ghostty(macOS 可用 brew install --cask ghostty)及核心工具(jq、ripgrep、fd、ast-grep、shellcheck、shfmt、actionlint、zizmor、macos-trash、node@22、pnpm、uv、ruff、ty、pip-audit、Rust 工具链、prek、worktrunk、cargo-deny、cargo-careful、oxlint、agent-browser)。

克隆并运行安装:

git clone https://github.com/trailofbits/claude-code-config.git
cd claude-code-config
claude

在 Claude Code 会话中运行 /trailofbits:config,会引导逐项安装、检测已有配置并自安装该命令。也可手动复制 settings.json 到 ~/.claude/settings.json、复制 CLAUDE.md 模板、状态栏脚本并添加别名。

沙箱可选:启用内置 /sandbox(文件系统与网络隔离,macOS 用 Seatbelt、Linux 用 bubblewrap);或使用 devcontainer 实现完整读写隔离;或使用 dropkit 创建远程 droplet 实现整机隔离。

别名示例:alias claude-yolo="claude --dangerously-skip-permissions";本地模型可配置 claude-local 函数指向 LM Studio。

命令包括:/trailofbits:config、/sandbox、/thinking、/insights、/terminal-setup。

技能可通过克隆 Trail of Bits 的 skills 仓库到 ~/.claude/skills 自动加载;MCP 服务器建议将 enableAllProjectMcpServers 设为 false,仅安装可信服务器。

适用场景

  • 安全审计工作流:创建隔离 droplet、克隆目标仓库、编写项目 CLAUDE.md、以 bypass 模式加沙箱运行。
  • Python 库开发:使用 devcontainer,配合 uv、ruff、ty、pytest。
  • Rust CLI 工具:使用 clap、anyhow、tokio,并通过 cargo deny 与 cargo careful 检查。

限制与注意事项

  • 拒绝规则只拦截 Claude 内置工具,需在操作系统层面强制隔离时应启用 /sandbox。
  • 钩子语法错误可能阻断所有 Bash 命令,部署前应测试。
  • 状态栏依赖 jq。
  • 具体收费、价格、平台或效果资料暂未提供。