Cuando escribes código para conectar con ChatGPT, Claude o Gemini, lo más fastidioso no es la lógica, sino que de repente te suelte un error de clave API, 401 o 403. Tú lo copias y lo pegas tal cual, y aun así no lo reconoce; dan ganas de meter el teclado en una taza de té. Resumí los tropiezos que me comí en un método de verificación universal que básicamente cubre la mayoría de escenarios (muchas documentaciones de plugins también lo clasifican como “error de clave API/problema de red”).
1 Primero confirma que no estás usando la contraseña de tu cuenta de chat
La API Key no es la contraseña de inicio de sesión, ni tampoco la Session de la web. OpenAI, Anthropic y Google tienen cada uno su propia consola; la Key hay que crearla en la plataforma correspondiente. No intentes “forzarla” con una cuenta de ChatGPT Plus.
2 La Key parece igual, pero hay trampas comunes al copiar
Lo más común es que al final haya un espacio o un salto de línea, o que la pegues en una configuración que incluye comillas. Te recomiendo pegar la Key en texto plano para comparar la longitud, y luego volver a copiarla. De paso, revisa si escribiste mal el nombre de la variable de entorno (por ejemplo, a OPENAI_API_KEY le falta una letra).
3 Permisos y proyecto mal configurados
En Gemini es frecuente que la API esté habilitada, pero el proyecto no tenga facturación vinculada o no se haya activado el servicio correspondiente; en Claude también puede haber denegación de acceso por permisos de la cuenta o políticas/región. Si te da 403, no te obsesiones con “la Key está mal”: muchas veces es “no tienes permiso para usarlo”.
