Claude Cage:把 Claude 放进隔离环境
一个开源桌面程序,在客机虚拟机(或你自己的 Linux 服务器)里跑终端、浏览器和 Claude Code,网络不跟主机直连。你自己准备代理节点。
Cage 想解决的是「主机浏览器、本机 Claude 登录和一条不确定的代理缠在一起」。它把工作放进客机:代理由 Cage 接管,关键网络检查不过就保持离线,代理挂了也不会悄悄改走直连。它可以管多个 Claude Code 订阅,也可以把环境放到你自己的 VPS,或用手机接着电脑上的会话。它不能保证账号不被限制。
它是什么
装好之后,你在一个工作台里开终端跑 Claude Code、用编辑器看改动、用 Cage 自己的浏览器登录。客机可以是 macOS、Windows 或 Linux。项目文件夹按你点开的范围共享;主机上已有的 Claude 登录、浏览器配置和 SSH 密钥不会自动带进去。
网络上,Cage 导入你自己的 Clash / Mihomo 配置,选一个节点再应用。公网出站默认是走这条代理的 IPv4 TCP,DNS 也走同一条。检查失败或证据不齐时,环境停在离线,而不是退回主机的直连。指纹侧可以设时区、语言,并按代理 IP 对齐。这些检查是采样,不是审计,上游文档也写明它们不能代替「账号一定安全」。
和「支持地区 VPS + Tailscale + Orca」怎么比
另一篇是自己买一台位于 Claude 支持地区的 VPS,用 Tailscale 组私网,让 Orca 的浏览器在那台机器上渲染。出口就是那台机器的公网地址,注册和日常使用都不经过家里的浏览器。
Cage 的默认形态是本机上的虚拟机:出口是你选的代理节点,而不是「这台电脑本身在支持地区」。节点若仍落在不支持的地区,条款问题还在。Cage 另外提供云端模式:从桌面侧栏用 SSH 把同一套工作台部署到你的 Linux 服务器,用 rootless 容器,不要求 KVM。那时候任务留在服务器上,但网络仍是你在 Cage 里配置的代理,不是 Orca 那套「页面就在 VPS 网卡上打开」。
可以同时了解两边:想要独占、地理位置明确的机器,走 VPS 那篇;想在熟悉的桌面上隔离主机与客机、并顺手管多个订阅,看 Cage。两边都是第三方工具,都不是防封产品。
能装在哪
- macOS 14 及以上的 Apple Silicon。Intel Mac 不支持。
- Windows 10 22H2 / Windows 11 x64。Windows 11 客机还要求主机是带 Hyper-V 的专业版、企业版或教育版;其他 Windows 主机可以用 Debian 或 Ubuntu 22.04 客机。Windows ARM64 不支持。
- Debian 12、Ubuntu 22.04 / 24.04 的 x86_64。Linux ARM64 不支持。本机模式需要可用的 KVM;没有
/dev/kvm的云主机不能按桌面虚拟机来启动,应改看云端部署。
安装包自带工作台和代理核心,不必先装 Go、Node、Docker 或 Clash。Cage 不提供系统授权、代理服务或 Claude 账号。macOS 与 Windows 镜像按各自的系统许可使用。
怎么开始
从下载页或 GitHub Releases 取对应平台的包,并核对随附的 SHA256SUMS。macOS 是把 Cage 拖进「应用程序」。Linux 在确认该版本确实发布了 deb 之后:
sudo apt install ./Cage-<版本>-linux-amd64.deb
包名是 claude-cage,避免和发行版里另一个叫 cage 的 Wayland 程序撞名。桌面命令是 cage-desktop。不要用 sudo cage-desktop 启动。本机虚拟机还需要:
test -r /dev/kvm && test -w /dev/kvm
sudo apt install qemu-system-x86 qemu-utils ovmf openssh-client iproute2 git
设备在但当前用户写不了时,把用户加入 kvm 组后重新登录。本机 Git 需要 2.38 或更新,否则 Cage 会拒绝在共享项目上启用 Git 安全保护。Ubuntu 22.04 默认仓库里的 Git 往往偏旧,需要另装更新的版本。
第一次使用按应用里的三步走,而不是一条安装脚本:
- 导入 Clash / Mihomo 的 YAML 订阅或本地配置,选节点,点「应用代理」。需要中转时再配链式代理。项目不做节点推荐,节点自己找。
- 选客机系统(或「自动匹配本机系统版本」)和磁盘位置,再安装或启动环境。默认虚拟磁盘上限约 24 GiB。以后启动会复用这个环境。
- 打开一个本机文件夹,或先用默认工作区。在 Cage 的终端里运行
claude,在 Cage 的浏览器里完成授权。不要拿到主机浏览器里去登。
上游也提供给其他 agent 用的说明:安装好的 Cage CLI 上运行 agent capabilities,协议和字段以当前构建为准。仓库里的 AGENTS.md 是给贡献者的,普通用户看 Agent 使用指南。
多个订阅
先分清三件事:解锁 Cage 工作台的账户、设置里调度的 Claude Code 订阅、以及网页或 Claude Desktop 的登录。后两者不会自动进调度。
环境起来之后,在 Cage 的普通终端执行 claude auth login。授权链接用 Cage 浏览器打开。登录成功后,在「设置 → Claude 账号」里核对邮箱并「加入调度」。再加一个订阅用「登录新账号」,每个独立登录有自己的配置目录。同一订阅不会重复参与调度。
新建 Claude 终端时才会自动分配。调度可以按「正在使用的终端数和已知剩余额度」均衡,或按列表顺序优先。关掉某个账号的「参与自动分配」只影响以后新建的终端。五小时和七天额度从环境里的官方 Claude Code 读取,「检查状态」可以立刻刷新;没有读数时,上次的百分比不能当成现在还能用。
要在同一段会话历史里换账号,先给允许互接的账号填同一个「接续分组」。未分组的不会跨账号交接。额度耗尽后是否自动接续,可以按会话选择。交接前必须停掉原来的执行。上游写明:这套能力跑的是客机里的原版 Claude Code,不把订阅令牌拿去代理模型请求;真实的双订阅是否被服务端接受,仍要你自己核实。
服务器和手机
放到自己的 Linux 服务器
本机不适合跑虚拟机,或希望任务在关机笔记本之后还在,可以用云端模式。左栏「SSH 主机」填地址、端口、用户和密钥(或 SSH agent),先核对主机指纹,再「部署并连接」。程序以 rootless 容器跑在服务器上,不需要 KVM,但需要 systemd 用户服务、cgroup v2、用户命名空间、足够的 subordinate UID/GID,以及 /dev/fuse 和 /dev/net/tun。退出 SSH 后还要继续跑,就得由管理员打开 linger。前提以仓库里的 deploy/cloud/README.md 为准。不要改用特权容器,也不要把 Docker socket 交给这个环境。
关掉本地窗口不会停掉服务器上的任务;要结束必须在云端工作台里明确「停止环境」。服务器上的账号、代理和项目不会从你电脑自动拷过去。更新电脑上的 Cage 不会自动更新服务器。
手机接着用
Android 8 及以上的 arm64 可以装官网提供的 APK。iPhone 需要 iOS 17 以上,并且目前要在自己的 Mac 上用 Xcode 签名安装,而不是从商店下载。电脑端在「设置 → 远程连接 → 手机连接」生成二维码(大约两分钟有效)或配对码。手机只负责显示和审批;Claude Code、出口、时区和语言仍在配对的那台电脑上。电脑改走 SSH 云端工作台时,手机配对还是指向电脑本机的 Cage,要回到本机工作台来管手机。
工具调用会在手机上问「允许一次」或「拒绝」。配对码等于授权,只给自己的手机。自建中继是可选项,中继只转发连接,不跑你的项目。
边界
- 这是第三方社区项目。发行说明和你装到的构建可能不一致,公开包的能力以该版本的说明为准。请自己复查。
- 网络检查不能保证账号不被平台限制,也不能代替虚拟化安全审计。官方客户端仍可能识别出运行环境,上游把这一点写在账号文档里。
- 共享进客机的项目,修改和删除会作用到主机上的原文件,包括 Git。先有版本控制或备份。
- 同一份 Cage 配置里的项目共用一个客机系统、一套工具和账户,项目之间不是各自隔离的虚拟机。
- 默认没有公网 UDP、IPv6、ICMP,也不能把主机或局域网当成直连出口。Tailscale 要在 Cage 里另行启用,才按私网权限去连设备。
- 代理不可用时没有「失败了就改走直连」的退路。这是刻意的,不是故障。