Claude-Cage README

项目的 README,来自 github.com/Lee-xeo/Claude-Cage。合并为一个 markdown 文件:README.md。

Claude Cage

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

Claude Cage

Release MIT

Trendshift — Go Repository of the Day Trendshift — Go Repository of the Week

Trendshift — Repository of the Day Trendshift — Repository of the Week

项目主页 · 下载应用 · 使用文档 · 常见问题

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

受够了 Anthropic

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

Claude Cage 让你在熟悉的系统里与 Claude 一起工作:Mac 上用 macOS 虚拟机,Windows 上用 Windows 虚拟机,也可以选择轻量的 Linux 环境。终端、浏览器、编辑器和官方 Claude Desktop 汇集在同一个工作台,项目按需共享,网络独立管理;还可以连接自己的服务器,或用手机接续电脑上的任务。支持以下几个重点功能:

使用 Cage 的环境检测结果:

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

FuckClaude · LinXiaoTao / GitHub

Cage 运行主界面:

Cage

你可以用它做什么

浏览器收藏、无痕会话、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。Windows 11 客机需要支持 Hyper-V 的 Windows 11 专业版、企业版或教育版主机;其他受支持的 Windows 主机可使用 Debian 或 Ubuntu 22.04。Intel Mac、Windows ARM64 和 Linux ARM64 暂不支持。 macOS · Windows · Linux。

开发构建另提供 Intel Mac 本机 Linux 客机,以及 macOS 15.4+ 主机上的本机 macOS 客机实验路线,使用独立测试包;公开发行版尚未包含此能力。条件、构建方式和验收范围见 Intel macOS 开发说明。

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

安装包随附工作台和代理核心,无需先安装 Go、Node.js、Docker 或 Clash。首次创建环境时选择客机系统与存储位置,再准备对应的官方系统镜像和开发工具。macOS、Windows 系统按各自许可使用;Cage 不提供系统授权、代理服务或 Claude 账户。

源码与安装包公开,版本说明和校验文件见 GitHub Releases。从源码构建工作台需安装 uv,平台工具详见构建说明。系统选择、镜像来源与数据保留方式见客机系统指南。

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

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

三步开始

1. 选择代理

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

2. 启动环境

首次选择客机系统或“自动匹配本机系统版本”,再选择存储位置。点击“安装客户机”或“启动 Cage 环境”,按引导完成安装与授权;进度和错误可在“操作详情”查看。以后启动复用原环境。

3. 打开项目,运行 Claude

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

使用前了解这些边界

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

文档与贡献

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

你要做什么 从这里开始
让自己的 Agent 下载、安装、配置和排查 Cage Agent 使用指南
第一次安装、配置代理、打开项目 安装与首次启动
选择 macOS、Windows、Debian 或 Ubuntu 22.04 客机,使用原生开发工具 选择客机系统
添加多个订阅、查看额度和分配终端 多账号与额度
手机扫码、工具审批、远程浏览器 手机连接与远程会话
在自己的 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 增长曲线

Claude-Cage (Lee-xeo/Claude-Cage)

正在搜索数据库…

这是什么?Claude Cage 是一款桌面应用,把 Linux 终端、浏览器、文件编辑器和 Claude Desktop 整合到同一个工作区中。它们运行在一个隔离环境里,并拥有独立的代理,因此你的 Claude 工作与宿主机相互分开。
它是在本地运行还是在服务器上运行?两者都支持。它会在你自己的电脑上运行一个轻量级虚拟机,也可以通过 SSH 把同样的工作环境部署到你自己的 Linux 服务器上。
我该怎么让它跑起来?从项目主页下载适用于 macOS、Windows 或 Linux 的应用。然后导入 Clash/Mihomo YAML 订阅或本地 YAML 文件来添加你自己的代理,选择出口节点,点击“Start Cage environment”,再打开一个项目文件夹。
我需要先安装 Go、Node.js、Docker 或代理工具吗?不需要。安装包已包含工作台和代理核心,无需额外安装任何东西。但你仍需要自己可用的代理节点和自己的 Claude 账号,因为本项目两者都不提供。
支持哪些平台和 CPU?支持 Apple Silicon 芯片的 macOS 14+、x64 架构的 Windows 10 22H2 或 Windows 11,以及 x64 架构的 Debian 12 或 Ubuntu 24.04。不支持 Intel 芯片的 Mac、Windows ARM64 和 Linux ARM64。Windows 和 Linux 版本仍处于开发验收阶段。
我的 Claude 登录信息和 SSH 密钥会怎样?只有默认工作区以及你明确打开的项目文件夹会被共享。宿主机上的 Claude 登录信息、浏览器配置文件和 SSH 密钥不会被自动导入。
它和指纹浏览器有什么不同?它隔离的是整个 Linux 环境,而不仅仅是浏览器。网络流量经过它自己的代理,时区和语言也会被设置为与之匹配;如果内置检测失败,它可以让该环境保持离线。
内置的网络检测是做什么的?它会在环境运行期间检查隔离和出口配置。如果某项关键检查失败或证据不完整,它会暂停外部网络访问。第三方浏览器检测结果仅供参考显示。
作者为什么要做这个?作者厌倦了折腾 VPS 和指纹浏览器、处理环境检测,并且担心账号被封。他的目标是做一个开箱即用的桌面程序,代理和隔离都已配置好。
作者
Lee-xeo
大小
52.2 MB
星标
6.4K
时长
18天
提交 · 90 天