Guías prácticas

Cómo instalar Claude Code y empezar a usarlo: guía paso a paso

Requisitos, instalación en macOS, Linux y Windows, primera sesión, planes e integración con VS Code o JetBrains: Claude Code según la documentación oficial de Anthropic.

Por Audryk · 20 octubre 2026

• Guías prácticas
• Agentes de programación
• #guías
• #Claude Code

Claude Code es el agente de programación de Anthropic: lee tu proyecto, propone cambios y ejecuta comandos desde el terminal, un IDE, la aplicación de escritorio o la web. Esta guía sigue la documentación oficial; cada comando se comprobó con ella el 20-10-2026. Para cifras de uso y planes, consulta la página de la herramienta Claude Code.

Antes de empezar

• Sistemas operativos: macOS 13.0 o posterior, Windows 10 1809 o posterior (o Windows Server 2019), Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ (Anthropic).
• Hardware: al menos 4 GB de RAM, procesador x64 o ARM64. Se necesita conexión a internet.
• Shell: Bash, Zsh, PowerShell o CMD.
• Ubicación: Claude Code solo se ofrece en los países admitidos por Anthropic.
• Cuenta: una suscripción Claude Pro, Max, Team o Enterprise, o una cuenta de Claude Console (API con créditos prepagados). El plan gratuito de claude.ai no incluye Claude Code. También se admiten Amazon Bedrock, Google Cloud y Microsoft Foundry.

Instalar Claude Code

El instalador nativo es el método recomendado por Anthropic; se actualiza solo en segundo plano.

macOS, Linux y WSL:

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

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

El instalador no muestra progreso mientras descarga. Después, abre un terminal nuevo. Existen dos alternativas, sin actualizaciones automáticas de forma predeterminada:

brew install --cask claude-code

winget install Anthropic.ClaudeCode

El cask claude-code de Homebrew sigue el canal estable (con una semana de retraso aproximadamente, y omitiendo las versiones con regresiones graves); claude-code@latest recibe todas las versiones en cuanto salen. También hay repositorios apt, dnf y apk firmados para Debian, Fedora, RHEL y Alpine.

Con npm: el paquete requiere Node.js 22 o posterior e instala el mismo binario nativo. Anthropic desaconseja sudo npm install -g (problemas de permisos y riesgos de seguridad).

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

Notas sobre Windows

Claude Code funciona de forma nativa en Windows o dentro de WSL. La instalación nativa no necesita derechos de administrador. Git for Windows es opcional: cuando está presente, Claude Code usa Git Bash para su herramienta Bash; si no, usa PowerShell. El sandboxing (ejecución aislada de comandos) solo se admite con WSL 2. En WSL, instala y lanza claude desde el terminal de Linux, no desde PowerShell.

Verificar la instalación

claude --version

El comando muestra un número de versión seguido de «(Claude Code)». Si tu shell dice que no encuentra claude, el directorio de instalación aún no está en tu PATH. Para una comprobación más completa, sin iniciar una sesión:

claude doctor

Tu primera sesión

Entra en un proyecto e inicia el agente:

cd /ruta/a/tu/proyecto
claude

En el primer uso, Claude Code abre tu navegador para iniciar sesión; después se guardan las credenciales. Si la variable de entorno ANTHROPIC_API_KEY está definida y la apruebas, se omite el paso de inicio de sesión. Con una cuenta de Console, se crea automáticamente un espacio de trabajo «Claude Code» para el seguimiento de costes.

Empieza con preguntas sencillas, por ejemplo:

what does this project do?

Después, un cambio pequeño. Claude Code muestra la edición y pide aprobación según el modo de permisos de la sesión; Shift+Tab recorre los modos.

add a hello world function to the main file

Comandos esenciales, tomados del inicio rápido de Anthropic:

• claude "tarea" inicia una sesión con un prompt inicial (p. ej. claude "fix the build error"); claude -p "consulta" responde una vez y sale;
• claude -c continúa la conversación más reciente del directorio actual; claude -r permite elegir una anterior;
• dentro de una sesión: /help lista los comandos, /resume continúa una conversación, /login cambia de cuenta, /clear borra el historial, /exit (o Ctrl+D dos veces) sale.

Coste y planes

Claude Code está incluido en los planes de pago de Claude (Anthropic, verificado el 20-10-2026):

• Pro: 17 $ al mes facturados anualmente (200 $ por adelantado), 20 $ facturados mensualmente;
• Max: desde 100 $ al mes, con 5 o 20 veces el uso de Pro;
• Team: puesto estándar a 20 $ al mes facturados anualmente (25 $ mensuales), puesto Premium a 100 $ (125 $ mensuales), para 2 a 150 personas;
• Enterprise: 20 $ por puesto y mes facturados anualmente, más el uso a tarifas de API, mínimo de 20 puestos.

Con una cuenta de Console, el uso se factura por token. Anthropic afirma que, en sus despliegues empresariales, el coste medio ronda los 13 $ por desarrollador y día activo y los 150-250 $ por desarrollador al mes, y se mantiene por debajo de 30 $ por día activo para el 90 % de los usuarios (Anthropic). El comando /usage muestra el consumo de la sesión; para los suscriptores de Pro y Max, el uso está incluido en el plan. Para comparar estos planes con otros agentes, consulta nuestra guía Elegir un agente de programación según el presupuesto.

Integrar Claude Code con tu IDE

VS Code y Cursor: la extensión oficial requiere VS Code 1.94.0 o posterior y una cuenta de pago de Claude o de Console, sin necesidad de clave de API (Anthropic). Abre la vista de extensiones (Cmd+Shift+X en Mac, Ctrl+Shift+X en Windows y Linux), busca «Claude Code» e instala. La extensión incluye su propia copia de la CLI; para ejecutar claude en el terminal integrado, instala también la CLI. Otros forks de VS Code (Devin Desktop, Kiro) usan el registro Open VSX.

JetBrains (IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand): el complemento no incluye la CLI. Instala primero la CLI, luego el complemento Claude Code desde el JetBrains Marketplace y reinicia el IDE (Anthropic). Ejecuta claude en el terminal integrado, o escribe /ide en una sesión iniciada desde un terminal externo. Cmd+Esc (Mac) o Ctrl+Esc (Windows y Linux) abre Claude Code desde el editor.

Actualizar y desinstalar

Las instalaciones nativas se actualizan solas. Para actualizar de inmediato:

claude update

Con Homebrew: brew upgrade claude-code; con WinGet: winget upgrade Anthropic.ClaudeCode. Para eliminar una instalación nativa en macOS, Linux o WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Para ir más lejos

• Conecta Claude Code con tus herramientas: Cómo configurar un servidor MCP.
• Compara: Claude Code, Codex o GitHub Copilot, Claude Code frente a Codex, alternativas a Claude Code.
• Vocabulario: agente de programación y ventana de contexto en el glosario.

Fuentes

• Claude Code Docs: Advanced setup, verificado el 20-10-2026
• Claude Code Docs: Quickstart, verificado el 20-10-2026
• Claude Code Docs: Manage costs effectively, verificado el 20-10-2026
• Claude Code Docs: Use Claude Code in VS Code, verificado el 20-10-2026
• Claude Code Docs: JetBrains IDEs, verificado el 20-10-2026
• Anthropic: Claude pricing, verificado el 20-10-2026

Conclusión: Claude Code se instala con un solo comando en macOS, Linux y Windows, pero requiere un plan de pago de Claude o una cuenta de Console; la extensión de VS Code incluye la CLI, el complemento de JetBrains no.

¿Ha detectado un error en este artículo? Comuníquenoslo · Nuestra política de correcciones