CC-Switch 是什么
CC-Switch 用于集中管理 Claude Code、Codex CLI、Gemini CLI 等工具的供应商配置。通过独立配置项，可以减少手工修改环境变量造成的冲突。
官方下载与安装
请从项目官方 GitHub Releases 下载适合当前系统的安装包，并核对发行者和版本信息。
配置 OpenAI / Codex
Base URL：
API Key：Api Halo 控制台创建的独立令牌
模型：从模型广场复制准确名称
https://apihalo.cn/v1API Key：Api Halo 控制台创建的独立令牌
模型：从模型广场复制准确名称
- 在 CC-Switch 新增 OpenAI 或 Codex 类型配置。
- 填入 Base URL 与令牌。
- 选择或填写令牌分组支持的模型。
- 保存并切换到该配置。
- 完全重启对应终端工具后测试。
配置 Anthropic / Claude Code
Base URL：
Auth Token：Api Halo 令牌
Claude 模型：以令牌分组和模型广场为准
https://apihalo.cnAuth Token：Api Halo 令牌
Claude 模型：以令牌分组和模型广场为准
如果工具版本要求不同变量名，应以 CC-Switch 与 Claude Code 当前官方说明为准，避免同时保留互相覆盖的旧配置。
常见问题
切换后为什么没有生效？
关闭旧终端和客户端进程后重新启动，并检查环境变量是否仍被 shell 配置文件覆盖。
为什么返回 403？
检查令牌分组是否包含目标模型，模型名称必须与模型广场完全一致。
配套在线工具
按本教程确认安装方式后，带入对应软件生成配置，再执行一次最小连接测试。