Iniciar sesiónElegir plan
Docs

Dos ajustes. Cualquier agente.

Cada herramienta necesita las mismas dos cosas: una Base URL de CodingPass y tu clave. Pega la clave una vez y cada fragmento de esta página queda listo para copiar.

Base URLs

https://codingpass.ai

Compatible con Anthropic

Messages API. Claude Code, Cline y los SDK de Anthropic. Sin /v1 al final.

https://codingpass.ai/v1

Compatible con OpenAI

Chat Completions y Responses. Codex, OpenCode y los SDK de OpenAI.

Tu configuración

Pega tu clave, elige tu herramienta.

Se queda en esta pestaña. Solo rellena los fragmentos de esta página.

Modelo

Cada herramienta arranca con un valor predeterminado razonable. Tu plan decide qué modelos responden.

Añade las dos líneas export a ~/.zshrc o ~/.bashrc, abre una terminal nueva y arranca Claude Code.

~/.zshrc
export ANTHROPIC_BASE_URL="https://codingpass.ai"
export ANTHROPIC_AUTH_TOKEN="cp-live-tu-clave"
Luego ejecuta
claude --model claude-sonnet-5-5
Guía completa de Claude Code

Comprueba que la clave funciona

Lista los modelos a los que llega tu clave. Si devuelve una lista JSON, la clave y la URL son correctas; un 401 indica que la clave es errónea.

Terminal
curl https://codingpass.ai/v1/models \
  -H "Authorization: Bearer cp-live-tu-clave"

¿Tu herramienta no está en la lista?

Funciona cualquier herramienta que deje configurar una Base URL de Anthropic u OpenAI. Busca un campo de Base URL o proveedor personalizado, pega la URL y tu clave, y usa un ID de modelo de Modelos.

¿Sigues atascado? Escribe a [email protected] con el nombre de la herramienta y la cabecera x-request-id de la respuesta.

Errores

Cada error, su estado y qué hacer.

El gateway responde con un estado HTTP estándar y el formato de error que tu cliente ya conoce. El type es el que usan Anthropic y OpenAI, así que los SDK lo manejan como siempre; el message está escrito para personas. El código de error aparece junto a cada solicitud fallida en el registro de solicitudes del panel.

Dos formatos, según el endpoint

Endpoints compatibles con Anthropic (/v1/messages, /v1/messages/count_tokens)
HTTP/1.1 429 Too Many Requests
retry-after: 4253
x-should-retry: false
x-ratelimit-remaining-5h: 0
x-ratelimit-reset-5h: 1h10m53s
x-request-id: req_8f2c41d07ab3

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Account limit reached: your 5h quota is used up for all models. Resets at …"
  }
}
Endpoints compatibles con OpenAI (/v1/chat/completions, /v1/responses, /v1/models)
HTTP/1.1 401 Unauthorized
x-request-id: req_5b1f09c2e7d4

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "param": null,
    "code": null
  }
}
Errores del gateway por estado HTTP
EstadoCódigoCuándo ocurre y qué hacer
400Solicitud incorrecta
400invalid_requestinvalid_request_error

Cuerpo de solicitud no válido

Cuándo ocurre: El cuerpo no es JSON válido o falta un campo obligatorio: model, messages o max_tokens en la API de Anthropic.

Cómo solucionarlo:

  • Actualiza tu cliente. Versiones antiguas a veces envían campos con formato obsoleto.
  • Si llamas a la API desde tu propio código, compara el cuerpo con la referencia de API del proveedor.
401Autenticación
401invalid_api_keyauthentication_error

Clave API no aceptada

Cuándo ocurre: La clave falta, está mal escrita, fue eliminada o se envió en una cabecera que el gateway no lee.

Cómo solucionarlo:

  • Vuelve a copiar la clave desde Claves en el panel, sin espacios ni saltos de línea.
  • Los clientes Anthropic la envían como x-api-key; los compatibles con OpenAI como Authorization: Bearer.
  • Tras borrar o rotar una clave, actualiza todos los clientes que sigan usando la anterior.
403Permisos
403no_subscriptionpermission_error

Sin plan activo

Cuándo ocurre: La clave es válida, pero su cuenta no tiene ningún plan activo: no se contrató ninguno, terminó o falló un pago de renovación.

Cómo solucionarlo:

  • Comprueba el estado del plan y del pago en Facturación.
  • ¿Sin plan aún? Elige uno en Precios. La misma clave funcionará en cuanto esté activo.
404No encontrado
404 / 405wrong_base_urlnot_found_error

Base URL o método incorrecto

Cuándo ocurre: La solicitud llegó al gateway por una ruta o método que no atiende. Normalmente sobra o falta /v1 en la Base URL, o se abrió la dirección de la API en el navegador como página web.

Cómo solucionarlo:

  • Clientes Anthropic como Claude Code usan la Base URL sin /v1; los compatibles con OpenAI añaden /v1. El mensaje de error muestra ambos valores.
  • Copia la Base URL de la guía de configuración de tu herramienta en lugar de escribirla a mano.
  • Envía solicitudes POST. La API no tiene página web para abrir en un navegador.
404model_not_foundinvalid_request_error

Modelo fuera de tu plan

Cuándo ocurre: El ID del modelo está mal escrito o el modelo no está incluido en tu plan.

Cómo solucionarlo:

  • Copia el ID exacto del modelo desde Modelos.
  • Comprueba que tu plan incluya el modelo. Los planes superiores añaden modelos.
413Demasiado grande
413body_too_largeinvalid_request_error

Solicitud demasiado grande

Cuándo ocurre: El cuerpo de la solicitud supera el límite de tamaño del gateway, normalmente por un contexto muy largo o adjuntos grandes.

Cómo solucionarlo:

  • Compacta o limpia la conversación (/compact en Claude Code) y reintenta.
  • Adjunta menos archivos o imágenes, o más pequeños.
429Límites
429quota_exceededrate_limit_error

Cuota agotada

Cuándo ocurre: Se alcanzó un límite de 5 horas, semanal o mensual, para un modelo o para toda la cuenta. El mensaje indica la ventana y la hora de restablecimiento; retry-after da los segundos de espera.

Cómo solucionarlo:

  • Espera hasta la hora de restablecimiento indicada en el mensaje.
  • Si solo un modelo alcanzó su límite, cambia a otro modelo. Los demás siguen funcionando.
  • Usa un restablecimiento de cuota en Facturación. Uno completo borra el uso de 5 horas, semanal y mensual; uno semanal borra el de 5 horas y semanal.
  • Sube de plan en Precios para tener límites más altos. Límites de uso explica cómo funcionan las ventanas.
429concurrency_limitedrate_limit_errorSeguro reintentar

Demasiadas solicitudes a la vez

Cuándo ocurre: Tu plan permite un número fijo de solicitudes en curso, y llegó una nueva mientras todas estaban ocupadas.

Cómo solucionarlo:

  • Ejecuta menos agentes o subagentes en paralelo.
  • Reintenta tras un segundo. La respuesta incluye retry-after: 1.
  • Los planes superiores permiten más solicitudes simultáneas. Compáralos en Precios.
429no_upstream_availablerate_limit_errorSeguro reintentar

Modelo al máximo de capacidad

Cuándo ocurre: Este modelo está al máximo de capacidad ahora mismo.

Cómo solucionarlo:

  • Espera los segundos indicados en la cabecera retry-after y reintenta.
  • Cambia a otro modelo de tu plan por ahora.
5xxProveedor del modelo
4xx / 5xxupstream_errorapi_errorSeguro reintentar

El proveedor del modelo devolvió un error

Cuándo ocurre: El proveedor del modelo rechazó o falló la solicitud, y el gateway reenvió su estado y mensaje. Un 502 significa que siguió fallando tras los reintentos.

Cómo solucionarlo:

  • Lee el mensaje del proveedor. Un 4xx suele señalar algo en la solicitud que conviene cambiar.
  • Reintenta un 5xx tras unos segundos. Si sigue fallando, revisa Estado.
503No disponible
503plan_unavailableapi_errorSeguro reintentar

Comprobación de plan no disponible

Cuándo ocurre: El gateway no pudo cargar tu plan por un momento. El problema es nuestro, no de tu clave.

Cómo solucionarlo:

503quota_unavailableapi_errorSeguro reintentar

Comprobación de cuota no disponible

Cuándo ocurre: El gateway no pudo leer tus contadores de uso, así que rechazó la solicitud en lugar de adivinar. El problema es de nuestro lado.

Cómo solucionarlo:

503upstream_unavailableapi_errorSeguro reintentar

No se pudo atender la solicitud

Cuándo ocurre: El modelo no pudo aceptar esta solicitud antes de responder. Reintentar suele funcionar.

Cómo solucionarlo:

503no_upstreamapi_error

Modelo no disponible ahora mismo

Cuándo ocurre: El modelo está en tu plan, pero no está disponible en este momento.

Cómo solucionarlo:

200 / 499Durante la respuesta
200stream_incompleteapi_errorSeguro reintentar

Stream cortado

Cuándo ocurre: La respuesta empezó con 200 pero el stream terminó antes de completarse, así que el cliente muestra una respuesta a medias o un error al final.

Cómo solucionarlo:

  • Reintenta tras unos segundos.
  • Revisa proxies o VPN entre tú y la API que corten conexiones largas.
499client_aborted

Cancelado por el cliente

Cuándo ocurre: Tu cliente cerró la conexión antes de terminar la respuesta: pulsaste Esc o Ctrl+C, expiró el timeout del cliente o se cayó la red. El 499 solo aparece en tu registro; el cliente nunca lo recibe.

Cómo solucionarlo:

  • Si cancelaste la solicitud tú mismo, no hay nada que arreglar.
  • Si ocurre solo, sube el timeout del cliente. Las respuestas largas pueden tardar varios minutos.

Los errores marcados como “seguro reintentar” son temporales: espera uno o dos segundos, o los segundos de retry-after, y vuelve a enviar la misma solicitud. La mayoría de los SDK lo hacen solos para 429 y 5xx. Todo lo demás requiere antes un cambio de tu lado.

Cabeceras de respuesta útiles

Cabeceras de respuesta que añade el gateway
CabeceraSignificado
x-request-idID único de esta solicitud, el mismo que aparece en tu registro de uso. Inclúyelo cuando escribas a [email protected].
retry-afterSegundos de espera antes de reintentar. Se envía con 429 y con 503 temporales.
x-should-retrySe envía como false con quota_exceeded: los SDK oficiales de Anthropic y OpenAI dejan entonces de reintentar por su cuenta, porque la espera es una ventana entera.
x-ratelimit-remaining-<window>Se envía como 0 con quota_exceeded. El sufijo es la ventana que alcanzaste: 5h, week o month. Si es de la cuenta o de un solo modelo aparece en el mensaje de error.
x-ratelimit-reset-<window>Se envía con quota_exceeded: cuánto falta para que se libere esa ventana, por ejemplo 1h10m53s.
x-ratelimit-limit-concurrencySe envía con concurrency_limited: cuántas solicitudes simultáneas permite tu plan. x-ratelimit-remaining-concurrency es 0. No se envía cuando el 429 es por capacidad del proveedor.