Greywall 智能编码沙箱

这个 Agent 能做什么，适合哪些场景？

Greywall 是面向 Linux 和 macOS 的命令行沙箱，可在本机运行 AI 编码代理及其他命令，无需容器。默认的 greywall 模式按拒绝优先策略限制文件、网络和系统调用；greywatch 则提供默认允许的观测模式，并将网络请求记录到 GreyProxy 仪表板。Linux 上使用 bubblewrap、Landlock、Seccomp BPF、eBPF 监控和 TUN 网络捕获等机制，macOS 上使用 Seatbelt。用户可通过内置代理配置文件、JSON 设置和命令行选项控制访问，也可用学习模式跟踪文件访问并生成配置。它作为本地 CLI 部署，也可作为 Go 包使用。

用户通过 greywall -- <command> 启动命令，Greywall 根据所选配置限制工作目录以外的文件访问、网络连接和系统调用，并可阻止配置中的危险命令。内置代理配置文件可为 Claude Code、Codex、Cursor 等工具及多种语言工具链授予所需访问；--profile 可组合配置文件，--allow-path 和 --allow-read-path 可为单次运行额外开放路径。网络连接经 GreyProxy 转发；在 greywatch 或 --watch 模式下，网络请求被允许并记录，文件系统策略也变为宽松。--learning 跟踪文件访问并生成最小权限配置文件；用户还可通过 -m 监控沙箱违规。配置可从 ~/.config/greywall/greywall.json 或 macOS 的应用支持目录读取。

1. 希望在本机运行 Claude Code、Codex 或 Cursor，并限制其访问 SSH 密钥和工作目录之外文件的开发者。
2. 想先了解某个编码代理会访问哪些文件和网络目标，再决定限制范围的工程师，可用 greywatch 观察并查看 GreyProxy 仪表板。
3. 需要为代理和语言工具链分别设置文件权限的团队，可组合内置代理与工具链配置文件。
4. 希望从实际文件访问记录生成最小权限配置的开发者，可使用 --learning 跟踪命令。
5. 需要在 Linux 或 macOS 上对命令执行设置本地访问边界、且不希望依赖 Docker 的工程团队。

如何安装或部署这个 Agent？

macOS 可通过 Homebrew 安装，Linux 和 Mac 也可运行安装脚本。Linux 需要 bubblewrap 和 socat；xdg-dbus-proxy 与 libsecret-tools 是可选依赖。Homebrew 和安装脚本会安装 GreyProxy 作为依赖；使用其他方式时，README 也将 GreyProxy 列为网络代理组件。安装后可用 greywall check 检查依赖和状态。

brew tap greyhavenhq/tap
brew install greywall

curl -fsSL https://raw.githubusercontent.com/GreyhavenHQ/greywall/main/install.sh | sh

greywall check

如何使用这个 Agent？

用 greywall -- <command> 运行受限命令；可用代理配置文件或学习模式调整访问范围。以下示例分别启动 Claude、观察其行为，以及跟踪 OpenCode 的文件访问。

greywall -- claude
greywatch -- claude
greywall --learning -- opencode

可通过 --profile 组合代理和工具链配置文件，并将额外设置保存在 JSON 配置文件中。

greywall --profile claude,python -- claude

{
  "network": {
    "proxyUrl": "socks5://localhost:1080",
    "dnsAddr": "localhost:5353"
  },
  "filesystem": {
    "defaultDenyRead": true,
    "allowRead": ["~/.config/myapp"],
    "allowWrite": ["."],
    "denyWrite": ["~/.ssh/**"],
    "denyRead": ["~/.ssh/id_*", ".env"]
  },
  "command": {
    "deny": ["git push", "npm publish"]
  }
}

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题