// Tutorial — Primeros pasos

Cómo instalar Claude Code

Todo lo que necesitas para tener Claude Code funcionando, ya sea en tu computadora local o en un servidor VPS listo para usar. Incluye cómo obtener tu API key.

Por Esteban Cervi Actualizado: marzo 2026 Tiempo estimado: 20 min

// Contenidos

  1. ¿Local o VPS?
  2. Requisitos previos
  3. Instalación local — paso a paso
  4. VPS en Neolo (todo preconfigurado)
  5. API key y plan Claude Code Pro
  6. Primer uso

¿Local o VPS?

Antes de comenzar, elige dónde vas a correr Claude Code. Las dos opciones funcionan, pero tienen perfiles distintos:

★ Recomendada

Instalación local

En tu propia computadora. Más control, sin costo de servidor, y es la forma en que la mayoría de los builders comienzan.

Para avanzados

VPS en Neolo

Servidor en la nube con todo preconfigurado: Claude Code, Git, Node.js y Nginx listos para usar desde el primer día.

// Recomendación Si estás comenzando, arranca con la instalación local. Si quieres un entorno dedicado, siempre encendido y accesible desde cualquier lugar, el VPS es la mejor opción.

Requisitos previos (instalación local)

Antes de instalar Claude Code, asegúrate de tener lo siguiente en tu sistema:

Verificar si ya tienes Node.js

Abre tu terminal y ejecuta:

node --version npm --version

Si aparecen versiones (ej. v20.11.0), ya tienes Node instalado. Si no, sigue el paso siguiente.

Instalar Node.js

La forma más sencilla es con el instalador oficial:

# Instalar nvm (Mac/Linux) curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # Luego instalar Node LTS nvm install --lts nvm use --lts

Instalación local — paso a paso

  1. Instalar Claude Code globalmente con npm

    Abre tu terminal y ejecuta el siguiente comando:

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

  1. Verificar la instalación

    Confirma que Claude Code se instaló correctamente:

claude --version

  1. Configurar tu API key

    Claude Code necesita tu API key para funcionar. Configúrala como variable de entorno:

# Mac / Linux — agrega esta línea a tu ~/.bashrc o ~/.zshrc export ANTHROPIC_API_KEY="tu-api-key-aqui" # Luego recarga tu terminal source ~/.zshrc # Windows (PowerShell) $env:ANTHROPIC_API_KEY="tu-api-key-aqui"

  1. Iniciar Claude Code

    Navega a cualquier proyecto y lanza Claude Code:

cd tu-proyecto claude
// Tip La primera vez que ejecutas claude, el proceso de autenticación es guiado. Si ya configuraste la variable de entorno con tu API key, es automático.

VPS en Neolo (todo preconfigurado)

Si quieres un entorno en la nube siempre disponible, sin tener que instalar ni configurar nada, una excelente opción es contratar el VPS 3 de Neolo con Claude Code preinstalado.

Opción recomendada

VPS 3 — Neolo

Neolo es un proveedor de hosting y servidores con soporte en español. El VPS 3 viene con todo lo necesario para trabajar con Claude Code desde el primer día, sin fricciones.

Claude Code preinstalado Node.js incluido Git listo para usar Nginx configurado Soporte en español Acceso SSH inmediato

Ideal para trabajar desde cualquier dispositivo, dejar procesos corriendo en segundo plano, o alojar los proyectos que construyes directamente en el mismo servidor.

Ver VPS 3 en Neolo →

Primeros pasos en el VPS

Una vez que tienes tu VPS, accede por SSH y verifica que todo esté listo:

# Conectarse al VPS ssh usuario@tu-ip-del-vps # Verificar las herramientas preinstaladas node --version # debería mostrar v20+ git --version # debería mostrar git 2.x claude --version # Claude Code listo nginx -v # Nginx instalado
# Solo resta configurar tu API key export ANTHROPIC_API_KEY="tu-api-key-aqui" echo 'export ANTHROPIC_API_KEY="tu-api-key-aqui"' >> ~/.bashrc source ~/.bashrc
// Nota Si el VPS no incluye Claude Code al momento de contratarlo, puedes instalarlo fácilmente con npm install -g @anthropic-ai/claude-code una vez conectado por SSH.

API key y plan Claude Code Pro

Para usar Claude Code necesitas dos cosas: una API key de Anthropic y un plan activo. El plan recomendado para builders que quieren construir proyectos reales es el Claude Code Pro.

Plan Claude Code Pro — $20/mes

El plan Pro de Claude Code cuesta USD $20 por mes e incluye:

// Importante El plan Claude Code Pro ($20/mes) es diferente a la API de pago por uso. Con el plan Pro tienes acceso directo a Claude Code como herramienta. Si quieres consumir la API programáticamente para tus proyectos, necesitas créditos en Anthropic Console por separado.

Cómo darse de alta

  1. Crear una cuenta en Anthropic

    Ir a claude.ai y registrarse con tu email. Es gratuito.

  2. Suscribirse al plan Pro

    Desde tu perfil en claude.ai, ir a la sección de planes y elegir el plan Pro por $20/mes. Se puede pagar con tarjeta de crédito internacional.

  3. Obtener tu API key

    Ir a console.anthropic.com → "API Keys" → "Create Key". Copiar la clave y guardarla en un lugar seguro (no se puede recuperar después).

  4. Configurar la API key en tu entorno

    Pegar la API key en la variable de entorno ANTHROPIC_API_KEY como se explica más arriba. Claude Code estará listo para usar.

// Seguridad Nunca compartas tu API key públicamente, no la subas a GitHub, y no la incluyas directamente en el código. Siempre usa variables de entorno o archivos .env incluidos en el .gitignore.

Primer uso — Probá que funciona

Con todo configurado, crea un directorio de prueba y lanza Claude Code:

# Crear un proyecto de prueba mkdir mi-primer-proyecto cd mi-primer-proyecto git init # Lanzar Claude Code claude

Claude Code analiza el directorio y estará listo para ayudarte a construir. Puedes pedirle cosas como:

// Pro tip de la comunidad Siempre inicia Claude Code desde la raíz de tu proyecto con Git inicializado. Claude Code usa el contexto del repositorio para entender mejor lo que estás construyendo y mantener coherencia entre sesiones.

¿Quedó alguna duda? Únete al grupo de WhatsApp de Claudio Builders y pregunta a la comunidad. Alguien ya lo resolvió antes.

Unirse a la comunidad ← Volver al inicio