Instalación de Claude Code en macOS

Claude code install es muy sencillo en macOS y Linux si ya tienes Node.js instalado. La forma más rápida de hacer Claude code install es usando npm, lo cual es mejor que los scripts ad hoc porque las actualizaciones se mantienen ligadas al paquete oficial en lugar de depender de scripts de terceros.

Resultado

Con esta configuración, puedes lanzar Claude Code desde una terminal, autenticarte con Anthropic y vincularlo a un directorio de proyecto. Esto es suficiente para comenzar a utilizar prompts conscientes del código, ediciones específicas y flujos de trabajo asistidos por la terminal sin necesidad de añadir plugins al editor primero.

Este inicio rápido se enfoca en el camino más corto y confiable. Los equipos que necesitan versiones específicas o imágenes de estaciones de trabajo gestionadas pueden incorporarlas más tarde, pero la instalación debería mantenerse cerca del paquete oficial, ya que menos elementos en movimiento significa menos fallos en la integración.

Requisitos previos

Utiliza un shell soportado en macOS o Linux e instala una versión actual de Node.js con npm disponible en PATH. Se requiere una cuenta de Anthropic para iniciar sesión; revisa la página oficial de precios para los detalles actuales del plan de Claude.

La mayoría de las instalaciones fallidas provienen de la configuración del shell, no de Claude Code. Si faltan node, npm o los binarios globales de npm en PATH, el paquete puede instalarse correctamente pero aún parecer roto desde la terminal.

Requisito	Por qué es importante	Cómo verificar
Node.js + npm	El camino de instalación oficial utiliza npm.	node -v y npm -v
Shell de macOS o Linux	Claude Code está diseñado para uso en terminal.	echo $SHELL
Cuenta de Anthropic	Se requiere iniciar sesión antes de que la CLI pueda acceder a Claude.	Inicia sesión en el sitio oficial de Anthropic
Directorio del proyecto	Correr dentro de un repositorio le da al herramienta contexto útil.	pwd dentro de la carpeta objetivo

Paso 1: Instala Node.js si no está instalado

Salta este paso si node -v y npm -v ya funcionan. Usar Node desde el instalador oficial o un gestor de versiones es la opción más segura, ya que rutas de npm rotas causan más fallas de instalación que Claude Code en sí.

En macOS, muchos equipos utilizan Homebrew o nvm. En Linux, un gestor de versiones suele ser más limpio que los paquetes de distribución, ya que los repositorios de distribución a menudo se quedan atrás con las versiones actuales de Node y pueden dividir el comportamiento de npm de maneras que confunden las instalaciones globales de la CLI.

La verificación es más importante que el método de instalación. Si node -v devuelve una versión pero npm -v falla, corrige Node antes de tocar Claude Code, porque la ruta oficial de Claude code install depende de npm y no tiene sentido depurar dos capas rotas al mismo tiempo.

Paso 2: Ejecuta el comando de instalación de claude code

El paquete oficial se instala con npm:

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

La instalación global es el predeterminado correcto para una CLI. Las instalaciones locales en el proyecto generan fricción en la ruta y no resuelven nada a menos que un equipo esté fijando versiones de herramientas de forma muy agresiva para un entorno de construcción bloqueado.

Aquí es donde muchos documentos internos se complican demasiado. Los scripts envolventes, binarios copiados y alias de shell crean puntos de falla adicionales, mientras que el comando npm directo mantiene la fuente de verdad clara y hace que las actualizaciones sean predecibles.

Si el shell genera errores de permiso durante la instalación global, corrige el prefijo global de npm o utiliza un gestor de versiones de Node en lugar de forzar sudo en el flujo de trabajo. Una CLI que necesita privilegios elevados para actualizar es un mal predeterminado en las máquinas de desarrollo.

Paso 3: Confirma que el binario esté en PATH

Ejecuta:

claude --version

Si el shell no puede encontrar claude, probablemente npm instaló el binario en un directorio que no está exportado en PATH. Eso es un problema del shell, no de Claude, así que corrige la ruta del binario global de npm antes de intentar reinstalar.

Una reinstalación rara vez ayuda si el directorio del binario es invisible para el shell. Revisa el prefijo de npm y la configuración del binario global, luego confirma que el directorio correspondiente esté cargado por el archivo de inicio del shell actual como .zshrc, .bashrc o la configuración del shell usada por la imagen de la estación de trabajo.

Probar con una terminal nueva es la verificación más sencilla. Si claude --version solo funciona en una sesión, el cambio de ruta se aplicó manualmente en lugar de ser persistente en la configuración del shell.

Paso 4: Autenticar y abrir un proyecto

Cámbiate al repositorio que deseas que Claude Code inspeccione, luego inicia la CLI:

cd /ruta/al/proyecto
claude

La CLI solicitará autenticación si la máquina no ha iniciado sesión aún. Ejecutarla desde el repositorio objetivo es mejor que abrirla en otro lugar porque la conciencia de archivos depende del directorio de trabajo actual.

Este es el primer lugar donde la calidad de la instalación se encuentra con la utilidad real. Un lanzamiento exitoso desde un directorio incorrecto solo prueba que el binario funciona, mientras que un lanzamiento dentro del repositorio demuestra que la herramienta puede ver los archivos que importan.

La autenticación debe considerarse como un punto de control separado de la instalación. Si claude inicia pero la sesión falla, el paquete está instalado correctamente y la próxima solución pertenece al acceso a la cuenta, política de red o flujo de autenticación basado en navegador en lugar de npm.

Paso 5: Dale una tarea acotada

Comienza con un prompt específico como revisar un módulo, explicar una prueba fallida o proponer una refactorización para un archivo. Las tareas pequeñas exponen problemas de permisos, problemas de acceso al repositorio y calidad del prompt más rápido que solicitudes amplias como “mejorar esta base de código.”

Un buen primer prompt es: “Resume la arquitectura de este repositorio e identifica el lugar más seguro para añadir un nuevo endpoint de API.” Esto prueba la lectura del repositorio, la comprensión del código y la salida práctica en una sola pasada.

Los prompts acotados son mejores porque crean una condición de éxito clara. Si la respuesta identifica mal los puntos de entrada, ignora pruebas o inventa archivos, el equipo se entera de inmediato que el contexto o los permisos necesitan trabajo antes de confiar en las ediciones.

Los prompts amplios ocultan una mala configuración detrás de una salida vaga. Una tarea precisa obliga a la CLI a demostrar que Claude code install no solo está completo, sino que realmente es útil en el repositorio donde los desarrolladores planean usarlo.

Primero, intenta esto

Pide a Claude Code que inspeccione el repositorio actual y produzca un breve mapa de directorios, puntos de entrada y comandos de prueba. Esto es mejor que pedir ediciones primero porque los equipos pueden verificar la calidad del contexto antes de que la herramienta escriba algo.

Ejemplo de prompt: “Lee este repositorio y lista los principales servicios, el comando de desarrollo local y la área de mayor riesgo para cambiar.”

Una tarea de orientación solo de lectura es la primera ejecución más segura porque revela qué tan bien la CLI entiende la estructura, la nomenclatura y los flujos de trabajo de los desarrolladores. Si el resumen coincide con el repositorio, el entorno está listo para tareas de mayor confianza como propuestas de parches, correcciones de pruebas o refactorizaciones.

Esto también proporciona a los equipos un prompt base para la incorporación. Reutilizar la misma primera tarea en diferentes máquinas facilita detectar si un problema proviene del repositorio, de la cuenta o de la configuración del shell de un desarrollador.

Errores comunes

• Instalar Node pero no exponer el directorio binario global de npm. Si claude --version falla después de la instalación de npm, revisa el prefijo de npm y la configuración del binario global en lugar de reinstalar el paquete repetidamente.
• Usar sudo npm install -g como la primera solución. Esto puede dejar archivos propiedad de root en la ruta del paquete global y dificultar las actualizaciones posteriores más que el problema original.
• Ejecutar Claude fuera del repositorio. La CLI funciona mejor con el proyecto como directorio actual; de lo contrario, las referencias de archivos se vuelven vagas o inútiles.
• Comenzar con una tarea enorme. “Auditar este monolito completo” es un mal primer prompt porque oculta problemas de configuración detrás de una salida genérica.
• Codificar detalles del plan en documentos internos. Revisa la página oficial de precios de Anthropic en su lugar: https://www.anthropic.com/pricing.

Los nombres de los paquetes, comandos y documentos oficiales pueden cambiar, así que verifica el comando actual de Claude code install en la documentación de Anthropic antes de incluirlo en la incorporación del equipo. Para la mayoría de los equipos de desarrollo, npm es el predeterminado correcto porque es simple, programable y más fácil de auditar que wrappers personalizados o binarios copiados.