¿Qué es Claude Code y por qué instalarlo en tu VPS?

Claude Code es el asistente de programación de línea de comandos de Anthropic: entiende tu proyecto, escribe y corrige código, y ejecuta tareas de desarrollo directamente desde la terminal. Instalarlo en tu VPS te permite trabajar (o automatizar tareas de desarrollo) directamente en el servidor donde vive tu proyecto, sin depender de tu máquina local.

Paso 1 — Conecta por SSH a tu VPS

ssh usuario@tu-ip-vps

Paso 2 — Instala Claude Code

El método recomendado es el instalador nativo: no requiere Node.js ni dependencias adicionales y se actualiza solo.

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

Al finalizar, cierra y vuelve a abrir la sesión SSH (o ejecuta source ~/.bashrc) para que el comando claude quede disponible en el PATH.

Paso 3 — Autentícate (elige una opción)

Tu VPS no tiene navegador, así que la autenticación por defecto necesita uno de estos dos caminos:

Opción A — Tienes suscripción Claude (Pro/Max/Team/Enterprise): en el propio VPS ejecuta:

claude setup-token

El comando te dará una URL de autorización. Ábrela en el navegador de tu computadora o celular (donde ya tengas sesión iniciada en Claude), aprueba el acceso, y copia el token que se genera (válido por 1 año). Luego, en el VPS:

export CLAUDE_CODE_OAUTH_TOKEN="el-token-que-copiaste"
echo 'export CLAUDE_CODE_OAUTH_TOKEN="el-token-que-copiaste"' >> ~/.bashrc

Opción B — Tienes una API Key de la Consola de Anthropic (console.anthropic.com):

export ANTHROPIC_API_KEY="tu-api-key"
echo 'export ANTHROPIC_API_KEY="tu-api-key"' >> ~/.bashrc

Esta opción salta por completo el flujo OAuth y es la más simple para automatización.

Paso 4 — Verifica la instalación

claude --version
claude doctor

claude doctor revisa tu configuración, conexión a la API y estado de autenticación, y te avisa si algo falta.

Paso 5 — Primeros comandos

Entra a la carpeta de tu proyecto e inicia una sesión interactiva:

cd /ruta/a/tu/proyecto
claude

Para una tarea puntual sin sesión interactiva (modo headless, ideal para scripts):

claude -p "revisa este proyecto y dime qué tecnologías usa"

Consejos para uso en VPS

• Sesiones persistentes: usa tmux o screen para que Claude Code siga corriendo aunque se corte tu conexión SSH — tmux new -s claude y luego claude dentro de esa sesión.
• Actualizaciones: el instalador nativo se actualiza solo en segundo plano. Para forzar una actualización manual: claude update.
• Seguridad: si usas ANTHROPIC_API_KEY, no la dejes en texto plano accesible por otros usuarios del servidor — restringe permisos con chmod 600 al archivo donde la guardes.
• Node.js opcional: no lo necesitas para el instalador nativo, pero sí si vas a usar servidores MCP basados en npx.