clawk

环境要求

• macOS 14+ 且为 Apple 芯片（Apple silicon）
• Homebrew（使用 brew 安装方式时）
• Go 1.26+（仅源码构建时需要）
• 无需 Docker、qemu 或 sudo；Linux 支持为实验性，走 firecracker

安装与启动步骤

1. 1用 Homebrew 安装

   README 推荐的常规安装方式，一条命令即可，无需额外宿主机工具链。

   brew install clawkwork/tap/clawk

   复制

2. 2从源码安装（可选）

   贡献者或不使用 Homebrew 时选此方式，需要本机有 Go 1.26+，make install 安装到 $GOBIN。

   git clone https://github.com/clawkwork/clawk && cd clawk
   make install

   复制

3. 3进入项目并启动沙箱

   先 cd 到代码仓库目录，再执行 clawk：它会为该目录启动一个一次性 Linux VM 并自动附加 claude。

   cd ~/code/my-project
   clawk

   复制

4. 4在同一沙箱跑其他代理

   同一个沙箱里可以换用 shell、codex、pi、opencode 等；向代理传参需用 -- 分隔。

   clawk run shell
   clawk run codex
   clawk run claude -- --resume

   复制

5. 5转发端口与网络白名单

   把 guest 内的开发服务器暴露到本机端口，或把域名加入沙箱网络允许列表（不在白名单的请求会被拒绝）。

   clawk forward add my-project 3000
   clawk network allow my-project api.example.com

   复制

6. 6停止、恢复与销毁

   clawk down 停止 VM（仓库与代理状态保留）；clawk attach 稍后恢复会话；clawk destroy 删除 VM 但保留对话历史。

   clawk down
   clawk attach
   clawk destroy

   复制

7. 7一次配置 Claude 认证

   使用 Claude Code 时先取 token 并写入 clawk，之后每个沙箱开机即已登录，避免并行沙箱的登录冲突。

   claude setup-token
   clawk auth set-token

   复制

8. 8可选：编写 clawk.mod

   项目需要更多配置时，在仓库放一个 go.mod 风格的 clawk.mod 文件，声明沙箱的 CPU、内存、镜像、网络与转发。

关键配置

如何确认成功

在仓库目录执行 clawk 后，VM 启动并自动附加 Claude Code；在沙箱内执行 curl https://tracker.evil.example 会因不在允许列表而被拒绝，说明边界生效。

常见问题

注意事项

• README 以 macOS 为先，要求 macOS 14+ 的 Apple 芯片机器。
• 首次运行会探测缺失依赖并提示修复。
• clawk.mod 不是必需的，无配置文件时使用合理默认值。
• 同一目录下的沙箱状态可持久保存，clawk destroy 只删除 VM，对话历史仍保留。