Resumen rápido: Claude Code CLI se instala mediante un único comando que descarga y configura la herramienta automáticamente. En macOS y Linux, utiliza el script de shell oficial de la documentación de Anthropic, mientras que los usuarios de Windows ejecutan comandos de PowerShell o WSL. Después de la instalación, autentícate con tu clave API para empezar a usar el asistente de codificación de IA de Claude en tu terminal.
Claude Code es una herramienta de codificación agentiva que reside en tu terminal y comprende toda tu base de código. Según la documentación oficial de Claude Code, puede leer archivos, ejecutar comandos, editar código e integrarse con herramientas de desarrollo a través de conversaciones en lenguaje natural.
Pero empezar requiere una instalación adecuada. Aquí tienes todo lo necesario para instalar Claude Code CLI y configurarlo correctamente.
Requisitos del sistema antes de la instalación
Antes de instalar Claude Code, verifica que el sistema cumple los requisitos básicos. Según la documentación oficial de configuración avanzada, elimina esta frase por completo.
Comprueba la instalación de Node.js abriendo una terminal y ejecutando:
| node –version |
Si Node.js no está instalado o la versión es inferior a 18, descárgalo del sitio web oficial de Node.js. La versión de Soporte a Largo Plazo (LTS) funciona perfectamente para Claude Code.
Además de Node.js, el sistema necesita requisitos básicos: macOS 13.0 o superior para usuarios de Mac, Windows 10 o superior para sistemas Windows y la mayoría de las distribuciones Linux modernas funcionan sin problemas. También se requiere una cuenta de Claude de Anthropic para la autenticación después de la instalación.
Instalación de Claude Code en macOS y Linux
El proceso de instalación para macOS y Linux utiliza un único comando de shell que lo maneja todo automáticamente. Este método está documentado en la guía de inicio rápido oficial de Claude Code.
Abre Terminal y ejecuta el script de instalación:
| curl -fsSL claude.ai/install.sh | bash |
El script descarga el binario de Claude Code, lo coloca en el directorio correcto y configura automáticamente la variable PATH. Todo el proceso suele completarse en menos de un minuto.
Para usuarios de macOS que prefieren Homebrew, existe un método de instalación alternativo, aunque no está documentado oficialmente en las fuentes principales. El método curl sigue siendo el enfoque recomendado según la documentación oficial.
Verificación de la instalación
Una vez completada la instalación, verifica que Claude Code sea accesible:
| claude –version |
Este comando debería mostrar el número de versión instalado. Si aparece un error indicando "command not found", la configuración de PATH necesita ajustarse.
Según la documentación oficial de solución de problemas, los problemas de PATH son el problema de instalación más común. La solución implica añadir el directorio de instalación de Claude al archivo de configuración del shell.
Instalación de Claude Code en macOS y Linux
El proceso de instalación para macOS y Linux se basa en npm (Node Package Manager). Según la documentación oficial, debes tener Node.js 18+ instalado en tu sistema antes de continuar. A diferencia de las herramientas CLI tradicionales que utilizan scripts de shell, Claude Code se instala globalmente a través de tu terminal para garantizar que todas las dependencias se manejen correctamente.
Abre tu Terminal y ejecuta el siguiente comando para instalar el paquete:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Nota: La variable de entorno CLAUDE_CODE_RELEASE_ALPHA=1 es necesaria actualmente durante la fase beta/alfa pública para reconocer el estado de vista previa de la herramienta.
Este comando descarga el paquete del registro npm oficial y vincula el ejecutable de claude al directorio global de binarios de tu sistema. Aunque algunos usuarios pueden intentar encontrar fórmulas de Homebrew, el método npm es la única ruta de instalación oficialmente admitida y documentada.
Verificación de la instalación
Una vez completada la instalación, verifica que la CLI esté correctamente mapeada a tu entorno ejecutando:
| claude –version |
Este comando debería mostrar el número de versión actual (por ejemplo, 0.2.9). Si encuentras un error de "command not found", generalmente significa que tu directorio npm global no está en la variable PATH de tu sistema.
Según la documentación oficial de solución de problemas, puedes solucionarlo identificando tu prefijo npm con npm config get prefix y asegurándote de que la carpeta /bin resultante se añada a tu archivo .zshrc o .bashrc.
Instalación de Claude Code en Windows
La instalación en Windows ofrece dos enfoques principales: instalación nativa con PowerShell o uso de Windows Subsystem for Linux (WSL). La documentación oficial recomienda PowerShell para la mayoría de los usuarios.
Método de instalación con PowerShell
Abre PowerShell como Administrador (haz clic derecho en el menú Inicio y selecciona "Windows PowerShell (Admin)"). Ejecuta este comando:
| irm claude.ai/install.ps1 | iex |
El script de PowerShell se encarga de la descarga, instalación y configuración de PATH automáticamente. Después de completarse, cierra y vuelve a abrir PowerShell para asegurar que las actualizaciones de PATH surtan efecto.
Método de instalación con WSL
Los desarrolladores que ya utilizan WSL pueden instalar Claude Code utilizando el método para Linux. Abre la terminal WSL y ejecuta el mismo comando curl que se utiliza para Linux:
| curl -fsSL claude.ai/install.sh | bash |
El enfoque WSL funciona de manera idéntica a las instalaciones nativas de Linux. Una ventaja: WSL proporciona un entorno más similar a Unix que coincide con las configuraciones de servidores de producción.
Según la documentación oficial de solución de problemas, los usuarios de WSL ocasionalmente experimentan problemas de conectividad de red. Si la instalación se detiene, verifica que WSL pueda acceder a redes externas y que las reglas de firewall no estén bloqueando el tráfico.
Encuentra créditos de Claude y herramientas de IA en un solo lugar
Instalar Claude Code CLI es un paso. Pagar por herramientas de IA a largo plazo es otro. Get AI Perks recopila créditos para startups y descuentos en software para herramientas de IA y nube en un solo lugar. Ofrece a los fundadores acceso a más de 200 ventajas, incluidas ofertas de Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom y otros. La plataforma también muestra las condiciones de las ventajas y guías para reclamar cada oferta.
¿Buscas créditos de Claude o Anthropic?
Consulta Get AI Perks para:
- encontrar créditos y descuentos para herramientas de IA en un solo lugar
- revisar las condiciones de las ventajas antes de solicitar
- acceder a guías para reclamar ofertas para startups
👉 Visita Get AI Perks para explorar las ventajas disponibles de Claude, Anthropic y otros softwares de IA.
Autenticación y configuración inicial
Después de la instalación, Claude Code requiere autenticación antes de poder funcionar. La herramienta utiliza claves API de Anthropic para verificar el acceso.
Inicia el proceso de autenticación ejecutando:
| claude |
La primera vez que se ejecuta este comando, Claude Code solicita la autenticación. Según la guía de inicio rápido oficial, esto abre una ventana del navegador para iniciar sesión en la cuenta de Anthropic.
Después de iniciar sesión a través del navegador, la CLI recibe automáticamente un token de autenticación. Este token se almacena localmente y persiste entre sesiones, por lo que no es necesaria una autenticación repetida.
Configuración de ajustes a nivel de proyecto
Claude Code admite la configuración en varios niveles según la documentación oficial de configuración. Los niveles de configuración más comunes son:
| Ámbito | Ubicación | Caso de uso |
|---|---|---|
| Usuario | Directorio ~/.claude/ | Preferencias personales en todos los proyectos |
| Proyecto | .claude/ en el repositorio | Configuración de equipo compartida |
| Local | .claude/settings.local.json | Anulaciones específicas de la máquina |
Para la configuración inicial, la configuración a nivel de usuario es suficiente. Los ajustes a nivel de proyecto se vuelven importantes al trabajar con equipos que comparten estándares de codificación.
Inicio de tu primera sesión de Claude Code
Una vez completada la instalación y la autenticación, inicia Claude Code ejecutando el comando sin argumentos:
| claude |
Esto inicia el modo interactivo donde Claude responde a solicitudes en lenguaje natural. La documentación oficial describe el modo interactivo como la forma principal de utilizar Claude Code para tareas de desarrollo.
Intenta un comando de prueba simple:
| Muéstrame la estructura de este proyecto |
Claude Code analiza el directorio actual y proporciona una descripción general de la estructura de la base de código. Esto demuestra que la instalación está funcionando correctamente y Claude tiene acceso para leer archivos.
Comandos esenciales para el uso diario
Más allá del modo interactivo, Claude Code admite varios patrones de comandos documentados en la referencia de la CLI:
| Patrón de comando | Propósito | Ejemplo |
|---|---|---|
| claude | Iniciar sesión interactiva | claude |
| claude “tarea” | Ejecutar tarea única | claude “soluciona los errores de linting” |
| claude -p “consulta” | Consulta rápida sin sesión | claude -p “¿qué hace esta función?” |
El patrón de tarea única es particularmente útil para pipelines de CI/CD y scripts de automatización donde una sesión interactiva no es apropiada.
Solución de problemas comunes de instalación
Incluso con scripts de instalación automatizados, ocasionalmente surgen problemas. La documentación oficial de solución de problemas cubre los problemas más frecuentes.
Errores de "Comando no encontrado"
Si la terminal muestra "command not found: claude" después de la instalación, la configuración de PATH no se completó correctamente. Para macOS y Linux, añade manualmente la ubicación del binario de Claude al archivo de configuración del shell.
Para usuarios de bash, edita ~/.bashrc o ~/.bash_profile y añade:
| export PATH=”$HOME/.local/bin:$PATH” |
Para usuarios de zsh (predeterminado en macOS moderno), edita ~/.zshrc con la misma línea. Después de guardar, recarga la configuración con source ~/.zshrc o abre una nueva ventana de terminal.
Problemas de red y firewall
Las redes corporativas y los firewalls restrictivos a veces bloquean el script de instalación. Según la documentación de solución de problemas, si la instalación se detiene o devuelve HTML en lugar de ejecutarse, es posible que el acceso a la red a los servidores de Anthropic esté bloqueado.
La solución alternativa implica descargar el script de instalación por separado:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Este enfoque proporciona más visibilidad sobre lo que falla si ocurren errores durante la descarga o ejecución.
Problemas específicos de WSL
Los usuarios de Windows que ejecutan WSL a veces experimentan problemas de conectividad entre el subsistema de Linux y Windows. La documentación oficial menciona que es posible que sea necesario ajustar las reglas del firewall para permitir el tráfico de WSL.
Si Claude Code se instala correctamente pero no puede acceder a los servidores de Anthropic para la autenticación, verifica que el firewall de Windows permita el acceso a la red de WSL. La guía de solución de problemas proporciona comandos específicos de PowerShell para configurar las reglas del firewall.
Actualización de Claude Code
Claude Code recibe actualizaciones periódicas con nuevas funciones y mejoras. Según la documentación oficial, las actualizaciones se instalan utilizando el mismo comando que la instalación inicial.
Ejecuta de nuevo el script de instalación:
| curl -fsSL code.anthropic.com/install.sh | sh |
El script detecta la instalación existente y la actualiza a la última versión. No se pierde ninguna configuración ni autenticación durante el proceso de actualización.
Comprueba la versión actual antes y después de actualizar:
| claude –version |
El registro de cambios en la documentación oficial de Claude Code enumera todos los cambios entre versiones, lo que ayuda a determinar si una actualización introduce funciones relevantes para flujos de trabajo específicos.
Próximos pasos después de la instalación
Con Claude Code instalado y funcionando, la exploración de funciones avanzadas se vuelve posible. La documentación oficial describe varias áreas que vale la pena investigar:
- Habilidades y personalización: Según la documentación oficial sobre habilidades, Claude Code admite habilidades personalizadas definidas en archivos Markdown dentro del directorio .claude/skills/. Estas habilidades amplían las capacidades de Claude con comandos y flujos de trabajo específicos del proyecto.
- Protocolo de Contexto de Modelo (MCP): La integración con MCP permite a Claude Code conectarse con herramientas y servicios externos. Esto convierte a Claude en un centro que puede acceder a bases de datos, APIs y otros recursos de desarrollo.
- Colaboración en equipo: Los archivos de configuración a nivel de proyecto en el directorio .claude/ se pueden confirmar en el control de versiones, compartiendo la configuración de Claude Code entre equipos de desarrollo completos.
- La documentación oficial proporciona guías detalladas para cada una de estas áreas, basándose en la instalación básica descrita aquí.
Preguntas frecuentes
¿Necesito una suscripción de pago a Claude para usar Claude Code CLI?
Claude Code requiere una cuenta de Claude de Anthropic, pero el nivel de suscripción específico necesario depende del uso. Según la documentación oficial, es necesaria la autenticación, pero los detalles de precios deben verificarse en el sitio web oficial de Anthropic, ya que los planes cambian con el tiempo.
¿Puedo instalar Claude Code sin privilegios de administrador?
En macOS y Linux, Claude Code se instala en el directorio de inicio del usuario de forma predeterminada y no requiere acceso de administrador. Los usuarios de Windows pueden necesitar privilegios de administrador para el método de instalación de PowerShell, aunque las instalaciones de WSL no requieren acceso de administrador.
¿Funciona Claude Code sin conexión?
No. Claude Code es una herramienta impulsada por IA que se comunica con los servidores de Anthropic para procesar solicitudes. Según la documentación oficial, se requiere una conexión a Internet activa para que Claude analice el código y genere respuestas.
¿Cómo desinstalo Claude Code?
La documentación oficial de configuración avanzada explica que la desinstalación implica eliminar el binario y los archivos de configuración. En macOS y Linux, elimina el directorio ~/.claude y elimina la modificación de PATH de los archivos de configuración del shell. Los usuarios de Windows deben eliminar el directorio de instalación y borrar la variable de entorno PATH.
¿Puede Claude Code acceder a todo mi sistema de archivos?
Por defecto, Claude Code opera dentro del directorio de trabajo actual y sus subdirectorios. Según la documentación oficial de permisos, el acceso se puede restringir aún más utilizando ajustes de sandbox en los archivos de configuración. Claude siempre pide confirmación antes de ejecutar operaciones potencialmente destructivas.
¿Cuál es la diferencia entre Claude Code CLI y Claude Desktop?
Claude Code CLI se ejecuta en la terminal y se centra en flujos de trabajo de desarrollo con acceso directo al sistema de archivos y ejecución de comandos. Claude Desktop es una aplicación independiente con una interfaz gráfica. Ambas herramientas sirven para diferentes casos de uso, con la CLI optimizada para desarrolladores que prefieren flujos de trabajo basados en terminal.
¿Con qué frecuencia debo actualizar Claude Code?
Las actualizaciones se pueden instalar cuando sea conveniente. El registro de cambios oficial documenta nuevas funciones y correcciones de errores. Para los equipos, coordinar las actualizaciones garantiza que todos utilicen versiones compatibles, aunque Claude Code mantiene la retrocompatibilidad con los archivos de configuración entre versiones.
Conclusión
Instalar Claude Code CLI lleva solo unos minutos independientemente del sistema operativo. Los scripts de instalación automatizados se encargan de la configuración, la configuración de PATH y la ubicación de los binarios sin intervención manual.
Después de la instalación y autenticación, Claude Code se convierte en un potente asistente de codificación con IA accesible desde cualquier terminal. Los comandos en lenguaje natural permiten a los desarrolladores escribir código, corregir errores y automatizar tareas sin salir de la línea de comandos.
¿Listo para experimentar el desarrollo asistido por IA? Ejecuta el comando de instalación para tu plataforma y comienza tu primera sesión de Claude Code hoy mismo. La documentación oficial en code.claude.com proporciona guías completas para funciones avanzadas una vez que la configuración básica esté completa.
