Claude Desktop en Rusia: configurar un gateway de inferencia

Qué significa la inferencia de terceros en Claude Desktop

Normalmente, Claude Desktop usa una cuenta y los servicios de Anthropic. La inferencia de terceros cambia el recorrido de la solicitud al modelo: la aplicación la envía al gateway configurado. Esto no convierte una API de terceros en una suscripción de Claude ni elimina los requisitos propios de la aplicación para la instalación, las actualizaciones o la disponibilidad de funciones.

No confundas un gateway de inferencia con Desktop Extensions o MCP. Las extensiones dan a Claude acceso a aplicaciones y datos locales. El gateway enruta las solicitudes hacia un modelo. Un fallo en una capa no demuestra que otra capa esté averiada.

La documentación actual de Anthropic indica que Claude Desktop está disponible para macOS, Windows y Linux beta. Las rutas de menú Help → Troubleshooting y Developer → Configure Third-Party Inference… que aparecen abajo están confirmadas por la guía actual de BetterToken para macOS. En otro sistema operativo, comprueba primero que la versión instalada exponga los mismos ajustes.

Elegir la ruta según el grupo de API Key

• Grupo Claude: gateway Anthropic-compatible directo; la Gateway base URL es https://www.bettertoken.ai; el esquema de autenticación es x-api-key.
• Grupo Codex: BetterToken → CC Switch → ruta local de Claude; la Gateway base URL es la Service address de CC Switch; el esquema de autenticación es bearer.

Para un grupo Codex, no introduzcas https://www.bettertoken.ai/v1 directamente en el Gateway de Claude Desktop. Esa es una Base URL OpenAI-compatible, mientras que el campo Gateway espera una ruta compatible con Anthropic. CC Switch acepta la OpenAI Responses API, asigna los modelos y expone una dirección de servicio local para Claude Desktop.

Configuración directa para un grupo Claude

1. Instalar la versión actual de Claude Desktop

Descarga la aplicación desde la página oficial de Claude. El flujo de instalación normal de Anthropic solicita iniciar sesión. El flujo de BetterToken Gateway comienza antes de ese inicio de sesión; sigue la secuencia de la guía del gateway para no mezclar ambos modos.

2. Activar el modo de desarrollador

En macOS, abre:

Help → Troubleshooting → Enable Developer Mode

Haz clic en Enable y cierra Claude Desktop por completo. Al reiniciarlo debería aparecer el menú Developer.

3. Abrir los ajustes del gateway

Ve a:

Developer → Configure Third-Party Inference…

Selecciona Gateway y rellena:

Gateway base URL: https://www.bettertoken.ai
Gateway API key: tu API Key de Token management
Gateway auth scheme: x-api-key

No incluyas la clave en un artículo, una captura, un registro público ni un repositorio. Después de seleccionar x-api-key, la aplicación debería solicitar los modelos disponibles del grupo Claude.

4. Aplicar los ajustes y reiniciar

Haz clic en Apply locally y después en Relaunch now. Tras el inicio, selecciona Continue with Gateway. La etiqueta Cowork 3P | Gateway de la esquina inferior izquierda indica que la ruta está activa.

Ruta local para un grupo Codex

Esta ruta es más larga: Claude Desktop se conecta a una dirección local de CC Switch, y CC Switch envía las solicitudes a la OpenAI Responses API de BetterToken.

1. Añadir BetterToken como proveedor en CC Switch

Abre Claude Code, haz clic en Add Provider e introduce:

Provider Name: BetterToken
Base URL: https://www.bettertoken.ai
API Key: tu BetterToken API Key

En Advanced Options, selecciona OpenAI Responses API. Luego pulsa Fetch Model List y asigna explícitamente modelos a los campos de mapping disponibles. Usa únicamente ID actuales de tu grupo Codex; no copies un modelo de un artículo antiguo ni de una captura ajena.

2. Activar la ruta local

Guarda el proveedor, márcalo como In use y activa el proxy. En Settings → Routing, comprueba el interruptor principal y la ruta de Claude. Copia la Service address mostrada; esa dirección local es la que necesita Claude Desktop.

3. Rellenar los campos Gateway en Claude Desktop

Vuelve a Developer → Configure Third-Party Inference…, selecciona Gateway e introduce:

Gateway base URL: Service address de CC Switch
Gateway API key: tu BetterToken API Key
Gateway auth scheme: bearer

En Model list, añade el Model ID actual y el Display name configurados en CC Switch. Haz clic en Apply locally, acepta Relaunch now y selecciona Continue with Gateway.

Verificar la solicitud y el registro del Dashboard

No empieces con acceso a directorios de trabajo ni con una tarea larga. Envía una solicitud breve sin datos personales, por ejemplo pregunta cuál es la diferencia entre un array JSON y un objeto; luego abre el Dashboard de BetterToken.

Una comprobación correcta tiene dos señales:

1. Claude Desktop muestra la respuesta y el modo activo Cowork 3P | Gateway.
2. El Dashboard muestra un registro coincidente con hora, modelo, estado, tokens de entrada/salida/caché y cargo.

Si recibes una respuesta pero no hay registro, confirma que la aplicación usa realmente Gateway y no otro modo. Si aparece un registro con estado de error, la ruta alcanzó la capa de API: revisa el grupo de claves, el esquema de autenticación, el modelo y el saldo. No uses el Dashboard como almacenamiento de un prompt o una respuesta completos; elimina claves y contenido de solicitudes de los registros antes de contactar al soporte.

Qué revisar si Claude Desktop no conecta

• No aparece el menú Developer: activa de nuevo el modo de desarrollador y cierra Claude Desktop por completo, no solo la ventana.
• Your provider setup needs a fix: revisa Model list, los ID actuales y todos los mappings obligatorios en CC Switch.
• 401 o 403: selecciona x-api-key para un grupo Claude y bearer para la ruta local de un grupo Codex.
• No hay respuesta ni registro en el Dashboard: confirma que el proxy, el interruptor principal de Routing y la ruta de Claude están activados en CC Switch.
• Aparece un registro pero falla la solicitud: revisa el grupo de claves, el modelo actual, el saldo disponible y los espacios accidentales de la clave.
• No cambia nada después de Apply locally: pulsa Relaunch now y después selecciona Continue with Gateway.

No diagnostiques el Gateway a partir de una sola etiqueta de interfaz. Correlaciona el modo de Claude Desktop, el estado de la ruta local y el registro de solicitud del Dashboard para saber en qué capa se interrumpe la cadena.

Limitaciones de este método

BetterToken es un proveedor de API independiente, no un producto de Anthropic ni un sustituto de una suscripción de Claude. Es responsable de su propio API Endpoint y de la documentación de configuración. El acceso a descargas, el inicio de sesión, las actualizaciones, Cowork, Code mode y otras funciones de Claude Desktop dependen de la versión actual de la aplicación, el plan y las reglas de Anthropic.

La conexión al API Endpoint de BetterToken desde Rusia no requiere VPN. Esta afirmación no cubre el sitio web de Claude, las descargas de la aplicación, las cuentas ni los servicios externos. Si las opciones de tu menú difieren de este artículo, detente y compara la documentación oficial de instalación de Claude Desktop con la guía de configuración actual de BetterToken.

Preguntas frecuentes

¿Puedo introducir https://www.bettertoken.ai/v1 en el Gateway de Claude Desktop?

No para el flujo descrito aquí. Es una dirección OpenAI-compatible. Un grupo Claude usa el endpoint Anthropic-compatible directo https://www.bettertoken.ai; un grupo Codex se conecta mediante la Service address local de CC Switch.

¿Necesito una cuenta de Claude para el modo Gateway?

Las instrucciones habituales de Anthropic piden iniciar sesión tras la instalación. La guía actual de BetterToken Gateway lleva al usuario por Continue with Gateway antes del inicio de sesión normal. No copies pasos de un modo al otro; comprueba la interfaz de tu versión instalada de Claude Desktop.

¿Cómo sé cuál es el esquema de autenticación correcto?

Usa x-api-key para un grupo Claude directo. Usa bearer para un grupo Codex enrutado localmente mediante CC Switch. Tras aplicar los ajustes, verifica tanto la respuesta de Desktop como un nuevo registro en el Dashboard.