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

# Как использовать Codex и другие third-party модели в Claude Desktop?

> Используйте локальный route CC Switch, чтобы запускать модели Codex group в Claude Desktop.

В новых версиях Claude Desktop изменился способ настройки third-party API gateways. В Gateway mode Claude Desktop строже проверяет model IDs, поэтому неофициальные model IDs, например GPT, DeepSeek или GLM, могут блокироваться.

Типичный симптом — предупреждение в верхней части страницы: `Your provider setup needs a fix Some required fields are missing or malformed. Open Setup to finish configuring it.` Одновременно selector third-party model в левом нижнем углу пуст, а Claude Desktop показывает только состояние **Legacy Model**.

<Frame>
  <img src="https://mintcdn.com/bettertoken-d796114e/oprfU9Hz5DNTxKqP/images/claude-desktop-third-party-models/provider-setup-needs-fix.png?fit=max&auto=format&n=oprfU9Hz5DNTxKqP&q=85&s=6e6085b6220b77faeae223baa27b4c05" alt="Claude Desktop показывает Your provider setup needs a fix, при этом selector third-party model пуст." style={{ borderRadius: '0.5rem' }} width="1916" height="1180" data-path="images/claude-desktop-third-party-models/provider-setup-needs-fix.png" />
</Frame>

Если вы хотите продолжать использовать Codex или другие third-party модели в Claude Desktop, маршрутизируйте запросы через CC Switch: настройте BetterToken в разделе **Claude Code** в CC Switch, затем введите local service address CC Switch в Claude Desktop Gateway.

<Info>
  Этот путь предназначен для API keys **Codex group**. Не вводите `https://www.bettertoken.ai/v1` напрямую в Claude Desktop Gateway.
</Info>

## Шаги настройки

<Steps>
  <Step title="Скачайте Claude Desktop">
    Скачайте актуальное приложение Claude Desktop по официальной ссылке:

    [Download Claude for Mac](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect)

    После установки не входите в Claude account. Перейдите к следующему шагу и включите developer mode.
  </Step>

  <Step title="Включите developer mode">
    Откройте Claude Desktop, затем в macOS menu bar выберите **Help** → **Troubleshooting** → **Enable Developer Mode**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/lwArVb1i_Yy7a2Md/images/claude-desktop-bettertoken-api/enable-developer-mode-menu.png?fit=max&auto=format&n=lwArVb1i_Yy7a2Md&q=85&s=7fbd69ca99f4055c750030b8352b7077" alt="Выбор Enable Developer Mode в меню Help приложения Claude Desktop." style={{ borderRadius: '0.5rem' }} width="3840" height="2160" data-path="images/claude-desktop-bettertoken-api/enable-developer-mode-menu.png" />
    </Frame>

    В окне подтверждения нажмите **Enable**, затем перезапустите Claude Desktop.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/lwArVb1i_Yy7a2Md/images/claude-desktop-bettertoken-api/developer-mode-confirm.png?fit=max&auto=format&n=lwArVb1i_Yy7a2Md&q=85&s=15978605afdf346ebe2d9ee65ebaa8b3" alt="Подтверждение developer mode в Claude Desktop." style={{ borderRadius: '0.5rem' }} width="520" height="480" data-path="images/claude-desktop-bettertoken-api/developer-mode-confirm.png" />
    </Frame>
  </Step>

  <Step title="Откройте настройки third-party inference">
    После перезапуска в macOS menu bar появится меню **Developer**.

    Выберите **Developer** → **Configure Third-Party Inference...**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/lwArVb1i_Yy7a2Md/images/claude-desktop-bettertoken-api/configure-third-party-inference.png?fit=max&auto=format&n=lwArVb1i_Yy7a2Md&q=85&s=31e6d69df48d0923a935c436238f8687" alt="Выбор Configure Third-Party Inference в меню Developer." style={{ borderRadius: '0.5rem' }} width="3840" height="2160" data-path="images/claude-desktop-bettertoken-api/configure-third-party-inference.png" />
    </Frame>
  </Step>

  <Step title="Откройте Claude Code в CC Switch и добавьте provider">
    Откройте CC Switch, переключитесь на **Claude Code** и нажмите **Add Provider**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/claude-code-add-provider.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=517f215f5f828187647dd214eacfe19b" alt="Страница Claude Code в CC Switch, кнопка добавления provider в правом верхнем углу." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-add-provider.png" />
    </Frame>
  </Step>

  <Step title="Заполните базовые поля">
    * **Provider Name**: `BetterToken`
    * **Base URL**: `https://www.bettertoken.ai`
    * **API Key**: ваш API Key BetterToken

    Номера на скриншоте соответствуют:

    1. **Provider Name**
    2. **API Key**
    3. **Base URL**

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/claude-code-basic-fields.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=24b47e9e1fe6fd717717af2950321b2c" alt="Страница редактирования provider в CC Switch с полями Provider Name, API Key и Base URL." style={{ borderRadius: '0.5rem' }} width="2000" height="1898" data-path="images/cc-switch/claude-code-basic-fields.png" />
    </Frame>
  </Step>

  <Step title="Установите API format и model mappings">
    Откройте **Advanced Options** и установите **API Format** в **OpenAI Responses API**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/claude-code-api-format.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=078af460fcf75fc78f037b92f24e3c0d" alt="Advanced Options в CC Switch, API Format установлен в OpenAI Responses API." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-api-format.png" />
    </Frame>

    В **Model Mapping** нажмите **Fetch Model List**. Явно выберите значения в dropdown для **Primary Model**, **Thinking Model**, **Haiku Default Model**, **Sonnet Default Model** и **Opus Default Model**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/claude-code-model-mapping.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=6a59bc2ab875c6c262656fbcc3e811f9" alt="Раздел model mapping в CC Switch с Fetch Model List и mappings для Primary, Thinking, Haiku, Sonnet и Opus." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-model-mapping.png" />
    </Frame>

    Используйте model IDs из текущих моделей **Codex group** в BetterToken model plaza (`https://www.bettertoken.ai/pricing`).
  </Step>

  <Step title="Сохраните, переключитесь и включите proxy">
    После сохранения вернитесь к списку providers:

    1. Установите только что сохраненный provider BetterToken как **In use**
    2. Включите **CC Switch proxy** в левом верхнем углу

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/claude-code-enable-proxy.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=78cbcfb305b6d52418ac6f4a7a7eacc7" alt="После сохранения provider BetterToken выбран активным, а proxy toggle CC Switch включен в левом верхнем углу." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-enable-proxy.png" />
    </Frame>
  </Step>

  <Step title="Откройте настройки CC Switch">
    Вернитесь на главный экран CC Switch и нажмите **Settings** в левом верхнем углу.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/oprfU9Hz5DNTxKqP/images/claude-desktop-bettertoken-api/cc-switch-settings-entry.png?fit=max&auto=format&n=oprfU9Hz5DNTxKqP&q=85&s=f5a418584cfb749cc2c4207037c1a9a8" alt="Главный экран CC Switch с выделенной кнопкой Settings в левом верхнем углу." style={{ borderRadius: '0.5rem' }} width="2000" height="1302" data-path="images/claude-desktop-bettertoken-api/cc-switch-settings-entry.png" />
    </Frame>
  </Step>

  <Step title="Проверьте routing и скопируйте service address">
    Откройте настройки **Routing**. Убедитесь, что главный routing switch и route switch **Claude** включены. Затем скопируйте **Service address** ниже.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/oprfU9Hz5DNTxKqP/images/claude-desktop-bettertoken-api/cc-switch-route-service.png?fit=max&auto=format&n=oprfU9Hz5DNTxKqP&q=85&s=228941106369a0014d56629fdca6baef" alt="Страница routing settings в CC Switch с главным route switch, Claude route switch и кнопкой копирования service address." style={{ borderRadius: '0.5rem' }} width="2000" height="1302" data-path="images/claude-desktop-bettertoken-api/cc-switch-route-service.png" />
    </Frame>
  </Step>

  <Step title="Введите Gateway base URL в Claude Desktop">
    Вернитесь в окно third-party inference settings Claude Desktop и выберите **Gateway**. Вставьте **Service address** из CC Switch в **Gateway base URL**, затем введите API Key BetterToken.

    Установите **Gateway auth scheme** в `bearer`.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/oprfU9Hz5DNTxKqP/images/claude-desktop-bettertoken-api/claude-gateway-local-route.png?fit=max&auto=format&n=oprfU9Hz5DNTxKqP&q=85&s=9e02209aaa648dee31a7aa17280bacf1" alt="Страница Gateway settings в Claude Desktop с локальным service address из CC Switch." style={{ borderRadius: '0.5rem' }} width="1800" height="1440" data-path="images/claude-desktop-bettertoken-api/claude-gateway-local-route.png" />
    </Frame>
  </Step>

  <Step title="Добавьте model list и примените локально">
    Добавьте модели, которые должны отображаться в **Model list**. Для каждой модели нужны и **Model ID**, и **Display name**.

    Например:

    | Model ID        | Display name    |
    | --------------- | --------------- |
    | `claude-opus-4` | `Claude Opus 4` |

    После заполнения списка нажмите **Apply locally**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/Lh1LYdBjqIQuQszR/images/claude-desktop-bettertoken-api/claude-model-list-codex-group.png?fit=max&auto=format&n=Lh1LYdBjqIQuQszR&q=85&s=96c59c443593dcd885535d9e8c3af088" alt="Model list в Claude Desktop с заполненными Model ID и Display name, кнопка Apply locally доступна." style={{ borderRadius: '0.5rem' }} width="1800" height="1440" data-path="images/claude-desktop-bettertoken-api/claude-model-list-codex-group.png" />
    </Frame>
  </Step>

  <Step title="Подтвердите relaunch приложения">
    После записи локальной конфигурации Claude попросит перезапуск. Нажмите **Relaunch now**, чтобы новая gateway-конфигурация вступила в силу.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/lwArVb1i_Yy7a2Md/images/claude-desktop-bettertoken-api/relaunch-claude.png?fit=max&auto=format&n=lwArVb1i_Yy7a2Md&q=85&s=e9fc78b7de865d5ee7d42122dac8b190" alt="Claude Desktop просит relaunch, кнопка Relaunch now выделена." style={{ borderRadius: '0.5rem' }} width="1800" height="1440" data-path="images/claude-desktop-bettertoken-api/relaunch-claude.png" />
    </Frame>
  </Step>

  <Step title="Войдите через Gateway">
    После перезапуска подождите около 3 секунд, пока появится выбор способа входа.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/lwArVb1i_Yy7a2Md/images/claude-desktop-bettertoken-api/continue-with-gateway.png?fit=max&auto=format&n=lwArVb1i_Yy7a2Md&q=85&s=629f35499122f468e3f8d63db31b8843" alt="Claude Desktop показывает вариант Continue with Gateway." style={{ borderRadius: '0.5rem' }} width="1200" height="1200" data-path="images/claude-desktop-bettertoken-api/continue-with-gateway.png" />
    </Frame>

    Выберите **Continue with Gateway**. Когда Claude откроется, в левом нижнем углу появится **Cowork 3P | Gateway**, и можно начинать работу.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/lwArVb1i_Yy7a2Md/images/claude-desktop-bettertoken-api/gateway-ready.png?fit=max&auto=format&n=lwArVb1i_Yy7a2Md&q=85&s=d10d706bd7ab74f6a181cf44f4b21f84" alt="Claude Desktop готов к работе после входа через Gateway." style={{ borderRadius: '0.5rem' }} width="2400" height="1600" data-path="images/claude-desktop-bettertoken-api/gateway-ready.png" />
    </Frame>
  </Step>
</Steps>

## Диагностика

Если вы все еще видите **Your provider setup needs a fix**, сначала проверьте:

1. Provider BetterToken в CC Switch установлен как **In use**
2. **API Format** установлен в **OpenAI Responses API**
3. В **Model Mapping** явно выбраны модели Codex group для Primary, Thinking, Haiku, Sonnet и Opus
4. **CC Switch proxy**, главный routing switch и route switch **Claude** включены
5. **Gateway base URL** в Claude Desktop использует local service address, скопированный из CC Switch
6. **Model list** содержит и **Model ID**, и **Display name** для каждой модели