Introducción
Claude Code es una herramienta de interfaz de línea de comandos (CLI) desarrollada por Anthropic que te permite interactuar directamente con Claude dentro de tu terminal. En lugar de abrir un navegador, chatear con la IA y luego copiar manualmente el código de vuelta — Claude Code permite que Claude trabaje directamente dentro del directorio de tu proyecto: leyendo archivos, escribiendo código, ejecutando comandos y explicando errores, todo en un flujo continuo.
Esta lección se enfoca en tres tareas específicas: instalar Claude Code, adjuntar una clave API y escribir tu primer comando para confirmar que todo funciona correctamente.
Requisitos previos
Claude Code se ejecuta sobre Node.js, por lo que tu máquina necesita la versión 18 o superior de Node.js. Verifícalo con el comando:
Si no lo tienes o tu versión es inferior a la 18, descarga Node.js en nodejs.org (elige la versión LTS). También necesitarás una cuenta de Anthropic y una clave API — regístrate en console.anthropic.com si aún no tienes una. Las claves API comienzan con sk-ant-...; mantén esta clave en secreto y nunca la subas a git.
Instalación de Claude Code
Claude Code se distribuye a través de npm. Ejecuta el siguiente comando para instalarlo de forma global:
Después de la instalación, verifica con:
La terminal mostrará el número de versión actual, por ejemplo 1.x.x. Si obtienes un error de permisos al instalar globalmente en macOS/Linux, usa nvm para gestionar Node en lugar de instalar Node directamente — esto evita la mayoría de los errores relacionados con permisos.
Configuración de la clave API
Claude Code necesita una clave API para autenticarse con Anthropic. La forma más sencilla es configurar la variable de entorno ANTHROPIC_API_KEY antes de ejecutarlo:
Esto es temporal — necesitarás configurarla nuevamente cada vez que abras una nueva terminal. Para guardarla de forma permanente, añade la línea anterior al archivo de configuración de tu shell:
Si usas bash en lugar de zsh, cambia ~/.zshrc por ~/.bashrc. En Windows con PowerShell, usa el comando:
Además, Claude Code admite un archivo .env.local en el directorio de tu proyecto — útil cuando quieres usar claves diferentes para proyectos distintos.
Ejecución de tu primer comando
Navega a cualquier directorio de proyecto (o crea uno nuevo), luego inicia Claude Code:
En la primera ejecución, Claude Code te pedirá que aceptes algunos términos de uso. Luego verás el prompt de comandos de Claude. Prueba escribiendo tu primer mensaje:
Claude creará un archivo hello.py con el contenido adecuado directamente en el directorio actual, tras lo cual puedes probarlo:
Si aparece la línea Hello, Claude Code!, todo está funcionando correctamente.
Errores comunes
El error más común al comenzar es un error de autenticación o una clave API inválida. Esto suele deberse a que la clave se copió con caracteres de más o de menos, o a que la variable de entorno no se ha cargado. Ejecuta el siguiente comando para comprobar si la clave se ha reconocido:
Si la terminal no imprime nada, la variable no se ha configurado en la sesión actual — vuelve a ejecutar el comando export o haz source del archivo de configuración de tu shell.
El segundo error común es command not found: claude tras instalar con npm. Esto ocurre porque el directorio bin global de npm no está en tu PATH. Verifica con:
Copia la ruta mostrada y añádela al PATH en el archivo de configuración de tu shell.
Resumen
Tras esta lección, tienes Claude Code ejecutándose en tu máquina con la clave API correctamente configurada. El proceso consta de tres pasos fundamentales: instalar mediante npm, configurar la variable de entorno ANTHROPIC_API_KEY y luego ejecutar claude dentro del directorio de tu proyecto. A partir de aquí, las lecciones siguientes profundizarán en las funciones prácticas de Claude Code en proyectos reales.
Punto de control de la lección