Instalar Claude — guía completa app desktop + CLI por terminal

Dos caminos según tu nivel#

Los dos son gratis empezar. Plan Free para probar, después upgradeás a Pro/Max si necesitás más uso (ver cuál plan Claude).

Camino A — App Desktop (recomendado para empezar)#

Descargar#

claude.ai/download — el sitio detecta tu OS y te muestra el botón correcto.

Soporta:

• macOS 13+
• Windows 10 (1809+)

Instalar#

Login#

Primera vez que la abrís te pide cuenta. Si no tenés, creala gratis — empezás en plan Free.

Qué te da la app desktop#

3 herramientas en una sola interfaz:

Camino B — Claude Code por terminal (para devs)#

Requisitos previos#

Instalación nativa#

macOS / Linux / WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Instalación con package manager#

Homebrew (macOS):

brew install --cask claude-code

WinGet (Windows):

winget install Anthropic.ClaudeCode

Lo que NO instalar#

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

Está deprecado. Si venís de tutoriales viejos, no uses ese método.

Primer arranque#

En un proyecto existente#

cd ~/proyectos/mi-app
claude

Crear proyecto nuevo#

mkdir mi-proyecto && cd mi-proyecto && claude

Flujo de autenticación#

1. Al correr claude, se abre flow de login
2. Elegí método:
   • Claude App (más común, login con tu cuenta)
   • Console (para API)
   • Bedrock (AWS enterprise)
   • Vertex AI (GCP enterprise)
3. Termina login
4. Listo — podés pedir tareas

Verificación#

Versión instalada#

claude --version

Debería mostrarte algo como 2.1.x.

Diagnóstico completo#

claude doctor

Te chequea:

• Versión
• Permisos
• Conexión a Anthropic
• Plugins instalados
• Configuración

Si no marca errores críticos, entorno listo.

Los comandos básicos#

Actualizar Claude Code#

Si instalaste con curl/irm (nativo)#

Actualizaciones automáticas en segundo plano. No tenés que hacer nada.

Con Homebrew#

brew upgrade claude-code

Con WinGet#

winget upgrade Anthropic.ClaudeCode

App Desktop#

Auto-update cuando la abrís. Si está vieja, te ofrece update.

Cuándo elegir cada camino#

App Desktop ideal si:#

✅ Nunca tocaste terminal en tu vida ✅ Querés probar Claude rápido sin setup ✅ Te interesa Cowork (proyectos, tareas programadas) ✅ Usás Dispatch desde celular ✅ Trabajás en multi-tab (chat + code + cowork)

Claude Code CLI ideal si:#

✅ Ya vivís en terminal (tmux, vim, neovim) ✅ Trabajás mucho con git ✅ Querés integrar con tu workflow de dev existente ✅ Te molestan las apps gráficas pesadas ✅ Usás múltiples proyectos en paralelo (cd entre ellos)

Ambos no se excluyen. La app desktop instala el CLI por debajo. Podés usar los dos.

Anti-patrones de instalación#

1. Usar tutoriales antiguos con npm install -g#

Deprecado. Usá curl o brew/winget.

2. Instalar sin verificar requisitos#

Si tu OS no está soportado, vas a chocar. Verificá primero.

3. Sin Git en Windows#

Sin Git for Windows, varios features de Claude Code rompen. Instalalo primero.

4. Olvidarse del país soportado#

Algunos países tienen restricciones por compliance. Si te tira "country not supported", necesitás VPN (con cuidado: viola TOS de Anthropic).

5. No verificar con claude doctor#

claude doctor te dice si algo no anda antes de empezar a trabajar. Corrélo después de instalar.

Troubleshooting común#

"command not found: claude"#

Path no incluye Claude. En macOS/Linux, verificá:

echo $PATH | tr ':' '\n' | grep -i claude

Si no aparece, agregalo a tu ~/.zshrc o ~/.bashrc.

"Cannot connect to Anthropic"#

Verificá:

• Internet funciona
• Tu país está soportado
• No hay firewall corporativo bloqueando

Versión vieja después de upgrade#

A veces el package manager no fuerza upgrade real:

brew uninstall claude-code
brew install --cask claude-code

Permisos de macOS#

Primera vez te puede pedir permisos de accesibilidad (para Computer Use, hooks, etc.). Acceptá en System Preferences → Security → Privacy.

Próximos pasos según tu objetivo#

Querés ahorrar tokens desde día 1#

Después de instalar, leé setup zero y Token Efficient.

Vas a trabajar con código#

Guía Claude Code completa y 5 skills equipo dev.

Querés saber cómo hablarle bien#

Hablarle a Claude y mejores prácticas Claude.

Vas a usar agentes#

Crear agentes con Claude y crear skills.

Fuentes oficiales#

• Descargas: claude.ai/download
• Planes: claude.ai/pricing
• Docs CLI: code.claude.com/docs
• Quickstart: code.claude.com/docs/en/quickstart

Próximos pasos#

• Para setup post-instalación con buenas prácticas, setup zero
• Para entender qué plan elegir, cuál plan Claude
• Para aprender a hablarle a Claude desde el primer día, hablarle a Claude