Tutorial de la Serie Claude Code 6: Cómo Autenticar - Inicio de sesión en el navegador y configuración manual de la clave API

Proceso de autenticación: Inicio de sesión en el navegador y configuración manual de la clave API

Después de instalar Claude Code, necesitas autenticarte para poder usarlo. Debes vincular la herramienta con tu cuenta de Anthropic. Hay dos formas de hacerlo: inicio de sesión en el navegador y configuración manual de la clave API. Ambas formas tienen el mismo resultado final; elige la que te resulte más conveniente.

Forma 1: Inicio de sesión en el navegador (recomendado)

Claude Code proporciona un comando de autenticación automática claude login, que abre el navegador, te permite autorizar en la página web y luego escribe automáticamente las credenciales en la terminal.

Pasos:

En la terminal, escribe:

bash claude login

El sistema mostrará un mensaje y abrirá automáticamente la página de autorización de Anthropic en tu navegador predeterminado.
Si no se abre automáticamente, la terminal imprimirá un enlace que puedes copiar manualmente y abrir en el navegador.
Inicia sesión en tu cuenta de Anthropic en el navegador (si ya has iniciado sesión, la página solicitará autorización directamente).
Haz clic en "Permitir" o "Autorizar"; la página del navegador mostrará "Autorización exitosa, puedes cerrar esta página".
Vuelve a la terminal y verás un mensaje de autenticación completada. En este punto, al ejecutar el comando claude, ya estará vinculado a tu cuenta.

Forma 2: Configuración manual de la clave API

Si estás utilizando un servidor sin interfaz gráfica, un contenedor, o no quieres pasar por la autorización del navegador, puedes obtener una clave API directamente desde la consola de Anthropic y configurarla en Claude Code.

Pasos:

Abre el navegador, ve a https://console.anthropic.com e inicia sesión en tu cuenta de Anthropic.
Ve a la página de API Keys (generalmente en Configuración u Opciones de desarrollador) y haz clic en "Crear clave API".
Asigna un nombre a la clave (por ejemplo, claude-code-local). Después de generarla, cópiala inmediatamente.
Nota: Esta clave solo se muestra una vez; si cierras la página, no podrás verla de nuevo. Si olvidas guardarla, elimina la antigua y genera una nueva.
Vuelve a la terminal. Hay dos formas de proporcionar la clave a Claude Code:

A. Mediante variable de entorno:

bash export ANTHROPIC_API_KEY=tu-api-key

Agrega esta línea a tu ~/.bashrc o ~/.zshrc para que se aplique automáticamente cada vez.

B. Escribiendo la configuración en un archivo:

Claude Code también lee su propio archivo de configuración. Edita manualmente ~/.claude/config.json (si no existe, créalo) y escribe:

json { "apiKey": "tu-api-key" }

Nota: Se recomienda establecer los permisos de este archivo en 600 (chmod 600 ~/.claude/config.json) para evitar que otros usuarios lo lean.

Prueba la conexión:

bash claude "Hola, responde con 'OK'"

Si recibes una respuesta normal, significa que la clave está configurada correctamente.

Errores comunes en la configuración manual:

¿La clave no debe comenzar con sk-ant- o sk-? No, la clave API de Anthropic sí comienza con sk-ant-api03- y es una cadena larga. Al copiar, no omitas caracteres.
Si configuras tanto la variable de entorno como el archivo, la variable de entorno tiene mayor prioridad. Mantén solo una para evitar confusiones.
La clave es un credencial de pago; no la subas a repositorios Git. Se recomienda usar .gitignore para ignorar todo el directorio ~/.claude o el archivo de configuración.

Cambiar de cuenta o cerrar sesión

Si deseas cambiar de cuenta o limpiar las credenciales locales:

Si usaste claude login: ejecuta claude logout y luego vuelve a ejecutar claude login.
Si configuraste manualmente la clave: elimina la clave antigua de la variable de entorno o del archivo de configuración y reemplázala con la nueva.

Verificar que la autenticación funciona

claude "Explica para qué sirve el directorio actual"

Si puede leer el resumen de tu proyecto, significa que el entorno está listo.