接入 CC Switch
CC Switch 是一款免费开源的跨平台桌面应用,用于集中管理 Claude Code、Codex、OpenCode 等 AI 编程工具的服务商配置。它让你在同一个界面里添加、切换、测速各家 API 服务商,并自动帮你写入工具的配置文件(如 ~/.claude/settings.json),无需手动编辑。官方网站:ccswitch.io。
一、前置条件
在 LongCat 开放平台 获取 API Key,并在 用量 页面确认账户有足够的 Token 额度。
LongCat API 开放平台目前提供以下模型:
| 模型名称 | API 格式 | 描述 |
|---|---|---|
| LongCat-2.5 | OpenAI/Anthropic | 高性能 Agentic 模型 |
二、安装 CC Switch
CC Switch 支持 Windows 10+ 和 macOS 12 (Monterey)+。可以用包管理器安装,也可以手动下载。
macOS
Homebrew(推荐):
brew install --cask cc-switch后续升级:
brew upgrade --cask cc-switch或从 Releases 页面 下载 .dmg,把 CC Switch.app 拖入 应用程序。macOS 版本已由 Apple 签名并公证,无需额外的安全放行步骤。
Windows
从 Releases 页面 下载 .msi 安装包(或便携版 .zip)并运行。
请仅从 ccswitch.io 或 GitHub Releases 下载。任何要求付费、充值或登录凭据的站点都不是官方渠道。
三、把 LongCat 添加到 Claude Code(Anthropic 协议)
CC Switch 以 Anthropic 兼容协议把 LongCat 添加到 Claude Code,并自动为你写入配置。
- 打开 CC Switch,在左侧边栏选择 Claude Code。

- 点击右上角「+ 添加供应商」,在搜索框输入
longcat,选择「模型厂商」下的 Longcat 预设。

- 进入配置页,API Key 填写你的 LongCat API Key,其余字段保持预填即可:「请求地址」(
ANTHROPIC_BASE_URL)为https://api.longcat.chat/anthropic,「模型映射」已将各角色及默认兜底模型映射到LongCat-2.5。

「上游格式」保持默认 Anthropic Messages(原生)。也可点击「获取模型列表」按钮,从端点自动拉取可用模型。
- 点击「添加」保存。CC Switch 写入的
~/.claude/settings.json形如:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "your_longcat_api_key",
"ANTHROPIC_BASE_URL": "https://api.longcat.chat/anthropic",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "LongCat-2.5",
"ANTHROPIC_DEFAULT_FABLE_MODEL_NAME": "LongCat-2.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "LongCat-2.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "LongCat-2.5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "LongCat-2.5",
"ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "LongCat-2.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "LongCat-2.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "LongCat-2.5",
"ANTHROPIC_MODEL": "LongCat-2.5"
}
}- 在 LongCat 供应商卡片上点击「切换」(▶ 图标)。卡片随后会显示蓝色边框与「使用中」标签。

四、把 LongCat 添加到 Codex(OpenAI 协议)
CC Switch 也能管理 Codex,Codex 通过 OpenAI 兼容协议访问 LongCat。针对 Codex,它写入的是 ~/.codex/config.toml 与 ~/.codex/auth.json,而不是 ~/.claude/settings.json。
在左侧边栏选择 Codex。
点击「+ 添加供应商」,搜索
longcat并选择「模型厂商」下的 Longcat 预设。API Key 填写你的 LongCat API Key,其余字段保持预填即可:「API 请求地址」(Base URL)为
https://api.longcat.chat/openai/v1,「模型列表」已包含LongCat-2.5。

点击「添加」保存。CC Switch 写入以下文件。
~/.codex/config.toml:
model_provider = "custom"
model = "LongCat-2.5"
disable_response_storage = true
web_search = "disabled"
model_reasoning_effort = "high"
model_supports_reasoning_summaries = true
[model_providers.custom]
name = "custom"
base_url = "https://api.longcat.chat/openai/v1"
wire_api = "responses"
requires_openai_auth = true~/.codex/auth.json:
{
"OPENAI_API_KEY": "your_longcat_api_key"
}- 在 LongCat 供应商卡片上点击「切换」(▶ 图标)。卡片显示「使用中」标签,顶部状态变为「直连生效中 · 直接连接 Longcat」。

五、切换与测试
Claude Code 支持热重载,切换供应商后无需重启终端,配置立即生效。
启动 Claude Code 并发送一条测试消息:
claude然后输入测试消息,如:「你好,请介绍一下自己」。如果配置正确,你将收到来自 LongCat 模型的回复。
Codex 不支持热重载,切换供应商后需彻底退出并重启 Codex(macOS 上按 ⌘Q,仅关闭窗口不生效),再发送测试消息:
codex提示:可在供应商配置页的「管理与测速」中测试端点延迟(🟢 <500ms / 🟡 500–1000ms / 🔴 >1000ms)。
六、常见问题
启用后供应商不生效?
- 确认左侧边栏选中的是正确的应用(Claude Code),且 LongCat 卡片显示「使用中」标签。
- 检查
~/.claude/settings.json中包含ANTHROPIC_BASE_URL: https://api.longcat.chat/anthropic。
认证失败或 401/403?
- 确认 API Key 为有效的 LongCat API Key,且没有把 API Key 和端点地址两个字段填反。
模型未找到或 404?
- 确认模型名称正好是
LongCat-2.5,端点为https://api.longcat.chat/anthropic。
Codex 供应商不生效?
- 确认左侧边栏选中的是 Codex,且
~/.codex/config.toml中包含base_url = "https://api.longcat.chat/openai/v1"与wire_api = "responses"。 - 确认
~/.codex/auth.json的OPENAI_API_KEY填入的是你的 LongCat API Key。 - 切换供应商后彻底退出并重启 Codex(macOS 上按 ⌘Q),使其重新加载配置。