接入 CC Switch
从 aicentos 控制台一键导入配置到 CC Switch，管理 Claude Code / Codex / Gemini CLI
CC Switch 是一个跨平台的 AI CLI 配置管理工具，用于集中管理 Claude Code、Codex、Gemini CLI 等工具的模型提供商（Provider）配置，让你在多个 CLI 工具或多套配置之间一键切换，不必反复修改环境变量。
aicentos 控制台内置了 CC Switch 一键导入：不用手抄 Base URL 和密钥，点几下就能把配置写进 CC Switch。
准备工作
- 登录 aicentos 控制台
- 确认账户有余额（注册赠送 ¥1 体验额度，用完后在「钱包」充值）
- 安装 CC Switch（见下）
安装 CC Switch
CC Switch 是开源项目，源码托管在 GitHub：farion1231/cc-switch。
打开 Releases 页面，在最新版本的资源列表中，根据自己的操作系统选择对应的安装包：
- macOS：
.dmg - Windows：
.msi - Linux：
.AppImage/.deb
下载完成后按系统正常方式安装，并至少打开一次 CC Switch，这样控制台的导入链接才能识别到本机已安装。
一键导入（推荐）
第 1 步：在控制台发起导入
进入控制台左侧「API 密钥」，在要使用的密钥那一行点右侧的「⋯」，在菜单里选「CC Switch」：
第 2 步：选择应用与模型
弹窗「填入 CC Switch」里选择目标应用（Claude / Codex / Gemini），并确认要使用的模型：
| 字段 | 说明 |
|---|---|
| 应用 | 选择要写入哪个 CLI 的配置。Claude 走 Anthropic 协议，Codex 走 OpenAI 兼容格式，Gemini 走 Gemini 原生格式 |
| 名称 | 导入后在 CC Switch 里显示的配置名，可自定义 |
| 主模型 | 该配置默认使用的模型，必填 |
| Haiku / Sonnet 模型 | Claude 应用下的分档模型，按需指定 |
模型名可参考支持的模型，例如 claude-opus-5-5、claude-sonnet-5、claude-haiku-4-5。
选好后点「打开 CC Switch」。
第 3 步：浏览器确认唤起
浏览器会询问是否打开 CC Switch，点「打开 CC Switch.app」：
如果勾选「始终允许 aicentos.com 在关联的应用中打开此类链接」，之后导入就不会再弹这个确认框。
第 4 步：在 CC Switch 确认导入
CC Switch 会弹出「确认导入供应商配置」，核对信息后点「导入」：
弹窗里会列出将写入的端点、密钥与分档模型，核对无误后点「导入」。
导入完成后，aicentos Claude 会出现在 CC Switch 的配置列表里，点一下即可切换：
手动配置
如果不想用一键导入，也可以手动填写：
| 字段 | 填什么 |
|---|---|
| 供应商名称 | aicentos（自定义，便于识别即可） |
| API Key | 控制台「API 密钥」页创建的密钥，形如 sk-xxxxxxxx |
| API 端点 | Claude / Gemini 填 https://aicentos.com；Codex 填 https://aicentos.com/v1 |
Anthropic 协议只填根地址，不要手动追加
/v1/messages，客户端会自动拼接。