Claude Code · Solución de problemas
Error 400 bad request de la API de Claude Code: causas comunes
Un 400 significa que la API entendió quién eres, pero rechazó la solicitud en sí. El mensaje después de invalid_request_error suele decir exactamente qué estaba mal; compáralo con la tabla a continuación.
Última comprobación
El texto del error
API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"..."}}Compara el mensaje
| El mensaje contiene | Causa | Solución |
|---|---|---|
| model / not found / invalid model | ANTHROPIC_MODEL o /model apunta a un ID de modelo que no está disponible | Elige un modelo desde /model o la página de modelos |
| prompt is too long / context | La conversación supera la ventana de contexto del modelo | Ejecuta /compact, o /clear y empieza de nuevo |
| max_tokens | Una anulación de tokens de salida es demasiado alta para el modelo | Elimina CLAUDE_CODE_MAX_OUTPUT_TOKENS o redúcelo |
| Not found / 404 instead of 400 | La URL base termina en /v1 | Usa https://api.aicodewith.ai exactamente |
| image / file | Un archivo adjunto que el modelo no puede aceptar | Redimensiona o elimina el archivo adjunto |
Solución paso a paso
1. Lee el mensaje
El texto después de invalid_request_error indica el problema. Búscalo en la tabla anterior.
2. Restablece las anulaciones de modelo
Elimina ANTHROPIC_MODEL y otras anulaciones de modelo de settings.json, reinicia y elige un modelo con /model.
~/.claude/settings.json{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_API_KEY": "", "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai" } }3. Reduce el contexto
Ejecuta /compact. Si la sesión es muy larga, /clear y continúa en una nueva.
¿Se cobran las solicitudes fallidas?
Las solicitudes fallidas (4xx/5xx, tiempos de espera, conexiones interrumpidas) no se cobran: solo se te factura por las solicitudes que se completan correctamente. Si un fallo del proveedor se reintenta automáticamente y tiene éxito, se te cobra una vez.
¿Sigue fallando?
- Consulta la página del modelo en aicodewith: muestra el estado reciente de cada canal.
- Busca la solicitud en los registros de uso de tu panel para ver su modelo, estado y coste.
- Envía un correo a support@aicodewith.com con la hora del error, el modelo y el texto del error (nunca tu clave de API completa).
Estado y precios de modelosContactar con soporteDocumentación
FAQ
¿Qué significa el error 400 de Claude Code?
La API rechazó el contenido de la solicitud. El mensaje después de invalid_request_error indica por qué: a menudo un ID de modelo incorrecto o una conversación demasiado larga.
¿Cómo soluciono "prompt is too long"?
Ejecuta /compact para resumir la sesión, o /clear y empieza de nuevo. Mantén CLAUDE.md y los registros pegados breves.
¿La URL base necesita /v1?
No. Usa https://api.aicodewith.ai; añadir /v1 rompe la ruta de la solicitud.
¿Por qué empezó después de editar settings.json?
Una anulación de modelo o de tokens suele ser la causa habitual. Elimina las anulaciones, reinicia y elige un modelo con /model.
¿Qué IDs de modelo puedo usar?
Ejecuta /model en Claude Code, o consulta la página de modelos para ver todos los modelos disponibles y sus IDs.
¿Me cobran las solicitudes fallidas?
Las solicitudes fallidas (4xx/5xx, tiempos de espera, conexiones interrumpidas) no se cobran: solo se te factura por las solicitudes que se completan correctamente. Si un fallo del proveedor se reintenta automáticamente y tiene éxito, se te cobra una vez.
¿Listo para probarlo?
El cobro es por token desde un saldo prepago. Se aplican límites de velocidad y concurrencia, y puedes establecer topes de gasto diarios, mensuales o totales en cada clave de API.
Relacionado
Fuentes
- Documentación de Claude Code: errores
- Documentación de Claude Code: configuración
- Documentación de la API de Anthropic: errores
Claude y Claude Code son marcas comerciales de Anthropic PBC. aicodewith es una plataforma independiente y no está afiliada a Anthropic ni cuenta con su respaldo. Los formatos de error se citan de Claude Code y pueden cambiar. Verificado 2026-10-10.