CC Switch 图形配置

✳

让 AI 帮你完成配置

首次安装或切换到 XXAPI，都可以使用。

打开豆包 ↗

AI 打不开链接时，。

查看短提示词

我想通过 XXAPI 使用 CC Switch，请先确认我的电脑系统（Windows / macOS / Linux）。请先阅读教程： https://docs.xxapi.ai/text/cc-switch.txt 先确认我是首次安装还是更换服务商。能操作本机时，请先检查并备份配置，再协助完成；只能聊天时，每次带我做一步，等我反馈再继续。密钥由我在本机填写，完成后验证连接。打不开链接就告诉我，我会提供完整教程。

不想手动改配置文件，可以用 CC Switch 填表。它负责保存和切换连接；Claude Code、Codex 等工具还需要分别安装。

1. 安装并打开 CC Switch

打开 CC Switch 官方下载页，展开 Assets，选择电脑对应的安装包。Windows 可选 .msi，macOS 和 Linux 按系统及芯片选择。

版本号以当前下载页为准。

安装后打开软件。如果提示导入已有配置，先导入并保存备份，之后再新增 XXAPI。

2. 准备 XXAPI 密钥和模型

打开 API 密钥 复制自己的 Key。再选择准备使用的模型，记住完整模型 ID。

查看当前可用模型与分组从 XXAPI 后台读取

选择与你的 API Key 相同的分组，再复制模型名称。

下面 Claude Code 和 Codex 两段，按自己要用的工具选一段完成即可。

3. 配置 Claude Code

先按 Claude Code 安装教程 安装程序。回到 CC Switch，在顶部选择 Claude Code / Claude，点击 添加供应商。

供应商选择 自定义，按下表填写。

项目	填写内容
名称	XXAPI
官网	https://xxapi.ai
API 请求地址	https://xxapi.ai
API Key	Claude 分组的 XXAPI API Key
API 格式	Anthropic Messages
默认模型	模型广场中的 Claude 模型 ID

密钥和模型请填写自己的值；界面位置以当前软件版本为准。

XXAPI 创建密钥的配置示意。名称自定，分组按模型广场与当前账户可用项选择。

地址为 https://xxapi.ai，密钥使用自己的值。

如果有 Haiku、Sonnet、Opus 模型映射，第一次把默认模型及 Haiku、Sonnet、Opus 三个映射都填成同一个真实 Claude 模型 ID。以后要分别使用不同模型，再逐项调整。

点击 添加 / 保存，回到列表，对 XXAPI 点击 启用。

密钥和模型请填写自己的值；界面位置以当前软件版本为准。

退出正在运行的 Claude Code，重新打开终端执行 claude，发送“请只回复：连接成功”。收到回复即可开始使用。

工具界面示例；请以自己的回复结果为准。

第一次启动仍要求官方账号登录

先检查是否启用了 XXAPI 配置。部分版本的 CC Switch 提供 跳过 Claude Code 初次确认选项，可用于 API 接入的首次初始化。按软件提示设置后，完全退出并重新启动 Claude Code。

如果仍然不生效，检查终端中是否遗留其他服务商的 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY，避免它们覆盖配置文件。

4. 配置 Codex

先完成 Codex 安装。在 CC Switch 顶部选择 Codex，添加自定义供应商。

在预设列表首项选择自定义配置，再填写下面的 XXAPI 参数。

项目	填写内容
名称	XXAPI
官网	https://xxapi.ai
API 请求地址	https://xxapi.ai/v1
API Key	Codex 分组的 XXAPI API Key
默认模型	Codex 分组里的 GPT 模型 ID
Wire API / 协议	responses

XXAPI 创建密钥的配置示意。名称自定，分组按模型广场与当前账户可用项选择。

模型和密钥分组按你当前选择的填写，图中型号仅作示例。

保存后启用 XXAPI。退出 Codex 并重新打开，执行 codex，发送“请只回复：连接成功”。

密钥和模型请填写自己的值；界面位置以当前软件版本为准。

工具界面示例；请以自己的回复结果为准。

已经有其他服务商

在 CC Switch 中新增 XXAPI，保留原服务商。切换时点击对应配置的启用按钮，再重新启动目标工具。正在运行的会话可能继续使用旧连接。

如果之前手动写过系统环境变量，也要核对它们是否覆盖了 CC Switch 写入的文件。恢复旧配置时，在列表里重新启用原服务商即可。

遇到问题

看到的情况	处理方法
claude 或 codex 找不到	CC Switch 不替代工具安装，先完成对应工具的安装教程
配了 Claude，Codex 却没变	两个应用分别配置、分别启用
401	核对当前应用使用的 Key 与 XXAPI 地址是否匹配
404	Claude 地址用根域，Codex 地址带 /v1
保存了但没生效	点击启用，退出旧会话，再检查遗留环境变量

配置保存在哪里、其他功能与官方文档

Claude Code 的用户配置通常在 ~/.claude/settings.json，Codex 在 ~/.codex/config.toml 和认证存储中。Windows 的 ~ 对应当前用户目录。使用 CC Switch 管理期间，优先在它的界面里修改，避免同时手工覆盖文件。

查看服务商卡片上的用量，可继续阅读 用量查询。服务器没有桌面时可用 CC Switch CLI。

• CC Switch 官方项目