Claude Cage

把 Claude 大小姐关起来，为了更好地保护我们的相遇

项目主页 · Français · 下载应用 · 使用文档 · 常见问题 · 参与开发

简体中文 · 繁體中文 · Русский · العربية · فارسی · 한국어 · Español · မြန်မာဘာသာ · Беларуская · پښتو · دری · አማርኛ · Soomaali · ትግርኛ · Français

受够了 Anthropic

作为一个只是想和 Claude 对话与合作的正常用户，受够了折腾各种 VPS，指纹浏览器，环境检测，面对封号的担惊受怕和财产损失。我们提出 Claude Cage 项目：一个开箱即用的桌面程序，配置好自己的网络代理，集中管理隔离环境、时区语言和环境检查。

Claude Cage 把 Linux 终端、浏览器、文件编辑器和按需安装的 Claude Desktop 放进同一个桌面工作台。可以在本机运行轻量虚拟机，也可以通过 SSH 将工作环境部署到自己的 Linux 服务器；手机开发客户端可连接电脑，处理 Claude Code 会话与工具审批。支持以下几个重点功能：

• 和主机隔离的网络设置，Cage 自己接管和代理内部的所有网络流量
• 和主机隔离的指纹设置，包括时区、语言等，支持自动与代理 IP 同步
• 针对 Claude 使用过程中的全链路适配（浏览器登录，授权，claude code 进程）
• 内置网络与隔离检查，关键检查失败或证据不完整时暂停外网；社区和第三方检测提供补充参考

| 网络与隔离检查 | 浏览器环境检测（社区参考） | | :---: | :---: | | | |

Cage 运行主界面：

!Cage

你可以用它做什么

• 在一个窗口里完成工作。 用终端运行 Claude Code，用编辑器查看改动，用 Cage 浏览器预览服务和完成登录。
• 控制共享范围。 只共享默认工作区和明确打开的项目文件夹；主机的 Claude 登录、浏览器配置和 SSH 密钥不会自动导入。
• 看清网络状态。 内置代理管理支持导入订阅、选择节点和检查出口。关键检查未通过时，环境保持离线；代理不可用时没有直连回退。
• 下次继续使用。 工具、文件和登录状态保存在虚拟磁盘里，关闭窗口可以保留后台任务。
• 管理多个 Claude Code 订阅。 独立登录多个账号，查看五小时和七天额度，为新建 Claude 终端分配账号；正在运行的终端保留原账号。多账号与额度
• 从手机继续处理任务。 Android / iPhone 开发客户端通过二维码或配对码连接电脑，创建和继续结构化 Claude Code 会话、处理工具审批；经电脑单独授权可使用远程浏览器。需要包含移动功能的构建，普通终端会话仍在原终端操作。手机连接
• 把环境放到自己的服务器。 从侧栏添加 SSH 主机，核验指纹后部署或连接，在符合条件的 Linux x86_64 VPS 运行环境，无需 KVM。项目、账户和网络配置保存在服务器，断开客户端可保留任务。云端部署与 SSH

快速开始

把这句话发给你的 agent（codex，dsh，workbuddy，反正不会是 claude code😁）

帮我安装 https://github.com/Lee-xeo/Claude-Cage ，并把 Cage 的代理配置为我本机 Clash 的 xxx 节点。

你唯一需要的，是一个靠谱的代理节点，本项目不做任何代理推广，可以自行搜索黑色错误网站解决。

下载与安装

Cage 支持 macOS、Windows 和 Linux：macOS 14+ 的 Apple Silicon Mac、Windows 10 22H2 / 11 x64，以及 Debian 12 / Ubuntu 24.04 x86_64。Windows 和 Linux 仍处于开发验收阶段；安装包是否可用、签名与实测范围以各平台的发行说明为准。Intel Mac、Windows ARM64 和 Linux ARM64 尚不受支持。 macOS · Windows · Linux。

1. 打开项目主页，点击“下载应用”并选择平台。
2. macOS：打开安装包，将 Cage 拖入 Applications（应用程序），再从“应用程序”启动。Windows：安装说明 · Linux：安装说明。
3. 按应用内引导配置自己的代理，启动环境后打开项目。

源码、主页与发行物公开；可下载版本、功能、签名、公证和平台验收范围以公开 Release说明为准。源码中的新增能力可能尚未进入公开包，手机开发客户端的安装与连接方式见移动端文档。

支持应用内更新的 macOS 和 Windows 版本通过所选代理下载，无直连回退；安装前请保存并停止任务。macOS 要求同一发布者的 Developer ID 签名并通过 Apple 验证，Windows 要求可信 Authenticode 签名和相同发布者公钥。Windows 未签名预览版和 Linux 系统包需手动更新。详见升级与卸载。

三步开始

1. 选择代理

点击首页“配置网络与代理”，再点击“添加来源”，导入 Clash/Mihomo YAML 订阅或本地 YAML 文件，在“节点”中选择最终出口并点击“应用代理”。需要通过中转连接住宅代理时，选择“链式代理”，按顺序选择中转与最终出口。没有可用代理时，可以明确勾选“通过主机网络下载这份订阅”，或直接导入本地文件。后续可从“设置 → 网络与代理”管理节点。

2. 启动环境

返回工作台，点击“启动 Cage 环境”。如果本机 Git 需要安全保护，应用先说明影响，由你点击“启用保护并继续”后设置；普通项目的提交与拉取不受影响。随后下载镜像、安装工具并执行网络检查，可以在“操作详情”查看进度。看到环境就绪、关键检查通过后，即可联网工作；失败时按页面提示修复并重试。

3. 打开项目，运行 Claude

点击“打开项目”选择本机上的文件夹，再新建终端，输入 claude，在 Cage 浏览器中完成自己的账户授权。也可以先使用默认工作区，无需提前准备项目。完整步骤见开始使用。

使用前了解这些边界

• 共享项目中的修改和删除会直接影响本机上的文件。请使用版本控制或备份；.git 等元数据默认只读，Git 提交在主机上完成。
• 所有项目共用一个 Cage 环境，也共用其中的工具、账户与 Linux 文件系统。项目之间没有独立隔离。
• 当前允许客机通过代理访问公网 IPv4 TCP，DNS 通过同一代理发送；公网 UDP、IPv6、ICMP，以及客机主动访问主机和局域网的连接受到阻断。依赖这些能力的工具可能无法使用。
• 网络检查展示当前配置和采样证据，无法保证账户不会受到平台限制，也不能代替完整的虚拟化安全审计。

文档与贡献

面向用户的官网使用文档支持按功能浏览、搜索与章节直达。源码与设计资料见仓库文档导航。

| 你要做什么 | 从这里开始 | |---|---| | 第一次安装、配置代理、打开项目 | 安装与首次启动 | | 添加多个订阅、查看额度和分配终端 | 多账号与额度 | | 手机扫码、工具审批、远程浏览器 | 手机连接与远程会话 | | 在自己的 VPS 部署和连接环境 | 云端部署与 SSH | | 了解每一项设置及何时生效 | 设置参考 | | 维护存储、资源、更新与备份 | 维护、资源与数据 | | 处理下载、启动、联网和登录问题 | 故障排查 | | 了解文件、按键和关闭与退出行为 | 项目、终端与文件 | | 从源码构建或提交改进 | 贡献指南 | | 了解模块与网络约束 | 工作台设计 | | 报告可复现问题 | GitHub Issues |

本项目仍在快速迭代中，欢迎加入交流群提意见，欢迎社区大佬一起维护

来源与许可

Cage 基于 agent-vm 二次开发，上游基线为 652688aae92c35ce536b9be52262e1cc5ec6e03a。

项目主许可为 MIT。随附组件保留各自许可，Mihomo 作为独立可执行文件按 GPL-3.0 分发；请同时参阅 NOTICE、第三方许可、第三方来源及 noVNC 来源说明。上游项目的说明保存在上游 README。

Cage 是独立社区项目，与 Anthropic 无隶属关系。

参考与致谢

感谢以下项目为 Cage 提供基础能力或设计参考：

• agent-vm：Cage 的二次开发底座。
• Lima：Linux 虚拟机管理。
• gvisor-tap-vsock：虚拟机网络能力。
• sshocker 和 SFTP：虚拟机与主机之间的文件共享能力。
• noVNC：浏览器中的远程画面与交互。
• Mihomo：内置代理核心。
• code-server：浏览器中的代码编辑器。
• AIO Sandbox：工作环境和交互体验参考。
• claude-switcher 和 Claude-Guardian：网络检查和安全诊断方法参考。

Star 增长曲线