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
Compatible con Anthropic
Messages API. Claude Code, Cline y los SDK de Anthropic. Sin /v1 al final.
Compatible con OpenAI
Chat Completions y Responses. Codex, OpenCode y los SDK de OpenAI.
Pega tu clave, elige tu herramienta.
Se queda en esta pestaña. Solo rellena los fragmentos de esta página.
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.
export ANTHROPIC_BASE_URL="https://codingpass.ai" export ANTHROPIC_AUTH_TOKEN="cp-live-tu-clave"
claude --model claude-sonnet-5-5
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.
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.
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
/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 …" } }
/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 } }
| Estado | Código | Cuándo ocurre y qué hacer |
|---|---|---|
| 400Solicitud incorrecta | ||
| 400 | invalid_requestinvalid_request_error | Cuerpo de solicitud no válido Cuándo ocurre: El cuerpo no es JSON válido o falta un campo obligatorio: Cómo solucionarlo:
|
| 401Autenticación | ||
| 401 | invalid_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:
|
| 403Permisos | ||
| 403 | no_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:
|
| 404No encontrado | ||
| 404 / 405 | wrong_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 Cómo solucionarlo:
|
| 404 | model_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:
|
| 413Demasiado grande | ||
| 413 | body_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:
|
| 429Límites | ||
| 429 | quota_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; Cómo solucionarlo:
|
| 429 | concurrency_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:
|
| 429 | no_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:
|
| 5xxProveedor del modelo | ||
| 4xx / 5xx | upstream_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:
|
| 503No disponible | ||
| 503 | plan_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:
|
| 503 | quota_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:
|
| 503 | upstream_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:
|
| 503 | no_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 | ||
| 200 | stream_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:
|
| 499 | client_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:
|
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
| Cabecera | Significado |
|---|---|
| x-request-id | ID único de esta solicitud, el mismo que aparece en tu registro de uso. Inclúyelo cuando escribas a [email protected]. |
| retry-after | Segundos de espera antes de reintentar. Se envía con 429 y con 503 temporales. |
| x-should-retry | Se 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-concurrency | Se 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. |