CC-Switch
CC-Switch 是 CatAPI 推荐的配置管理方式之一，适合同时使用 Claude Code、Codex CLI的用户。参考：CC-Switch 使用指南。
适用场景
- 需要在多个 AI CLI 之间频繁切换。
- 不想手动编辑多个配置文件。
- 希望把令牌、Base URL、模型名集中管理。
- 需要在 Claude、Codex、Gemini 不同生态之间快速切换。
基本流程
- 安装并打开 CC-Switch。
- 新增一个 CatAPI 配置。
- 填写 API Key、Base URL 和模型名。
- 选择目标工具，比如 Claude Code、Codex CLI 或 Gemini CLI。
- 保存后切换到该配置，再启动对应 CLI 验证。
常用字段
| 字段 | 建议值 |
|---|---|
| API Key | CatAPI 后台创建的令牌 |
| Base URL | https://api.catapi.com |
| Provider | 按目标 CLI 选择 Anthropic、OpenAI 或 Gemini 兼容项 |
| Model | 从 模型分组 中选择匹配模型 |
Claude Code
Claude Code 通常使用 Anthropic 兼容配置。配置重点是：
- 令牌写入 Anthropic Token 字段。
- Base URL 指向 CatAPI。
- 模型使用 Claude 或 CC 分组中可用的名称。
如果 Claude Code 仍然请求官方地址，说明当前 shell 环境或配置文件里还有旧的 Anthropic 配置。
Codex CLI
Codex CLI 通常走 OpenAI 兼容配置。配置重点是：
- API Key 使用 CatAPI 令牌。
- Base URL 使用 CatAPI 的 OpenAI 兼容入口。
- 模型选择
Codex分组内模型。
如果 Codex CLI 报鉴权或模型错误，先确认当前 profile 是否真的切换到了 CatAPI 配置。
排查顺序
- CC-Switch 当前激活的配置是否正确。
- Base URL 是否仍指向官方服务。
- 模型名是否属于当前分组。
- API Key 是否过期、复制不完整或余额不足。
- 终端是否需要重启才能读取新环境变量。