Node.js para Claude Code: qué versión usar y cómo prescindir de él
La instalación con npm requiere Node.js 18 o posterior; usa node -v para comprobarlo y nvm (nvm install --lts) para corregirlo. Una versión antigua de Node es el motivo más habitual por el que una instalación nueva no arranca. Si Node no forma parte de tus herramientas de desarrollo, prescinde de él: el instalador nativo que aparece a continuación incluye un binario independiente que se actualiza automáticamente.
Opción 1 — npm (cualquier sistema operativo con Node.js 18 o posterior)
npm install -g @anthropic-ai/claude-code
claude --versionSi npm install -g falla con EACCES en macOS o Linux, no uses sudo; corrige el prefijo de npm: npm config set prefix ~/.npm-global y añade ~/.npm-global/bin a tu PATH. En Windows, ejecuta la instalación desde una terminal normal (sin privilegios de administrador).
Opción 2 — instalador nativo para Mac, Linux y Windows (sin Node.js)
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex# Windows CMD (the one-liner people search for)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdInstalar Claude Code en Linux y Ubuntu
En Ubuntu, Debian, Fedora o cualquier distribución: el instalador nativo (curl -fsSL https://claude.ai/install.sh | bash) coloca un binario que se actualiza automáticamente en tu directorio personal y no requiere privilegios de root ni Node.js. Si prefieres npm, instala primero Node 18 o posterior desde NodeSource o nvm —la versión de Node disponible mediante apt en Ubuntu suele ser demasiado antigua— y después npm install -g @anthropic-ai/claude-code. En un servidor con acceso solo por terminal o en un contenedor, el binario nativo es la mejor opción; añade las dos variables de la pasarela a ~/.bashrc y funcionará por SSH exactamente igual que en local.
La versión nativa se actualiza automáticamente y evita conflictos entre versiones de Node. Es la mejor opción en equipos donde Node aún no forma parte de tus herramientas de desarrollo.
Opción 3 — aplicación de escritorio o extensión de IDE
La aplicación de escritorio de Claude incluye Claude Code, y las extensiones de VS Code y JetBrains instalan la CLI la primera vez que las usas. Consulta la guía de web, escritorio e IDE para saber qué permite y qué no permite cada interfaz.
Notas sobre Windows
Claude Code se ejecuta de forma nativa en Windows 10/11 (PowerShell o Git Bash) y dentro de WSL. WSL ofrece una experiencia más fluida para proyectos que presuponen un shell de Unix. Si claude no se encuentra después de instalarlo con npm en Windows, abre una nueva terminal para que se vuelva a leer PATH, o comprueba npm config get prefix y añade su carpeta bin .
Ejecutar Claude Code sin iniciar sesión: autenticarse con una clave de API
Ejecuta claude y elige /login para iniciar sesión con una suscripción Claude Pro/Max, o prescinde por completo del inicio de sesión. Si ANTHROPIC_API_KEY (o ANTHROPIC_AUTH_TOKEN) está definido, Claude Code nunca muestra la pantalla de inicio de sesión y se ejecuta localmente contra el endpoint indicado por ANTHROPIC_BASE_URL, que es también como funciona en equipos que no pueden abrir un navegador. Para esta pasarela, usa la opción de la clave:
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key # or ANTHROPIC_AUTH_TOKEN
claudeColoca esas dos líneas en ~/.zshrc, ~/.bashrc o en tu perfil de PowerShell para que estén disponibles en cada nueva terminal. Dentro de Claude Code, /status muestra qué endpoint y qué clave están activos.
Cómo actualizar y desinstalar Claude Code
claude update # native / self-update
npm update -g @anthropic-ai/claude-code # npm install
npm uninstall -g @anthropic-ai/claude-codeSi la instalación se completó correctamente, pero Claude Code no arranca
command not found→ PATH: abre un nuevo shell o añade el directorio global de binarios de npm.Node versionerrores → se requiere Node.js 18 o posterior; usanode -vpara comprobarlo, o cambia al instalador nativo.- Se queda bloqueado en el primer inicio → proxy corporativo; define HTTPS_PROXY o la URL base de la pasarela si tu red bloquea api.anthropic.com.
401/ clave no válida → la clave debe ser una clave de la pasarela cuando ANTHROPIC_BASE_URL apunta aquí; se rechazará una clave de la consola de Anthropic.
Pruébalo gratis primero
Las cuentas nuevas reciben $5 de crédito gratuito para la API con el código CLAUDECODE — suficiente para una tarde de Claude Code con Sonnet — y después créditos por 7.69231× su valor nominal.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyPreguntas frecuentes
¿Necesito Node.js para instalar Claude Code?
Solo para la instalación mediante npm. El instalador nativo (curl en macOS/Linux, PowerShell en Windows) y la aplicación de escritorio no necesitan Node.
¿Claude Code funciona en Windows?
Sí, de forma nativa en PowerShell o Git Bash, y dentro de WSL. Se recomienda WSL para proyectos orientados a Unix.
¿Puedo instalar Claude Code sin una suscripción a Claude?
Sí. La instalación es gratuita; autentícate con una clave de API en lugar de /login. Una clave de la pasarela de este sitio funciona como sustituto directo.
Ejecuta Claude Code con la pasarela
Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código CLAUDECODE.
Obtener una clave de API Ver planes ilimitadosAI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.