跳到正文
开发者资源
开发者资源

CC Switch

安装 CC Switch，添加 RunAPI Claude Code Provider，选择模型并验证连接。

查看 Markdown

概览

CC Switch 是用于管理编程工具 Provider 的桌面应用。本指南通过它的 Claude Code Provider 连接 RunAPI，不需要手动修改 shell profile 或项目文件。

开始前准备

  • 安装 Claude Code，并登录你的 RunAPI 账户。
  • 在身份验证指南中创建标准 API Key。只将密钥保存在 CC Switch 中，不要提交到源码仓库。
  • 选择此连接可用的 RunAPI model identifier。你可以在 CC Switch 中选择，也可以从模型目录复制。

安装

从 CC Switch 的官方 Releases下载适用于 Windows、macOS 或 Linux 的版本。使用 Homebrew 的 macOS 用户可运行：

SHELL 
brew install --cask cc-switch

安装后打开 CC Switch，并在 app switcher 中选择 Claude Code。

配置 RunAPI

  1. 选择 Add Provider，然后选择 Custom preset。
  2. 将 Provider 命名为 RunAPI，并在 configuration editor 中填写 API Key 和 Base URL：
JSON 
{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_BASE_URL": "https://runapi.ai"
  }
}

上面的 API Key 只是占位符。请通过身份验证指南创建和轮换实际密钥。

选择模型

  1. Fetch Models 仅用于发现候选模型。若列表中没有该模型，请从模型目录复制 model identifier。获取候选模型不会为 Claude Code 的请求角色分配模型。
  2. 在 Default fallback model 中设置选定的 identifier，然后点击 一键设置。这会将该 identifier 应用到每个 Actual Request Model：Sonnet、Opus、Fable、Haiku 和 Subagent。
  3. 保存前确认每一行都显示预期的 RunAPI identifier。CC Switch 会将映射写入 ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 和 CLAUDE_CODE_SUBAGENT_MODEL。
  4. 保存 Provider，在 Provider 列表中选中它并激活。

验证

在项目目录打开新的终端并启动 Claude Code：

SHELL 
claude

运行 /status 查看当前 model，然后发送简短提示，例如 用一句话描述这个仓库。。收到正常响应即表示 CC Switch 正在使用已激活的 RunAPI Provider。

排查问题

  • 身份验证失败： 检查当前激活的 CC Switch Provider 中的 API Key；必要时在身份验证指南中创建新密钥。
  • 没有预期的模型： 刷新 model selector，或从模型目录复制受支持的 model identifier，然后重新在 Default fallback model 中设置并点击 一键设置。
  • Claude Code 仍在使用其他 Provider： 在 CC Switch 中激活 RunAPI Provider，然后打开新的终端会话。环境变量冲突请查看 CC Switch 的Provider 文档。

下一步

协议选择与请求行为请查看 LLM API 快速开始。请求和响应字段请查看 Anthropic Messages API 参考。如需在 Claude Code 中添加 RunAPI tools，请继续查看 MCP 概览。