Errores comunes de Claude Code y cómo solucionarlos

Índice de mensajes de error

Los mensajes de error siguientes se han probado en Claude Code 2.1.299.

400

API Error: 400 {"error":"模型 xxx 不存在或未上线，请前往 https://aicodewith.com/zh/dashboard/pricing 查看可用模型列表 (request_id: …)"}

• •El nombre del modelo está mal escrito o el modelo no está disponible: ejecuta /model para elegirlo de nuevo o consulta el ID del modelo en la página del modelo.
• •El contexto es demasiado largo: ejecuta /compact para comprimir la conversación o /clear para iniciar una sesión nueva.

401 Autenticación

Failed to authenticate. API Error: 401 {"error":"请在请求中提供有效的 API Key。"}

1. Vuelve a copiar la clave desde el panel, comprueba que no tenga espacios ni saltos de línea al principio o al final y asegúrate de que la clave no se haya eliminado.
2. Pon la clave en ANTHROPIC_AUTH_TOKEN y deja ANTHROPIC_API_KEY vacía.
3. En una terminal nueva, ejecuta echo $ANTHROPIC_API_KEY y elimina los valores antiguos de ~/.zshrc o ~/.bashrc.
4. Cierra todas las sesiones de Claude Code y vuelve a abrirlas; después, ejecuta /status.

403 Clave desactivada

Failed to authenticate. API Error: 403 此 API Key 已被停用，如有疑问请联系我们 https://aicodewith.com/zh/contact

Cuando la clave se desactiva o se elimina, este error aparece en cuestión de segundos. Comprueba el estado de la clave en el panel, crea una clave nueva y actualiza tu configuración; contacta con nosotros si tienes alguna duda.

Not logged in

Not logged in · Please run /login

Esto significa que la clave está vacía o no está configurada; no quiere decir que tengas que iniciar sesión en una cuenta de Claude. Introduce la clave en ANTHROPIC_AUTH_TOKEN dentro de ~/.claude/settings.json y reinicia Claude Code.

429 Límite de solicitudes

{"error":"当前并发请求过多，请稍后重试 (request_id: …)"}

(Este error se reprodujo con solicitudes curl simultáneas; la visualización dentro de Claude Code puede variar.)

El pago por uso no tiene cuota de 5 horas ni semanal, pero los límites de tasa y concurrencia siguen aplicándose. Cuando se envían demasiadas solicitudes a la vez, las solicitudes sobrantes devuelven 429; espera un momento y vuelve a intentarlo.

• •Cierra las sesiones adicionales de Claude Code y reduce los subagentes en paralelo; los scripts y trabajos de CI que comparten la misma clave también cuentan.
• •Crea una clave distinta para cada persona o pipeline para que sea más fácil identificar el origen.

overloaded

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}

La solicitud y la clave están bien; simplemente el modelo está ocupado en ese momento. El pico suele ser breve y solo afecta a un modelo concreto.

• •Espera un momento y vuelve a enviar; la conversación no se perderá.
• •Ejecuta /model para cambiar a otro modelo (por ejemplo, de Opus a Sonnet) y poder terminar el trabajo primero.
• •Consulta el estado del canal en la página del modelo y, si es necesario, cambia la clave a otro canal.

Tiempo de espera agotado / Conexión interrumpida (ECONNRESET)

API Error: Connection dropped (ECONNRESET)

Este error aparece cuando no se puede acceder al endpoint de la API o el dominio es incorrecto.

• •Ejecuta /status para confirmar que el endpoint de la API es api.aicodewith.ai y no la dirección predeterminada de Anthropic.
• •Desactiva temporalmente tu proxy o VPN local y vuelve a intentarlo; las conexiones desde China pueden funcionar directamente.

Cuando la clave es incorrecta o no se puede acceder a la red, Claude Code reintenta automáticamente durante unos 3–4 minutos, y durante ese tiempo la interfaz se queda en blanco sin mostrar ningún mensaje. Si se queda bloqueado mucho tiempo, comprueba primero la clave y el endpoint.

Problemas con API de terceros (URL base, configuración no aplicada)

There's an issue with the selected model (...). It may not exist or you may not have access to it. Run --model to pick a different model.

Si ANTHROPIC_BASE_URL está configurada como https://aicodewith.ai o tiene una ruta incorrecta (como /foo), obtendrás este error. Parece un problema del modelo, pero en realidad el endpoint es incorrecto; usa https://api.aicodewith.ai en su lugar.

Las variables de entorno tienen prioridad sobre ~/.claude/settings.json: los valores antiguos exportados en tu terminal sobrescribirán el archivo de configuración. Después de cambiar cualquier configuración, cierra todas las sesiones de Claude Code (incluidos los plugins de VS Code y JetBrains) y vuelve a abrirlas. La configuración estándar es:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
  }
}

• •ANTHROPIC_BASE_URL no debe incluir /v1 ni una barra final.
• •Si la primera ejecución se queda bloqueada en la página de inicio de sesión, añade "hasCompletedOnboarding": true en ~/.claude.json.

Guía de integración de Claude CodeConfiguración de relay de Claude CodeSolución de errores de la API de Claude Haiku

FAQ