ccl

command module

v1.3.12 Latest Latest Go to latest Published: Jul 27, 2026 License: MIT Imports: 1 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/claude-code-launch/ccl

Links

Open Source Insights

README ¶

ccl: Claude Code 多网关智能代理启动器

ccl 是 Claude Code（Anthropic 官方 CLI）的多模型网关启动器。

用一句话理解它：

你继续用 Claude Code 的界面和习惯，ccl 负责帮你接上不同的模型来源（DeepSeek / OpenRouter / ChatGPT 订阅 / Gemini / Grok / Copilot / Kimi 等），并在需要时自动做协议翻译。

适合这些场景：

想用更便宜的 OpenAI 兼容网关跑 Claude Code
想用 ChatGPT / Gemini / Grok / Copilot / Kimi 等订阅账号
需要在多个网关 / 多个账号之间快速切换
不想手写复杂的环境变量和模型映射

5 分钟上手（新手优先看这里）

1. 安装

任选一种方式：

# 推荐：npm 全局安装
npm install -g @claudecodelaunch/ccl

# 或：Go 安装
go install github.com/claude-code-launch/ccl@latest

# 或：从源码编译
git clone https://github.com/claude-code-launch/ccl.git
cd ccl
go build -o ccl .

也可以从 GitHub Releases 下载对应平台的二进制：

平台	文件名
macOS Intel	`ccl-darwin-amd64`
macOS Apple Silicon	`ccl-darwin-arm64`
Linux amd64	`ccl-linux-amd64`
Linux arm64	`ccl-linux-arm64`
Windows x64	`ccl-win32-x64.exe`
Windows arm64	`ccl-win32-arm64.exe`

chmod +x ccl-darwin-arm64
mv ccl-darwin-arm64 /usr/local/bin/ccl

安装后检查：

ccl version
ccl doctor

ccl doctor 会检查本地依赖；如果还没装 Claude Code CLI，会尝试自动安装。

2. 选一条入门路径

路径 A：用订阅账号登录（最简单）

# 任选其一
ccl auth gpt        # GPT / Codex (OpenAI 订阅)
ccl auth gemini     # Google Gemini
ccl auth grok       # xAI Grok
ccl auth copilot    # GitHub Copilot
ccl auth kimi       # Kimi / Moonshot
ccl auth claude     # Anthropic Claude 订阅

# 登录成功后直接启动
ccl

登录成功后，ccl 会自动创建并切换到对应 provider。多账号可以加别名：

ccl auth gpt work
ccl auth gpt personal
ccl use work

路径 B：用 API Key / 第三方网关

# 交互式配置（推荐）
ccl set

# 或指定名称
ccl set deepseek

按提示填写：

Endpoint URL（例如 https://api.deepseek.com）
API Key
选择 Auto（自动映射模型）或 Manual（自己指定 Opus / Sonnet / Haiku）
在最后一页核对并保存

然后启动：

ccl

3. 日常三板斧

ccl                 # 用当前 provider 启动 Claude Code
ccl ls              # 看看有哪些 provider
ccl use deepseek    # 切换 provider
ccl doctor          # 连不通时先跑诊断

可选：信任环境里不想每次点权限确认时：

ccl bypass on       # 启动时自动加 --dangerously-skip-permissions
ccl bypass          # 查看状态
ccl bypass off      # 关闭

注意：bypass 会跳过 Claude Code 的交互式权限确认，只在你信任的环境开启。

4. 新手最常卡的点

现象	建议
不知道从哪开始	有订阅就 `ccl auth ...`；有 API Key 就 `ccl set`
启动后模型不对	`ccl map` 或 `ccl set` 重新映射 Opus / Sonnet / Haiku
连不上 / 鉴权失败	`ccl doctor`，再 `ccl preview` 看注入了什么环境变量
多个账号互相覆盖	登录时加别名：`ccl auth gpt work`
想换中英文界面	`ccl lang zh` / `ccl lang en`
旧文档里的 `ccl auto`	已更名为 `ccl bypass`，配置字段是 `bypass_mode`

它具体帮你做什么？

智能多档模型映射
未手动配置时，自动拉取上游模型列表，按关键词分配到：
- 💎 Opus 强推理档
- 🚀 Sonnet 黄金档
- ⚡ Haiku 极速档
  用 ccl set / ccl map 手动指定后，对应档位以手动为准。
协议翻译与流式代理
内嵌 CLIProxyAPI Go SDK。OpenAI Chat、OpenAI Responses、Codex 与 OAuth provider 统一暴露本机 /v1/messages；Anthropic 兼容网关保持直连。
交互式 TUI 配置
全屏向导配置 endpoint、协议、模型槽位、上下文压缩等；支持中文 / English（ccl lang）。
环境诊断
ccl doctor 检查依赖、连通性、鉴权，并批量测模型可用性。
多通道 / 多账号
配置在 ~/.ccl/config.yaml；OAuth 凭据在 ~/.ccl/auth。可随时 use / ls / cp / mv / rm。
订阅 OAuth 一键接入
gpt / gemini / grok / copilot / kimi / claude，支持多账号别名；token 会在运行时刷新。

命令速查

启动 Claude Code

ccl                              # 启动
ccl resume                       # 透传参数给 Claude Code
ccl --dangerously-skip-permissions

`ccl bypass` — 权限确认旁路（原 `ccl auto`）

ccl bypass          # 查看状态
ccl bypass on       # 开启
ccl bypass off      # 关闭

全局开关，写入 ~/.ccl/config.yaml 的 bypass_mode。开启后，所有由 ccl 拉起的 Claude Code 会话都会自动带上 --dangerously-skip-permissions。

旧版命令 ccl auto / 字段 auto_mode 已更名为 ccl bypass / bypass_mode。

`ccl debug` — 运行时诊断日志

ccl debug          # 查看状态
ccl debug on       # 开启，默认写 /tmp/ccl-debug.log
ccl debug off      # 关闭

debug 是全局开关，写入 ~/.ccl/config.yaml 的 debug_mode。开启后，所有由 ccl 拉起的 Claude Code 会话会把运行时诊断写入 /tmp/ccl-debug.log（可用 CCL_DEBUG_LOG=/path/file.log 覆盖）。日志包含 runtime 启动信息、上游 401/429/5xx/stream 错误、OAuth refresh/cooldown 事件、会话模型与设置数量等元数据；不会写入 access token、refresh token、Authorization header、API key 或请求/响应正文。

`ccl auth` — 登录订阅账号

ccl auth gpt
ccl auth gemini
ccl auth grok
ccl auth copilot
ccl auth kimi
ccl auth claude

# 多账号别名
ccl auth gpt work
ccl auth gemini personal

# 可选
ccl auth gpt --no-browser
ccl auth gpt --callback-port 1455

provider	backend	协议	登录方式
`gpt`	codex	`openai(responses)`	OpenAI OAuth 回调
`copilot`	codex	`openai(responses)`	GitHub device-code
`gemini`	antigravity	`openai(chat)`	Google/Antigravity OAuth
`grok`	xai	`openai(chat)`	xAI device-code
`kimi`	kimi	`openai(chat)`	Kimi/Moonshot device-code
`claude`	claude	`anthropic`	Anthropic OAuth 回调

说明：

不带别名时，会从凭据文件名派生 provider 名（如 gpt-alice@example.com），避免多账号互相覆盖。
每条 provider 通过 oauthAccountCredential 绑定具体账号文件。
不再提供 --protocol 覆盖；各 OAuth backend 协议固定。
旧版 ccl auth chatgpt 仍可用，会规范为 gpt。
GPT 默认槽位（空槽位时写入；已有手动映射会保留；chatgpt 为兼容别名）：
- Opus / Custom → gpt-5.6-sol
- Sonnet → gpt-5.6-terra
- Haiku → gpt-5.6-luna
Grok 默认槽位（空槽位时写入；已有手动映射会保留）：
- Opus / Custom → grok-4.5
- Sonnet → grok-4.3
- Haiku → grok-3-mini
Gemini 默认槽位（空槽位时写入；已有手动映射会保留）：
- Opus / Custom → claude-opus-4-6-thinking
- Sonnet → claude-sonnet-4-6
- Haiku → gemini-3.1-pro-low
启动时若上游 model list 没有对应首选模型，会清除该首选默认并回退自动发现映射。
Fast mode（约 1.5x 速度、更高用量）仅 gpt / copilot 有意义：可在 ccl set 的「核对并应用 / Review & Apply」页编辑，也可在 Claude Code 内用 /fast 开关。

导入已有授权文件

ccl auth import ~/xai-haiboyuwen@icloud.com.json
ccl auth import ~/auth-backup          # 只读取目录第一层的 *.json，不递归
ccl auth import ~/codex.json --provider copilot

导入前会验证 JSON 和 CPA backend 类型。
ccl 不依赖源文件名，会按凭据身份生成规范名称（例如 xai-user@example.com.json），并在 ~/.ccl/auth/ 保存一份权限为 0600 的独立副本。
codex 文件默认识别为 gpt；如果它来自 GitHub Copilot device flow，使用 --provider copilot。
导入后自动刷新账号 provider。手动向 ~/.ccl/auth/ 移入、移出或删除 JSON 后，可运行：

ccl sync

ccl sync 会新增未登记账号、删除凭据已不存在的单账号 provider，并从 group 中裁剪失效成员；不会删除仍在磁盘上的授权文件。

OAuth 账号组

同一订阅 backend 的多个账号可以组成一个共享 token 池：

ccl auth group                               # 选择已有 group，或新建并输入名称
ccl auth group grok1                         # 直接编辑指定 group
ccl auth group grok1 --provider-name grok-pool
ccl auth group grok1 --provider grok \
  --members grok-a@example.com,grok-b@example.com

ccl auth group ls
ccl auth group cp grok1 grok-backup
ccl auth group mv grok-backup grok-prod
ccl auth group rm grok-prod

ccl use group-grok1
ccl map group-grok1                          # 组内账号共享这一份模型映射

# group- 只是推荐前缀；重命名后仍按配置类型识别
ccl mv group-grok1 grok-pool
ccl use grok-pool

ccl auth group ls 会显示 group 所在的 config.yaml 文件名与绝对路径，并以文件列表形式逐项显示组内授权 JSON 的绝对路径。

设计边界：

一个 group 只接受相同 JSON type（CPA backend）的授权。Grok、GPT、Gemini 等模型目录不同，不混在同一组；编辑已有 group 时沿用原类型，新建且存在多种类型时由选择页决定。
group 保存规范凭据文件名的引用，不复制 token；新 provider 默认命名为 group-<组名>，但该前缀只是推荐，ccl 通过 authGroup 字段识别类型。
模型池和 Opus/Sonnet/Haiku/Custom 映射保存在对应 group provider 上，组成员只负责提供不同 token。
CPA 默认对可用成员进行 round-robin，并能在失败、限流或配额冷却时换到其他成员。
编辑 group 或执行 ccl sync 后不需要重新 ccl use。下一次启动会直接读取最新成员；正在运行的 group 会话也会检测成员清单及授权文件变化并让 CPA 重新加载，后续请求使用新账号池（已经在途的请求不会迁移）。
ccl ls 的 KIND 列会显示 normal 或 group；ccl doctor 会检查 group 定义、成员文件和 JSON type 是否一致。
ccl set <group-provider> 可以像普通 provider 一样配置共享模型映射、上下文/Compact 和运行参数；账号成员仍通过 ccl auth group <组名> 管理。

端到端加密云同步

可以使用 iCloud Drive，或直接通过浏览器授权 Google Drive。每个网盘连接都有独立别名：

ccl login icloud icloud-main        # macOS 已登录并启用 iCloud Drive
ccl login google-drive personal     # 自动打开浏览器；不需要 OAuth JSON
ccl login google-drive work
ccl login google-drive --passphrase # 可选：首次创建 profile 时使用口令模式
ccl cloud ls
ccl cloud use personal              # 选择 primary
ccl cloud rename personal home
ccl cloud set work --no-mirror

ccl key export                      # 输出离线恢复密钥
ccl key export -o ~/ccl-recovery-key.txt
ccl key import                      # 新设备粘贴恢复密钥
ccl key import -f ~/ccl-recovery-key.txt
ccl key import --provider google-drive
ccl status

ccl tag release-2026-07       # 给当前本地快照打标签
ccl tag                       # 不写名称时使用 latest
ccl push                      # 默认推送 primary
ccl push --to work
ccl push --all                # 同一份密文镜像到所有 mirror Remote
ccl pull                      # 默认从 primary 拉取 latest
ccl pull --from work
ccl pull --from work --tag release-2026-07
ccl status --all

ccl logout work               # 只删除本地 token/cache/cursor
ccl logout work --revoke      # 同时撤销 OAuth 授权
ccl logout work --delete-remote --yes

ccl login google-drive 使用 CCL 内置的公开 Desktop OAuth 客户端 ID，启动本机随机端口回调并使用 PKCE；用户不需要下载、传入或保管 Desktop OAuth JSON。它只申请 drive.appdata 最小权限，不能读取普通网盘文件。每个 Remote 的刷新令牌以 0600 独立保存在本机；Google Drive 中只保存应用隐藏目录里的 ccl-sync.bundle 和短期配对 envelope。这条链路不依赖 rclone 或 Google Drive SDK。

Cloud Sync v2 会把每个网盘的 token、缓存和同步游标隔离在 ~/.ccl/cloud/remotes/<remote-id>/。旧版 cloud.json、cloud.key、cloud-state.json 和 Google 授权文件会在第一次 cloud 命令时执行本地无损迁移；迁移本身不会上传、下载或删除远端数据，并保留 *.v1.bak。

发布构建还会通过链接参数注入该 Desktop OAuth 客户端对应的 client secret；它不会作为文件分发，也不会要求最终用户输入。GitHub Release 需要配置 Actions secret GOOGLE_OAUTH_CLIENT_SECRET。从源码做本地开发时，可以临时设置 CCL_GOOGLE_OAUTH_CLIENT_SECRET；PKCE 才是桌面公共客户端保护授权码的安全边界。

macOS 默认生成随机 256-bit 主密钥并以 0600 保存在当前 Profile 的本地 key 文件中，不需要口令或 Touch ID。Linux 和 Windows 默认使用至少 12 个字符的 passphrase，通过 scrypt 派生 AES-256-GCM 密钥；macOS 也可以显式使用 --passphrase。--passphrase-file 和 CCL_SYNC_PASSPHRASE 可用于非交互登录。

ccl key export 会把当前主密钥编码成与 profile 绑定、带校验码的恢复密钥。恢复密钥和 cloud.key 都不会上传；请离线保存，任何获得恢复密钥的人都能解密同步数据。Google Drive 新设备先运行 ccl login google-drive 授权账号；若远端已有 profile，本机缺少 key，随后运行 ccl key import，ccl 会自动选择已授权的 Google Drive，也可以使用 --provider google-drive 明确指定。恢复密钥通过远端加密 verifier 验证成功后，才会写入本机登录状态。

也可以让一台已经授权的设备批准新设备，不需要输入恢复密钥：

# 新设备：先登录同一个云账号；ccl 会提示缺少 profile key
ccl login google-drive personal
ccl device request --via personal --name "New MacBook"

# 已授权设备：必须输入新设备显示的完整 12 位代码
ccl device ls --all
ccl device approve J7KM-P4QX-2R9D

# 新设备
ccl device complete J7KM-P4QX-2R9D

配对请求 10 分钟过期。协议使用 X25519、HKDF-SHA256 和 XChaCha20-Poly1305；网盘只能看到一次性公钥和密文。所有已授权设备都丢失时，离线恢复密钥仍是唯一恢复手段。

配置、授权、标签和版本索引会先 gzip 压缩再用 AES-256-GCM 加密。远端明文只包含格式版本、随机 profile ID，以及口令模式所需的随机 KDF 盐，不包含用户配置、主密钥、passphrase 或恢复密钥。

同步范围：

~/.ccl/config.yaml
~/.ccl/auth/*.json（只包含第一层）

cloud.key、Google OAuth 令牌、设备状态和本地备份不会上传。

版本与冲突行为：

没有手动 ccl tag 时，ccl push 自动使用可移动的 latest 标签。
相同标签和相同内容不会重复上传。
命名标签默认不可覆盖；内容不同会要求换一个标签，或显式使用 ccl push --force。
如果本地和远端都从上次同步后发生变化，push/pull 会停止并报告冲突，不会静默覆盖。
ccl pull --force 会覆盖未同步的本地变化，但覆盖前会在 ~/.ccl/backups/ 留下一份同样经过压缩加密的本地快照。
ccl status 会显示当前 provider、解锁模式和同步状态。
ccl status --all 会逐个检查 Remote；一个网盘不可达不会掩盖其他网盘的状态。
ccl push --all 会先预检所有目标，并复用同一个 snapshot ID 和密文；部分提交通过本地 operation journal 重试。
ccl pull 永远只从一个明确来源读取，不会在多个分叉网盘间自动猜测“最新”。
默认 ccl logout 不删除远端密文或 Profile key。
ccl key import 也接受位置参数、--file、CCL_SYNC_RECOVERY_KEY 或 stdin。
iCloud 使用 Drive 中的 ccl-sync/；Google Drive 使用该 OAuth 应用专属、用户界面不可见的 appDataFolder。不同 Google 账号之间不会共享这一目录。
CCL_ICLOUD_DRIVE_DIR 仅用于测试或自定义 iCloud Drive 挂载位置。

`ccl set` — 添加 / 更新 Provider

ccl set                 # 交互选择已有或新建
ccl set my-provider     # 指定名称

TUI 大致流程：

步骤	内容
Step 1	Endpoint + API Key
Step 2	Auto / Manual 配置模式
Step 3	Opus / Sonnet / Haiku / Custom / Subagent 映射
Step 4	扩展上下文 `[1m]` + Auto Compact 预设
Step 5	核对 Connection / Mapping / Runtime 并保存

Context & Compact：

Extended Context [1m]（按槽位）：声明该模型 ID 支持扩展上下文。
Auto Compact（Provider 全局）：设置默认上下文与绝对压缩窗口。

压缩预设	默认上下文	自动压缩窗口	说明
Custom (preserve)	保留现值	保留现值	保护自定义配置
Claude default	未管理	未管理	删除 ccl 覆盖
Switch-safe 300K / 200K	300,000	200,000	常切换标准上下文时较稳妥
Balanced 500K / 400K	500,000	400,000	容量与余量平衡
Maximum 1M / 900K	1,000,000	900,000	超长会话

Provider 管理

ccl ls
ccl ls -a
ccl use provider-name
ccl cp source target
ccl mv old-name new-name
ccl rm name

# 完整语义入口（效果相同）
ccl provider ls
ccl provider use my-provider
ccl provider set my-provider
ccl provider map
ccl provider models
ccl provider env
ccl provider doctor
ccl provider preview

`ccl map` — 快速映射模型槽位

ccl map                                          # 交互式 TUI
ccl map auto                                     # 自动填充前几个槽位
ccl map --opus gpt-5.1 --sonnet gpt-5.1-mini
ccl map --haiku gpt-4o-mini
ccl map --custom gpt-5.1 my-provider
ccl map --subagent gpt-5.4-mini

`ccl models` / `ccl doctor` / `ccl preview`

ccl models              # 测试已配置模型
ccl models --all        # 查看并测试 provider 全部模型
ccl doctor              # 依赖 + 连通性 + 鉴权 + 模型可用性
ccl preview             # 预览将注入 Claude Code 的 settings JSON

`ccl env` — 环境变量

ccl env ls
ccl env KEY VALUE
ccl env mv OLD_KEY NEW_KEY
ccl env rm KEY

其它

ccl lang                # 交互切换语言
ccl lang zh
ccl lang en

ccl update              # 升级
ccl version             # 版本
ccl completion zsh      # shell 补全（也支持 bash/fish/powershell）

语言优先级：CCL_LANG 环境变量 > config.yaml > 系统语言。

配置文件

路径：~/.ccl/config.yaml

active_provider: deepseek
lang: zh-CN
bypass_mode: false
providers:
  deepseek:
    name: deepseek
    type: openai
    endpoint: https://api.deepseek.com
    apikey: sk-xxx
    model: deepseek-chat,deepseek-reasoner
    opusModel: deepseek-reasoner
    sonnetModel: deepseek-chat
  sensenova:
    name: sensenova
    type: anthropic
    endpoint: https://token.sensenova.cn
    apikey: sk-xxx
    anthropicAuth: bearer
  gpt:
    name: gpt
    type: openai_responses
    endpoint: oauth://codex
    oauthProvider: gpt
  group-grok1:
    name: group-grok1
    type: openai
    endpoint: oauth://xai
    oauthProvider: grok
    authGroup: grok1
    customModelId: grok-4.5
    opusModel: grok-4.5
    sonnetModel: grok-4.3
    haikuModel: grok-3-mini
auth_groups:
  grok1:
    oauthProvider: grok
    credentials:
      - xai-a@example.com.json
      - xai-b@example.com.json

字段要点：

type: openai（显示 openai(chat)）：经 CLIProxyAPI 转到上游 Chat Completions。
type: openai_responses（显示 openai(responses)）：经 SDK 走 Responses API；Codex 路径默认选 Responses，可在核对页切换。
type: anthropic：Claude Code 直连 endpoint，不做协议转换。
oauthProvider：使用已保存的 OAuth 凭据；运行时使用本机会话地址与随机 key，不写回配置。
authGroup：引用 auth_groups 中的动态账号池；成员列表不会重复写入 provider。
bypass_mode：全局是否自动附加 --dangerously-skip-permissions。
Anthropic 直连时 endpoint 建议裸域名（如 https://token.sensenova.cn），避免拼出 /v1/v1/messages。
运行时默认：子代理模型优先 Custom/Sonnet；工具并发默认 3；ENABLE_TOOL_SEARCH=false；CLAUDE_CODE_MAX_OUTPUT_TOKENS 默认 32000。可在 Review & Apply 页或 ccl env 覆盖。

OAuth 凭据目录：~/.ccl/auth/（每个账号一个 JSON）。

本地验证（开发者）

go test ./...
go build -o /tmp/ccl-debug .

export CCL_TEST_HOME="$(mktemp -d)"
HOME="$CCL_TEST_HOME" /tmp/ccl-debug set sensenova
HOME="$CCL_TEST_HOME" /tmp/ccl-debug preview
HOME="$CCL_TEST_HOME" /tmp/ccl-debug doctor
HOME="$CCL_TEST_HOME" /tmp/ccl-debug models --all

Anthropic 兼容网关建议确认：

endpoint 为裸域名，不带 /v1
Bearer 认证时 preview 出现 ANTHROPIC_AUTH_TOKEN，而不是 ANTHROPIC_API_KEY
ccl set 不再写入 effortLevel / CLAUDE_CODE_EFFORT_LEVEL
配置了 Custom model 时，preview 顶层 model 与 ANTHROPIC_CUSTOM_MODEL_OPTION 一致

CI/CD

推送 v* tag 触发多平台构建与发布：

git tag v1.2.0
git push origin v1.2.0

GitHub Actions 会构建 6 个平台二进制，并发布到 GitHub Releases + npm。

目录结构

├── cmd/
│   ├── advanced_config.go     # TUI 配置向导
│   ├── auth.go                # 订阅 OAuth 登录
│   ├── auth_import.go         # 导入并规范化已有 OAuth 文件
│   ├── auth_group.go          # 多账号组管理与多选 TUI
│   ├── auth_sync.go           # auth 目录与配置同步
│   ├── cloud_sync.go          # iCloud/Google Drive 登录、恢复密钥与同步命令
│   ├── bypass.go              # ccl bypass（权限旁路开关）
│   ├── debug.go               # ccl debug（运行时诊断日志开关）
│   ├── provider.go            # provider 子命令
│   ├── env.go                 # 环境变量管理
│   ├── set.go                 # set 命令
│   ├── select.go              # 通用 TUI 选择器
│   ├── doctor.go              # 环境与连通性自检
│   ├── install.go             # Claude CLI 自动安装
│   ├── lang_cmd.go            # 语言切换
│   ├── list.go                # ls
│   ├── map.go                 # 模型槽位映射
│   ├── models.go              # 模型列表与可用性
│   ├── root.go                # 主入口 + passthrough
│   ├── preview.go             # 预览 settings JSON
│   ├── update.go              # 升级
│   ├── use.go                 # 切换 provider
│   └── version.go             # 版本
├── internal/
│   ├── cloudsync/             # 压缩、AES-GCM 加密、快照和冲突处理
│   ├── claude/                # Claude Code 进程拉起
│   ├── config/                # yaml 配置读写
│   ├── locale/                # 多语言
│   ├── modelrouting/          # 档位启发式映射
│   ├── oauthproxy/            # CLIProxyAPI 登录与内嵌运行时
│   ├── protocol/              # endpoint 规范化与探测
│   └── provider/              # Provider / Config 结构
└── main.go

开源许可

MIT。CLIProxyAPI SDK 的第三方许可见 THIRD_PARTY_NOTICES.md。

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

Path	Synopsis
cmd
internal
claude
config
locale Package locale provides cross-platform language detection and translation.	Package locale provides cross-platform language detection and translation.
modelrouting
oauthproxy Package oauthproxy embeds CLIProxyAPI as ccl's OpenAI-family runtime.	Package oauthproxy embeds CLIProxyAPI as ccl's OpenAI-family runtime.
protocol
provider

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

ccl

README ¶

ccl: Claude Code 多网关智能代理启动器

5 分钟上手（新手优先看这里）

1. 安装

2. 选一条入门路径

路径 A：用订阅账号登录（最简单）

路径 B：用 API Key / 第三方网关

3. 日常三板斧

4. 新手最常卡的点

它具体帮你做什么？

命令速查

启动 Claude Code

`ccl bypass` — 权限确认旁路（原 `ccl auto`）

`ccl debug` — 运行时诊断日志

`ccl auth` — 登录订阅账号

导入已有授权文件

OAuth 账号组

端到端加密云同步

`ccl set` — 添加 / 更新 Provider

Provider 管理

`ccl map` — 快速映射模型槽位

`ccl models` / `ccl doctor` / `ccl preview`

`ccl env` — 环境变量

其它

配置文件

推荐工作流示例

只用 DeepSeek 便宜跑

ChatGPT 订阅 + 本地 API 网关并存

排查「为什么没用上我想要的模型」

本地验证（开发者）

CI/CD

目录结构

开源许可

Documentation ¶

Source Files ¶

Directories ¶

README ¶

ccl: Claude Code 多网关智能代理启动器

5 分钟上手（新手优先看这里）

1. 安装

2. 选一条入门路径

路径 A：用订阅账号登录（最简单）

路径 B：用 API Key / 第三方网关

3. 日常三板斧

4. 新手最常卡的点

它具体帮你做什么？

命令速查

启动 Claude Code

ccl bypass — 权限确认旁路（原 ccl auto）

ccl debug — 运行时诊断日志

ccl auth — 登录订阅账号

导入已有授权文件

OAuth 账号组

端到端加密云同步

ccl set — 添加 / 更新 Provider

Provider 管理

ccl map — 快速映射模型槽位

ccl models / ccl doctor / ccl preview

ccl env — 环境变量

其它

配置文件

推荐工作流示例

只用 DeepSeek 便宜跑

ChatGPT 订阅 + 本地 API 网关并存

排查「为什么没用上我想要的模型」

本地验证（开发者）

CI/CD

目录结构

开源许可

Documentation ¶

Source Files ¶

Directories ¶

`ccl bypass` — 权限确认旁路（原 `ccl auto`）

`ccl debug` — 运行时诊断日志

`ccl auth` — 登录订阅账号

`ccl set` — 添加 / 更新 Provider

`ccl map` — 快速映射模型槽位

`ccl models` / `ccl doctor` / `ccl preview`

`ccl env` — 环境变量