Configura BetterToken en CC Switch

CC Switch es una aplicación de escritorio opcional para administrar API Keys, direcciones y modelos de Claude Code, Claude Desktop, Codex CLI, OpenCode y OpenClaw.

Instala CC Switch

macOS

Homebrew es la opción más sencilla. También puedes descargar el .dmg o .zip más reciente desde GitHub Releases.

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows

Descarga el instalador CC-Switch-v{version}-Windows.msi o la versión portátil .zip más reciente desde GitHub Releases.

Linux

Descarga la versión .deb, .rpm o .AppImage más reciente desde GitHub Releases.

Qué necesitas

• Una BetterToken API Key (regístrate aquí)
• Claude Code usa el protocolo Anthropic, por lo que su Base URL es https://bettertoken.ai
• Codex, OpenCode y OpenClaw usan el protocolo compatible con OpenAI, por lo que su Base URL es https://bettertoken.ai/v1
• Un ID de modelo vigente para Codex, OpenCode y OpenClaw. Cópialo desde la model plaza de BetterToken o deja que CC Switch lo obtenga desde /v1/models

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.

BetterToken usa dos modos de acceso: Anthropic y compatible con OpenAI. Para no mezclar https://bettertoken.ai con https://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.

Añade un proveedor BetterToken

Claude Code

En CC Switch, selecciona Claude Code y haz clic en Add Provider.

Conecta Claude Code con tu BetterToken API Key, la Base URL https://bettertoken.ai y el Model ID que quieras usar.

• Provider Name: BetterToken
• API Key: YOUR_API_KEY
• API Endpoint: https://bettertoken.ai

Usa el formato Anthropic Messages API. Introduce los Model ID elegidos en Model Mapping y guarda la configuración.

Copia el Model ID exacto de la model plaza.

Guarda la configuración, activa BetterToken y reinicia completamente el cliente.

Claude Desktop

Claude Desktop solo admite modelos Claude. Es una limitación del cliente Claude Desktop.

Abre la página independiente Claude Desktop en CC Switch para añadir un proveedor o importar proveedores existentes de Claude Code. Revisa los Model IDs de Claude importados y el modo de conexión antes de activarlo; consulta el manual oficial de Claude Desktop.

Para configurarlo directamente en Claude Desktop, sigue la guía de Claude Desktop: selecciona Gateway, usa la Base URL https://bettertoken.ai, tu BetterToken API Key y Gateway auth scheme x-api-key. Pulsa Apply Changes para guardar y volver a iniciar Claude Desktop.

Codex

En CC Switch actual, inicia sesión oficialmente antes de conservarla. Abre Ajustes → Configuración de aplicaciones → Codex y activa Conservar sesión oficial al cambiar sin toma de control; después añade o activa BetterToken. No sobrescribas el archivo de sesión oficial con una clave de terceros.

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

Completa los campos básicos

• Provider Name: BetterToken
• Base URL: https://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

Obtén y asigna un modelo

Haz clic en Fetch Models y elige un ID de modelo vigente de la model plaza. Codex no necesita el proxy de CC Switch.

Guarda y cambia de proveedor

Guarda y activa BetterToken. La API Key de terceros se escribe en el provider de config.toml; el interruptor de conservación decide si permanece el auth.json oficial.

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

OpenCode

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.

Completa los campos básicos

• Provider Name: BetterToken
• Base URL: https://bettertoken.ai/v1
• API Key: tu BetterToken API Key
• API Format: OpenAI Compatible

Elige el modelo predeterminado

Usa Fetch Models cuando sea posible. Si necesitas introducir el modelo manualmente, usa un ID vigente de la model plaza de BetterToken.

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

Guarda y cambia de proveedor

Añade el proveedor en CC Switch y selecciona el proveedor y el modelo de BetterToken dentro de OpenCode. CC Switch guarda este proveedor junto con los demás proveedores de OpenCode.

OpenClaw

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.

Completa los campos básicos

• Provider Name: BetterToken
• Base URL: https://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.

Elige el modelo predeterminado

Usa Fetch Models cuando sea posible. Si necesitas introducir el modelo manualmente, usa un ID vigente.

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

Guarda y cambia de proveedor

Añade el proveedor en CC Switch y selecciona el proveedor y el modelo de BetterToken dentro de OpenClaw. CC Switch guarda este proveedor junto con los demás proveedores de OpenClaw.

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 la sesión oficial de Codex al cambiar directamente. Historial unificado de sesiones Codex es opcional y solo afecta a resume en CLI; no hace falta para la versión de escritorio actual. Continuar una sesión con otro provider puede fallar; crea una nueva tras cambiar. Consulta sesión oficial e historial.

Problemas habituales

• No añadas /v1 a la Base URL de Claude Code

• 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://bettertoken.ai/v1

• Cuando Codex, OpenCode u OpenClaw soliciten un modelo, usa un ID

• Si falla Fetch Models, comprueba la API Key y la Base URL e introduce manualmente el ID del modelo

• Si los cambios no se aplican, confirma que BetterToken esté activo en CC Switch para Codex o seleccionado dentro de OpenCode/OpenClaw y reinicia el cliente o gateway afectado como se describe arriba

• Si Codex bloquea el envío al agotarse la cuota oficial, conservar la sesión oficial puede mantener ese bloqueo. Sigue las indicaciones de la versión oficial: cambia al modo directo, desactiva Keep official login for direct switches en Settings → App config → Codex, activa BetterToken y reinicia Codex por completo. Esto usa el modo API Key y deja sin acceso las funciones que requieren la sesión oficial; restaura la configuración que conserva la sesión cuando se renueve la cuota.

Páginas relacionadas

• Detalles de Claude Code: Claude Code

• Configuración directa del proveedor Claude en Claude Desktop: Claude Desktop

• Detalles de Codex: Codex

• Detalles de OpenCode: OpenCode

• Detalles de OpenClaw: OpenClaw

• Compara todas las herramientas compatibles

• Errores de API, códigos de estado y límites de solicitudes

Preguntas relacionadas

• Endpoint de Claude Desktop
• API compatible con OpenAI frente a API compatible con Anthropic
• MCP frente a API Key y Base URL
• ¿Qué son model_provider, base_url y wire_api?
• Cómo configurar una API compatible con OpenAI en Cline