> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CC Switch (переключатель CLI)

> Используйте CC Switch, чтобы одним кликом переключить Claude Code, Codex, OpenClaw и другие инструменты на RuAPI

[CC Switch](https://github.com/farion1231/cc-switch) — это кроссплатформенное десктопное приложение для управления конфигурациями **Claude Code, Codex, Gemini CLI, OpenCode и OpenClaw**. Один GUI вместо ручной правки `~/.claude/settings.json`, `~/.codex/config.toml` и `~/.openclaw/openclaw.json`.

<Note>
  Если вы пользуетесь только одним CLI (например, только Claude Code), CC Switch не обязателен — см. [прямую настройку Claude Code](/ru/integrations/claude-code). CC Switch удобен, когда **инструментов несколько** и **провайдеров несколько**.
</Note>

## Предварительные требования

<Steps>
  <Step title="Регистрация и пополнение">
    Создайте аккаунт на [www.ruapi.ai](https://www.ruapi.ai) и пополните баланс в USDT. См. [руководство по пополнению](/ru/topup).
  </Step>

  <Step title="Создайте API-ключ">
    Консоль → **Токены** → **Создать токен**. Скопируйте строку, начинающуюся с `sk-...`. Подробнее в [API-ключи и безопасность](/ru/authentication).
  </Step>

  <Step title="Установите хотя бы один CLI">
    CC Switch не устанавливает Claude Code, Codex и т. д. — он лишь управляет их конфигурацией. Сначала установите CLI по инструкциям [Claude Code](/ru/integrations/claude-code) или [Codex](/ru/integrations/codex).
  </Step>
</Steps>

## Установка CC Switch

Скачайте сборку со [страницы релизов](https://github.com/farion1231/cc-switch/releases/latest):

<Tabs>
  <Tab title="macOS">
    Скачайте `cc-switch-x.y.z-arm64.dmg` (Apple Silicon) или `cc-switch-x.y.z-x64.dmg` (Intel) → откройте → перетащите `CC Switch.app` в **Программы**.

    <Note>
      Если при первом запуске появится «не удаётся проверить разработчика», откройте **Системные настройки → Конфиденциальность и безопасность**, прокрутите вниз и нажмите **Открыть всё равно**.
    </Note>
  </Tab>

  <Tab title="Windows">
    Скачайте `cc-switch-x.y.z-x64-setup.exe` и запустите установщик. Ярлык CC Switch появится на рабочем столе.
  </Tab>

  <Tab title="Linux">
    Скачайте `cc-switch_x.y.z_amd64.deb` (Debian/Ubuntu) или `cc-switch-x.y.z.AppImage` (остальные дистрибутивы).

    ```bash theme={null}
    # Debian / Ubuntu
    sudo dpkg -i cc-switch_*_amd64.deb

    # AppImage
    chmod +x cc-switch-*.AppImage
    ./cc-switch-*.AppImage
    ```
  </Tab>
</Tabs>

## Добавьте RuAPI в CC Switch (Claude Code)

Откройте CC Switch, выберите слева вкладку **Claude Code**:

<Steps>
  <Step title="Нажмите «Добавить провайдера»">
    Кнопка **+ Add Provider** в правом верхнем углу.
  </Step>

  <Step title="Выберите «Custom Provider»">
    Пролистайте список пресетов до конца и выберите **Custom Provider**. Если в списке уже есть готовый пресет «RuAPI», возьмите его — останется только вставить API-ключ.
  </Step>

  <Step title="Основная информация">
    | Поле        | Значение               |
    | ----------- | ---------------------- |
    | **Name**    | `RuAPI`                |
    | **Website** | `https://www.ruapi.ai` |
    | **Icon**    | Необязательно          |
  </Step>

  <Step title="Переменные окружения">
    Перейдите на вкладку **Environment Variables** (или **Endpoint config**):

    | Переменная                                 | Значение                                                  |
    | ------------------------------------------ | --------------------------------------------------------- |
    | `ANTHROPIC_BASE_URL`                       | `https://www.ruapi.ai`                                    |
    | `ANTHROPIC_API_KEY`                        | `sk-ваш-токен-RuAPI`                                      |
    | `ANTHROPIC_MODEL` (опционально)            | `имя-модели` (например, `claude-opus-4-8`)                |
    | `ANTHROPIC_SMALL_FAST_MODEL` (опционально) | `имя-модели` (быстрая модель Claude — ID на странице цен) |

    <Warning>
      **Не** добавляйте `/v1` в конце `ANTHROPIC_BASE_URL`. SDK Anthropic сам подставит `/v1/messages`, лишний `/v1` приведёт к 404.
    </Warning>
  </Step>

  <Step title="Сохраните и активируйте">
    Нажмите **Save** → на главном экране нажмите **Enable** на строке с RuAPI. Зелёный статус — Claude Code теперь работает через RuAPI.
  </Step>
</Steps>

## Добавьте RuAPI в CC Switch (Codex)

Переключитесь на вкладку **Codex** слева и повторите тот же процесс, но переменные окружения другие:

| Переменная                   | Значение                              |
| ---------------------------- | ------------------------------------- |
| `OPENAI_BASE_URL`            | `https://www.ruapi.ai/v1`             |
| `OPENAI_API_KEY`             | `sk-ваш-ключ` (тот же токен подходит) |
| `OPENAI_MODEL` (опционально) | `имя-модели` (например, `gpt-5.4`)    |

<Note>
  Codex работает по OpenAI-совместимому протоколу — `OPENAI_BASE_URL` **должен** заканчиваться на `/v1`.
</Note>

## Проверка переключения

После переключения в CC Switch поведение разное для разных инструментов:

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal">
    **Перезапускать не нужно** — CC Switch переключает на лету. Можно продолжать работу в уже открытом `claude`.
  </Card>

  <Card title="Codex / OpenClaw / Gemini CLI" icon="rotate">
    **Закройте и снова откройте терминал** (или перезапустите CLI), чтобы новые переменные окружения подхватились.
  </Card>
</CardGroup>

Быстрая проверка:

```bash theme={null}
# Claude Code
claude "В одном предложении: через какой API ты работаешь?"

# Codex
codex "В одном предложении: через какой API ты работаешь?"
```

Нормальный ответ без 401 и сетевых ошибок = переключение успешно.

## Возврат к официальному провайдеру

В главном окне CC Switch выберите другого провайдера → **Enable**. CC Switch автоматически перезапишет соответствующие файлы конфигурации.

<Tip>
  Можно одновременно держать RuAPI, официальный аккаунт Anthropic/OpenAI и любых других сторонних провайдеров и переключаться одним кликом — это и есть главное удобство CC Switch.
</Tip>

## Решение проблем

<AccordionGroup>
  <Accordion title="После переключения Claude Code всё равно идёт на старый эндпоинт">
    1. Закройте текущую сессию `claude` и откройте новый терминал.
    2. Проверьте, не выставлен ли вручную `export ANTHROPIC_BASE_URL` — переменные окружения в shell перекрывают settings-файл, который пишет CC Switch.
    3. Выполните `cat ~/.claude/settings.json` и убедитесь, что блок `env` содержит конфигурацию RuAPI.
  </Accordion>

  <Accordion title="401 Unauthorized">
    * `ANTHROPIC_API_KEY` должен быть полностью скопирован (с префиксом `sk-` и всеми символами в конце).
    * В Консоли → **Токены** убедитесь, что ключ активен и нужная модель не исключена из allowlist.
    * Проверьте баланс USD.
  </Accordion>

  <Accordion title="404 / model not found">
    * Опечатка в ID модели. На RuAPI доступны семейства Claude Sonnet, Claude Opus, Claude Haiku — точные имена возьмите со страницы цен.
    * Не добавляйте `/v1` к `ANTHROPIC_BASE_URL`.
  </Accordion>

  <Accordion title="CC Switch не видит конфигурацию Claude Code">
    Убедитесь, что Claude Code хотя бы раз запускался (тогда создаётся `~/.claude/settings.json`). Без установленного Claude Code переключать нечего.
  </Accordion>
</AccordionGroup>

## Что дальше

* **Настроить Claude Code напрямую (без CC Switch)?** — см. [Claude Code](/ru/integrations/claude-code).
* **Настроить Codex?** — см. [Codex](/ru/integrations/codex).
* **Настроить OpenClaw?** — см. [OpenClaw](/ru/integrations/openclaw).