CCBaga:用于 Claude 身份管理与浏览器检查的跨平台工具包

CCBaga 将加密的本地 Claude 身份档案、带指纹配置的配套浏览器,以及系统区域设置控制整合到适用于 macOS、Linux 和 Windows 的原生工具包中。

管理多个本地 Claude Code 或 Claude Desktop 配置可能存在风险:切换账户可能覆盖有用状态,清理操作可能误删不该删除的内容,浏览器或系统设置也可能与所选区域不一致。CCBaga 将这些工作整合到原生桌面工作流中,让用户明确控制要归档的内容、工作区中要保留的内容,以及哪些环境检查确实已通过。

该项目是一款独立的 MIT 许可 Rust 和 Tauri 应用,适用于 macOS、Linux 和 Windows。项目声明其预期用途是供居住或旅行至海外的人管理自己的 Claude 身份;禁止用于违反 Anthropic 服务条款的行为。

两款应用,各司其职

CCBaga 由两款协同工作的应用组成。CCBaga-A 负责管理本地身份、系统设置和环境检查。CCBaga-B 是一款配套的 Fingerprint Chromium 浏览器,拥有专用配置文件。浏览器测量结果通过本地会话返回主机,而不是让浏览器测试页面直接访问 Tauri 命令。

这种分离很重要:设置已配置与结果已验证并不是一回事。CCBaga 可以应用时区或浏览器指纹设置,之后再测量浏览器和计算机实际报告的内容。

日常工作流从区域选择器开始,并提供四项常用操作:清除浏览器缓存、轮换指纹、重置时区和语言,或归档当前身份。高级控制位于 Network、Claude identities、Browser 和 Computer 页面中。界面支持英语和简体中文;更改界面语言不会改变计算机或浏览器的语言。

切换 Claude 身份,不丢弃当前状态

身份管理器负责处理 Claude Code 和 Claude Desktop 的默认本地数据目录。每次切换时,都会先保存当前身份,再恢复已保存的身份或以空工作区启动。切换前,用户可以展开 Keep in workspace,选择是否让技能和命令、插件、MCP 配置、个人设置、项目记录、对话历史以及缓存或日志留在原处,或随身份一起移动。登录数据始终会随归档身份一同保存。

归档文件是经过压缩、身份验证和加密的 .baga 容器,存储在 Claude 工作目录之外。本地 SQLite 数据库会跟踪身份名称、保留策略和恢复状态。CCBaga 会在更改工作区前验证归档;切换失败时会回滚,中断的切换则会提供恢复途径。恢复操作本身会先保存恢复前的状态。

已保存的身份可以在运行相同操作系统的设备之间导出和导入。导出文件受密码保护;导入只会添加归档,不会切换身份或覆盖现有账户。可选择包含指纹设置,但不会包含浏览器 Cookie、密码或代理设置。代码仓库还介绍了加密设备间传输,以及身份备份的安全检查。

需要注意以下边界:不会扫描 Claude 自身数据目录之外的项目源代码;不会自动纳入自定义的 CLAUDE_CONFIG_DIR 位置;直接删除当前选定的数据不会创建归档,删除已保存的卡片则会移除相应归档。两种操作都需要明确确认。文件系统所有权或管理员访问权限并非绝对的保密屏障;已过期或被服务器撤销的登录仍可能需要重新认证。

测量浏览器环境,而不仅仅是检查配置

CCBaga 的浏览器检查涵盖网络出口及预估国家/地区、时区、语言、平台、CPU 核心数、浏览器引擎版本和位置设置。只有在检查结果匹配、报告到达清理器且没有遗留测量错误时,才会显示成功页面。

区分清除缓存与完整重置尤其重要。Clear cache 会保留登录状态和个人浏览器数据。Clear all browser data 会永久重置当前身份的整个浏览器配置文件,包括已保存的密码、加密元数据、书签、历史记录、扩展程序、设置和网站会话。此操作不会影响其他身份的配置文件或身份保险库,并且需要单独确认,且不会创建备份。

绿色结果只是有限的证据,并不保证匿名性或账户一定会被接受。DNS 和 WebRTC 泄漏检查未经独立验证,IP 地理位置也是外部服务给出的估算值。选择区域会更改语言、时区和区域设置,但不会更改公网 IP。轮换指纹会关闭并重启 CCBaga-B,因此请先保存尚未完成的浏览器工作。

可选且须经批准的网络配置

Network 页面提供三步指南——获取 VPS、获取住宅代理、安装 Skill——以及可复制的提示词,可用于选定的编码代理:General、Codex、Cursor、OpenCode 或 Copilot。独立的 ccbaga-network Skill 遵循 Agent Skills 规范,可通过以下命令安装:

npx skills add liseami/CCBaga --skill ccbaga-network --global

该 Skill 支持经授权的 Debian 12 或 13 服务器,并要求使用 root 密钥通过 22 端口登录。提供 VPS 地址、匹配的 PEM/PPK/PUB 密钥文件或下载的密钥包,以及住宅 SOCKS5 连接详情后,它可以配置 Xray/Reality、检查 SSH 身份和固定的 SOCKS5 出口,并在服务器自检通过后提供私有本地导入文件。只有在用户批准实际变更后,才会对远程服务器进行修改。客户端设置为 TUN ON、System Proxy OFF,并将显式浏览器代理留空;TUN 和浏览器行为仍需分别验证。

订阅 URL 使用 HTTP 且包含凭据,因此项目建议优先使用通过 SSH 获取的文件。应用本身不会收集 SSH 密钥或代理凭据,也不会向服务器部署内容。网络配置是可选的:维护本地身份和浏览器无需 VPS 或代理订阅。提供给编码代理的数据受该服务提供商的数据处理实践约束。

安装与开发

官方支持的平台为 Apple Silicon 上的 macOS 12 或更高版本、Linux x86_64,以及 Windows 10/11 x86_64。不支持 Intel Mac 和 Linux ARM64。Linux 构建包括在 Ubuntu 22.04(glibc 2.35)上构建的 DEB、RPM 和 AppImage 包,以及一个适用于当前 Arch/pacman 系统的独立软件包;这些软件包均包含配套浏览器。Windows 使用包含两款应用的 NSIS 安装程序。安装程序未经过 Authenticode 签名,可能触发 SmartScreen 警告,也可能被受管理的安全策略拦截。

在 macOS 上,请下载官方的 CCBaga-<version>-macos-arm64.dmg。一个磁盘映像中包含 CCBaga-A.app 和 CCBaga-B.app,无需单独下载浏览器。将两款应用拖入 Applications,然后启动 CCBaga-A;它会启动配套浏览器。

针对 macOS 源码构建,代码仓库说明了 Bun、Rust、Xcode Command Line Tools,以及需要单独获取的浏览器引擎。获取脚本会下载固定版本 Fingerprint Chromium 148.0.7778.215 的 macOS arm64 引擎,验证其 SHA-256,并保留应用包结构和声明文件。基本开发步骤如下:

bun install --frozen-lockfile
python3 scripts/fetch-browser.py
sh scripts/make-icons.sh
sh scripts/package-browser.sh
bun run tauri dev

可用的检查包括 bun run build、bun test、通过 cargo test --manifest-path src-tauri/Cargo.toml 运行 Rust 测试、浏览器签名测试,以及离线 Network Skill 测试。项目的 CI 会在 Ubuntu、macOS 和 Windows 上运行前端、原生 Rust、Skill 和安装检查。文档所述工作流使用只读令牌,不使用签名密钥,也不上传构建产物;完整的引擎和安装程序验证则会单独进行。

CCBaga 的架构结合了用于原生命令和事务边界的 Rust 与 Tauri 2、用于界面的 React 19 和 TypeScript、用于操作系统集成的平台专属桥接层,以及用于获取真实浏览器读数的专用 Chromium 运行环境。其核心设计原则是可观测性与明确的边界:切换前先归档,执行破坏性操作前先征求许可,区分已应用的设置与实际测量结果,并明确呈现平台限制,而不是暗示所有环境或账户状态都受到覆盖。

来源

liseami/CCBaga