Claude Code es la interfaz de línea de comandos oficial de Anthropic que lleva la asistencia de IA para programación directamente a tu terminal. A diferencia de las herramientas basadas en navegador, lee toda tu base de código, ejecuta comandos y gestiona ediciones complejas en múltiples archivos mediante lenguaje natural, todo sin salir de la línea de comandos. A fecha de marzo de 2026, el método de instalación recomendado es el instalador nativo, que no requiere dependencias y se actualiza automáticamente. Necesitas como mínimo una suscripción a Claude Pro ($20/mes) para autenticarte y utilizar Claude Code, ya que el plan gratuito no incluye acceso a la CLI.
Resumen rápido
Aquí tienes todo lo que necesitas saber sobre la instalación de Claude Code, resumido en los datos esenciales. En macOS o Linux, abre tu terminal y ejecuta curl -fsSL https://claude.ai/install.sh | bash — el proceso completo tarda menos de dos minutos. Los usuarios de Windows deben instalar primero Git for Windows y luego ejecutar irm https://claude.ai/install.ps1 | iex en PowerShell. El instalador nativo es el método oficialmente recomendado porque no requiere Node.js, se actualiza automáticamente y ofrece la experiencia más estable. Homebrew (brew install --cask claude-code) y WinGet (winget install Anthropic.ClaudeCode) son alternativas compatibles para desarrolladores que prefieren gestores de paquetes. El antiguo método de instalación por npm (npm install -g @anthropic-ai/claude-code) está ahora obsoleto — si todavía lo usas, Anthropic recomienda migrar al instalador nativo. Claude Code requiere una cuenta de Claude de pago: el plan Pro empieza en $20/mes ($17/mes con facturación anual), mientras que el plan Max a $100/mes ofrece 20 veces más capacidad de uso. El plan gratuito no incluye acceso a Claude Code. Después de la instalación, ejecuta claude en cualquier directorio de proyecto para iniciar una sesión interactiva de programación donde puedes pedirle a Claude que lea, edite y gestione tu código mediante conversación.
¿Qué es Claude Code y realmente lo necesitas?
Claude Code no es simplemente otra herramienta de autocompletado de código con IA — es un entorno de programación agéntico completo que se ejecuta íntegramente en tu terminal. Lanzado por Anthropic y alcanzando disponibilidad general en mayo de 2025, Claude Code entiende la estructura completa de tu proyecto, puede navegar entre archivos, ejecutar tests, hacer commits y hasta depurar problemas complejos en múltiples bases de código simultáneamente. Lo que lo diferencia fundamentalmente de herramientas como GitHub Copilot o Cursor es que Claude Code opera como un agente autónomo: describes lo que quieres en lenguaje natural y él planifica, ejecuta y verifica los cambios sin necesidad de que selecciones código manualmente ni cambies entre archivos. Funciona con cualquier lenguaje, cualquier framework y cualquier editor — porque no necesita un editor en absoluto.
La cuestión de si realmente necesitas Claude Code depende de tu flujo de trabajo y del tiempo que pasas en la terminal. Si eres un desarrollador que ya trabaja intensamente con herramientas de línea de comandos, Claude Code encaja de forma natural en tu proceso existente. Destaca en tareas que normalmente requieren tocar muchos archivos a la vez: refactorizar un módulo a lo largo de toda tu base de código, implementar una funcionalidad que abarca frontend y backend, o depurar un problema que implica rastrear múltiples capas de tu aplicación. Para desarrolladores que están evaluando herramientas de programación con IA, puede interesarte leer nuestra comparativa completa entre ChatGPT y Claude para entender cómo los modelos subyacentes de Claude se comparan con la competencia. Si tu trabajo se centra principalmente en un solo archivo a la vez, un asistente de código inline tradicional podría ser suficiente, pero para tareas de ingeniería complejas que involucran múltiples archivos, Claude Code representa un avance significativo en la productividad del desarrollador. La herramienta ha encontrado una adopción especialmente fuerte entre desarrolladores backend, ingenieros full-stack y profesionales de DevOps que trabajan regularmente con múltiples servicios y archivos de configuración. Los primeros usuarios en Reddit y foros de desarrolladores destacan consistentemente que la capacidad de Claude Code para entender el contexto del proyecto — leyendo archivos README, analizando grafos de dependencias y comprendiendo patrones de tests — lo hace drásticamente más útil que los asistentes de IA que solo ven archivos individuales de forma aislada. El hecho de que se ejecute en la terminal también significa que se integra perfectamente con los flujos de trabajo existentes que involucran git, docker, make y otras herramientas de línea de comandos sin requerir plugins de editor ni configuración alguna.
Lo que necesitas antes de instalar Claude Code
Antes de ejecutar el comando de instalación, hay dos cosas que debes resolver: los requisitos del sistema y tu suscripción a Claude. Asegurarte de tenerlos en orden desde el principio te ahorra la frustración de instalar Claude Code solo para descubrir que no puedes autenticarte o que tu sistema operativo no es compatible. Este es el paso que la mayoría de guías de instalación se saltan, y es la razón por la que muchos desarrolladores se estancan inmediatamente después de la instalación.
Los requisitos del sistema son sencillos pero varían según la plataforma. En macOS, necesitas la versión 13.0 (Ventura) o posterior — las versiones anteriores de macOS no son compatibles con el instalador nativo (code.claude.com/docs/en/setup, verificado en marzo de 2026). Los usuarios de Windows necesitan Windows 10 versión 1809 o posterior, o Windows Server 2019+, y es fundamental tener Git for Windows instalado antes de ejecutar el instalador de Claude Code. Esta dependencia de Git es la causa más común de fallos de instalación en Windows, así que instálalo desde git-scm.com antes de intentar cualquier otra cosa. Los usuarios de Linux necesitan Ubuntu 20.04+, Debian 10+ o Alpine 3.19+ (Alpine requiere dependencias adicionales). Todas las plataformas requieren un mínimo de 4GB de RAM, aunque se recomiendan 8GB o más para trabajar con bases de código grandes. Los shells compatibles son Bash, Zsh, PowerShell y CMD.
Los precios son la parte que pilla desprevenidos a muchos. Claude Code en sí es gratuito para instalar — el binario no cuesta nada. Sin embargo, para usarlo realmente, debes autenticarte con una cuenta de Claude que incluya acceso a Claude Code. El plan gratuito de Claude ($0/mes) no incluye Claude Code en absoluto (claude.com/pricing, marzo de 2026). El plan Pro a $20/mes ($17/mes con facturación anual) es el nivel mínimo que incluye Claude Code, y es el que la mayoría de desarrolladores individuales debería elegir. Si necesitas significativamente más uso, el plan Max a $100/mes (o $200/mes para el nivel 5x) proporciona 20 veces más capacidad y funcionalidades adicionales como pensamiento extendido y capacidades de investigación. Para equipos, el plan Teams Premium a $150/usuario/mes incluye Claude Code, pero el plan Teams estándar a aproximadamente $25/usuario/mes no lo incluye. Puedes explorar las opciones de prueba gratuita de Claude Pro para probar el servicio antes de comprometerte, o consultar nuestro detallado desglose de precios de suscripción a Claude para una comparación completa. Los desarrolladores que prefieren facturación por uso también pueden autenticar Claude Code con una clave API de Anthropic en lugar de una suscripción, lo que cobra según el consumo real de tokens. Para desarrolladores que ya trabajan con APIs de IA, plataformas como laozhang.ai ofrecen acceso agregado a múltiples modelos mediante una sola API, lo que puede ser una alternativa rentable para uso programático.
Cómo instalar Claude Code (paso a paso)
Este es el núcleo de la guía — los comandos exactos que necesitas ejecutar, organizados por plataforma. El instalador nativo es el enfoque recomendado para todas las plataformas porque incluye todo lo que Claude Code necesita sin requerir que instales Node.js ni gestiones paquetes npm. Cada método a continuación ha sido verificado contra la documentación oficial en code.claude.com a fecha de marzo de 2026.
macOS y Linux (incluyendo WSL)
Instalar Claude Code en macOS o Linux es genuinamente un proceso de un solo comando que tarda aproximadamente dos minutos de principio a fin. Abre tu terminal — en macOS puedes presionar Cmd+Espacio, escribir "Terminal" y presionar Enter, mientras que en Linux puedes usar Ctrl+Alt+T o tu emulador de terminal preferido. Luego ejecuta el siguiente comando:
bashcurl -fsSL https://claude.ai/install.sh | bash
Esto descarga y ejecuta el script de instalación oficial, que detecta automáticamente tu sistema operativo y arquitectura, descarga el binario apropiado y lo coloca en tu PATH del sistema. Una vez completada la instalación, verás un mensaje de éxito. Verifica la instalación ejecutando claude --version, que debería mostrar el número de versión actual (algo como claude v1.0.33 (stable) o similar). Si estás usando WSL (Windows Subsystem for Linux), el proceso es idéntico — abre tu terminal WSL y ejecuta el mismo comando curl. El instalador trata WSL como un entorno Linux, así que no se requieren pasos especiales. Después de la verificación, simplemente escribe claude en cualquier directorio de proyecto para iniciar una sesión interactiva y comenzar a usar la asistencia de programación impulsada por IA.
Instalación en Windows
La instalación en Windows requiere un paso adicional en comparación con macOS y Linux: debes instalar Git for Windows antes de ejecutar el instalador de Claude Code. Esto no es opcional — el instalador fallará sin él, y este requisito pilla desprevenidos a muchos usuarios ya que no se menciona de forma prominente en todas las guías. Descarga Git for Windows desde git-scm.com/download/win, ejecuta el instalador con la configuración predeterminada y asegúrate de reiniciar tu terminal después de la instalación para que Git esté disponible en tu PATH.
Una vez instalado Git, tienes dos opciones para instalar Claude Code en Windows. El método recomendado usa PowerShell — abre PowerShell (puedes hacer clic derecho en el botón de Inicio y seleccionar "Windows PowerShell" o "Terminal"), luego ejecuta:
powershellirm https://claude.ai/install.ps1 | iex
Si prefieres el Símbolo del sistema tradicional (CMD), usa este comando alternativo:
cmdcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Ambos comandos logran el mismo resultado: descargan el instalador oficial, extraen el binario de Claude Code y configuran tu PATH. El método de PowerShell es ligeramente más limpio ya que no deja un archivo temporal. Después de la instalación, verifica con claude --version en una nueva ventana de terminal. Si el comando no se reconoce, puede que necesites cerrar y reabrir tu terminal para actualizar la variable de entorno PATH. Un error común en Windows es que algunos desarrolladores intentan usar Git Bash (el emulador de Bash que viene con Git for Windows) para ejecutar el instalador basado en curl de macOS/Linux — aunque esto a veces funciona, no es el enfoque recomendado. Usa el método de PowerShell o CMD para la experiencia más fiable en Windows. Si estás usando WSL en Windows, deberías instalar dentro del entorno WSL usando el comando curl de Linux en lugar del instalador de PowerShell de Windows, ya que WSL mantiene su propio sistema de archivos y configuración de PATH independientes.
Alternativas con gestores de paquetes (Homebrew y WinGet)
Para desarrolladores que prefieren gestionar todas sus herramientas a través de un gestor de paquetes, Claude Code está disponible a través de Homebrew en macOS y WinGet en Windows. En macOS, simplemente ejecuta brew install --cask claude-code — esto instala Claude Code como un cask de Homebrew, lo que significa que las actualizaciones se gestionan mediante brew upgrade en lugar del actualizador automático integrado. En Windows, puedes usar winget install Anthropic.ClaudeCode para instalar a través del Administrador de paquetes de Windows. Ambos métodos de gestor de paquetes proporcionan el mismo binario de Claude Code que el instalador nativo, y manejan la configuración del PATH automáticamente. La contrapartida es que gestionas las actualizaciones a través de tu gestor de paquetes en lugar del mecanismo de actualización integrado de Claude Code, lo que algunos desarrolladores prefieren por consistencia en su cadena de herramientas mientras que otros encuentran menos conveniente para mantenerse en la última versión.
Instalador nativo vs Homebrew vs npm: ¿cuál deberías elegir?
Con tres métodos de instalación diferentes disponibles (más WinGet para Windows), elegir el adecuado puede resultar abrumador. La realidad es más sencilla de lo que parece: para la gran mayoría de usuarios, el instalador nativo es la opción correcta, y la propia documentación de Anthropic lo recomienda explícitamente. El instalador nativo no requiere dependencias de ejecución como Node.js, incluye actualizaciones automáticas para que siempre estés en la última versión, y proporciona la experiencia más estable porque es el método principal que Anthropic prueba y da soporte. Funciona en todas las plataformas — macOS, Windows, Linux y WSL — mediante un único comando de instalación específico para tu sistema operativo.
Homebrew y WinGet son buenas alternativas si tienes una fuerte preferencia por gestionar todas tus herramientas de desarrollo a través de un gestor de paquetes unificado. Muchos desarrolladores experimentados mantienen toda su cadena de herramientas mediante comandos brew o winget, y usar estos para Claude Code mantiene tu flujo de trabajo consistente. La contrapartida es que las actualizaciones no son automáticas — necesitas ejecutar explícitamente brew upgrade o winget upgrade para obtener nuevas versiones, lo que significa que podrías quedarte atrás respecto a las últimas funcionalidades y correcciones de errores. En entornos empresariales donde los despliegues controlados importan, esto puede ser realmente una ventaja, ya que eliges cuándo actualizar en lugar de que las actualizaciones se apliquen automáticamente.
Entender por qué el instalador nativo es tan fuertemente recomendado ayuda a contextualizar las otras opciones. Anthropic diseñó el instalador nativo para ser autónomo: no depende de ningún gestor de paquetes del sistema ni entorno de ejecución, lo que elimina toda una categoría de problemas de instalación relacionados con conflictos de dependencias, incompatibilidades de versiones y contaminación del PATH. El binario que instala está compilado estáticamente para tu plataforma y arquitectura específicas, lo que significa que arranca más rápido y funciona de forma más fiable que la versión basada en npm, que requería el entorno de ejecución de Node.js. El mecanismo de actualización automática comprueba si hay nuevas versiones cada vez que lanzas Claude Code y aplica las actualizaciones de forma transparente en segundo plano, asegurando que siempre tengas acceso a las últimas mejoras del modelo y correcciones de errores sin ninguna intervención manual.
El método npm (npm install -g @anthropic-ai/claude-code) sigue funcionando pero está oficialmente obsoleto según la documentación actual (code.claude.com, marzo de 2026). Si instalaste Claude Code mediante npm previamente, seguirá funcionando, pero Anthropic recomienda migrar al instalador nativo para mejor rendimiento, estabilidad y actualizaciones automáticas. El método npm también requiere tener Node.js 18 o posterior instalado en tu sistema, que es una dependencia innecesaria para una herramienta que realmente no necesita Node.js para ejecutarse. Si actualmente usas la instalación por npm, la migración es sencilla: desinstala el paquete npm con npm uninstall -g @anthropic-ai/claude-code, luego instala la versión nativa usando el comando curl o PowerShell para tu plataforma. Tu configuración y ajustes se preservarán ya que se almacenan en tu directorio home, no en la ubicación del paquete npm.
Tus primeros 5 minutos con Claude Code
Después de la instalación, la transición de "instalado" a "productivo" debería ser inmediata, y eso es exactamente para lo que Claude Code está diseñado. La primera vez que ejecutes claude en tu terminal, serás guiado a través de un flujo de autenticación que conecta la CLI con tu cuenta de Claude. Se te pedirá que inicies sesión a través de tu navegador, donde autorizarás a Claude Code a usar tus credenciales Pro, Max o de API. Esta configuración se hace una sola vez — los lanzamientos posteriores usarán tu autenticación guardada.
Una vez autenticado, lo más importante que debes entender es que Claude Code es consciente del contexto basándose en tu directorio de trabajo actual. Navega a una carpeta de proyecto usando cd /ruta/a/tu/proyecto antes de lanzar Claude, y automáticamente escaneará y entenderá la estructura de tu base de código. Inicias una sesión interactiva simplemente escribiendo claude sin argumentos. Desde ahí, puedes hablar con Claude en lenguaje natural: pedirle que explique cómo funciona una función particular, solicitar que implemente una nueva funcionalidad, decirle que encuentre y corrija un error, o instruirle para que refactorice un módulo. Claude Code lee tus archivos, hace ediciones, crea nuevos archivos e incluso puede ejecutar comandos de terminal en tu nombre (con tu permiso). Algunos primeros comandos particularmente útiles incluyen claude "explain the architecture of this project" para orientarte en una base de código desconocida, o claude "run the tests and fix any failures" para obtener valor práctico inmediato. También puedes usar el modo de un solo comando pasando tu solicitud directamente como argumento — por ejemplo, claude "add input validation to the user registration form" — lo que ejecuta la tarea y sale sin iniciar una sesión interactiva, haciéndolo perfecto para correcciones rápidas o flujos de trabajo automatizados.
Comprender cómo Claude Code gestiona los permisos es esencial para confiar en él con tu base de código. Por defecto, Claude Code pide tu aprobación antes de realizar cualquier cambio en archivos o ejecutar comandos de shell, mostrando exactamente lo que pretende hacer y esperando tu confirmación. Puedes ajustar este comportamiento mediante los modos de permisos: el modo predeterminado requiere aprobación para cada acción, el modo "acceptEdits" aprueba automáticamente las ediciones de archivos pero sigue preguntando sobre los comandos de shell, y hay modos más permisivos para usuarios experimentados que quieren una ejecución más rápida. Este sistema de permisos significa que nunca tienes que preocuparte de que Claude Code haga cambios inesperados — cada modificación es visible y aprobada antes de que ocurra, dándote el mismo nivel de control que si hicieras los cambios manualmente mientras te beneficias de la velocidad y precisión asistida por IA.
Más allá de las sesiones interactivas, Claude Code soporta varios patrones de flujo de trabajo en los que los usuarios experimentados confían a diario. Puedes redirigir contenido directamente a Claude con comandos como git diff | claude "review this code change" para revisiones rápidas de código, o cat error.log | claude "diagnose the root cause of these errors" para depuración rápida. El comando /init crea un archivo CLAUDE.md en la raíz de tu proyecto que le da a Claude contexto persistente sobre las convenciones de tu proyecto, estándares de codificación y decisiones arquitectónicas importantes — piensa en él como un documento de briefing que hace que cada interacción posterior sea más efectiva. Los usuarios experimentados suelen rellenar este archivo con información sobre su stack tecnológico, requisitos de testing y preferencias de estilo de codificación, lo que mejora dramáticamente la calidad y consistencia de las sugerencias de Claude entre sesiones.
También puedes configurar el comportamiento de Claude Code a través de los ajustes, incluyendo la elección del canal de distribución a seguir (stable vs beta), la configuración de servidores MCP (Model Context Protocol) para acceso extendido a herramientas, y la personalización de atajos de teclado para tu entorno de terminal preferido. La integración MCP es particularmente poderosa porque permite a Claude Code interactuar con herramientas y servicios externos — bases de datos, gestores de incidencias, sistemas de documentación — dándole capacidades que van mucho más allá de la simple edición de código. Para desarrolladores que ya trabajan con APIs de IA en sus proyectos, servicios como laozhang.ai proporcionan acceso agregado a múltiples modelos de IA a través de un solo endpoint de API, lo que puede complementar las capacidades de Claude Code cuando necesitas integrar funcionalidades de IA directamente en tus aplicaciones.
Solución de los 5 problemas de instalación más comunes
Incluso con un proceso de instalación sencillo, las cosas pueden salir mal — y cuando ocurren en la etapa de instalación, resulta especialmente frustrante porque ni siquiera puedes empezar a usar la herramienta. Estos son los cinco problemas que aparecen con más frecuencia en las discusiones de la comunidad y los canales de soporte, junto con sus soluciones.
"command not found" después de la instalación es el problema más común con diferencia, y casi siempre se debe a que el PATH de tu shell no se ha actualizado. El instalador añade Claude Code a tu PATH, pero tu sesión de terminal actual puede no haber recogido el cambio. La solución más simple es cerrar tu terminal completamente y abrir una nueva. Si eso no funciona, comprueba si la instalación añadió una entrada a tu perfil de shell ejecutando cat ~/.bashrc | grep claude (o ~/.zshrc para usuarios de Zsh). En Windows, abre una nueva ventana de PowerShell — no reutilices la misma en la que ejecutaste el instalador. Si la entrada del PATH falta por completo, puedes añadir manualmente la ubicación del binario de Claude Code a tu PATH, que normalmente es ~/.claude/bin en macOS/Linux.
Git no encontrado en Windows es el segundo problema más frecuente, y es completamente prevenible. El instalador de Claude Code en Windows depende de que Git for Windows esté disponible en el PATH de tu sistema. Si instalaste Git pero el instalador sigue sin encontrarlo, la causa más probable es que no marcaste la opción "Add Git to PATH" durante la instalación de Git, o que no reiniciaste tu terminal después de instalar Git. Reinstala Git for Windows, asegurándote de seleccionar la opción que añade Git al PATH del sistema, luego reinicia tu terminal antes de intentar la instalación de Claude Code de nuevo. Puedes verificar que Git está correctamente configurado ejecutando git --version en una nueva ventana de terminal.
Fallos de autenticación normalmente ocurren cuando tu cuenta de Claude no tiene el nivel de suscripción requerido. Recuerda que el plan gratuito no incluye acceso a Claude Code — necesitas como mínimo una suscripción Pro ($20/mes). Si tienes una suscripción Pro pero sigues sin poder autenticarte, prueba a limpiar tus credenciales en caché ejecutando claude logout seguido de claude login para reiniciar el flujo de autenticación. Problemas de red, particularmente cortafuegos corporativos o VPNs que bloquean los endpoints de autenticación de Anthropic, también pueden causar fallos de autenticación. En esos casos, comprueba si puedes acceder a claude.ai en tu navegador desde la misma red.
Errores de permisos durante la instalación ocurren cuando el instalador no puede escribir en el directorio destino o ejecutar el binario descargado. En macOS y Linux, esto normalmente significa que necesitas ajustar los permisos del directorio ~/.claude o ejecutar el instalador con los permisos de usuario apropiados. Es importante evitar usar sudo para la instalación a menos que sea absolutamente necesario, porque ejecutar el instalador como root crea archivos propiedad de root en tu directorio home, lo que causa problemas de permisos diferentes más tarde cuando intentas ejecutar Claude Code como tu usuario normal. Si ejecutaste previamente el instalador con sudo, corrige la propiedad con sudo chown -R $(whoami) ~/.claude y luego inténtalo de nuevo sin sudo. En Windows, ejecutar PowerShell como Administrador puede resolver la mayoría de los fallos de instalación relacionados con permisos — haz clic derecho en el icono de PowerShell y selecciona "Ejecutar como administrador" antes de ejecutar el comando de instalación. Si estás en un entorno corporativo con acceso de escritura restringido, software de protección de endpoints o políticas de listas blancas de aplicaciones, puede que necesites solicitar a tu equipo de TI que incluya en la lista blanca el directorio de instalación y el binario de Claude Code.
Conflictos de versión con instalaciones antiguas de npm pueden causar un comportamiento confuso si previamente tenías Claude Code instalado mediante npm y luego instalaste la versión nativa. Ambas versiones pueden existir en tu PATH, y tu shell podría estar encontrando la incorrecta. Ejecuta which claude (macOS/Linux) o where claude (Windows) para ver qué binario se está ejecutando. Si apunta a una instalación npm (normalmente algo como /usr/local/bin/claude o una ruta dentro de tu instalación de Node.js), desinstala primero la versión npm con npm uninstall -g @anthropic-ai/claude-code, luego verifica que la instalación nativa es la que se encuentra. El instalador nativo coloca el binario en ~/.claude/bin/claude en la mayoría de sistemas. Después de eliminar la versión npm, abre una nueva terminal y ejecuta which claude de nuevo para confirmar que ahora estás usando el binario nativo. Si ambas estaban instaladas, también vale la pena comprobar que no estás viendo información de versión en caché obsoleta ejecutando claude --version para verificar que estás en la última versión nativa.
Si encuentras algún problema no cubierto anteriormente, la guía oficial de solución de problemas de Claude Code en code.claude.com proporciona soluciones adicionales, y el comando claude doctor realiza una verificación de diagnóstico que identifica automáticamente los problemas de configuración más comunes. Ejecutar claude doctor muestra un informe detallado de la configuración de tu sistema, el estado de autenticación y cualquier problema detectado, convirtiéndolo en el mejor punto de partida cuando algo va mal con tu instalación.
Seguridad y actualizaciones
La seguridad no es normalmente lo primero en lo que piensas al instalar una herramienta de desarrollo, pero Claude Code presenta un caso único que merece atención. En 2026, investigadores de seguridad descubrieron una campaña en la que se promocionaban páginas falsas de instalación de Claude Code a través de Google Ads, distribuyendo malware conocido como el ataque "InstallFix" (reportado por BleepingComputer y TechRepublic). Estas páginas maliciosas se parecían convincentemente a las páginas oficiales de descarga de Anthropic y aparecían en los primeros resultados de búsqueda como anuncios de pago. La conclusión es simple pero crítica: instala Claude Code únicamente desde fuentes oficiales. Las URLs de instalación legítimas son claude.ai/install.sh para macOS/Linux, claude.ai/install.ps1 para PowerShell de Windows, el cask oficial de Homebrew, el paquete WinGet Anthropic.ClaudeCode, o el paquete npm @anthropic-ai/claude-code del registro oficial de npm. Si llegaste a una página de instalación a través de un anuncio de Google o un sitio web desconocido, verifica cuidadosamente la URL antes de ejecutar cualquier comando.
Para verificar la integridad de tu instalación después de ejecutarla, comprueba la salida de la versión con claude --version — una instalación legítima mostrará una cadena de versión limpia como claude v1.0.33 (stable). Si ves algo inusual, branding inesperado, o el binario está ubicado en un directorio inesperado (compruébalo con which claude en macOS/Linux), elimínalo inmediatamente y reinstala desde la fuente oficial. También vale la pena señalar que Claude Code se comunica exclusivamente con los servidores de Anthropic para el procesamiento de IA — no envía tu código a servicios de terceros, y puedes revisar exactamente qué datos se están transmitiendo a través de las funcionalidades de transparencia de la herramienta.
Mantener Claude Code actualizado es sencillo con el instalador nativo, que comprueba y aplica actualizaciones automáticamente cuando lanzas la herramienta. Puedes comprobar manualmente tu versión actual con claude --version y activar una comprobación de actualización con claude update. Si instalaste a través de Homebrew, ejecuta brew upgrade claude-code periódicamente para mantenerte al día. Para instalaciones de WinGet, usa winget upgrade Anthropic.ClaudeCode. Mantenerse en la última versión es importante no solo por las nuevas funcionalidades, sino también por los parches de seguridad y las mejoras de estabilidad. El equipo de Claude Code publica actualizaciones frecuentemente, a menudo varias veces por semana, por lo que el mecanismo de actualización automática del instalador nativo es genuinamente valioso para asegurar que siempre tienes las últimas correcciones y capacidades sin ninguna intervención manual. También puedes elegir entre los canales de distribución stable y beta a través de los ajustes de Claude Code — el canal stable se recomienda para trabajo en producción, mientras que el canal beta te da acceso anticipado a nuevas funcionalidades.
Preguntas frecuentes
¿Es gratuito usar Claude Code?
Claude Code en sí es gratuito para instalar — el binario no cuesta nada descargar. Sin embargo, necesitas una cuenta de Claude de pago para autenticarte y usarlo realmente. El requisito mínimo es una suscripción Claude Pro a $20/mes ($17/mes con facturación anual). El plan gratuito de Claude no incluye acceso a Claude Code. Alternativamente, puedes usar una clave API de Anthropic con facturación por uso, que cobra según los tokens consumidos durante tus sesiones de programación en lugar de una tarifa mensual fija.
¿Funciona Claude Code sin conexión?
No, Claude Code requiere una conexión a internet para funcionar. Se comunica con los modelos Claude de Anthropic en la nube para procesar tus solicitudes, por lo que necesitas una conexión a internet estable durante el uso. Tu código en sí se procesa localmente para el contexto, pero el razonamiento de la IA ocurre en los servidores de Anthropic. La herramienta sí almacena en caché algo de configuración localmente, por lo que el lanzamiento y la navegación básica funcionan sin conectividad, pero cualquier asistencia real impulsada por IA requiere estar en línea.
¿Puedo usar Claude Code con VS Code o JetBrains?
Claude Code es una herramienta de terminal independiente y no requiere ningún IDE. Sin embargo, funciona junto a cualquier editor o IDE ya que opera en tu terminal. Muchos desarrolladores ejecutan Claude Code en un diseño de terminal dividida dentro del terminal integrado de VS Code o en una pestaña de terminal separada junto a su IDE de JetBrains. También existen extensiones creadas por la comunidad que integran Claude Code más profundamente con editores específicos, aunque la experiencia nativa de terminal es el flujo de trabajo principal soportado.
¿Cómo desinstalo Claude Code?
El instalador nativo incluye una opción de desinstalación limpia. Ejecuta claude uninstall para eliminar el binario y sus archivos asociados. Si instalaste a través de Homebrew, usa brew uninstall claude-code. Para WinGet, usa winget uninstall Anthropic.ClaudeCode. Si instalaste mediante npm, usa npm uninstall -g @anthropic-ai/claude-code. Tus archivos de configuración en ~/.claude/ se preservan por defecto durante la desinstalación, para que puedas reinstalar más tarde sin perder tus ajustes.
¿Cuál es la diferencia entre Claude Code y la aplicación de escritorio de Claude?
La aplicación de escritorio de Claude proporciona una interfaz gráfica de chat similar a claude.ai pero como una aplicación nativa en tu ordenador. Claude Code, por otro lado, es una herramienta de línea de comandos diseñada específicamente para el desarrollo de software. Claude Code puede leer y modificar archivos en tu proyecto, ejecutar comandos de terminal, interactuar con git y realizar ediciones en múltiples archivos — capacidades que la aplicación de escritorio no tiene. Piensa en la aplicación de escritorio como un asistente de IA de propósito general y en Claude Code como un compañero de programación especializado que vive en tu terminal.
¿Cuánto cuenta el uso de Claude Code en los límites de mi suscripción?
El uso de Claude Code sí cuenta en los límites de uso de tu suscripción. Con el plan Pro, obtienes una cantidad generosa pero finita de uso por día, y las sesiones intensivas de Claude Code (especialmente las que involucran bases de código grandes o muchas operaciones secuenciales) pueden consumir esta asignación rápidamente. El plan Max a $100/mes proporciona aproximadamente 20 veces la capacidad de uso del Pro, por lo que Anthropic lo recomienda para desarrolladores que usan Claude Code extensivamente durante su jornada laboral. Si alcanzas tu límite de uso, Claude Code te notificará y necesitarás esperar a que el límite se restablezca (normalmente en una ventana móvil) o actualizar a un nivel superior. Usar una clave API en lugar de una suscripción te da precios por uso sin límites diarios estrictos, aunque los costes pueden acumularse con un uso intensivo.
¿Puedo usar Claude Code en un pipeline CI/CD o scripts automatizados?
Sí, Claude Code soporta uso no interactivo que funciona bien en entornos automatizados. Puedes pasar comandos directamente como argumentos, como claude -p "generate unit tests for src/utils.ts", lo que ejecuta la tarea y muestra el resultado sin ningún prompt interactivo. Para la integración CI/CD, normalmente te autenticarías usando una clave API almacenada como variable de entorno en lugar de un inicio de sesión interactivo en el navegador. Esto hace posible usar Claude Code para revisiones de código automatizadas, generación de tests o actualizaciones de documentación como parte de tu pipeline de build. La bandera --output-format json es particularmente útil en contextos con scripts porque devuelve una salida estructurada que otras herramientas pueden analizar programáticamente.
Empieza a programar con Claude Code hoy
Instalar Claude Code tarda menos de cinco minutos en cualquier plataforma, y el instalador nativo hace que el proceso sea tan simple como ejecutar un solo comando. Empieza verificando que tu sistema cumple los requisitos (macOS 13+, Windows 10 1809+ o Linux Ubuntu 20.04+), asegúrate de tener una suscripción Claude Pro ($20/mes mínimo) o una clave API de Anthropic, y ejecuta el comando de instalación apropiado para tu plataforma. El instalador nativo es la opción recomendada para la mayoría de usuarios — gestiona las dependencias automáticamente, se mantiene actualizado sin intervención manual y proporciona la experiencia más fiable que Anthropic prueba y da soporte activamente.
Recuerda descargar únicamente desde fuentes oficiales (claude.ai, code.claude.com o GitHub anthropics/claude-code) para protegerte de las campañas de malware que han apuntado a usuarios de Claude Code a través de anuncios falsos de Google. Si encuentras problemas durante la instalación, la sección de solución de problemas anterior cubre los cinco problemas más comunes y sus soluciones, y el comando claude doctor está siempre disponible como punto de partida para diagnósticos. Una vez instalado, navega a tu directorio de proyecto, escribe claude y empieza a construir — ya sea implementando una nueva funcionalidad, refactorizando código legacy o depurando un problema complicado a lo largo de toda tu base de código. Tu terminal acaba de convertirse en tu herramienta de programación más potente, y ahora estás equipado con el conocimiento para instalar, configurar y mantener Claude Code de forma segura y efectiva en cualquier plataforma.