供应商识别原理
Claude Code / Codex 如何识别第三方供应商
原理
Claude Code 和 Codex 本质上是通过环境变量或配置文件来决定请求发往哪个服务器。
Claude Code
Claude Code 读取 ~/.claude/settings.json 中的环境变量:
ANTHROPIC_BASE_URL— 决定请求发往哪个服务器ANTHROPIC_AUTH_TOKEN— 认证用的 API Key
当这两个变量指向 VibeAPI 时,所有请求都会发到 VibeAPI 而不是 Anthropic 官方。
Codex
Codex 读取 ~/.codex/config.toml 中的 model_providers 配置:
base_url— 决定请求发往哪个服务器auth.json中的OPENAI_API_KEY— 认证用的 API Key
CC Switch 做了什么
CC Switch 是一站式桌面应用(官网 https://ccswitch.io),管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 共 6 个 AI CLI 工具的配置。它的核心工作是:
- 写入正确的 Base URL(
https://www.vibeapi.cn) - 写入你的 API Key
- 配置模型映射
CC Switch 自身数据存储在 ~/.cc-switch/cc-switch.db(SQLite),但它会向各工具的标准配置位置写入供应商信息。此外还提供本地路由(格式转换、故障转移)、MCP 管理、提示词/技能管理、Cloud Sync 等功能。
这些操作你完全可以手动完成(参见手动配置文档),CC Switch 只是让这个过程更方便,并提供了额外的管理能力。
为什么先装 CC Switch 再装工具
如果先装 Claude Code 并用官方账号登录,settings.json 会被官方的 OAuth token 占用。后续想切到 VibeAPI 需要手动清理。先装 CC Switch 写好配置,装完工具后直接就能用,避免冲突。