Source: https://aiprimetech.io/es/claude-code/install/ [Inicio](/es/) › [Claude Code](/es/claude-code/) › Instalación [Descripción general](/es/claude-code/)[Instalación](/es/claude-code/install/)[referencia de la CLI](/es/claude-code/cli/)[Precios y límites](/es/claude-code/pricing/)[Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins](/es/claude-code/skills/)[GitHub](/es/claude-code/github/)[Web, escritorio e IDE](/es/claude-code/web-and-desktop/)[Modelos](/es/claude-code/models/)[Errores](/es/claude-code/errors/)[¿Código abierto?](/es/claude-code/open-source/)[Tutorial](/es/claude-code/tutorial/)[Para estudiantes](/es/claude-code/for-students/)[Automatización de QA](/es/claude-code/qa-automation/)[Comparación con Cursor](/es/claude-code/vs-cursor/)[Comparación con Codex y OpenCode](/es/claude-code/vs-codex/)[Subagentes](/es/claude-code/subagents/)[Hooks](/es/claude-code/hooks/)[MCP](/es/claude-code/mcp/)[Ecosistema](/es/claude-code/ecosystem/)[VS Code](/es/claude-code/vscode/)[OpenRouter](/es/claude-code/openrouter/)[Límites de solicitudes](/es/claude-code/rate-limits/)[Guía en chino](/claude-code/zh/) Última actualización: 11 de octubre de 2026 # Cómo instalar Claude Code Hay tres formas admitidas de instalar Claude Code en un equipo. Elige una; todas proporcionan el mismo comando claude . ## TLDR - npm: npm install -g @anthropic-ai/claude-code (requiere Node.js 18 o posterior). - Instalador nativo: un comando curl (macOS/Linux) o una línea de PowerShell (Windows); no requiere Node. - Verifica la instalación con claude --version, después define ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY para usar esta pasarela. ## 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 --version ``` Si 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.cmd ``` ## Instalar 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 claude ``` Coloca 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-code ``` ## Si 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 version errores → se requiere Node.js 18 o posterior; usa node -v para 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_key ``` [Crea una cuenta con el código CLAUDECODE](/register?promo=CLAUDECODE) ## Preguntas 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](/register?promo=CLAUDECODE) [Ver planes ilimitados](/es/plans/) AI 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. ## Más guías de Claude Code [Claude Code: la guía completa](/es/claude-code/)[Documentación de la CLI de Claude Code: comandos y opciones](/es/claude-code/cli/)[Precios y límites de Claude Code, explicados](/es/claude-code/pricing/)[El SDK de Claude Code, ahora Claude Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins de Claude Code](/es/claude-code/skills/)[Claude Code en GitHub: la App, la Action y @claude](/es/claude-code/github/)[¿Claude Code tiene una interfaz web? Explicación de las versiones web, de escritorio y para IDE](/es/claude-code/web-and-desktop/)[Qué modelo utiliza Claude Code y cómo cambiarlo](/es/claude-code/models/)[Errores de Claude Code y cómo solucionarlos](/es/claude-code/errors/)[¿Claude Code es de código abierto?](/es/claude-code/open-source/)[Tutorial de Claude Code: tu primera sesión real](/es/claude-code/tutorial/)[Claude para estudiantes: Claude Code, la API y qué ofrece realmente el ámbito educativo](/es/claude-code/for-students/)[Cómo usar Claude Code para automatizar QA](/es/claude-code/qa-automation/)[Claude Code frente a Cursor: cuál usar, cuándo y cómo ejecutar ambos](/es/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparativa de los agentes de terminal](/es/claude-code/vs-codex/)[Subagentes de Claude Code: cómo funcionan, cómo definirlos y equipos de agentes](/es/claude-code/subagents/)[Hooks de Claude Code: control determinista sobre lo que hace el agente](/es/claude-code/hooks/)[MCP en Claude Code: conexión de servidores, ámbitos, MCP remoto y ejemplos reales](/es/claude-code/mcp/)[El ecosistema de Claude Code: enrutadores, frameworks, plugins y las listas que los recopilan](/es/claude-code/ecosystem/)[Claude Code en VS Code: la extensión, el uso desde la terminal y los errores](/es/claude-code/vscode/)[Cómo usar OpenRouter en Claude Code (y cuándo no hacerlo)](/es/claude-code/openrouter/)[Error de límite de solicitudes de Claude: qué significa «Error de API: se ha alcanzado el límite de solicitudes» y cómo solucionarlo](/es/claude-code/rate-limits/)[Cómo usar Claude Code: desde la instalación hasta el uso diario](/claude-code/zh/)