> ## 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.

# Configuración avanzada de proveedores BetterToken en CC Switch

> Gestiona en CC Switch los proveedores BetterToken, el mapeo de modelos y los ajustes de proxy para Claude Code, Claude Desktop, Codex CLI, OpenCode y OpenClaw.

CC Switch es una aplicación de escritorio multiplataforma para gestionar proveedores en Claude Code, Claude Desktop, Codex, OpenCode y OpenClaw. Esta página reúne la configuración avanzada. Empieza por la página de configuración directa de cada herramienta y usa CC Switch cuando necesites cambiar de proveedor o ejecutar un modelo no nativo.

## Instala CC Switch

<Tabs>
  <Tab title="macOS">
    Homebrew es la opción más sencilla. También puedes descargar el `.dmg` o `.zip` más reciente desde [GitHub Releases](https://github.com/farion1231/cc-switch/releases).

    ```bash theme={null}
    brew tap farion1231/ccswitch
    brew install --cask cc-switch
    ```
  </Tab>

  <Tab title="Windows">
    Descarga el instalador `CC-Switch-v{version}-Windows.msi` o la versión portátil `.zip` más reciente desde [GitHub Releases](https://github.com/farion1231/cc-switch/releases).
  </Tab>

  <Tab title="Linux">
    Descarga la versión `.deb`, `.rpm` o `.AppImage` más reciente desde [GitHub Releases](https://github.com/farion1231/cc-switch/releases).
  </Tab>
</Tabs>

## Qué necesitas

* Una BetterToken API Key (<a href={"https://bettertoken.ai/register"}>regístrate aquí</a>)
* Claude Code usa el protocolo Anthropic, por lo que su `Base URL` es `https://www.bettertoken.ai`
* Claude Desktop con un proveedor distinto de Claude requiere la versión más reciente de Claude Desktop y CC Switch `v3.16.5` o posterior
* Codex, OpenCode y OpenClaw usan el protocolo compatible con OpenAI, por lo que su `Base URL` es `https://www.bettertoken.ai/v1`
* Un ID de modelo vigente del **proveedor GPT** para Codex, OpenCode y OpenClaw. Cópialo desde la <a href={"https://bettertoken.ai/pricing"}>model plaza de BetterToken</a> o deja que CC Switch lo obtenga desde `/v1/models`

<Info>
  En el primer inicio, CC Switch importa automáticamente las configuraciones que encuentra en tu equipo. Puedes conservar tu proveedor oficial como alternativa y añadir BetterToken junto a él.
</Info>

<Note>
  BetterToken usa dos modos de acceso: Anthropic y compatible con OpenAI. Para no mezclar `https://www.bettertoken.ai` con `https://www.bettertoken.ai/v1`, crea proveedores por aplicación en lugar de intentar agrupar Claude Code y las herramientas compatibles con OpenAI en un proveedor universal.
</Note>

## Añade un proveedor BetterToken

<Tabs>
  <Tab title="Claude Code" id="claude-code">
    <Steps>
      <Step title="Abre Claude Code en CC Switch y añade un proveedor">
        Abre CC Switch, cambia a **Claude Code** y haz clic en **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="Página de Claude Code en CC Switch con el botón para crear un proveedor en la esquina superior derecha." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-add-provider.png" />
        </Frame>
      </Step>

      <Step title="Completa los campos básicos">
        * **Provider Name**: `BetterToken-claude` (u otro nombre fácil de identificar)
        * **Base URL**: `https://www.bettertoken.ai`
        * **API Key**: tu BetterToken API Key
        * **API Format**: `OpenAI Responses API`

        Los marcadores numerados de la captura corresponden a estos campos:

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

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-basic-fields.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=514944678fb16510d03f0f2610bd8b70" alt="Página de edición del proveedor Claude Code en CC Switch con los campos Provider Name, API Key y API Endpoint." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="Configura el mapeo según el proveedor">
        * Si usas el **proveedor Claude**, normalmente no necesitas cambiar las opciones avanzadas ni el mapeo de modelos
        * Si usas el **proveedor GPT**, completa esta configuración adicional:

        1. Abre **Advanced Options**
        2. Establece **API Format** en **OpenAI Responses API**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-api-format.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=5605667b764f033854f78dc981592f84" alt="Opciones avanzadas de CC Switch con API Format establecido en OpenAI Responses API." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-api-format.png" />
        </Frame>

        3. En **Model Mapping**, haz clic en **Fetch Model List**
        4. Elige valores explícitos en los menús de **Primary Model**, **Thinking Model**, **Haiku Default Model**, **Sonnet Default Model** y **Opus Default Model**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-model-mapping.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=d1104cc24dae2825dfed3a6be53dc6b3" alt="Sección Model Mapping de CC Switch con Fetch Model List y las asignaciones de Primary, Thinking, Haiku, Sonnet y Opus." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-model-mapping.png" />
        </Frame>

        Todos estos modelos deben usar ID vigentes del **proveedor GPT** obtenidos en la <a href={"https://bettertoken.ai/pricing"}>model plaza de BetterToken</a>.
      </Step>

      <Step title="Guarda, cambia de proveedor y decide si activar el proxy">
        Después de guardar, vuelve a la lista de proveedores:

        1. Marca el proveedor BetterToken como activo
        2. Si usas el **proveedor Claude**, no necesitas activar el **proxy de CC Switch** de la esquina superior izquierda
        3. Si usas el **proveedor GPT**, activa el **proxy de CC Switch**

        La captura siguiente muestra BetterToken-claude activo en la lista. Activa el **proxy de CC Switch** de la esquina superior izquierda solo si usas el **proveedor GPT**.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-enable-proxy.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=13c9adc5d76d5a2d1fae0e52e90a87ca" alt="Lista de proveedores de CC Switch con BetterToken-claude seleccionado y marcado como In Use." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-enable-proxy.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Desktop" id="claude-desktop">
    <Info>
      Esta pestaña corresponde a GPT, Kimi, GLM y otros proveedores distintos de Claude. Para el proveedor Claude, usa la [configuración directa de Claude Desktop](/es/faq/claude-desktop-bettertoken-api).
    </Info>

    <Steps>
      <Step title="Cambia a Claude Desktop y añade un proveedor">
        Abre CC Switch, selecciona el icono **Claude Desktop** en la barra superior y haz clic en **+** en la esquina superior derecha.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/cc-switch-claude-desktop-add-provider.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=8906aaf8ead247cf406a55a51f402bdf" alt="Selecciona Claude Desktop en CC Switch y haz clic en el botón más para añadir un proveedor." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/cc-switch-claude-desktop-add-provider.png" />
        </Frame>
      </Step>

      <Step title="Introduce los campos básicos">
        * **Provider Name**: usa un nombre reconocible, como `BetterToken-GPT`
        * **API Key**: tu BetterToken API Key
        * **API Endpoint**: `https://www.bettertoken.ai`

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/provider-basic-fields.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=ba55f76085a213cde6527e86aca54798" alt="Introduce Provider Name, API Key y API Endpoint para Claude Desktop en CC Switch." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/provider-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="Configura API Format y el mapeo de modelos">
        Selecciona **OpenAI Responses API (Requires routing)** en **API Format** y haz clic en **Fetch Models**.

        Asigna Sonnet, Opus, Fable y Haiku al ID de modelo que quieras usar:

        | Función del modelo | Modelo solicitado |
        | ------------------ | ----------------- |
        | Sonnet             | `YOUR_MODEL_ID`   |
        | Opus               | `YOUR_MODEL_ID`   |
        | Fable              | `YOUR_MODEL_ID`   |
        | Haiku              | `YOUR_MODEL_ID`   |

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/provider-model-mapping.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=d93c1bd4098f1f839cd2ab6a426d1aba" alt="Selecciona OpenAI Responses API y configura el mapeo de modelos de Claude Desktop en CC Switch." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/provider-model-mapping.png" />
        </Frame>

        Copia un ID de modelo vigente desde la <a href={"https://bettertoken.ai/pricing"}>model plaza</a> o el cuadro **Setup** de la API Key. Activa **Declare 1M** solo cuando la model plaza indique que el modelo admite una ventana de contexto de 1M.
      </Step>

      <Step title="Guarda, cambia de proveedor y activa el proxy">
        Guarda el proveedor, establécelo como **In use** y activa el interruptor del proxy en la esquina superior izquierda.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/provider-enable-proxy.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=99800d159627886f2e999f9eceb061bf" alt="El proveedor BetterToken para Claude Desktop está activo y el proxy de CC Switch está habilitado." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/provider-enable-proxy.png" />
        </Frame>
      </Step>

      <Step title="Reinicia Claude Desktop">
        Cierra Claude Desktop por completo y vuelve a abrirlo. **Gateway** en la esquina inferior izquierda confirma que la configuración está activa. Elige un modelo asignado en el menú del cuadro de mensajes.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/claude-desktop-gateway-ready.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=bf573497e7a842b367f6c9ca95fdc99b" alt="Claude Desktop muestra Gateway después de reiniciarse y ofrece los modelos asignados mediante CC Switch." style={{ borderRadius: '0.5rem' }} width="2400" height="1600" data-path="images/claude-desktop-third-party-models/claude-desktop-gateway-ready.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Codex" id="codex-cli">
    <Steps>
      <Step title="Abre Codex en CC Switch y añade un proveedor">
        Abre CC Switch, cambia a **Codex** y haz clic en **Add Provider**. Si CC Switch pide primero un preset, elige **OpenAI Compatible** o **Custom**.

        Los marcadores numerados de la captura corresponden a estas acciones:

        1. Cambia a **Codex**
        2. Haz clic en **Add Provider** en la esquina superior derecha

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/codex-cli-add-provider.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=5f892bf124c432babed54886c6051632" alt="Página Codex de CC Switch con Codex seleccionado y el botón para crear un proveedor en la esquina superior derecha." style={{ borderRadius: '0.5rem' }} width="1800" height="1532" data-path="images/cc-switch/codex-cli-add-provider.png" />
        </Frame>
      </Step>

      <Step title="Completa los campos básicos">
        * **Provider Name**: `BetterToken`
        * **Base URL**: `https://www.bettertoken.ai/v1`
        * **API Key**: tu BetterToken API Key

        Si cambias a la vista de configuración personalizada, asegúrate de que la configuración use `wire_api = "responses"`.

        Los marcadores numerados de la captura corresponden a estos campos:

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

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/codex-cli-basic-fields.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=a6483a11bcf6eaf3663134f407843391" alt="Página de edición del proveedor Codex en CC Switch con los campos Provider Name, API Key y Base URL." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/codex-cli-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="Obtén y asigna un modelo">
        Haz clic en **Fetch Models** y elige un ID de modelo vigente de la <a href={"https://bettertoken.ai/pricing"}>model plaza</a>. Codex no necesita el proxy de CC Switch.
      </Step>

      <Step title="Guarda y cambia de proveedor">
        Guarda el proveedor y cambia Codex a BetterToken. CC Switch escribe los archivos de autenticación y configuración de Codex correspondientes.

        Después de guardar, vuelve a la lista y confirma que BetterToken esté marcado como **In Use**.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/cc-switch/codex-cli-activate-provider.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=52dc850977af1443b4b573a27726c4b5" alt="Lista de proveedores Codex de CC Switch con BetterToken seleccionado y marcado como In Use." style={{ borderRadius: '0.5rem' }} width="1800" height="1686" data-path="images/cc-switch/codex-cli-activate-provider.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenCode" id="opencode">
    <Steps>
      <Step title="Abre OpenCode en CC Switch y añade un proveedor">
        Abre CC Switch, cambia a **OpenCode** y haz clic en **Add Provider**. Si CC Switch pide primero un preset, elige **OpenAI Compatible** o **Custom**.
      </Step>

      <Step title="Completa los campos básicos">
        * **Provider Name**: `BetterToken`
        * **Base URL**: `https://www.bettertoken.ai/v1`
        * **API Key**: tu BetterToken API Key
        * **API Format**: `OpenAI Compatible`
      </Step>

      <Step title="Elige el modelo predeterminado">
        Usa **Fetch Models** cuando sea posible. Si necesitas introducir el modelo manualmente, usa un ID vigente del **proveedor GPT** de la <a href={"https://bettertoken.ai/pricing"}>model plaza de BetterToken</a>.

        OpenCode lee directamente la configuración guardada del proveedor y no necesita el proxy de CC Switch.
      </Step>

      <Step title="Guarda y cambia de proveedor">
        Guarda el proveedor y cambia OpenCode a BetterToken.
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenClaw" id="openclaw">
    <Steps>
      <Step title="Abre OpenClaw en CC Switch y añade un proveedor">
        Abre CC Switch, cambia a **OpenClaw** y haz clic en **Add Provider**. Si CC Switch pide primero un preset, elige **OpenAI Compatible** o **Custom**.
      </Step>

      <Step title="Completa los campos básicos">
        * **Provider Name**: `BetterToken`
        * **Base URL**: `https://www.bettertoken.ai/v1`
        * **API Key**: tu BetterToken API Key
        * **API Format**: `OpenAI Responses API`

        Si editas una configuración personalizada del proveedor OpenClaw, comprueba que `api` sea `openai-responses`.
      </Step>

      <Step title="Elige el modelo predeterminado">
        Usa **Fetch Models** cuando sea posible. Si necesitas introducir el modelo manualmente, usa un ID vigente del **proveedor GPT**.

        OpenClaw usa directamente la configuración guardada del proveedor y no necesita el proxy de CC Switch.
      </Step>

      <Step title="Guarda y cambia de proveedor">
        Guarda el proveedor y cambia OpenClaw a BetterToken.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Aplica los cambios guardados

Después de guardar y cambiar de proveedor, reinicia el cliente o gateway afectado antes de verificar la configuración.

* Claude Code: termina por completo la sesión actual e inicia otra.
* Claude Desktop: cierra la aplicación por completo, vuelve a abrirla y confirma que **Gateway** aparezca en la esquina inferior izquierda.
* Codex: reinicia el proceso actual o abre una sesión de terminal nueva.
* OpenCode: termina la sesión actual e inicia otra.
* OpenClaw: ejecuta `openclaw gateway restart` y usa `/new`, `/status` y `/model` en Discord.

## Funciones avanzadas específicas de CC Switch

CC Switch puede conservar el inicio de sesión oficial de Codex al cambiar a un proveedor externo y reunir las sesiones oficiales y externas en un mismo historial. Reinicia Codex después de activar estas opciones. Consulta cómo [conservar el inicio de sesión oficial de Codex y unificar el historial](/es/faq/codex/official-login-third-party-api).

## Problemas habituales

* No añadas `/v1` a la `Base URL` de Claude Code
* Si Claude Code usa el **proveedor GPT**, establece **API Format** en **OpenAI Responses API** dentro de **Advanced Options**
* Si Claude Code usa el **proveedor Claude**, no necesitas activar el **proxy de CC Switch**
* Si Claude Desktop usa un proveedor distinto de Claude, activa el **proxy de CC Switch** y reinicia la aplicación por completo
* Codex, OpenCode y OpenClaw deben usar `https://www.bettertoken.ai/v1`
* Cuando Codex, OpenCode u OpenClaw soliciten un modelo, usa un ID del **proveedor GPT**
* Si falla **Fetch Models**, comprueba la API Key y la `Base URL` e introduce manualmente el ID del modelo
* Si el cambio no se aplica, confirma que BetterToken sea el proveedor activo en CC Switch y reinicia el cliente o gateway afectado como se describe arriba

## Páginas relacionadas

* Detalles de Claude Code: [Claude Code](/es/ai-tools/claude-code)
* Configuración directa del proveedor Claude en Claude Desktop: [Claude Desktop](/es/faq/claude-desktop-bettertoken-api)
* Detalles de Codex: [Codex](/es/ai-tools/codex)
* Detalles de OpenCode: [OpenCode](/es/ai-tools/opencode)
* Detalles de OpenClaw: [OpenClaw](/es/ai-tools/openclaw)

## Preguntas relacionadas

* [Usar modelos de terceros y Codex en Claude Desktop](/es/faq/claude-desktop/third-party-models)
* [API compatible con OpenAI frente a API compatible con Anthropic](/es/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [MCP frente a API Key y Base URL](/es/faq/concepts/mcp-vs-api-key-base-url)
* [¿Qué son model\_provider, base\_url y wire\_api?](/es/faq/codex/model-provider-base-url-wire-api)
* [Cómo configurar una API compatible con OpenAI en Cline](/es/faq/cline/openai-compatible-api)