---
title: 通过 CC Switch 接入 RunAPI
url: https://runapi.ai/zh-CN/docs/resources/tool-integrations/cc-switch.md
canonical: https://runapi.ai/zh-CN/docs/resources/tool-integrations/cc-switch
locale: zh-CN
---

# 通过 CC Switch 接入 RunAPI

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

## 开始前准备

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

## 安装 CC Switch

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



[1]: https://github.com/farion1231/cc-switch/releases

```shell
brew install --cask cc-switch
```

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

## 添加 RunAPI Provider

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"
  }
}
```

1.  **Fetch Models** 仅用于发现候选模型。若列表中没有该模型，请从[模型目录](/zh-CN/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 列表中选中它并激活。

上面的 API Key
只是占位符。请通过[身份验证指南](/zh-CN/docs/guides/authentication)创建和轮换实际密钥。

## 验证连接

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

```shell
claude
```

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

## 排查问题

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



[1]: https://github.com/farion1231/cc-switch/tree/main/docs/user-manual/zh/2-providers

协议选择与请求行为请查看 [LLM API
快速开始](/zh-CN/docs/guides/llm-api/quickstart)。请求和响应字段请查看 [API
参考](/zh-CN/docs)。