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

# How can I use Codex and other third-party models in Claude Desktop?

> Use a CC Switch local route to run GPT Key group models in Claude Desktop.

Recent Claude Desktop versions changed how third-party API gateways are configured. In Gateway mode, Claude Desktop validates model IDs more strictly, so non-official model IDs such as GPT, DeepSeek, or GLM can be blocked.

A common symptom is this warning at the top of the page: `Your provider setup needs a fix Some required fields are missing or malformed. Open Setup to finish configuring it.` At the same time, the third-party model selector in the lower-left area is empty, and Claude Desktop only shows a **Legacy Model** state.

<Frame>
  <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/claude-desktop-third-party-models/provider-setup-needs-fix.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=ef9e493dc92e4eabbaacdc132acd9e2c" alt="Claude Desktop showing Your provider setup needs a fix while the third-party model selector is empty." style={{ borderRadius: '0.5rem' }} width="1916" height="1180" data-path="images/claude-desktop-third-party-models/provider-setup-needs-fix.png" />
</Frame>

If you want to keep using Codex or other third-party models in Claude Desktop, route the requests through CC Switch: configure LLMEasy under **Claude Code** in CC Switch, then enter the CC Switch local service address in Claude Desktop Gateway.

<Info>
  This path is for API keys from the **GPT Key group**. Do not enter `https://www.llmeasy.ru/v1` directly in Claude Desktop Gateway.
</Info>

## Setup steps

<Steps>
  <Step title="Download Claude Desktop">
    Download the latest Claude Desktop app from the official link:

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

    After installation, do not sign in to a Claude account. Continue to the next step and enable developer mode.
  </Step>

  <Step title="Enable developer mode">
    Open Claude Desktop, then choose **Help** → **Troubleshooting** → **Enable Developer Mode** from the macOS menu bar.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/ejT8e_A0sPBKAOtG/images/claude-desktop-llmeasy-api/enable-developer-mode-menu.png?fit=max&auto=format&n=ejT8e_A0sPBKAOtG&q=85&s=147f5e2eae39abade8d298c9e074a63f" alt="Select Enable Developer Mode from the Claude Desktop Help menu." style={{ borderRadius: '0.5rem' }} width="3840" height="2160" data-path="images/claude-desktop-llmeasy-api/enable-developer-mode-menu.png" />
    </Frame>

    In the confirmation window, click **Enable**, then restart Claude Desktop.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/claude-desktop-llmeasy-api/developer-mode-confirm.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=30a7080083bc46d51850c2c75128c098" alt="Confirm developer mode in Claude Desktop." style={{ borderRadius: '0.5rem' }} width="520" height="480" data-path="images/claude-desktop-llmeasy-api/developer-mode-confirm.png" />
    </Frame>
  </Step>

  <Step title="Open third-party inference settings">
    After restarting, the macOS menu bar shows a **Developer** menu.

    Choose **Developer** → **Configure Third-Party Inference...**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/Hz5PirDnykYqKKtv/images/claude-desktop-llmeasy-api/configure-third-party-inference.png?fit=max&auto=format&n=Hz5PirDnykYqKKtv&q=85&s=f187947f46a3f22bffff67ed717e91cd" alt="Choose Configure Third-Party Inference from the Developer menu." style={{ borderRadius: '0.5rem' }} width="3840" height="2160" data-path="images/claude-desktop-llmeasy-api/configure-third-party-inference.png" />
    </Frame>
  </Step>

  <Step title="Open Claude Code in CC Switch and add a provider">
    Open CC Switch, switch to **Claude Code**, and click **Add Provider**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/cc-switch/claude-code-add-provider.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=caf1f2ad7dfadf9d362e1556e1393c07" alt="The Claude Code page in CC Switch, with the add button in the top-right corner used to create a new provider." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-add-provider.png" />
    </Frame>
  </Step>

  <Step title="Fill in the basic fields">
    * **Provider Name**: `LLMEasy`
    * **Base URL**: `https://www.llmeasy.ru`
    * **API Key**: your LLMEasy API Key

    The screenshot labels map to:

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

    <Frame>
      <img src="https://mintcdn.com/bettertoken/ejT8e_A0sPBKAOtG/images/cc-switch/claude-code-basic-fields.png?fit=max&auto=format&n=ejT8e_A0sPBKAOtG&q=85&s=3f85334a096631b00c382cee762e6833" alt="The provider edit page in CC Switch, showing where to enter Provider Name, API Key, and Base URL." style={{ borderRadius: '0.5rem' }} width="2000" height="1898" data-path="images/cc-switch/claude-code-basic-fields.png" />
    </Frame>
  </Step>

  <Step title="Set the API format and model mappings">
    Open **Advanced Options** and set **API Format** to **OpenAI Responses API**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/ejT8e_A0sPBKAOtG/images/cc-switch/claude-code-api-format.png?fit=max&auto=format&n=ejT8e_A0sPBKAOtG&q=85&s=d7e1ffea7af3dcbef90c5b22e7231731" alt="The advanced options section in CC Switch, with API Format set to OpenAI Responses API." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-api-format.png" />
    </Frame>

    In **Model Mapping**, click **Fetch Model List**. Explicitly select dropdown values for **Primary Model**, **Thinking Model**, **Haiku Default Model**, **Sonnet Default Model**, and **Opus Default Model**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/cc-switch/claude-code-model-mapping.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=edb9324ade4ee810882017e08b14d051" alt="The model mapping section in CC Switch, showing Fetch Model List and the mappings for Primary, Thinking, Haiku, Sonnet, and Opus models." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-model-mapping.png" />
    </Frame>

    Use model IDs from the current **GPT Key group** models in the <a href={"https://www.llmeasy.ru/pricing"}>LLMEasy model plaza</a>.
  </Step>

  <Step title="Save, switch, and enable the proxy">
    After saving, return to the provider list:

    1. Set the LLMEasy provider you just saved as **In use**
    2. Enable the **CC Switch proxy** from the top-left corner

    <Frame>
      <img src="https://mintcdn.com/bettertoken/ejT8e_A0sPBKAOtG/images/cc-switch/claude-code-enable-proxy.png?fit=max&auto=format&n=ejT8e_A0sPBKAOtG&q=85&s=c5f366dd894c2e9d4d2df912f6f014c1" alt="After saving, return to the provider list, set LLMEasy as active, and enable the CC Switch proxy toggle in the top-left corner." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-enable-proxy.png" />
    </Frame>
  </Step>

  <Step title="Open CC Switch settings">
    Return to the CC Switch home screen, then click **Settings** in the top-left corner.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/ejT8e_A0sPBKAOtG/images/claude-desktop-llmeasy-api/cc-switch-settings-entry.png?fit=max&auto=format&n=ejT8e_A0sPBKAOtG&q=85&s=b07ed283cf3496bb21907a7bd9f19c09" alt="The CC Switch home screen with the Settings button highlighted in the top-left corner." style={{ borderRadius: '0.5rem' }} width="2000" height="1302" data-path="images/claude-desktop-llmeasy-api/cc-switch-settings-entry.png" />
    </Frame>
  </Step>

  <Step title="Confirm routing is enabled and copy the service address">
    Open **Routing** settings. Confirm that the highlighted main routing switch and **Claude** route switch are both on. Then copy the **Service address** shown below.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/claude-desktop-llmeasy-api/cc-switch-route-service.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=eabf3c75a86fdf2e57ba1bfb2d2a4552" alt="The CC Switch routing settings page, with the main route switch, Claude route switch, and service address copy button highlighted." style={{ borderRadius: '0.5rem' }} width="2000" height="1302" data-path="images/claude-desktop-llmeasy-api/cc-switch-route-service.png" />
    </Frame>
  </Step>

  <Step title="Enter the Gateway base URL in Claude Desktop">
    Return to the Claude Desktop third-party inference settings window and select **Gateway**. Paste the CC Switch **Service address** into **Gateway base URL**, then enter your LLMEasy API Key.

    Set **Gateway auth scheme** to `bearer`.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/claude-desktop-llmeasy-api/claude-gateway-local-route.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=f84d8c9b9a97653769cfdfd70dd22c3e" alt="The Claude Desktop Gateway settings page with the CC Switch local service address entered." style={{ borderRadius: '0.5rem' }} width="1800" height="1440" data-path="images/claude-desktop-llmeasy-api/claude-gateway-local-route.png" />
    </Frame>
  </Step>

  <Step title="Add the model list and apply locally">
    Add the models you want to show in **Model list**. Each model entry needs both **Model ID** and **Display name**.

    For example:

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

    After filling in the list, click **Apply locally**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/claude-desktop-llmeasy-api/claude-model-list-codex-group.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=ce8aef0ed312cd8fdd8b8e41717998f0" alt="The Claude Desktop Model list with Model ID and Display name filled in, and Apply locally available." style={{ borderRadius: '0.5rem' }} width="1800" height="1440" data-path="images/claude-desktop-llmeasy-api/claude-model-list-codex-group.png" />
    </Frame>
  </Step>

  <Step title="Confirm the app relaunch">
    After Claude writes the local configuration, it asks you to save and restart. Click **Save & Restart** so the new gateway configuration takes effect.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/Hz5PirDnykYqKKtv/images/claude-desktop-llmeasy-api/relaunch-claude.png?fit=max&auto=format&n=Hz5PirDnykYqKKtv&q=85&s=b0ffd0485974b3cc7f03cce181a19eb2" alt="Claude Desktop asks to save and restart, with the Save & Restart button highlighted." style={{ borderRadius: '0.5rem' }} width="1800" height="2046" data-path="images/claude-desktop-llmeasy-api/relaunch-claude.png" />
    </Frame>
  </Step>

  <Step title="Sign in with Gateway">
    After restarting, wait about 3 seconds for the sign-in choice to appear.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/claude-desktop-llmeasy-api/continue-with-gateway.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=847eb5601c187dd8680779018340596e" alt="Claude Desktop shows the Continue with Gateway sign-in option." style={{ borderRadius: '0.5rem' }} width="1200" height="1200" data-path="images/claude-desktop-llmeasy-api/continue-with-gateway.png" />
    </Frame>

    Choose **Continue with Gateway**. After Claude opens, **Cowork 3P | Gateway** appears in the lower-left corner and you can start using it.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/Hz5PirDnykYqKKtv/images/claude-desktop-llmeasy-api/gateway-ready.png?fit=max&auto=format&n=Hz5PirDnykYqKKtv&q=85&s=64769ca6417cd1e420bd6057f10dea4b" alt="Claude Desktop is ready after signing in with Gateway." style={{ borderRadius: '0.5rem' }} width="3840" height="2100" data-path="images/claude-desktop-llmeasy-api/gateway-ready.png" />
    </Frame>
  </Step>
</Steps>

## Troubleshooting

If you still see **Your provider setup needs a fix**, check these items first:

1. The LLMEasy provider in CC Switch is set as **In use**
2. **API Format** is set to **OpenAI Responses API**
3. **Model Mapping** explicitly selects GPT Key group models for Primary, Thinking, Haiku, Sonnet, and Opus
4. **CC Switch proxy**, the main routing switch, and the **Claude** route switch are all enabled
5. Claude Desktop **Gateway base URL** uses the local service address copied from CC Switch
6. **Model list** includes both **Model ID** and **Display name** for each model
