CC

管理登录

管理 OAuth 账号与网关 API Key

API 调用只用 sk-gw-*,无需管理登录(与官方一致)。

CC
Claude Gateway
—

账号 / API Key

1 OAuth 号 → 1 Key → 1 设备 → 1 出口代理

还没有账号。创建后会生成 sk-gw-*,并绑定 Claude↔Bun 版本与 device_id。

每个 Claude Code 版本必须绑定唯一 Bun 版本/镜像(一对一)。账号只能选择已启用的绑定。

集中管理 SOCKS/HTTP 出口代理;账号侧仅下拉选择,勿在账号里手写 URL。

还没有代理。先添加 socks5/http 出口,再在账号里选用。

—

组件状态

日志

暂无可下载日志

          

请求容量

Worker 上限读取中…

请求超时

请求策略

自动停用异常账号
Cache Control

模型兼容

流量日志

记录错误请求

后台任务

Token 预刷新

新账号默认

会话池

两种入口

  • 管理 UI:需登录,用于版本绑定、OAuth 档案、Key、设备、代理。
  • 业务 API:只带 x-api-key: sk-gw-…,无 Session(与 Anthropic 官方一致)。
  • 客户端策略(按 sk-gw):默认「仅 Claude Code」;可选「允许所有」——补 tools/人设并剔除易泄露工具名后出站。

版本强绑定

Claude Code 版本与 Bun worker 版本/镜像 1:1;出站 UA / cch 跟 Claude 版本,TLS 跟 Bun pin。

Claude Code 接入

export ANTHROPIC_BASE_URL=http://<网关>:8790
export ANTHROPIC_API_KEY=sk-gw-xxxxxxxx
# 账号 client_policy=claude_code_only(默认)时须用 CLI
# 开放其它客户端:编辑账号 → 客户端策略 → 允许所有

OAuth 授权

账号卡片 →「OAuth 授权」→ 打开链接登录 → 粘贴 localhost 回调 URL。交换 token 与 Messages 共用该号 egress 代理。

探测 Key

curl -s http://127.0.0.1:8790/v1/me -H 'x-api-key: sk-gw-…'

新建账号

在「出口代理」页维护列表;allow_all 账号必须选择代理。

默认仅 CLI。选「允许所有」须选代理且勿与 only-CLI 号共用出口。详见 docs/上线检查清单.md。

按账号固化 OS/Arch 画像,减少全池同一 Linux 指纹;可后续加预设。

device_id
—

新建账号保存后自动生成;编辑时可重置(出站 metadata 指纹会变)。

account_uuid
(空 · 待 OAuth 回填)

只读(与 device_id 同样式)。仅 OAuth 授权/刷新成功后由官方 account.uuid 回填;未授权前为空。

选择后只显示对应字段;OAuth 也可点卡片「OAuth 授权」完成。

新建版本绑定

Claude 内嵌 Bun rev(私有 · 拆包对照,不可改)
—
JA3 hash(只做对照,不可改 · 不影响出站)
—

出站 TLS 由 Bun 镜像 ref 决定;请用 tools/ja3-compare / 矩阵导入写入,管理台不可改。

User-Agent(由 Claude 版本 + entrypoint 自动生成,无需手填)
claude-cli/x.y.z (external, cli)

修改管理员密码

修改成功后其它已登录会话会失效,本机会用新会话继续保持登录。

从 version-matrix 导入

只读仓库内 tools/version-matrix/matrix.json + image-pin,不跑 下载 / JA3 / shell 门禁。 仅 gates.cch_formula 与 ja3_match_worker 为真且字段齐全的版本可导入(稳定门槛)。

新建代理

仅 socks5:// / socks5h:// / http:// / https://。不能粘贴完整 Clash/mihomo 订阅;若本地 mixed-port=7890,填 socks5://127.0.0.1:7890。

OAuth 授权

与官方 CLI 相同:redirect_uri=http://localhost:端口/callback(非 platform 固定回调)。 登录后浏览器会跳到 localhost(可能打不开,正常)。 复制地址栏完整 URL 粘贴下方。Token 交换走账号 egress 代理。

redirect_uri: —

打开授权页

确认操作

预览