clawk是什么:如何给AI编程助手一台专属的一次性Linux虚拟机

原创2026-10-17 14:19:271,843 阅读

clawk是什么:如何给AI编程助手一台专属的一次性Linux虚拟机

clawk 是一个开源工具,它的定位非常直接:给 AI 编程助手(如 Claude Code、Codex)一台专属的一次性 Linux 虚拟机,而不是让它直接在你的电脑上执行命令。你在项目目录里敲一个 clawk 命令,AI 就能在这台隔离的 Linux 沙箱里安装依赖、运行代码、访问网络,而你的文件、密钥串(keychain)和主机系统始终与虚拟机隔绝——即使 AI 把系统"干炸了",销毁重建也只需一条命令。

clawk 为 AI 编程助手启动一次性 Linux 虚拟机沙箱的演示动画:一条命令接入 Claude Code,被拦截的出站请求显示在网络拒绝日志中

为什么需要一次性Linux虚拟机?AI编程助手的安全困境

AI 编程助手只有真正"动手"才有价值:安装包、跑代码、起服务、用网络。而在你自己的机器上,你只有两个不尴不尬的选择:

  • 每条命令都批准:每隔几秒就盯着一个权限弹窗,效率崩溃;
  • 开启 --dangerously-skip-permissions:放手让 AI 跑,然后祈祷它不会有一条 rm -rf 或一次密钥泄露毁掉你的电脑。

clawk 给出了第三种选择:把 AI 放进一台独立的机器里。隔离边界不是写在提示词里、可能被 AI"说服"的规则,而是一台真正的虚拟机——宿主机文件系统从未挂载,AI 唯一能碰到的,只有你主动挂载进去的东西。

快速上手:3步安装并启动clawk

第一步:安装 clawk

要求 macOS 14+(Apple 芯片)。无需 Docker、无需 qemu、无需 sudo,一条命令搞定:

brew install clawkwork/tap/clawk

如果你不用 Homebrew,也可以从源码构建(需要 Go 1.26+):

git clone https://gitcode.com/gh_mirrors/cl/clawk && cd clawk
make install

第二步:进入项目目录,运行 clawk

这是 clawk 的日常使用场景,一条命令启动沙箱并接入 Claude:

cd ~/code/my-project
clawk                  # 为当前目录启动沙箱,并接入 claude
clawk run shell        # 或进入沙箱内的 shell 自己看看
clawk run codex        # 也可以接入其他 agent:codex、pi、opencode 等

首次启动会从你选择的 OCI 镜像(比如 golang:1.25)构建 rootfs,之后每次启动只需几秒——磁盘是写时复制(copy-on-write)克隆,启动时直接引导内核,没有固件、没有安装程序。

第三步:随时离开、随时回来

clawk down             # 停止 VM(仓库 + agent 状态保留)
clawk attach           # 之后回来:自动启动并重新接入 claude
clawk destroy          # 删除 VM(对话历史仍然保留)

如果 AI 把虚拟机搞坏了?clawk destroy && clawk,全新虚拟机、同一个仓库,加上 --resume 恢复对话,损失为零。🔄

核心特性:clawk 为 AI 编程助手做了什么

⚡ 一条命令的全自主工作模式

clawk 启动 agent 时会使用其"外部沙箱"模式(claude 是 --dangerously-skip-permissions、codex 是对应的绕过参数)。在你自己机器上这些参数很危险,在这里它们恰好在点子上:VM 边界 + 网络白名单才是真正的防线,AI 可以全速工作、不被逐条确认打断。如果你仍想要确认提示,加一个 --safe 即可。

🔒 出网默认拒绝:网络白名单机制

每个沙箱拥有独立的出站白名单:DNS 可以解析一切,但 TCP/UDP/ICMP 对未列出的主机一律拒绝。npm、PyPI、crates.io、GitHub 等常用仓库已预置放行。

clawk network allow my-project api.example.com   # 放行新域名
clawk network denials my-project                 # 查看 AI 被拦截的出站尝试
clawk forward add my-project 3000                # 把沙箱内开发服务器映射到本机 localhost:3000

更妙的是 ssh-agent 转发:你的 SSH 私钥从不进入虚拟机,但 git push 依然可用——签名动作发生在宿主机上。

♻️ 可随意销毁:VM 可弃,数据不丢

clawk 只有一条持久化规则:虚拟机是一次性的,你会心疼的东西全在宿主机上。

clawk down clawk destroy
你的代码仓库(挂载的 worktree) ✅ 保留 ✅ 保留
Agent 对话记忆(Claude/Codex 等) ✅ 保留 ✅ 保留
VM 磁盘(apt 安装、缓存、$HOME) ❌ 下次启动重建 ❌ 彻底删除

Agent 的 home 目录(~/.claude/ 等)按沙箱挂载在宿主机 ~/.clawk/namespaces/default/state/<name>/ 下,所以重建虚拟机后旧对话依然可用 --resume 恢复。

💤 忘记关掉的沙箱几乎不花钱

空闲的 VM 会自动把内存释放到约 1 GiB,闲置 30 分钟后自动停止;clawk snapshot 还能把整个客户机"休眠"到磁盘,下次启动时恢复到暂停那一刻。多开几个项目沙箱也不会吃光你的内存。

配置指南:用 clawk.mod 定制你的虚拟机

clawk 没有配置文件也能用(默认 2 CPU、4 GiB、内置白名单)。当项目需要更多定制时,在仓库里放一个 clawk.mod 文件即可,语法类似 go.mod:

sandbox my-project (
    vm (
        cpu    4
        memory 8GiB
        image  golang:1.25          # 任意 OCI 镜像都可作为 rootfs
    )
    network ( allow api.example.com )
    forwards ( 3000 )
    env ( DATABASE_URL )           # 从你的 shell 转发环境变量
)

完整参考(共享目录、密钥文件、MCP 服务器、多仓库工作区等)见 docs/configuration.md。

💡 用 Claude Code 的话,先运行 claude setup-token 再执行 clawk auth set-token,之后每个沙箱启动时都已自动登录,无需 /login。详见 docs/claude-auth.md。

clawk 与容器、云沙箱有什么不同?

  • vs 容器 / devcontainer:容器共享你的内核,看到"你的文件系统减去拒绝规则",一次挂载失误就可能暴露宿主机;clawk 是独立内核、从未挂载宿主机文件系统,且不需要写 Dockerfile——任何 OCI 镜像都是 rootfs。
  • vs OS 级 agent 沙箱:那是在你真实机器上施加进程级护栏,一条策略失误(连 keychain 一起)就全暴露;clawk 把整个工作负载搬到了另一台机器上。
  • vs 云沙箱:clawk 本地优先——代码永远不出你的机器、不按小时计费,AI 编辑的 worktree 就是你编辑器里打开的那份。

完整的架构与取舍逻辑可以看 ARCHITECTURE.md 和 DESIGN.md。

常见问题(FAQ)

🤔 需要装 Docker 吗? 不需要。clawk 自己拉取 OCI 镜像并构建可启动磁盘,Docker 引擎完全不参与(Docker 镜像只是输入格式)。

🖥️ 支持 Windows 或 Intel Mac 吗? 不支持。macOS 需要 Apple 芯片(macOS 14+);Linux 通过 firecracker 支持但仍是实验性,入门请看 docs/linux-quickstart.md。

📚 有哪些常用命令? clawk list / clawk status 查看状态,clawk up / clawk down 启停,clawk pause / clawk resume 内存中挂起与恢复,clawk snapshot 休眠到磁盘。全部命令说明见 docs/commands.md。

🎫 跨多个仓库的工单能处理吗? 能。在一个列出多个仓库的 clawk.mod 工作区里运行 clawk work INFRA-123,会为每个仓库创建 git worktree 和新分支,之后 clawk pr INFRA-123 一次为所有仓库推送并开互相关联的 PR。详见 docs/ticket-mode.md。

总结

clawk 解决的是 AI 编程时代一个很实际的问题:如何让 AI 真正放手干活,又不把你的电脑当赌注。它的答案是"再给 AI 一台机器"——一次性、可销毁、网络白名单隔离,你的代码和密钥始终留在宿主机。一条 clawk 命令,AI 编程助手就有了自己的 Linux 工作站,而你的笔记本电脑安然无恙。🦞

登录后查看全文
clawk