Lee-xeo/Claude-Cage

Public

Cage:为 Claude 特化的轻量化虚拟机,彻底杜绝网络泄露。多平台适配,支持多账号管理、远程部署、移动端操控。

  • Stars7.1k+2.3k tuần này
  • Forks832
  • Watchers12
  • Issues142
  • Ngày tạo31/10/2026
  • Cập nhật gần nhất21/11/2026
  • Ngôn ngữGo
  • Giấy phépMIT
README.md29.2 KBRaw

受够了 Anthropic

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

Claude Cage 在一个小型的 Debian 13 环境里运行官方 Claude Code 和 Claude Desktop,macOS、Windows 和 Linux 上都是同一个环境。终端、浏览器、编辑器和官方 Claude Desktop 汇集在同一个工作台,项目按需共享,网络独立管理;还可以连接自己的服务器,或用手机接续电脑上的任务。支持以下几个重点功能:

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

使用 Cage 的环境检测结果:

网络与隔离检查 浏览器环境检测(社区参考)
网络与隔离检查 浏览器环境检测(社区参考)

FuckClaude · LinXiaoTao / GitHub

Cage 运行主界面:

Cage

你可以用它做什么

  • 在一个窗口里完成工作。 用终端运行 Claude Code,用编辑器查看改动,用 Cage 浏览器预览服务和完成登录。
  • 三个平台,同一个环境。 macOS、Windows 和 Linux 上的 Cage 都使用同一个 Debian 13 环境,工具与操作方式一致。 Debian 环境
  • 控制共享范围。 只共享默认工作区和明确打开的项目文件夹;主机的 Claude 登录、浏览器配置和 SSH 密钥不会自动导入。
  • 看清网络状态。 内置代理管理支持导入订阅、选择节点和检查出口。关键检查未通过时,环境保持离线;代理不可用时没有直连回退。
  • 下次继续使用。 工具、文件和登录状态保存在虚拟磁盘里,关闭窗口可以保留后台任务。
  • 管理多个 Claude Code 订阅。 查看额度、为新会话分配账号,并在明确授权后切换账号接续历史。 Claude Code
  • 从手机继续处理任务。 Android / iPhone 配对电脑,接续 Claude Code 对话与工具审批,或操作远程浏览器和 Claude Desktop。手机连接
  • 把环境放到自己的服务器。 通过 SSH 部署或连接 Linux VPS,工具、任务和数据留在服务器,无需 KVM。云端部署与 SSH
  • 通过私网连接设备。 在 Cage 内登录 Tailscale,查看网络中的设备,使用 SSH、Web 与其他 TCP 服务。 Tailscale 私网
  • 让 Claude 使用电脑上的工具(实验性)。 默认关闭。开启后,环境里的 Claude 可以在已共享的项目目录中运行电脑上的命令,每次调用都需在系统对话框中确认,能力以插件提供。 插件

浏览器收藏、无痕会话、Cookie、扩展、密码保险箱,以及外观、资源、存储和工具更新,见完整使用文档。

快速开始

把这句话发给你的 agent(codex,dsh,workbuddy,反正不会是 claude code😁)

帮我拉取 https://github.com/Lee-xeo/Claude-Cage 的最新源码,打包安装,并把 Cage 的代理配置通过我本机 clash 的 xx 节点走我的 xx ip 出口,全过程你盯着,有问题直接修复,且有必要的话顺手给项目提交 issue 帮助他们优化兼容性。

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

下载与安装

Cage 支持 macOS、Windows 和 Linux:macOS 14+ 的 Apple Silicon Mac、Windows 10 22H2 / 11 x64,以及 Debian 12 / Ubuntu 22.04 / 24.04 x86_64。Intel Mac、Windows ARM64 和 Linux ARM64 暂不支持。 macOS · Windows · Linux。

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

安装包随附工作台和代理核心,无需先安装 Go、Node.js、Docker 或 Clash。首次创建环境时选择存储位置,Cage 会下载 Debian 13 镜像和开发工具。Cage 不提供代理服务或 Claude 账户。

Windows 安装向导和 Cage 首次打开时按主机的显示语言预选界面语言,第一屏可以改选。支持的语言见上方列表,之后也可在「设置 → 通用 → 界面语言」切换。 界面语言说明

源码与安装包公开,版本说明和校验文件见 GitHub Releases。从源码构建工作台需安装 uv,平台工具详见构建说明。环境的要求、镜像来源与数据保留方式见Debian 环境。Intel Mac 的实验性开发构建见 Intel Mac 开发说明。

功能以所用构建为准,公开安装包的能力与验证范围以发行说明为准。

macOS 和已签名 Windows 版本支持通过所选代理更新;Windows 未签名预览版与 Linux 使用安装包手动更新。更新前保存并停止任务,个人数据继续保留。 升级与卸载

三步开始

1. 选择代理

导入 Clash/Mihomo YAML 订阅或本地配置,选择节点并点击“应用代理”;需要中转时可配置链式代理。网络与代理

2. 启动环境

首次启动时选择存储位置,点击“启动 Cage 环境”,按引导完成安装;进度和错误可在“操作详情”查看。以后启动复用原环境。

3. 打开项目,运行 Claude

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

使用前了解这些边界

  • 共享项目中的修改和删除直接影响本机原文件,包括 Git 操作。请使用版本控制或备份,并核对提交结果。
  • 同一份 Cage 配置中的项目共用同一个 Debian 环境及其中的工具、账户与文件系统,项目之间没有独立隔离。
  • 默认公网出站支持 IPv4 TCP,DNS 通过同一代理;公网 UDP、IPv6、ICMP 及主机和局域网直连受限。主动启用 Tailscale 后,可按私网权限连接设备。
  • 网络检查展示当前配置和采样证据,无法保证账户不会受到平台限制,也不能代替完整的虚拟化安全审计。

详细机制见网络与数据边界。

文档与贡献

面向用户的官网使用文档支持按功能浏览、搜索与章节直达。各项操作见使用文档导航。

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

代码与文档贡献采用“contribution Issue 审核 → 邀请成为协作者 → 提交 PR → 审查合入”的流程。请先提交方案贡献 Issue;维护者审核通过并添加 accepted 标签后,自动化会发送协作者邀请。接受邀请后再创建 PR,详细步骤与权限说明见贡献指南。

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

QQ 群 · 273237690 微信
QQ 群 · 273237690 微信

Telegram

来源与许可

Cage 基于 agent-vm 二次开发。

项目主许可为 MIT。随附组件保留各自许可,Mihomo 作为独立可执行文件按 GPL-3.0 分发;请同时参阅 NOTICE · 第三方许可 · noVNC。

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

参考与致谢

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

Claude Cage 的 GitHub Star 增长曲线

Nội dung README thuộc về Lee-xeo và cộng đồng đóng góp, giấy phép MIT. Nguồn: github.com/Lee-xeo/Claude-Cage