Cómo conectar Claude Code y Cherry Studio a un relay de API de terceros (listo en 5 minutos)

2026-09-28 ｜ RouteAPI Team ｜ 5 min read

Claude Code es el agente de programación en terminal oficial de Anthropic, y Cherry Studio es uno de los clientes de IA de escritorio más populares de China. Por defecto, ambos se conectan a los endpoints oficiales y facturan a la tarifa oficial completa. Esta guía te muestra cómo redirigir sus peticiones a un relay de API: solo hacen falta dos cambios de configuración.

Índice

1. Consigue primero tu API Key 2. Configurar Claude Code 3. Configurar Cherry Studio 4. Verificación y preguntas frecuentes

1. Consigue primero tu API Key

  1. Abre RouteAPI y regístrate o inicia sesión (con inicio de sesión de Google en un clic);
  2. En la barra lateral izquierda, entra en «Claves API» → crea una clave y cópiala; tendrá este aspecto: sk-xxxx;
  3. Cuando tu saldo esté bajo, recarga en línea en la página de recarga: el saldo se acredita automáticamente tras el pago.

2. Configurar Claude Code

Claude Code apunta al endpoint de origen mediante variables de entorno. Basta con añadirlas a tu archivo de configuración de shell (~/.zshrc o ~/.bashrc):

# Usar un relay (protocolo compatible con Anthropic)
export ANTHROPIC_BASE_URL=https://route-api.site
export ANTHROPIC_AUTH_TOKEN=sk-your-key

# O usar el protocolo compatible con OpenAI (para herramientas que admiten una base_url personalizada)
export OPENAI_BASE_URL=https://route-api.site/v1
export OPENAI_API_KEY=sk-your-key

Tras guardar, ejecuta source ~/.zshrc (o reinicia el terminal) y usa el comando claude con normalidad. Consulta el catálogo de modelos para ver los nombres de modelo.

3. Configurar Cherry Studio

  1. Abre Cherry Studio → «Ajustes» en la esquina inferior izquierda → «Servicios de modelos»;
  2. Elige «Añadir» para crear un proveedor compatible con OpenAI (o edita directamente un proveedor existente);
  3. Pon como dirección de API https://route-api.site/v1 y pega tu clave sk- en el campo API Key;
  4. Haz clic en «Obtener lista de modelos» o añade manualmente los nombres de modelo que quieras en los ajustes de modelos (p. ej. claude-sonnet-4-6, gpt-5.6-terra);
  5. Vuelve a la vista de chat y cambia de modelo arriba para empezar.

4. Verificación y preguntas frecuentes

¿Cómo compruebo que está bien configurado? Envía un mensaje: si recibes una respuesta normal, todo funciona. En la sección «Uso» de la consola verás el consumo de tokens y el coste de esa llamada.

¿Error 401? Comprueba que la clave se ha copiado entera y que la dirección termina en /v1.

¿Saldo insuficiente? Recarga en la página de recarga y vuelve a intentarlo cuando llegue el saldo.

¿Qué modelos se admiten? Todos (Claude, GPT, Grok y más) están en el catálogo de modelos, facturados uniformemente al 49 % del precio oficial de referencia.

Modelos

Modelos →