Instala Claude Code en tu computadora

Claude Code es un asistente de programación que vive en tu terminal. A diferencia de un chat en el navegador, trabaja directamente sobre los archivos de tu proyecto: los lee, propone cambios, los aplica si se lo permites y ejecuta comandos como npm test o git status. Tú sigues siendo quien decide qué entra al repositorio.

Aquí preparas tu computadora para las 18 lecciones del curso. Cuando cierres esta página sabrás cómo:

• revisar si tu equipo cumple los requisitos;
• instalar Claude Code con el método adecuado para tu sistema;
• iniciar sesión con tu cuenta;
• diagnosticar problemas con claude doctor y mantener la herramienta actualizada.

Antes de instalar: requisitos

Claude Code funciona en las tres plataformas principales. Según la documentación oficial, necesitas:

En hardware piden al menos 4 GB de RAM y un procesador x64 o ARM64. También necesitas conexión a internet, porque el modelo corre en los servidores de Anthropic, no en tu computadora.

Además, ten a mano:

• Git, porque vas a versionar el proyecto del curso y Claude Code lo usa con frecuencia.
• Node.js 22 o posterior, no para Claude Code en sí, sino para el proyecto lupita-api que construiremos.
• Una cuenta con acceso a Claude Code: un plan de suscripción de Claude (Pro, Max, Team o Enterprise) o una cuenta de Claude Console con créditos. Hablamos de cuál conviene en la lección 1.3.

Instalación con el instalador nativo

El método recomendado es el instalador nativo. Descarga un binario y lo deja listo en tu ruta de comandos. Una ventaja práctica: las instalaciones nativas se actualizan solas en segundo plano.

macOS, Linux y WSL

Abre la aplicación Terminal (o la consola de tu distribución). Vamos a hacerlo en dos pasos: primero bajas el script de instalación a un archivo y luego lo ejecutas. Entre un paso y otro puedes abrir instalar-claude.sh con cualquier editor y leerlo, una buena costumbre con cualquier script que bajes de internet:

curl -fsSL https://claude.ai/install.sh -o instalar-claude.sh
bash instalar-claude.sh

La guía oficial hace lo mismo en una sola línea, pasando la descarga directamente a bash con una tubería. El resultado es idéntico. El script detecta tu sistema, baja el binario correcto y te avisa cuando termina.

Windows con PowerShell

Busca "PowerShell" en el menú Inicio y ábrelo como usuario normal, sin permisos de administrador. Esta línea descarga el script de instalación y lo ejecuta en la misma ventana:

irm https://claude.ai/install.ps1 | iex

Windows con el símbolo del sistema

Si en tu empresa solo puedes usar la consola clásica (CMD), la página oficial de instalación tiene una variante propia que baja un archivo install.cmd, lo ejecuta y lo borra. Como PowerShell viene incluido en todas las versiones de Windows compatibles, en este curso usamos esa opción.

Un error frecuente en Windows es pegar el comando en la consola equivocada. Si ves un mensaje sobre que && no es un separador válido, estás en PowerShell y pegaste la variante de CMD. Si ves que irm no se reconoce, estás en CMD y pegaste el de PowerShell. La pista está en el prompt: PowerShell muestra PS C:\ al inicio y CMD no.

Windows nativo o WSL

En Windows tienes dos caminos:

• Directo en Windows: Claude Code queda instalado junto a tus programas de siempre y abre carpetas como C:\Users\Ana\lupita-api. Te conviene tener Git for Windows: trae Git Bash, que Claude Code aprovecha para correr comandos. Sin él, los comandos se lanzan con PowerShell, que también funciona.
• Dentro de WSL: entras a tu Ubuntu (u otra distribución) y repites ahí el comando de Linux. Claude Code vive en ese Linux y Git for Windows no hace falta.

Si tus proyectos ya viven en WSL, quédate en WSL. Si trabajas con herramientas de Windows, la instalación nativa es más directa.

Otras formas de instalar

Si administras tus programas con un gestor de paquetes, también puedes usarlo. La diferencia importante es que estas instalaciones no se actualizan solas: tú decides cuándo actualizar.

Homebrew, si en tu Mac o Linux ya instalas todo con brew. La segunda línea es la que tendrás que recordar cada cierto tiempo:

brew install --cask claude-code
brew upgrade claude-code

El cask claude-code sigue el canal estable, que suele ir alrededor de una semana detrás de la última versión. Existe también claude-code@latest si quieres cada versión en cuanto sale.

WinGet, el gestor incluido en las versiones recientes de Windows. Igual que con Homebrew, la actualización corre por tu cuenta:

winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode

npm, para quien ya tiene Node.js 22 o posterior y quiere todo en un mismo gestor. Un dato curioso: el paquete solo trae el mismo binario nativo, así que Node no participa cuando Claude Code está corriendo. Nunca lo instales con sudo, porque deja problemas de permisos; y para actualizarlo, repite la orden agregando @latest al final del nombre del paquete:

npm install -g @anthropic-ai/claude-code

También hay repositorios oficiales para apt, dnf y apk si trabajas en servidores Debian, Fedora, RHEL o Alpine. En Alpine, además, hay que instalar algunos paquetes extra; la guía de instalación oficial los lista.

Verifica la instalación

Cierra la terminal, abre una nueva y escribe:

claude --version

Debe aparecer un número de versión seguido de (Claude Code). Si la terminal responde que claude no existe, casi siempre es porque la carpeta de instalación todavía no está en tu PATH. Abrir una terminal nueva lo resuelve en la mayoría de los casos; si no, la página de solución de problemas de la documentación explica cómo agregarla.

Para un diagnóstico completo, usa:

claude doctor

Este comando no inicia una sesión. Revisa la salud de la instalación, valida tus archivos de configuración y muestra advertencias con sugerencias para corregirlas. También te dice si las actualizaciones automáticas están activas y cuál fue el resultado del último intento. Conviene correrlo cada vez que algo se comporte raro.

Inicia sesión

Entra a cualquier carpeta y ejecuta:

claude

La primera vez, Claude Code te pide iniciar sesión y abre el navegador para que autorices el acceso. Puedes entrar con:

• una suscripción de Claude (Pro, Max, Team o Enterprise);
• una cuenta de Claude Console, que funciona con créditos prepagados de la API;
• un proveedor de nube empresarial, como Amazon Bedrock, si tu empresa lo usa.

Tus credenciales quedan guardadas, así que no tendrás que repetir este paso. Si después quieres cambiar de cuenta, dentro de la sesión escribe /login; para cerrar sesión, /logout.

Un detalle útil: si tienes definida la variable de entorno ANTHROPIC_API_KEY, Claude Code te pregunta una vez si quieres usar esa clave en lugar de abrir el navegador. Si no quieres pagar por API sin darte cuenta, revisa que esa variable no esté definida cuando tu intención sea usar tu suscripción.

Mantén Claude Code al día

Claude Code cambia rápido: aparecen comandos nuevos y se corrigen errores cada semana. Con el instalador nativo no tienes que hacer nada, porque busca actualizaciones al arrancar y mientras trabajas, y las aplica la siguiente vez que lo abres. Si quieres forzar la actualización en este momento:

claude update

Si trabajas en una empresa que necesita controlar versiones, puedes elegir el canal estable con el ajuste autoUpdatesChannel o desactivar las actualizaciones automáticas. Lo verás con más calma cuando hablemos de archivos de configuración.

Práctica

Prepara tu computadora para el proyecto Abarrotes Lupita, que usarás en todo el curso:

1. Comprueba tus herramientas base y anota las versiones:

   git --version
   node --version
   

   Si Node.js es menor que 22, actualízalo antes de seguir.
2. Instala Claude Code con el método que corresponde a tu sistema y abre una terminal nueva.
3. Ejecuta claude --version y claude doctor. Guarda la salida de claude doctor en un archivo de texto llamado diagnostico-inicial.txt.
4. Crea la carpeta del proyecto e inicia Git:

   mkdir lupita-api
   cd lupita-api
   git init
   

5. Dentro de lupita-api, ejecuta claude, inicia sesión y escribe esta primera pregunta: ¿En qué carpeta estás trabajando y qué archivos ves?. Debe responder que la carpeta está vacía o casi vacía.
6. Sal de la sesión con /exit.

Si algo falla, compara tu error con la salida de claude doctor antes de buscar en internet. En la siguiente lección usarás esta carpeta para crear la primera versión de la API.

Quiz

Resumen

• Claude Code trabaja en tu terminal sobre los archivos reales del proyecto y te pide permiso según el modo que elijas.
• El instalador nativo es el método recomendado y se actualiza solo; Homebrew, WinGet y npm requieren actualizar a mano.
• En Windows puedes instalar de forma nativa (mejor con Git for Windows) o dentro de WSL.
• claude --version confirma la instalación y claude doctor diagnostica problemas.
• Inicias sesión la primera vez que ejecutas claude; /login cambia de cuenta.