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

cc-switch 配置教程

推荐路径：后台创建 Key → 一键「导入到 CCS」→ 在 CC Switch 里启用。下面按真实截图走完 Claude / Codex / Grok 配置；Grok 额外需要模型映射。

0它解决什么问题

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

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

1安装

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

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

2后台创建 API 密钥

先在 CcApi 后台拿到可用的 sk- Key。不同客户端/模型走不同分组，创建时务必选对。

  1. 打开「API 密钥」页 → 点「创建密钥」

    进入后台的密钥管理页，右上角绿色按钮新建一条密钥。

    API 密钥列表，点击创建密钥
    步骤 1 · 密钥列表页 → 右上角「+ 创建密钥」

  2. 填写名称，并选择对应分组

    分组决定这条 Key 能用哪些模型、按什么倍率计费。常见对应关系：

    分组用途
    ClaudeClaude Code / Desktop
    GPT / GPT CodeXCodex / GPT 类客户端
    GrokGrok 模型（后面要做模型映射）
    创建密钥时选择分组
    步骤 2 · 创建密钥弹窗 →「分组」下拉选择 Claude / GPT / Grok
    分组别混 Claude Code 用 Claude 分组 Key；Codex 用 GPT 分组 Key；Grok 单独一条。混用容易出现模型 not allowed 或计费异常。

3一键「导入到 CCS」

密钥创建好后，不必手抄 Base URL / Key。后台支持直接导入到本机 CC Switch。

  1. 在密钥行点「导入到 CCS」

    对应客户端用哪条 Key，就点那一行的导入按钮（图示为 GPT / Codex 示例）。

    密钥列表中点击导入到 CCS
    步骤 3 · 操作列 →「导入到 CCS」

  2. 确认导入供应商配置

    弹窗会展示应用类型、供应商名称、API 端点、Key、默认模型等。确认无误后点「导入」。

    确认导入供应商配置到 CC Switch
    步骤 4 · 核对应用类型（如 Codex）与 API 端点后点「导入」
    导入后可改 导入只是写入 CC Switch 供应商列表。之后仍可在供应商列表里编辑、删除，或改模型映射。

4在 CC Switch 启用

导入成功后打开 CC Switch，找到刚写入的供应商（例如 CC Api）：

  1. 启用供应商，必要时测连与刷余额

    点「启用」后，退出并重新打开 Codex / Claude Code 才会吃到新配置。可用「测试连接」确认通，用刷新图标更新余额。

    CC Switch 中启用供应商、刷新余额、测试连接
    步骤 5 · 启用供应商 → 测试连接 / 刷新余额 → 退出客户端后重开
必须重开客户端 CC Switch 写的是本地配置文件。已经在跑的 Claude Code / Codex 不会热加载，启用后请完全退出再打开。

5Grok 特殊配置 · 模型映射

Grok 分组导入后，若要在 Claude Code 里用 Grok，需要把 Claude 的模型角色映射到真实 Grok 模型名。否则客户端仍按 Sonnet / Opus 等名字请求，网关对不上。

  1. 编辑 Grok 对应供应商 → 打开高级选项

    确认 API 格式与认证字段符合当前客户端；Claude Code 场景下可按截图配置，再点「获取模型列表」拉可用模型。

  2. 填写「模型映射」

    左侧是 Claude Code 的模型角色（Sonnet / Opus / Fable / Haiku），中间「显示名称」可自定义，右侧「实际请求模型」填网关真实模型 ID。

    模型角色示例显示名称实际请求模型
    Sonnetgrok-4.3grok-4.3
    Opusgrok-4.5grok-4.5
    Fablegrok-4.5-latestgrok-4.5-latest
    Haikugrok-composer-2.5-fastgrok-composer-2.5-fast
    Grok 供应商模型映射配置
    Grok 专项 · 编辑供应商 → 模型映射：角色 → 实际请求模型，保存后重新启用
    为什么要映射 Claude Code 内部按 Sonnet / Opus / Haiku 等角色选模型；Grok 没有同名模型。映射后，选 Sonnet 实际请求的是你填的 grok-* 模型。
    保存后 改完映射点「保存」，回到列表确认该供应商仍处于启用状态，再重启 Claude Code 验证。

6验证是否生效

启用后可直接查底层配置文件，确认写入成功：

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 = "CcApi"
[model_providers.CcApi] base_url = "https://your-domain.com/v1" ...

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

7多预设玩法

🔑

多 Key 分账

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

🌐

Claude / GPT / Grok

三条 Key 分别导入，日常在 CC Switch 里一键切换客户端所用供应商。

🗺️

Grok 映射复用

Grok 映射配好后可当模板；换 Key 时只改密钥，映射可保留。

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