---
title: Connect CC Switch to RunAPI
url: https://runapi.ai/docs/resources/tool-integrations/cc-switch.md
canonical: https://runapi.ai/docs/resources/tool-integrations/cc-switch
locale: en
---

# Connect CC Switch to RunAPI

CC Switch is a desktop application for managing coding-tool Providers.
This guide connects its Claude Code Provider to RunAPI without editing
your shell profile or project files by hand.

## Before you begin

* Install Claude Code and sign in to your RunAPI account.
* Create a standard API key in the [Authentication
  Guide](/docs/guides/authentication). Keep it in CC Switch; do not add
  it to source control.
* Use a RunAPI model identifier available through this connection. You
  can select one from CC Switch or copy it from the [Model
  Catalog](/models).

## Install CC Switch

Download CC Switch from its [official releases][1] for Windows, macOS,
or Linux. On macOS with Homebrew, install it with:



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

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

Open CC Switch after installation and select **Claude Code** in the app
switcher.

## Add a RunAPI Provider

1.  Select **Add Provider**, then choose the **Custom** preset.
2.  Name the Provider `RunAPI` and enter your API key and Base URL in
    its configuration editor:

```json
{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_BASE_URL": "https://runapi.ai"
  }
}
```

1.  Use **Fetch Models** only to discover candidates. If the model is
    not listed, copy its identifier from the [Model Catalog](/models).
    Fetching does not assign models to Claude Code request roles.
2.  Set the chosen identifier as the **Default fallback model**, then
    select **Quick Set**. This applies the identifier to every **Actual
    Request Model** row: Sonnet, Opus, Fable, Haiku, and Subagent.
3.  Before saving, confirm that every row shows the intended RunAPI
    identifier. CC Switch persists this mapping as `ANTHROPIC_MODEL`,
    `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_OPUS_MODEL`,
    `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`,
    and `CLAUDE_CODE_SUBAGENT_MODEL`.
4.  Save the Provider, select it in the Provider list, and activate it.

The API key above is a placeholder. Create and rotate your actual key
through the [Authentication Guide](/docs/guides/authentication).

## Verify the connection

Open a new terminal in a project directory and start Claude Code:

```shell
claude
```

Run `/status` to inspect the active model, then send a short prompt such
as `Describe this repository in one sentence.` A normal response
confirms that CC Switch is using the active RunAPI Provider.

## Troubleshoot

* **Authentication fails:** verify the API key in the active CC Switch
  Provider, then create a new key from the [Authentication
  Guide](/docs/guides/authentication) if needed.
* **The expected model is unavailable:** refresh the model selector or
  copy a supported model identifier from the [Model Catalog](/models),
  then set it as the **Default fallback model** and select **Quick Set**
  again.
* **Claude Code still uses another Provider:** activate the RunAPI
  Provider in CC Switch, then open a fresh terminal session. Check CC
  Switch's [provider documentation][1] for environment conflicts.



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

For protocol selection and request behavior, use the [LLM API
quickstart](/docs/guides/llm-api/quickstart). For request and response
fields, use the [API Reference](/docs).