cc-gateway

CC Gateway（Creative Commons Gateway）是 motiful 在 GitHub 上开源的 AI API 身份网关，定位为 Claude Code 与 Anthropic API 之间的反向代理。它通过标准化设备指纹、环境变量和遥测数据，在不绕过官方计费的前提下，帮助用户实现隐私保护的 API 流量管控。该项目于 2026 年 4 月发布首个版本，当前 Stars 数已超过 2800，属于 AI 工具链中增长较快的小众实用项目。

背景故事：为什么有人愿意为此付费

作者 motiful 在项目 README 中坦言自己为 Anthropic 付费近 200 美元/月，拥有笔记本、台式机和 iPad 三台设备，但账户却因"多设备检测"被封禁——没有任何警告，没有任何解释，也没有导出历史记录的方式。更令人沮丧的是，官方并不提供家庭或企业多设备管理方案。motiful 没有选择绕过付费限制或共享账号，而是花时间开发了一个透明的反向代理：让多台设备通过同一个受控出口访问 Anthropic API，使服务提供商看到的是单一、一致的身份。这是一种技术上优雅、道德上清白的解法。

核心功能：四层重写机制

第一层：身份标准化

Claude Code 每次启动会生成一个唯一的 device_id，并向 API 发送邮件地址、会话元数据和 user_id JSON blob。CC Gateway 将这些信息全部替换为统一的规范身份（Canonical Identity），用户可自定义设备 ID、邮箱和会话名。所有设备共用同一身份，Anthropic 无法通过设备指纹区分用户的多台机器。

第二层：环境变量完整替换

Claude Code 发送的 env 对象包含 40+ 维度的环境信息：操作系统版本、CPU 架构、Node.js 版本、终端类型、Shell 类型、包管理器、已安装运行时等。CC Gateway 不是逐个字段 patch，而是用规范配置文件中的对应值整体替换整个 env 对象，确保即使新版本 Claude Code 引入了新的环境探测字段也能被覆盖。

第三层：系统提示词净化

Claude Code 在每次对话的系统提示词中注入 <env> 块，包含平台、Shell、OS 版本和工作目录路径。这些信息经过 Gateway 时会被改写为规范身份对应的值，防止从提示词中泄露真实设备信息。

第四层：计费头剥离与跨会话缓存

Claude Code 发送的 x-anthropic-billing-header 包含每个会话的指纹哈希，剥离后不仅保护隐私，还能启用跨会话 prompt cache 共享——据项目文档，Claude Code 的系统 prompt 长度约 6000 tokens，剥离计费头后可将系统 prompt 成本降低约 85%。

技术架构：TypeScript 模块化反向代理

CC Gateway 采用 TypeScript + Node.js 构建，使用 ESNext 模块系统，编译目标为 ES2022。代码结构清晰，核心模块包括：

• proxy.ts：HTTP/HTTPS 代理核心逻辑，处理请求路由
• rewriter.ts：请求体重写引擎，负责替换身份、env、提示词中的敏感字段
• auth.ts：OAuth 生命周期管理（token 获取、自动刷新、故障恢复）
• oauth.ts：Anthropic OAuth 端点交互封装
• proxy-agent.ts：自定义 HTTP Agent，处理代理环境变量（HTTPS_PROXY / HTTP_PROXY / ALL_PROXY）
• config.ts：YAML 配置文件解析和验证
• logger.ts：连接级请求日志（Inbound IP + Client Name 记录）

配置通过 config.yaml 管理，支持 TLS 证书配置、多客户端管理、规范身份定义等。

部署方式：零配置体验

项目提供三种部署路径：

一键 Docker 部署（推荐）：bash scripts/admin-setup.sh 交互式脚本自动提取 OAuth 凭证、生成配置和首个客户端启动器、构建并启动 Docker 容器。非交互式：bash scripts/quick-setup.sh 一行命令完成本地启动。

纯 Node.js 部署：npm install && npx tsx src/index.ts 即可运行，开发模式 npm run dev（ts-node watch）支持热重载。

多机部署：通过 TLS 证书配置远程网关，所有客户端机器（包括管理员机器本身）都通过网关访问 Anthropic，管理员机器直连也会产生第二个设备指纹。

争议与局限

CC Gateway 的技术手段干净，但它处于一个灰色地带：Anthropic 可能随时更新检测策略，40+ 字段的完整替换是当前版本能做到的最大努力。另外，它无法解决账户被封禁后恢复的问题——Gateway 只负责访问控制，不提供绕过封禁的能力。作者明确声明"不用于共享账号、不用于商业用途、不用于绕过费率限制"，并将项目定位为教育研究用途。

行业意义

在 AI 隐私意识逐渐增强的背景下，CC Gateway 代表了一种新兴需求：用户既想使用 AI 服务，又不希望自己的设备指纹、使用习惯和地理位置被完整记录并用于行为分析。它展示了一种不依赖 VPN 或欺骗手段、而是通过标准化身份来保护隐私的工程思路。随着 Claude Code 用户群体扩大，类似的多设备身份管理工具可能会成为 AI 工具链的标配组件。