Ir al contenido
Mastering Claude

Inicio / Una instalación estructurada

Una instalación estructurada10 minApplication

Instalar, conectarse y primer lanzamiento

El instalador nativo de Claude Code se actualiza solo, la conexión se hace mediante una suscripción Pro, Max, Team, Enterprise o Console en lugar de una clave API olvidada en el entorno, y claude doctor entrega un diagnóstico de solo lectura antes de cualquier corrección.

Cuatro comandos instalan Claude Code según el sistema operativo, pero solo uno se actualiza solo. En macOS, Linux y WSL, el comando nativo es curl -fsSL https://claude.ai/install.sh | bash. En PowerShell, es irm https://claude.ai/install.ps1 | iex. La documentación de Anthropic, consultada el 2 de septiembre de 2026, precisa que las instalaciones nativas se actualizan automáticamente en segundo plano para mantenerse en la última versión.

Otros tres métodos, sin actualización automática

Homebrew instala Claude Code mediante brew install --cask claude-code, con dos canales posibles según el cask elegido, la versión estable o la última disponible, pero ninguno de los dos se actualiza solo. WinGet, en Windows, propone winget install Anthropic.ClaudeCode, la misma constatación. npm instala la versión global mediante npm install -g @anthropic-ai/claude-code, y el paquete exige desde la versión 2.1.198 de Claude Code Node.js 22 o más reciente, sin que eso sea bloqueante en una versión más antigua: npm muestra entonces una advertencia EBADENGINE durante la instalación, pero esta termina y claude funciona de todos modos, ya que el paquete descarga un binario nativo que no usa Node.js en tiempo de ejecución. Estos tres métodos convienen cuando ya existe un gestor de paquetes en el equipo y debe seguir siendo la única fuente de verdad sobre lo que hay instalado ahí, al precio de una actualización que hay que relanzar uno mismo.

Conectarse mediante la suscripción, no mediante una clave olvidada

Claude Code exige una cuenta Pro, Max, Team, Enterprise o Console, el plan gratuito de Claude.ai no abre ese acceso, según la misma documentación, que añade una alternativa distinta de la suscripción, un proveedor de API externo como Amazon Bedrock, Google Cloud Agent Platform o Microsoft Foundry. Una clave ANTHROPIC_API_KEY ya presente en el entorno del equipo no se ignora ni se usa en silencio: Claude Code pide una sola vez que la apruebes, en lugar de abrir un navegador para la conexión mediante suscripción. Lanza la primera llamada desde la carpeta del proyecto que quieres que Claude lea, el aviso de conexión aparece en ese momento, antes de la primera respuesta.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows, PowerShell
irm https://claude.ai/install.ps1 | iex

# Diagnóstico de solo lectura, sin abrir sesión
claude doctor

El primer reflejo después de la instalación

El comando claude doctor, o su alias /checkup desde dentro de una conversación, verifica el estado de la instalación, los duplicados, los problemas de PATH, los archivos de configuración ilegibles, y propone una corrección solo después de haber informado lo que encontró. Desde la terminal, permanece en modo de solo lectura y no inicia ninguna sesión. Es el punto de partida más fiable para juzgar una instalación antes de construir lo que sea sobre ella, en lugar de adivinar a partir de un mensaje de error aislado. El mapa del módulo ubica este primer elemento, el motor instalado y conectado, antes de los otros seis.

Figure 1

Cuatro métodos de instalación, uno al lado del otro

Método de instalaciónActualizaciónAlcanceRequisito previo
Instalador nativo (curl / irm)Automática, en segundo planoCuenta de usuario actual del equipoNo requiere gestor de paquetes
Homebrew (macOS)Manual, mediante brew upgradeDepende del cask elegido, stable o latestHomebrew ya instalado en el equipo
WinGet (Windows)Manual, mediante winget upgradeCuenta de Windows actualWinGet ya instalado en el equipo
npm globalManual, mediante npm update -gAlcance del gestor Node del equipoNode.js 22 o más reciente desde la versión 2.1.198, no bloqueante, advertencia EBADENGINE en caso contrario
La tabla cruza cada método de instalación con su actualización, su alcance y su requisito previo, para mostrar que solo el método nativo se actualiza sin un comando relanzado a mano.
Calíbralo tú mismo

Un administrador instala Claude Code en un equipo con el comando curl proporcionado por la documentación, y luego lanza claude por primera vez desde la carpeta de su proyecto. El aviso de conexión le propone varias opciones, y elige su cuenta Pro existente.

Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.

Lo que hay que recordar
  • El instalador nativo se actualiza solo en segundo plano, mientras que Homebrew, WinGet y npm exigen cada uno un comando de actualización relanzado a mano.
  • Una cuenta de Claude Code exige una suscripción Pro, Max, Team, Enterprise o Console, el plan gratuito de Claude.ai no abre ese acceso.
  • Una clave ANTHROPIC_API_KEY ya presente en el entorno no se ignora ni se usa en silencio, dispara una solicitud de aprobación única en lugar de la apertura del navegador.
  • El comando claude doctor plantea un diagnóstico de solo lectura sin abrir sesión, y su alias /checkup dispara el mismo control desde dentro de una conversación.
  • Desde la versión 2.1.198, npm pide Node.js 22 o más reciente sin que eso sea bloqueante: en una versión más antigua, la instalación termina de todos modos tras una advertencia EBADENGINE.
Hazlo ahora

Lanza claude doctor en tu terminal ahora mismo y anota las tres primeras líneas que muestra, antes de corregir nada: es tu punto de partida medido para el resto del mapa.

Verificar en la fuente

Cada afirmación datable de esta lección remite aquí al texto público que la respalda. Una fuente que no se abre no prueba nada.