Titikey
InicioConsejos prácticosLista de verificación para diagnosticar errores de las APIs de ChatGPT, Claude y Gemini: API key inválida

Lista de verificación para diagnosticar errores de las APIs de ChatGPT, Claude y Gemini: API key inválida

2/2/2026
实用技巧

Lo que más te sube la presión no es que el modelo no sepa escribir, sino que justo cuando estás por ponerte a trabajar, la consola te suelta un API key invalid, 401 o network error. Donde más me he estrellado yo es en esto: la Key no tiene problema; el problema está en la “configuración alrededor”. Esta lista está ordenada según el orden en que uso normalmente ChatGPT, Claude y Gemini.

Primero confirma que estás usando la Key correcta y el proyecto correcto

Mucha gente copia una Key antigua, una Key de prueba, o cambia de proyecto en la consola y ni se da cuenta. Te recomiendo crear una Key nueva directamente en el panel del proveedor y reemplazarla de inmediato; no te enredes peleando con el entorno viejo.

Sin permisos y sin facturación, es como no tener Key

Un 401/403 no necesariamente significa que la Key esté mal; lo más común es no tener la facturación habilitada, tener un alcance de permisos insuficiente o restricciones por organización/proyecto. En Claude y Gemini, ese tipo de “parece que funciona”, pero en cuanto llamas a la API da error, es especialmente común; no me preguntes cómo lo sé.

Las variables de entorno y los espacios son asesinos ocultos

Un espacio de más en el .env, un salto de línea sin manejar, o que la plataforma de despliegue no inyecte variables, todo puede convertirse en “Key inválida”. Imprimir la longitud de la Key y hacer trim al inicio y al final sirve más que quedarte mirando el error media hora.

Los problemas de conexión de red son más frecuentes de lo que crees

Si te encuentras con timeouts, fallos de DNS o 502 esporádicos, sospecha primero de la red/la ruta del proxy. En la documentación de algunos plugins incluso separan aparte la “resolución de problemas de conexión de red”; no es por ponerse quisquillosos.

No pases por alto los falsos errores causados por dependencias y versiones

En proyectos Node, cuando aparecen problemas de dependencias como ETARGET, ERESOLVE o ENOTEMPTY, puede que la aplicación ni siquiera esté arrancando y tú creas que se cayó la API. Primero deja las dependencias bien instaladas y estables, y luego prueba el endpoint.

Mi orden habitual de autochequeo rápido

  • Cambiar a una Key nueva y probar de inmediato
  • Confirmar el estado de proyecto/organización/permisos y facturación
  • Revisar si las variables de entorno están inyectadas y si hay espacios o saltos de línea
  • Reprobar con red directa o con un proxy más limpio
  • Descartar errores de instalación de dependencias y de runtime

Si además quieres conectar Claude a más herramientas (por ejemplo, usando MCP para “integrar un asistente” rápidamente con APIs existentes), te sugiero pulir primero estas tres cosas: cuenta, Key y red. Si quieres ahorrar tiempo y evitar tropiezos, puedes pasarte por Titikey a ver la lista de herramientas y experiencias reales que compilé; básicamente son de las que “puedes copiar y pegar tal cual”.

InicioTiendaPedidos