Agent Skills
返回列表
🤖

沙箱内运行编码代理

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/run-coding-agents-in-a-locked-down-local-sandbox-with-repo-only-filesystem-access-and-controlled-egress-using-agent-sandbox。

技能介绍

直接在宿主机运行编码 Agent 的风险

当你把 Claude Code、Codex 或其他支持的编码 CLI 工具直接跑在开发机上时，它们实际上拥有对宿主文件系统的完全控制权，并能自由发起任意网络请求。这意味着一个逻辑错误的脚本或一次错误的自动格式化，不仅可能破坏本地的关键项目文件，还可能因为误访问 ~/.ssh 或 .env 等机密目录而导致敏感凭证泄露。在多项目并行开发时，这往往是灾难性的。

agent-sandbox 的隔离机制与核心步骤

为了消除上述隐患，agent-sandbox 技能提供了一个轻量且持久的本地隔离方案。该技能通过 agentbox exec 命令接管终端会话，将 Agent 的工作根目录严格锁定在当前的 Git 仓库内。这意味着 Agent 的文件读写权限被限制在 repo-only 的沙箱路径下，既不会碰到宿主机其他目录，也无法越权修改系统配置。同时，通过配置受控的出站访问规则，可以有效拦截 Agent 发起的非预期网络请求，确保其依赖下载或 API 调用处于可审计的状态。

适用边界与注意点

该技能的目标平台针对运行 Docker Engine 的 Apple Silicon 架构（通过 Colima 提供虚拟机层），但理论上兼容任何支持 Docker 的运行环境。需要注意的是，你需要确保本地的 VM 层（如 Colima）和 Docker 引擎处于运行状态，Agent 才能正确挂载并执行。此外，虽然文件系统被严格锁定，你依然需要对 Agent 生成的代码进行人工 Review，避免逻辑层面的错误随合并流程进入主分支。

使用场景

  • 在共享开发机上运行自动化代码重构代理时，防止其误删宿主机其他项目文件或修改系统配置，需将工作目录严格锁定在当前仓库内。
  • 让 AI 助手批量修复包含敏感凭证的微服务仓库漏洞，同时禁止其向公网发起未授权的请求或上传本地机密环境变量。
  • 在本地启动多个不同项目的 AI 编程助手进行并行开发，确保它们只能读写各自所属的 Git 仓库目录，避免交叉污染代码库。

适合人员

  • 负责维护多租户共享开发环境的运维工程师，希望防止自动化脚本越权访问宿主机其他租户的数据。
  • 处理包含核心机密的金融项目开发者，需要在让 AI 助手帮忙重构代码时确保敏感文件不出本机。
  • 管理多个并行开源或商业项目的全栈开发者，想要避免不同 AI 编程助手在本地互相干扰或误改代码。