Pi 本身不包含内置权限系统，默认以启动用户的权限运行。需要更强边界时，有三种容器化方案。
三种方案
1. Gondolin Extension（推荐）
最灵活的方案：pi 进程和 Provider 认证保留在宿主机，只将内置工具和 ! 命令路由到本地 Linux 微虚拟机（micro-VM）执行。
- 优点：宿主机 API Key 不暴露到容器中，工具执行隔离
- 适合：需要访问云端 Provider、同时要文件系统隔离的场景
2. Plain Docker
整个 pi 进程运行在本地容器中，简单直接。
docker run -it --rm \
-v $(pwd):/workspace \
-e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
-w /workspace \
<pi-docker-image>- 优点：配置简单
- 缺点：API Key 需要传入容器
3. OpenShell
整个 pi 进程在策略控制的沙箱中运行。
- 优点：更细粒度的策略控制
- 适合：企业合规场景
详细文档
参见：packages/coding-agent/docs/containerization.md
相关页面：quick-start | extensions