AI Agent / 系统课时

使用隔离环境

使用隔离环境

允许智能体执行命令时,最有效的风险控制不是不断增加提示语,而是缩小它能够影响的文件、网络和凭据范围。本课将组合临时分支、独立工作树与开发容器,构建可删除、可重建、无生产权限的执行环境。

学习目标

  • 理解代码隔离、进程隔离和凭据隔离的不同作用
  • 能创建独立工作树承载 Claude Code 修改
  • 会为开发容器设置最小挂载和非特权用户

隔离环境要限制什么

临时 Git 分支只能隔离提交历史,不能阻止命令读取主机文件;工作树能把修改目录分开,但仍共享同一用户权限;容器或虚拟机进一步限制进程和文件系统。真正安全的环境还必须移除生产密钥、缩小网络出口,并让破坏性结果可以通过删除环境恢复。

Claude Code 隔离环境分层图

创建独立工作树

在主仓库旁创建一个专用工作树和临时分支:

bash
git worktree add ../project-claude-sandbox -b claude/sandbox

预期输出

text
Preparing worktree (new branch 'claude/sandbox')
HEAD is now at <COMMIT> <MESSAGE>

进入新目录后再启动 Claude Code。<COMMIT> 和 <MESSAGE> 会随仓库变化。这样主工作目录保持不动,审查通过后可以合并分支;失败时删除工作树即可。任务完成并确认不再需要时执行:

bash
git worktree remove ../project-claude-sandbox

预期结果

text
命令成功时通常不输出内容,独立工作树目录被移除。

若目录中仍有未提交修改,Git 会拒绝删除,避免误丢内容。

使用开发容器限制进程权限

下面是一个最小 .devcontainer/devcontainer.json 片段,使用非 root 用户,并且不自动挂载宿主机密钥目录。

json
{
  "name": "claude-code-sandbox",
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "remoteUser": "vscode",
  "workspaceFolder": "/workspaces/project",
  "runArgs": [
    "--cap-drop=ALL",
    "--security-opt=no-new-privileges"
  ]
}

配置生效后,应在容器内安装项目依赖和 Claude Code,只挂载当前项目,不挂载 ~/.ssh、~/.aws、Docker Socket 或生产配置。若确实需要访问外部系统,使用只读、短期、测试环境凭据。

控制依赖安装与网络访问

依赖安装会执行第三方脚本,因此 npm install、pip install 或构建插件不应默认视为无害。锁定版本、使用锁文件、优先内部镜像,并把新增依赖纳入人工确认。网络层只允许文档站点、包仓库和测试 API,生产数据库与管理端点应从隔离环境不可达。

Claude Code 也支持 Bash 沙箱设置,可用于限制文件系统和网络,但是否可用取决于平台。无论使用内置沙箱还是容器,都要验证隔离实际启动;“配置了但回退到未隔离执行”比明确失败更危险。:contentReference[oaicite:11]{index=11}

验收隔离是否有效

在环境内检查当前用户不是 root,确认敏感目录不存在或无权访问,测试只能连接允许的地址,并验证删除工作树或容器后主仓库没有未审查修改。最后通过普通代码评审合并结果,不要把“运行在容器里”当作跳过审查的理由。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用隔离环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通