开发者资源
通过 CC Switch 接入 RunAPI
安装 CC Switch，添加 RunAPI Claude Code Provider，选择模型并验证连接。
CC Switch 是用于管理编程工具 Provider 的桌面应用。本指南通过它的 Claude Code Provider 连接 RunAPI，不需要手动修改 shell profile 或项目文件。
开始前准备
安装 CC Switch
从 CC Switch 的官方 Releases下载适用于 Windows、macOS 或 Linux 的版本。使用 Homebrew 的 macOS 用户可运行：
SHELL
brew install --cask cc-switch
安装后打开 CC Switch，并在 app switcher 中选择 Claude Code。
添加 RunAPI Provider
- 选择 Add Provider，然后选择 Custom preset。
- 将 Provider 命名为
RunAPI，并在 configuration editor 中填写 API Key 和 Base URL：
JSON
{
"env": {
"ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
"ANTHROPIC_BASE_URL": "https://runapi.ai"
}
}
- Fetch Models 仅用于发现候选模型。若列表中没有该模型，请从模型目录复制 model identifier。获取候选模型不会为 Claude Code 的请求角色分配模型。
- 在 Default fallback model 中设置选定的 identifier，然后点击 一键设置。这会将该 identifier 应用到每个 Actual Request Model：Sonnet、Opus、Fable、Haiku 和 Subagent。
- 保存前确认每一行都显示预期的 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。 - 保存 Provider，在 Provider 列表中选中它并激活。
上面的 API Key 只是占位符。请通过身份验证指南创建和轮换实际密钥。
验证连接
在项目目录打开新的终端并启动 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 快速开始。请求和响应字段请查看 API 参考。