---
title: "Docs: configurar Claude Code, Codex, OpenCode y Cline, y todos los errores API"
description: "Las dos Base URL, configuración lista para copiar para cada agente con tu clave rellenada y cada error que devuelve el gateway con qué hacer."
url: https://codingpass.ai/es/docs
language: es
---
# 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.

## Pega tu clave, elige tu herramienta.

Clave API [Obtener clave](https://codingpass.ai/es/app/keys)

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](https://codingpass.ai/es/tools/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](https://codingpass.ai/es/models).

¿Sigues atascado? Escribe a support@codingpass.ai 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](https://codingpass.ai/es/app/usage) 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
  }
}
```

| Estado | Código | Cuándo ocurre y qué hacer |
| --- | --- | --- |
| 400Solicitud incorrecta |  |  |
| 400 | invalid\_request invalid\_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 |  |  |
| 401 | invalid\_api\_key authentication\_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](https://codingpass.ai/es/app/keys) 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 |  |  |
| 403 | no\_subscription permission\_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](https://codingpass.ai/es/app/billing). ¿Sin plan aún? Elige uno en [Precios](https://codingpass.ai/es/pricing). La misma clave funcionará en cuanto esté activo. |
| 404No encontrado |  |  |
| 404 / 405 | wrong\_base\_url not\_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](https://codingpass.ai/es/tools) 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. |
| 404 | model\_not\_found invalid\_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](https://codingpass.ai/es/models). Comprueba que tu plan incluya el modelo. Los planes superiores añaden modelos. |
| 413Demasiado grande |  |  |
| 413 | body\_too\_large invalid\_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 |  |  |
| 429 | quota\_exceeded rate\_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](https://codingpass.ai/es/app/billing). 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](https://codingpass.ai/es/pricing) para tener límites más altos. [Límites de uso](https://codingpass.ai/es/usage-limits) explica cómo funcionan las ventanas. |
| 429 | concurrency\_limited rate\_limit\_error Seguro 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](https://codingpass.ai/es/pricing). |
| 429 | no\_upstream\_available rate\_limit\_error Seguro 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 / 5xx | upstream\_error api\_error Seguro 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](https://codingpass.ai/es/status). |
| 503No disponible |  |  |
| 503 | plan\_unavailable api\_error Seguro 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:** Reintenta tras unos segundos. Si dura más de unos minutos, revisa [Estado](https://codingpass.ai/es/status) y escribe a support@codingpass.ai. |
| 503 | quota\_unavailable api\_error Seguro 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:** Reintenta tras unos segundos. Si dura más de unos minutos, revisa [Estado](https://codingpass.ai/es/status) y escribe a support@codingpass.ai. |
| 503 | upstream\_unavailable api\_error Seguro 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:** Reintenta tras unos segundos. Si dura más de unos minutos, revisa [Estado](https://codingpass.ai/es/status) y escribe a support@codingpass.ai. |
| 503 | no\_upstream api\_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:** Cambia a otro modelo de tu plan por ahora. Si dura más de unos minutos, revisa [Estado](https://codingpass.ai/es/status) y escribe a support@codingpass.ai. |
| 200 / 499Durante la respuesta |  |  |
| 200 | stream\_incomplete api\_error Seguro 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. |
| 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:** 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

| Cabecera | Significado |
| --- | --- |
| x-request-id | ID único de esta solicitud, el mismo que aparece en tu registro de uso. Inclúyelo cuando escribas a support@codingpass.ai. |
| 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. |
