01 Qué hace exactamente este instalador
Instalar Claude Code a mano no es difícil, pero tiene dos tropiezos clásicos para quien no viene del desarrollo: abrir la terminal correcta y el mensaje claude: command not found porque el PATH no se ha recargado. claude-cmd automatiza esos pasos sin sustituir nada de Anthropic.
-
1
Llama al instalador oficial
Por debajo ejecuta el instalador nativo de Anthropic (claude.ai/install.sh en Mac y Linux, claude.ai/install.ps1 en Windows). El programa que acabas usando es el mismo que instalarías a mano.
-
2
Comprueba la instalación y el PATH
Verifica que el binario quedó en tu carpeta de usuario y corrige el PATH si hace falta. No pide permisos de administrador ni instala Node.
-
3
Crea el acceso directo
Genera en tu ordenador un lanzador «Claude Terminal» con icono propio que llama al binario por su ruta completa, así funciona sin reiniciar la terminal.
02 Antes de empezar
- ✓Una suscripción de pago: el plan gratuito no incluye Claude Code.
- ✓Mac con macOS 13 o superior, Windows 10 versión 1809 o superior de 64 bits, o Linux de 64 bits con glibc (Ubuntu, Debian, Fedora, Arch…). Alpine y otras distribuciones con musl no sirven.
- ✓Conexión a internet durante la instalación.
- ✓Cinco minutos para leer el script antes de ejecutarlo (recomendado).
03 Instalarlo según tu sistema
Mac. Abre la app Terminal (Cmd + Espacio, escribe «Terminal») y pega el comando. Es la vía recomendada porque no descarga un archivo y macOS no muestra ningún aviso de seguridad.
curl -fsSL https://raw.githubusercontent.com/Hainrixz/claude-cmd/main/install-mac.command | bashWindows. Puedes descargar install-windows.bat del repositorio y hacer doble clic, o abrir PowerShell (no CMD) y pegar el comando. Si SmartScreen avisa, pulsa «Más información» y «Ejecutar de todas formas».
irm https://raw.githubusercontent.com/Hainrixz/claude-cmd/main/install-windows.ps1 | iexLinux. Pega el comando en la terminal. En escritorios como GNOME, KDE o XFCE aparecerá «Claude Terminal» en el menú de aplicaciones; en servidores o WSL instala Claude igual y omite el icono.
curl -fsSL https://raw.githubusercontent.com/Hainrixz/claude-cmd/main/install-linux.sh | bash04 La primera vez que lo abres
-
1
Abre «Claude Terminal»
Doble clic en el escritorio (o desde el menú de aplicaciones en Linux).
-
2
Inicia sesión
Al arrancar Claude Code por primera vez se abre el navegador. Entra con tu cuenta de Claude y vuelve a la terminal.
-
3
Elige la carpeta del proyecto
Selecciona dónde quieres trabajar. Claude solo verá esa carpeta y sus subcarpetas, así que no abras tu carpeta personal entera si no hace falta.
-
4
Comprueba que todo está bien
En cualquier terminal, ejecuta claude doctor: muestra un diagnóstico de la instalación y de la configuración sin abrir sesión.
Acabo de instalar Claude Code y no programo habitualmente. Explícame en cinco puntos qué hay en esta carpeta, qué podrías hacer aquí por mí y qué acciones te pedirán confirmación antes de ejecutarse. No modifiques nada todavía.05 La opción de saltar permisos
El panel ofrece una «sesión avanzada» que arranca Claude con --dangerously-skip-permissions: crea, edita y borra archivos y ejecuta comandos sin preguntarte. Viene desactivada y se elige sesión a sesión. La documentación oficial reserva ese modo para contenedores y máquinas virtuales aisladas.
06 Problemas frecuentes
| Síntoma | Solución |
|---|---|
| claude: command not found | Cierra y abre la terminal (o source ~/.zshrc en Mac, source ~/.bashrc en Linux). El acceso directo funciona igualmente. |
| Aviso de Gatekeeper en Mac al abrir el archivo descargado | Usa el comando de Terminal, o ve a Ajustes del Sistema › Privacidad y seguridad › «Abrir de todos modos». El truco de clic derecho › Abrir ya no funciona desde Sequoia. |
| irm no se reconoce (Windows) | Estás en CMD: abre PowerShell. |
| Scripts deshabilitados en Windows | Ejecuta Set-ExecutionPolicy -Scope Process Bypass y repite. El .bat ya lo evita. |
| Versión antigua o instalaciones duplicadas | Desinstala la versión de npm con npm uninstall -g @anthropic-ai/claude-code y vuelve a instalar. |
rm -f ~/.local/bin/claude && rm -rf ~/.local/share/claude
rm -f ~/Desktop/"Claude Terminal.command"Preguntas frecuentes
Es igual de seguro en cuanto al programa, porque usa el instalador oficial. Lo que añades es confianza en el script del repositorio, por eso conviene leerlo antes.
Sí. La vía oficial es curl -fsSL https://claude.ai/install.sh | bash en Mac, Linux y WSL, o irm https://claude.ai/install.ps1 | iex en PowerShell. También hay paquetes para Homebrew y WinGet, que no se actualizan solos.
El binario de Claude Code en tu carpeta de usuario (~/.local/bin en Mac y Linux, %USERPROFILE%\.local\bin en Windows), el acceso directo del escritorio y, una vez que lo usas, tu configuración en ~/.claude y ~/.claude.json. No toca archivos del sistema.
Se instala, pero al iniciar sesión verás que tu cuenta no tiene acceso: Claude Code requiere plan de pago o cuenta de API.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.