LogoAICore Docs

CC Switch 配置

使用 CC Switch 配置 AiCore API,并管理 Claude Code 与 Codex

CC Switch 简介

CC Switch 是一个跨平台桌面配置管理工具,可以用图形界面管理 Claude Code、Claude Desktop、Codex 等 AI 工具的 API 供应商,并在多个供应商之间快速切换。

准备工作

下载并安装 CC Switch

打开 最新版本下载页,根据系统选择安装包:

添加 AiCore API 供应商

首次启动时,CC Switch 可能会检测并导入本机已有的 CLI 配置。随后按以下步骤添加新的供应商:

  1. 在左侧选择要配置的应用,例如 Claude 或 Codex。
  2. 点击右上角的 +,打开“添加供应商”面板。
  3. 选择“自定义”配置;如果列表中有匹配的预设,也可以先选择预设,再修改端点地址。
  4. 填写 API Key、接口地址和模型等字段。
  5. 点击“添加”或“保存”,再点击供应商卡片上的“启用”。

下面是两个应用的具体参数。

配置 Claude Code

在 Claude 应用中添加一个自定义供应商,填写:

配置项值
供应商名称claude.xty.app
备注可留空
官网链接https://claude.xty.app
API Keysk-你的令牌
API 地址https://claude.xty.app
上游格式Anthropic Messages(默认)

如果使用 JSON 编辑器,可以参考以下配置:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "ANTHROPIC_BASE_URL": "https://claude.xty.app/",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_MODEL": "claude-opus-4-8"
  },
  "theme": "light",
  "model": "sonnet[1m]"
}

启用供应商后,在项目目录中启动 Claude Code:

cd your-project-folder
claude

Claude Code 支持配置热切换,切换供应商后通常无需重启;如果当前版本没有立即更新,请退出后重新运行 claude。

配置 Codex

在 Codex 应用中添加一个自定义供应商,填写:

配置项值
供应商名称api.xty.app
备注可留空
官网链接https://api.xty.app
API Keysk-你的令牌
API 地址https://codex-hk.xty.app/v1
默认模型gpt-5.6-sol
上游格式Responses(原生)

Codex 必须使用 Responses 协议。不要将协议改成 Chat Completions。

如果 CC Switch 显示高级 JSON/TOML 配置,可对应使用:

model_provider = "xty-api"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.xty-api]
name = "xty-api"
base_url = "https://codex-hk.xty.app/v1"
wire_api = "responses"
requires_openai_auth = true

启用后,关闭当前 Codex 终端并重新打开,再运行:

cd your-project-folder
codex

切换供应商

添加多个供应商后,可以通过两种方式切换:

  • 主界面:在对应应用的供应商卡片上点击“启用”。
  • 系统托盘:右键 CC Switch 托盘图标,在对应应用的子菜单中点击供应商名称。

不同工具的生效方式如下:

工具生效方式
Claude Code支持热切换;未生效时重新启动 CLI
Codex关闭并重新打开终端

如果您同时使用多个工具,请在对应的应用面板中分别点击“启用”。切换 Claude 的供应商不会自动切换 Codex 的供应商。

验证配置

分别启动对应 CLI,并发送一条简单消息:

你好,请简单介绍一下自己。

如果无法回复,可以先检查配置文件中的 API 地址、协议和 API Key,再确认令牌具有对应模型的调用权限。

常见问题

相关文档