Claude 指南 稳定使用

Claude Cage:把 Claude 放进隔离环境

一个开源桌面程序,在客机虚拟机(或你自己的 Linux 服务器)里跑终端、浏览器和 Claude Code,网络不跟主机直连。你自己准备代理节点。

新增于 2026 年 11 月 12 日 · 撰写时仓库约 4.6k star · MIT

项目与作者。Claude Cage 由 Lee-xeo 维护。 仓库:github.com/Lee-xeo/Claude-Cage。 项目主页 lee-xeo.github.io/Claude-Cage 目前会跳到 claude-cage.com,使用文档在 claude-cage.com/docs。 主许可是 MIT;内置的 Mihomo 按 GPL-3.0 单独分发。它基于 agent-vm 二次开发,与 Anthropic 无关。安装前请自己读源码和发行说明。
直接结论

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。两边都是第三方工具,都不是防封产品。

能装在哪

安装包自带工作台和代理核心,不必先装 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 往往偏旧,需要另装更新的版本。

第一次使用按应用里的三步走,而不是一条安装脚本:

  1. 导入 Clash / Mihomo 的 YAML 订阅或本地配置,选节点,点「应用代理」。需要中转时再配链式代理。项目不做节点推荐,节点自己找。
  2. 选客机系统(或「自动匹配本机系统版本」)和磁盘位置,再安装或启动环境。默认虚拟磁盘上限约 24 GiB。以后启动会复用这个环境。
  3. 打开一个本机文件夹,或先用默认工作区。在 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,要回到本机工作台来管手机。

工具调用会在手机上问「允许一次」或「拒绝」。配对码等于授权,只给自己的手机。自建中继是可选项,中继只转发连接,不跑你的项目。

边界