Curso de Claude Code · Lección 1 de 22 · Módulo 1: Empezar
Claude Code es el asistente de programación de Anthropic: lee tu proyecto, edita archivos y ejecuta comandos mientras tú le pides cosas en lenguaje natural. Esta primera lección te deja con Claude Code instalado, verificado y con la sesión iniciada, en Windows, macOS o Linux.
Qué necesitas antes de instalar
- Una terminal abierta. Si nunca has usado una, la guía de terminal oficial explica cómo abrirla y pegar un comando.
- Un proyecto con código. Para esta lección basta una carpeta vacía.
- Una cuenta Pro, Max, Team, Enterprise o Console, o acceso a través de Amazon Bedrock, Google Cloud o Microsoft Foundry. El plan gratuito de Claude.ai no incluye acceso a Claude Code.
Los requisitos del sistema son estos:
- Sistemas operativos: macOS 13 o superior, Windows 10 versión 1809 o superior (o Windows Server 2019), Ubuntu 20.04 o superior, Debian 10 o superior y Alpine Linux 3.19 o superior.
- Hardware: 4 GB de RAM o más y procesador x64 o ARM64.
- Red y ubicación: conexión a internet y estar en un país soportado por Anthropic.
- Shell: Bash, Zsh, PowerShell o CMD.
Claude Code también existe en la aplicación de escritorio, en VS Code, en JetBrains, en la web y en Slack. En este curso usamos la terminal porque es la forma más directa de ver qué hace Claude en cada paso.
Paso 1: instalar con el instalador nativo
Es el método recomendado y se actualiza solo en segundo plano. Copia el comando de tu sistema y ejecútalo.
macOS, Linux y WSL
curl -fsSL https://claude.ai/install.sh | bash
Windows con PowerShell
irm https://claude.ai/install.ps1 | iex
Sabes que estás en PowerShell cuando el prompt empieza con PS C:\.
Windows con CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
El instalador no muestra progreso mientras descarga. Cuando termine, abre una terminal nueva antes de seguir. En Windows nativo se recomienda tener Git for Windows para que Claude use la herramienta Bash; si no está instalado, usa PowerShell. En WSL no hace falta.
Otros métodos de instalación
| Método | Comando | Se actualiza solo |
|---|---|---|
| Homebrew (macOS) | brew install --cask claude-code | No: usa brew upgrade claude-code |
| WinGet (Windows) | winget install Anthropic.ClaudeCode | No: usa winget upgrade Anthropic.ClaudeCode |
| npm (Node.js 18 o superior) | npm install -g @anthropic-ai/claude-code | No: usa npm install -g @anthropic-ai/claude-code@latest |
Con npm no uses sudo. También hay repositorios apt, dnf y apk para Debian, Fedora, RHEL y Alpine, que se explican en la guía de instalación avanzada.
Paso 2: comprueba que funciona
claude --version
Debe imprimir un número de versión seguido de (Claude Code). Para una revisión más detallada de la instalación y la configuración, ejecuta:
claude doctor
Paso 3: inicia sesión y abre tu primera sesión
Entra en la carpeta de tu proyecto y escribe claude:
cd /ruta/a/tu/proyecto
claude
La primera vez te pide iniciar sesión. Con una cuenta de suscripción o de Console, completas la autenticación en el navegador. Si tienes definida la variable ANTHROPIC_API_KEY y apruebas usarla cuando Claude Code te lo pregunta, se salta el inicio de sesión. Tus credenciales quedan guardadas y no tendrás que repetir el proceso.
Dentro de la sesión te serán útiles estos comandos:
/helpmuestra los comandos disponibles./logincambia de cuenta o vuelve a autenticar./exitsale de Claude Code (también Ctrl+D dos veces).
Ejercicio de cinco minutos
- Crea una carpeta vacía llamada
practica-claudey entra en ella desde la terminal. - Escribe
claudee inicia sesión si te lo pide. - Pregunta:
¿Qué puedes hacer en esta carpeta?. - Pregunta:
¿Cómo creo una skill personalizada en Claude Code?. - Sal con
/exit.
Resultado esperado: Claude responde las dos preguntas y la sesión se cierra sin errores. Si es así, la instalación está lista para la lección 2.
Actualizar y desinstalar
- Instalador nativo: se actualiza solo y los cambios se aplican al reiniciar Claude Code. Para forzarlo, ejecuta
claude update. - Homebrew, WinGet y npm: actualiza manualmente con los comandos de la tabla anterior.
- Desinstalar: en macOS, Linux y WSL con instalador nativo, borra
~/.local/bin/claudey~/.local/share/claude. Con Homebrew,brew uninstall --cask claude-code; con WinGet,winget uninstall Anthropic.ClaudeCode; con npm,npm uninstall -g @anthropic-ai/claude-code.
Errores comunes
- El sistema dice que
claudeno existe: la carpeta de instalación aún no está en el PATH. Abre una terminal nueva; si sigue igual, revisa la sección solución de problemas de instalación. The token '&&' is not a valid statement separator: estás en PowerShell y pegaste el comando de CMD.'irm' is not recognized: estás en CMD y pegaste el comando de PowerShell.- Error de sintaxis, 403 u otro fallo del instalador: busca el mensaje en la página oficial de solución de problemas, que lo asocia con su arreglo y con métodos de instalación alternativos.
Qué sigue
Con Claude Code funcionando, la siguiente lección te lleva a una primera sesión real: preguntar por un proyecto, pedir un cambio y escribir buenos prompts.
Preguntas frecuentes
¿Claude Code es gratis?
No. Requiere una cuenta Pro, Max, Team, Enterprise o Console, o acceso por un proveedor en la nube compatible. El plan gratuito de Claude.ai no incluye acceso.
¿Puedo usarlo en Windows sin instalar Git?
Sí. Si Git for Windows no está instalado, Claude Code usa PowerShell como herramienta de shell. Git for Windows se recomienda para poder usar la herramienta Bash.
¿Necesito saber usar la terminal?
Lo básico: abrirla y pegar comandos. La guía de terminal oficial lo explica desde cero.
Fuentes
- Quickstart de Claude Code (documentación oficial)
- Configuración avanzada e instalación (documentación oficial)
Última revisión: 12 de noviembre de 2026, con la documentación oficial de Claude Code. Los comandos proceden de esa documentación; esta lección se preparó con ayuda de IA (consulta cómo usamos la IA).
