sub2api // 接入文档
// 配置切换器 · 一键切供应商

cc-switch 配置教程

cc-switch 是一个管理 Claude Code / Codex 多套配置的切换器。把 sub2api 存成一个「供应商预设」，之后在官方、sub2api、其他网关之间一键切换，无需手动改环境变量。

0它解决什么问题

手动接入时，切换网关要反复改 ~/.claude/settings.json 或 ~/.codex/config.toml。cc-switch 把每套「地址 + Key + 模型」存成一个预设，点一下就把对应配置写回到 Claude Code / Codex 的配置文件里。

本质 cc-switch 不是代理，它只是帮你管理和切换本地配置文件。切到某个预设 = 把该预设的 Base URL / Key 写进 Claude Code（或 Codex）的配置。真正转发请求的还是 sub2api 网关。

1安装

cc-switch 是桌面应用（Windows / macOS / Linux）。到项目 Releases 页下载对应安装包即可：

macOS · .dmg Windows · .exe / .msi Linux · .AppImage
下载 GitHub 搜索 cc-switch，进 Releases 下载最新版。安装后首次打开，它会自动识别本机已有的 Claude Code / Codex 配置。

2添加 sub2api 供应商预设

  1. 打开 cc-switch → 切到「Claude Code」标签页

    顶部通常有 Claude Code / Codex 两个分区，先配 Claude Code。

  2. 点「新增供应商 / Add Provider」

    按下表填写。这几项就是接入网关的全部信息：

    字段填入
    名称 Namesub2api（自己认得就行）
    Base URLhttps://your-domain.com（不带 /v1）
    API Key / Tokensk-xxxxxxxxxxxxxxxx
    模型 Model（可选）claude-sonnet-4-5

  3. 保存

    列表里会出现一条 sub2api 预设。

  4. 点它 → 切换 / Apply

    cc-switch 会把这套配置写入 ~/.claude/settings.json。此时打开 Claude Code 就直连你的网关了。

3Codex 侧同理

切到 cc-switch 的「Codex」分区，新增供应商，注意 Codex 的地址规则不同：

字段填入
名称sub2api
Base URLhttps://your-domain.com/v1（带 /v1）
API Keysk-xxxxxxxxxxxxxxxx
协议 wire_apiresponses

切换后，cc-switch 会把对应内容写进 ~/.codex/config.toml（等价于 Codex 教程里那份手写配置）。

4验证切换生效

在 cc-switch 点了某个预设后，可以直接查底层配置文件确认写入成功：

bash — 确认写入 复制 
# Claude Code 侧
$ cat ~/.claude/settings.json
{ "env": { "ANTHROPIC_BASE_URL": "https://your-domain.com",
           "ANTHROPIC_AUTH_TOKEN": "sk-xxxx", ... } }

# Codex 侧
$ cat ~/.codex/config.toml
model_provider = "sub2api"
[model_providers.sub2api] base_url = "https://your-domain.com/v1" ...

# 然后正常启动即可
$ claude       # 或 codex

5多预设玩法

🔑

多 Key 分账

给同一网关建多个预设（不同 Key），按项目/客户切换，用量分开统计。

🌐

多网关备份

主网关 + 备用网关各存一条，主网关抖动时一键切到备用。

🏢

官方 / 自建并存

官方 Anthropic 与自建 sub2api 各一条，随时来回切。

注意 cc-switch 是通过覆写本地配置文件来切换的。如果你同时手动 export 了环境变量，环境变量优先级可能更高、盖过 cc-switch 的写入。用 cc-switch 就别再手动 export，避免两边打架。
← 上一篇Codex 接入