Agent Safehouse命令选项完全指南20个--enable开关逐一讲透【免费下载链接】agent-safehouseSandbox your local AI agents so they can read/write only what they need项目地址: https://gitcode.com/gh_mirrors/ag/agent-safehouseAgent Safehouse 是一款面向 macOS 的 AI 编程代理沙箱工具用原生sandbox-exec和可组合的策略档案让 Claude、Codex、Gemini 等本地 AI 代理只能读写它们真正需要的文件。它的核心配置入口就是--enable命令选项——通过一组功能开关按需解锁浏览器、Docker、Keychain、GPU 等集成能力。本文把这些--enable开关按场景逐一讲透帮你用最少权限跑满最强能力。一、为什么需要 --enable 开关Agent Safehouse 遵循「拒绝优先」deny-first的默认假设默认只授予工作目录读写、~/.config、~/.cache等窄范围权限一切额外能力浏览器、麦克风、云凭证……都必须显式开启完整的选项说明见 docs/docs/options.md。--enable就是这套最小权限模型的「总闸」不开就是关开了才把对应的策略档案混入最终生成的沙箱策略。可选功能档案统一放在 profiles/55-integrations-optional/每个.sb文件对应一个开关解析逻辑在 bin/lib/policy/selection.sh 中实现。二、三种写法逗号分隔、可重复、可持久化开关的解析与合并逻辑见 bin/lib/policy/request.sh# 逗号分隔一次开多个 safehouse --enabledocker,kubectl -- kubectl get pods -A # 开关可重复 safehouse --enablessh --enablegpg -- codex还可以写进工作目录的.safehouse配置文件需配合--trust-workdir-config格式见 docs/docs/options.mdenabledocker,shell-init三、开发调试类开关1. lldb本地原生调试器--enablelldb为 LLDB 打开沙箱侧许可适合让代理驱动原生调试。注意 macOS 仍可能拒绝附加到受保护的目标进程。2. xcode完整 Xcode 开发环境解锁 Xcode 开发者根目录、DerivedData与CoreSimulator状态配合xcodebuild使用。它不包含调试器 task-port 权限——真要用调试器请另开lldb。3. gpgGPG 提交签名先在沙箱外启动代理进程沙箱内的git即可签名提交gpgconf --launch gpg-agent gpgconf --launch keyboxd safehouse --enablegpg -- git commit -S -m signed4. sshSSH 访问放行 SSH 相关路径便于代理访问 Git 远端。5. process-control宿主机进程枚举与信号允许进程枚举/信号发送主要用于本地调试场景权限较大按需开启。6. shell-init读取 Shell 启动文件让运行时能读取.zshrc、.bashrc等启动配置。⚠️ 开启前请先审计这些文件代理可能继承其中导出的凭证与 token。四、桌面与 GUI 类开关7. macos-gui桌面 GUI 权限为需要与桌面交互的代理流程提供基础 GUI 放行。8. electronElectron 应用支持自动隐含gpu与macos-gui用于跑 Electron 宿主的应用内代理工作流。9. gpuMetal 与 GPU IOKit 权限授予 Metal 着色器编译MTLCompilerService与 GPU IOKit 用户客户端适合纯 GPU/Metal 工作负载。electron和chromium-headless都会传递性地拉入它。10. launch-servicesopen -b 应用启动允许沙箱内进程调用open -b复用已运行的应用例如复用已在运行的 VS Code 做 Claude 的外部编辑器交接。由于它可以启动沙箱外任意应用请谨慎开启。11. vscode冷启动独立 VS Code没有vscode开关时只能复用已运行的 VS Code开启后 Safehouse 可以冷启动一个隔离的 VS Code 编辑器窗口处理 Claude 的临时 prompt 文件不继承你的扩展与最近列表。若已设置EDITOR/VISUAL则不会注入。12. spotlight / clipboard / microphone / cleanshotspotlightSpotlight 索引访问clipboard剪贴板读写microphone麦克风权限cleanshotCleanShot 媒体目录访问。均为细粒度开关按需单独开启即可。五、浏览器类开关注意依赖链13. agent-browser代理浏览器自动化为浏览器自动化代理流程放行所需路径。14. chromium-headless / chromium-full / playwright-chrome三者存在清晰的隐含依赖链playwright-chrome ⇒ chromium-full ⇒ chromium-headless ⇒ gpu⚠️ 在 Safehouse 内运行 Chromium 家族进程时务必给浏览器自身传--no-sandbox否则会先撞上 Chromium 内层 Seatbelt 沙箱报错。15. browser-native-messaging浏览器原生消息通道放行 native messaging 清单与扩展检测不是浏览数据。六、凭证与云资源类开关16. keychain / 1password密码管理器访问keychain主要用于插件或辅助流程需要 macOS 钥匙串凭证的场景核心opencode不需要1password则放行 1Password 集成路径。17. cloud-credentials / cloud-storage云凭证与云存储分别放行云凭证文件与云存储同步目录让代理能配置并访问对象存储。七、基础设施类开关18. dockerDocker 套接字访问safehouse --enabledocker -- docker ps19. kubectlK8s 配置与 krew 路径放行kubectl配置、缓存及 krew 路径可直接执行集群命令。20. herdr本地调试面板集成允许宿主机进程枚举/信号交互以支持 herdr 调试当环境中检测到HERDR_ENV时还会自动启用并透传相关环境变量。八、三个「全家桶」开关开关作用all-agents启用 profiles/60-agents/ 下全部代理档案all-apps启用 profiles/65-apps/ 下全部 App 宿主档案wide-read在/上授予宽泛只读可见性这三者会短路常规的命令/应用匹配流程见 bin/lib/policy/selection.sh属于「最大便利」选项日常开发建议只开wide-read级别的只读放宽。九、新手快速上手清单默认运行即可享受最窄权限safehouse claude --dangerously-skip-permissions常用基础设施一次性配齐--enabledocker,kubectl需要写代码跑测试默认工具链/usr/bin/git、make、clang等不需要--enable已由默认档案覆盖浏览器自动化--enableplaywright-chrome一条搞定整条依赖链拿不准开什么跑一次会报Unknown feature in --enable并列出全部支持的开关清单等价于内置帮助更多示例见 docs/docs/usage.md十、延伸阅读完整命令选项表docs/docs/options.md使用模式与集成示例docs/docs/usage.md策略档案目录profiles/开关解析测试tests/surface/cli/enable-parsing.bats 记住原则开最少的开关给最窄的权限——这正是 Agent Safehouse 把 20 个功能拆成独立--enable开关的意义所在。【免费下载链接】agent-safehouseSandbox your local AI agents so they can read/write only what they need项目地址: https://gitcode.com/gh_mirrors/ag/agent-safehouse创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考