CC Gateway 是一个夹在 Claude Code 与 Anthropic API 之间的反向代理,定位是「拿回对 AI API 遥测的控制权」:它把设备标识、环境指纹(40+ 维度)、进程指标等都改写成一份统一的「规范化身份」,并剥离计费/归因相关 header,从而控制哪些遥测离开你的网络。技术上是 TypeScript 实现、MIT 开源、Docker 可部署。需要前置说清楚的是它的双刃性:除了「减少自己使用时的遥测泄露」这一隐私用途,它的设计(集中式 OAuth + 给多个客户端各发启动脚本 + 把所有设备伪装成同一规范身份 + 去掉计费/归因头)也使「多人/多机共用一个 Claude 账号并掩盖这一事实」成为可能——这很可能违反 Anthropic 的服务条款与反滥用机制。项目自身标注 Alpha 并建议「先用非主力账号测试」,本身就提示了账号被风控的风险。本页客观说明其能力,但把合规与账号风险放在首位。
来源:README Why/Features/Disclaimer/Alpha 提示、What Gets Rewritten 表、GitHub meta(motiful/cc-gateway,TypeScript,MIT) 查看 GitHub 仓库 →Claude Code 会上报大量遥测(README 称 640+ 事件类型、40+ 环境维度、每 5 秒回传,含设备 ID、邮箱、OS、运行时、RAM 等),多机使用时每台还有唯一永久标识,官方没有内置方式管理「身份如何呈现给 API」。CC Gateway 抓住了对厂商遥测与隐私的担忧,提供一个能统一改写身份指纹、剥离遥测的代理,传播性强。但它的热度也与一个敏感卖点交织:剥离计费头可启用跨会话提示缓存共享(号称省约 85% 系统提示成本),加上多客户端 + 身份归一,实际上能支撑账号共享/绕过按设备的追踪——这部分既吸睛也最具争议。
来源:README Why/Features(billing header/cross-session cache)、GitHub meta(stars 2805、created_at 2026-03-31)把每个 API 请求里的 device_id、email、session 元数据与 user_id JSON 归一到一份规范身份;整个 env 对象(平台、架构、Node 版本、终端、包管理器、运行时、CI/部署标志等 40+ 维度)被整体替换而非局部修补。
来源:README Features、What Gets Rewritten 表(Identity/Environment)改写注入到每条提示里的
移除含每会话指纹哈希的 x-anthropic-billing-header(等同官方 CLAUDE_CODE_ATTRIBUTION_HEADER=false),并据称借此启用跨会话提示缓存共享、降本约 85%;同时剥离会暴露代理使用的 baseUrl、gateway 字段。
来源:README Features、What Gets Rewritten 表(Headers/Billing/Leak fields)网关内部统一管理 token 刷新,客户端机器不直接联系 platform.claude.com;管理员用 add-client 为每人生成带唯一 token 的启动脚本(cc-alice/cc-bob),客户端零登录、零配置即可经网关启动 Claude Code,并可选 hijack 让 `claude` 也走网关。
来源:README Features(Zero-login/Centralized OAuth)、Add Clients/Quick Start 段支持 HTTPS_PROXY/HTTP_PROXY 把出站流量(API + token 刷新)经 Clash/V2Ray 等转发,附 clash-rules.yaml;提供 Dockerfile 与 docker-compose,启动即用现有 access token、token 到期前不发网络调用。
来源:README Features(Proxy-aware/Instant startup)、Deployment、仓库(Dockerfile/docker-compose/clash-rules.yaml)CC Gateway 是 TypeScript 实现的反向代理(需 Node.js 22+),位于 Claude Code 与 Anthropic API 之间。核心在 src/,对经过的请求做多层改写:身份层(device_id/email/user_id)、环境层(整个 env 对象)、提示层(
中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
Node.js 22+ 运行时macOS Keychain(提取 OAuth 凭据)Docker / docker-compose(部署)可选出站代理:Clash / V2Ray(HTTPS_PROXY)正当角度看,它可用于「掌控自己使用 Claude Code 时上报的遥测」——把设备指纹、环境、进程指标归一以减少硬件/环境信息泄露,属隐私偏好。但其架构(集中式 OAuth + 多客户端启动器 + 身份归一 + 剥离计费/归因头)同样直接服务于「多人/多机共用一个账号并掩盖差异」「绕过按设备追踪与提示缓存计费」等用途,这类用法很可能违反 Anthropic 服务条款、触发账号风控甚至封号。是否使用应以「是否合法、是否符合 ToS、是否仅作用于自己授权的账号」为前提;本页不支持也不鼓励用它规避厂商的计费、归因或反滥用机制。
来源:README Why/Features/Disclaimer 的双面性分析项目处于 Alpha、活跃开发中(README 明确建议先用非主力账号测试)。以仓库形式迭代,提供 quick-setup/add-client 脚本与 Docker 部署。功能已覆盖身份/环境/提示/进程/头部多层改写、计费头剥离、集中式 OAuth 与多客户端。最近一次更新在 2026-04-02。
来源:README Alpha 提示/Changelog、GitHub meta pushed_at 2026-04-02、created_at 2026-03-31CC Gateway 在技术上是一份对 Claude Code 遥测做了细致逆向、并能多层归一身份指纹的反向代理,对真正只想「管理自己使用时离开网络的遥测」的隐私偏好者有一定价值。但必须把它的另一面放在前面:剥离计费/归因头、把多设备伪装成单一身份、集中式多客户端共享 OAuth 的设计,使它很容易被用于多人共用账号、绕过按设备的计费与反滥用机制——这很可能违反 Anthropic 服务条款并导致账号被风控或封禁,项目自己也只敢标 Alpha 并建议用非主力账号。因此本站的态度是:客观记录其存在与隐私层面的合理诉求,但强烈提示其合规与账号风险,不支持将其用于规避厂商的计费、归因或反滥用机制。使用与否,应以是否合法、是否符合 ToS、是否仅作用于自己授权的账号为前提。
来源:综合 README、能力与风险、Alpha/Disclaimer 与 GitHub meta 的事实判断