Resumen rápido: Claude Code se puede instalar a través de instaladores nativos en macOS, Windows y Linux desde el sitio web oficial de Claude Code. Los usuarios de Windows deben instalar WSL2 primero antes de ejecutar Claude Code. Después de la instalación, autentíquese con su cuenta de Claude cuando Claude Code abra una ventana del navegador para que inicie sesión en el primer lanzamiento y comience a codificar con asistencia de IA directamente desde su terminal o aplicación de escritorio.
Claude Code representa el impulso de Anthropic en herramientas de desarrollo de IA agentiva. Este asistente de línea de comandos lee bases de código, edita archivos, ejecuta comandos y se integra con flujos de trabajo de desarrollo.
Pero instalarlo no siempre es sencillo. Las diferentes plataformas requieren diferentes enfoques. Windows necesita una configuración adicional. Y la documentación, aunque completa, puede abrumar a los recién llegados.
Esta guía elimina la complejidad. Cubre los requisitos del sistema, los pasos de instalación específicos de la plataforma, la autenticación y la verificación, todo lo necesario para que Claude Code funcione correctamente.
Requisitos del sistema antes de la instalación
Según la documentación oficial de Claude Code, la herramienta es compatible con macOS, Windows y Linux. Sin embargo, cada plataforma tiene requisitos previos específicos.
Para macOS, los requisitos son mínimos. El sistema necesita macOS 13.0 o posterior. Los chips Intel y Apple Silicon funcionan bien.
Windows presenta más complejidad. El sistema operativo debe ser Windows 10 Build 19041 o posterior, o Windows 11. Pero aquí está el truco: Claude Code no se ejecuta de forma nativa en Windows.
El Subsistema de Windows para Linux 2 (WSL2) es obligatorio. Esto crea un entorno Linux donde Claude Code opera realmente. Sin WSL2, la instalación falla.
Los usuarios de Linux necesitan una distribución de 64 bits. La documentación oficial confirma el soporte para Ubuntu, Debian, Fedora y otras distribuciones importantes. Alpine Linux y los sistemas basados en musl requieren configuración adicional.
Todas las plataformas necesitan una conexión a Internet estable durante la instalación. Los tamaños de descarga varían, pero generalmente oscilan entre 50 MB y 500 MB, dependiendo de lo que ya esté instalado.
| Plataforma | Versión mínima | Requisitos especiales |
|---|---|---|
| macOS | 13.0 | Ninguno |
| Windows | 10 Build 19041 o 11 | WSL2 requerido |
| Linux | Distribución de 64 bits | Se prefieren las basadas en glibc |
Instalación de Claude Code en macOS
El proceso de instalación de macOS utiliza un instalador nativo. Este es el camino más sencillo entre todas las plataformas.
Primero, descargue el instalador del sitio web oficial de Claude Code. La página de descarga detecta automáticamente macOS y ofrece el paquete apropiado.
Abra el archivo .dmg descargado. Arrastre la aplicación Claude Code a la carpeta Aplicaciones. Instalación estándar de macOS, nada inusual aquí.
Algunos usuarios encuentran una advertencia de seguridad al iniciar por primera vez. macOS bloquea las aplicaciones de desarrolladores no identificados por defecto. Haga clic derecho en la aplicación Claude Code y seleccione "Abrir" para omitir esta advertencia de una sola vez.
La herramienta de línea de comandos se instala automáticamente con la aplicación de escritorio. Abra Terminal y escriba claude --version para verificar. Si aparece el número de versión, la instalación se completó correctamente.
Verificación de la instalación de macOS
Ejecute estos comandos para confirmar que todo funciona:
| claude --version claude --help |
Ambos comandos deberían mostrar resultados sin errores. El comando de versión muestra la versión de Claude Code instalada. El comando de ayuda muestra las opciones y comandos disponibles.
La creación de un directorio de prueba ayuda a verificar la funcionalidad completa. Navegue a una carpeta de proyecto y ejecute claude para iniciar una sesión interactiva. La herramienta debería inicializarse y solicitar autenticación si aún no ha iniciado sesión.
Instalación de Windows con WSL2
La instalación de Windows requiere varios pasos. El proceso lleva más tiempo que en macOS, pero sigue siendo manejable.
WSL2 debe instalarse primero. Abra PowerShell como Administrador y ejecute:
| wsl --install |
Este comando instala WSL2 y Ubuntu por defecto. El sistema requerirá un reinicio. Después de reiniciar, Ubuntu se inicia automáticamente para completar la configuración inicial.
Cree un nombre de usuario y contraseña de Unix cuando se le solicite. Estas credenciales son independientes de las credenciales de inicio de sesión de Windows.
Una vez que WSL2 esté en funcionamiento, se aplicará el proceso de instalación de Linux. Abra la terminal de Ubuntu (instalada con WSL2) y descargue el instalador de Claude Code para Linux.
Instalación de Claude Code en WSL2
Según la documentación oficial, el comando de instalación descarga y ejecuta el instalador nativo:
| curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
Este script maneja las dependencias automáticamente. Instala Node.js si es necesario, configura el binario de Claude Code y las variables PATH.
La instalación tarda unos minutos. Las barras de progreso y los mensajes de estado indican lo que está sucediendo. Cuando termine, cierre y vuelva a abrir la terminal para actualizar las variables de entorno.
Probar la instalación sigue el mismo proceso que en macOS. Ejecute claude --version para verificar.
Proceso de instalación en Linux
Los usuarios de Linux tienen la ruta de instalación más sencilla. El instalador nativo funciona directamente sin capas adicionales como WSL2.
Descargue y ejecute el script de instalación:
| curl -fsSL claude.ai/install.sh | bash |
Esto descarga el binario de Claude Code, instala las dependencias y configura el entorno del shell. El script detecta la distribución y se ajusta en consecuencia.
Para sistemas basados en Ubuntu y Debian, el script configura la instalación. La documentación oficial confirma el soporte para Ubuntu 20.04+, Debian 10+ y otras distribuciones.
Consideraciones sobre Alpine Linux
Alpine Linux y las distribuciones basadas en musl necesitan pasos adicionales. La documentación oficial señala que estos sistemas requieren configuración manual.
El instalador estándar puede fallar en Alpine. En su lugar, descargue el binario compatible con musl directamente de la página de lanzamientos. Extraiga en un directorio en la ruta del sistema, típicamente /usr/local/bin.
Establezca permisos ejecutables:
| chmod +x /usr/local/bin/claude |
Los usuarios de Alpine deben verificar la compatibilidad antes de continuar. Algunas funciones pueden no funcionar exactamente igual que en las distribuciones basadas en glibc.
Autenticación y configuración de cuenta
Después de instalar Claude Code, ejecute claude en su terminal. En el primer lanzamiento, Claude Code abrirá una ventana del navegador para que inicie sesión.
Esto abre la página de autenticación de Claude. Inicie sesión con una cuenta de Claude existente o cree una nueva.
El navegador mostrará un código de autorización. Copie este código y regrese a la terminal. Pegue el código cuando se le solicite.
La autenticación exitosa almacena las credenciales localmente. Las sesiones futuras no requerirán inicio de sesión a menos que las credenciales expiren o se borren manualmente.
Autenticación de equipos y empresas
Según la documentación oficial de autenticación, los equipos que utilizan Claude for Teams o Enterprise tienen opciones adicionales. Las organizaciones pueden configurar el inicio de sesión único (SSO) o la autenticación del proveedor de la nube.
La configuración de SSO requiere configuración de administrador. Los desarrolladores individuales se autentican a través del proveedor de identidad de su organización en lugar de cuentas personales de Claude.
La autenticación del proveedor de la nube funciona para implementaciones de AWS, Google Cloud y Azure. Este método utiliza credenciales de nube existentes en lugar de cuentas de Claude separadas.
| Método de autenticación | Caso de uso | Complejidad de configuración |
|---|---|---|
| Cuenta personal | Desarrolladores individuales | Simple |
| SSO para equipos/empresas | Organizaciones | Requiere administrador |
| Proveedor de nube | Usuarios de AWS/GCP/Azure | Moderada |
Instalación de la aplicación de escritorio
Claude Code ofrece aplicaciones de línea de comandos y de escritorio. La aplicación de escritorio proporciona una interfaz gráfica manteniendo la funcionalidad completa de la terminal.
Descargue el instalador de escritorio del sitio web oficial de Claude. La página ofrece versiones para macOS, Windows y Windows ARM64. Seleccione la versión apropiada para el sistema.
La instalación de macOS sigue el mismo proceso .dmg descrito anteriormente. Los usuarios de Windows pueden descargar la aplicación de escritorio para una interfaz gráfica sin necesidad de configurar WSL2.
La aplicación de escritorio incluye acceso a terminal integrado. Puede iniciar sesiones de Claude Code sin cambiar a aplicaciones de terminal externas.
Una ventaja de la aplicación de escritorio es la disponibilidad en segundo plano. Según la página de descarga oficial, la aplicación "permanece lista en segundo plano" y se puede activar desde cualquier aplicación sin cambiar de ventana ni perder el enfoque.
Utilice Get AI Perks para encontrar créditos para su pila de Claude Code
La instalación es la parte fácil. El costo real generalmente proviene de todo lo que la rodea: infraestructura, herramientas de soporte y servicios de pago utilizados durante la configuración y las pruebas. Get AI Perks puede ayudar listando créditos y descuentos para startups en un solo lugar, junto con orientación sobre cómo aplicarlos.
Con Get AI Perks, puede:
- Encontrar créditos para herramientas de nube y relacionadas con IA
- Consultar las condiciones de las ventajas antes de solicitarlas
- Evitar perder tiempo en ofertas para las que quizás no califique
- Reducir el costo de poner en marcha su configuración
Visite Get AI Perks para ver si las ofertas disponibles se ajustan a las herramientas que planea usar con Claude Code.
Extensiones IDE e integraciones
Más allá de la instalación independiente, Claude Code se integra con entornos de desarrollo populares. Existen extensiones para Visual Studio Code e IDE de JetBrains.
La extensión de VS Code se instala a través del mercado. Busque "Claude Code" en el panel de Extensiones y haga clic en Instalar. La extensión requiere que la herramienta de línea de comandos esté instalada primero.
Algunos usuarios informan de problemas con el archivo de extensión de VS Code incluido. Si la instalación automática falla con un error "End of central directory record signature not found", el archivo .vsix incluido puede estar corrupto.
La solución alternativa implica instalar la extensión manualmente desde el mercado de VS Code en lugar de depender de la versión incluida en la CLI. Esto separa los dos componentes y previene conflictos de instalación.
La integración de JetBrains funciona de manera similar. Instale el plugin desde el mercado de JetBrains dentro de IntelliJ IDEA, PyCharm, WebStorm u otros productos de JetBrains.
Verificación del éxito de la instalación
Una verificación adecuada garantiza que Claude Code funcione correctamente antes de comenzar las tareas de desarrollo reales.
Las verificaciones básicas comprueban la disponibilidad de comandos:
| claude --help claude --version |
Estos comandos deberían ejecutarse sin errores. El comando de ayuda lista las opciones disponibles. El comando de versión muestra la versión de lanzamiento instalada.
Las pruebas funcionales requieren iniciar una sesión. Cree un directorio de prueba:
| mkdir test-project cd test-project claude |
Esto inicializa una sesión interactiva de Claude Code. La herramienta debería analizar el directorio (vacío en este caso) y presentar un indicador.
Intente comandos básicos dentro de la sesión. Escriba help para ver las acciones disponibles. Solicite tareas sencillas como "crear un archivo README" o "explica qué puedes hacer".
Las respuestas exitosas indican una instalación correcta. Si ocurren errores, generalmente se relacionan con la autenticación, la conectividad de red o la falta de dependencias.
Gestión de actualizaciones y versiones
Claude Code se actualiza automáticamente por defecto. La documentación oficial explica que la herramienta busca nuevas versiones y las instala sin intervención del usuario.
El comportamiento de actualización se puede configurar a través de la configuración de Claude Code. La documentación oficial cubre la configuración del canal de lanzamiento y las opciones de actualización manual.
Las actualizaciones manuales requieren ejecutar el script de instalación nuevamente. El mismo comando utilizado para la instalación inicial descarga la última versión:
| curl -fsSL claude.ai/install.sh | bash |
Instalar versiones específicas es posible para pruebas o por motivos de compatibilidad. La documentación de configuración avanzada cubre la fijación de versiones y la configuración de canales de lanzamiento.
Los canales de lanzamiento incluyen estable, beta y nocturno. Se recomienda el canal estable para trabajos de producción. Los canales beta y nocturno brindan acceso temprano a nuevas funciones, pero pueden contener errores.
Problemas comunes de instalación
Varios problemas aparecen con frecuencia en las discusiones comunitarias sobre la instalación de Claude Code.
La configuración de PATH causa muchos problemas. Si el comando claude no se encuentra después de la instalación, el directorio binario no está en el PATH del sistema.
En macOS y Linux, agregar el directorio a PATH generalmente implica editar ~/.bashrc, ~/.zshrc o archivos de configuración de shell similares. El script de instalación suele encargarse de esto automáticamente, pero la verificación manual ayuda a solucionar problemas.
Los usuarios de Windows en WSL2 pueden necesitar cerrar y volver a abrir la terminal después de la instalación. Las variables de entorno no se actualizan en las sesiones existentes.
Las restricciones de red bloquean algunas instalaciones. Los cortafuegos corporativos o los servidores proxy pueden impedir la descarga del instalador o la conexión a los servidores de autenticación.
La configuración del proxy requiere variables de entorno:
| export HTTP_PROXY= proxy.example.com:8080 export HTTPS_PROXY= proxy.example.com:8080 |
Se producen errores de permisos al instalar en directorios protegidos. El instalador necesita acceso de escritura a /usr/local/bin o ubicaciones equivalentes. Ejecutar con sudo resuelve esto, pero debe evitarse a menos que sea necesario.
Preguntas frecuentes
¿Puede Claude Code ejecutarse sin conexión a Internet?
No. Claude Code requiere conectividad a Internet para funcionar. La herramienta envía código y consultas a los servidores de Anthropic para su procesamiento. El almacenamiento en caché local puede permitir que algunas operaciones funcionen temporalmente sin conexión, pero la funcionalidad completa requiere una conexión activa.
¿Claude Code funciona con herramientas de codificación de IA existentes?
Sí. Claude Code puede ejecutarse junto con GitHub Copilot, Cursor u otras herramientas de desarrollo de IA. Operan de forma independiente y no entran en conflicto. Sin embargo, usar varios asistentes de IA simultáneamente puede crear confusión sobre qué herramienta está manejando qué tarea.
¿Se requiere WSL2 para todas las funciones de Windows?
La herramienta de línea de comandos requiere WSL2 en Windows. Sin embargo, la aplicación de escritorio se ejecuta de forma nativa en Windows sin WSL2. La aplicación de escritorio proporciona una funcionalidad similar a través de una interfaz gráfica en lugar de una interacción pura de línea de comandos.
¿Cuánto cuesta usar Claude Code?
El precio varía según el uso y el nivel de suscripción. Consulte el sitio web oficial de Claude para conocer los precios actuales, ya que los costos y las estructuras de los planes cambian con el tiempo. Algunas funciones requieren suscripciones a Claude Pro o Enterprise.
¿Puede Claude Code editar archivos fuera del directorio del proyecto?
Por defecto, Claude Code restringe el acceso a los archivos al directorio del proyecto actual por seguridad. La configuración puede ampliar los permisos, pero hacerlo requiere autorización explícita. La documentación de aislamiento cubre la gestión de permisos en detalle.
¿Cuál es la diferencia entre Claude Code y la API de Claude?
Claude Code es una herramienta de desarrollo para asistencia interactiva de codificación. La API de Claude proporciona acceso programático para crear aplicaciones que utilizan las capacidades de IA de Claude. Sirven para propósitos diferentes: una para desarrolladores que escriben código, la otra para aplicaciones que integran funciones de IA.
¿La desinstalación elimina todos los datos de Claude Code?
La desinstalación elimina el binario de la aplicación, pero puede dejar archivos de configuración y datos en caché. La eliminación completa requiere eliminar manualmente el directorio ~/.claude en macOS y Linux, o la ubicación equivalente de AppData en Windows.
Primeros pasos después de la instalación
Con Claude Code instalado y verificado, el siguiente paso es comprender cómo usarlo de manera efectiva.
La documentación de inicio rápido recomienda comenzar con tareas sencillas. Navegue a un proyecto existente y ejecute claude para comenzar una sesión interactiva.
Pida a Claude que explique la estructura del proyecto. Solicite un resumen de lo que hace la base de código. Estas consultas exploratorias ayudan a comprender cómo la herramienta interpreta el código.
Intente hacer pequeños cambios. Pida a Claude que agregue comentarios a las funciones, cree archivos de prueba simples o refactorice bloques de código básicos. Estas tareas demuestran las capacidades de edición sin riesgo.
La integración de Git funciona automáticamente si el proyecto utiliza control de versiones. Claude Code puede crear commits, explicar diferencias y sugerir mejoras basadas en los cambios.
La documentación oficial incluye ejemplos de flujo de trabajo para tareas de desarrollo comunes. Estos cubren la corrección de errores, la implementación de funciones, la revisión de código y las pruebas automatizadas.
Claude Code es una herramienta en evolución. La instalación es solo la base. Comprender sus capacidades, limitaciones y mejores prácticas requiere experimentación y práctica.
¿Listo para instalar Claude Code? Descargue el instalador apropiado para su plataforma desde el sitio web oficial y siga los pasos descritos en esta guía. Autentíquese con su cuenta de Claude, verifique que la instalación funcione correctamente y comience a explorar el desarrollo asistido por IA.
