Claude Code es el asistente de IA para programar de Anthropic que funciona en el terminal. En el servidor escribe y corrige código, ejecuta comandos y te ayuda a configurar programas. Con la función Remote Control puedes manejar la sesión del servidor desde la aplicación Claude en el ordenador o en el móvil.

Qué necesitas

Qué	Requisitos
Servidor	Ubuntu 22.04, 24.04 o Debian 12, desde 4 GB de RAM – te sirve el plan DE-RZ9-2
Cuenta	Claude Pro, Max, Team o Enterprise. El plan gratuito no incluye Claude Code
Ordenador	Un navegador para iniciar sesión y la aplicación Claude en el PC o el móvil para Remote Control
Acceso	SSH al servidor – cómo conectarte lo explicamos en el artículo sobre Termius

Paso 1. Preparar el servidor

Conéctate al servidor como root, instala git y tmux y crea un usuario aparte. Ejecutar Claude Code como root no hace falta y no es seguro.

apt update && apt install -y git tmux
adduser dev

A partir de aquí trabaja con este usuario – cámbiate a él con su - dev o conéctate al servidor directamente como ssh dev@dirección-IP.

¿Hay que dar permisos sudo al usuario?

Si Claude Code tiene que instalar paquetes o cambiar ajustes del sistema, añade el usuario al grupo sudo con el comando usermod -aG sudo dev. Aun así, cada uno de esos comandos te pedirá confirmación y contraseña. Si Claude solo va a trabajar con código en la carpeta personal, mejor no le des permisos sudo.

Paso 2. Instalar Claude Code

Ejecuta el instalador oficial con el usuario dev:

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

Comprueba la instalación:

claude --version
claude doctor

Si el sistema muestra claude: command not found, vuelve a entrar en el servidor o ejecuta source ~/.profile. No hace falta instalar Node.js, y Claude Code se actualiza solo en segundo plano.

Paso 3. Iniciar sesión en tu cuenta

El servidor no tiene navegador, así que el inicio de sesión se hace a través de tu ordenador. Elige el método que mejor te venga.

Te recomendamos este método, porque es el único con el que funciona el control desde la aplicación (Remote Control). Necesitas un ordenador con navegador y una conexión SSH abierta con el servidor.

1. Inicia Claude Code – conéctate al servidor con el usuario dev, escribe claude y pulsa Enter.
2. Responde a las primeras preguntas – la primera vez, Claude Code te pedirá que elijas un tema de colores. Elige el que quieras con las flechas del teclado y pulsa Enter. Si aparecen pantallas con explicaciones, simplemente pulsa Enter.
3. Elige cómo iniciar sesión – en la lista, elige la primera opción, el inicio de sesión con una cuenta de Claude con suscripción (Claude account with subscription), y pulsa Enter.
4. Copia el enlace – el servidor no puede abrir un navegador, así que Claude Code mostrará un enlace largo. Pulsa la tecla c y el enlace se copiará. Si no funciona, selecciona el enlace entero con el ratón (puede ocupar varias líneas) y cópialo.
5. Abre el enlace en el ordenador – pégalo en la barra de direcciones del navegador, inicia sesión en tu cuenta de Claude y confirma el acceso con el botón Authorize.
6. Copia el código – tras la confirmación, el navegador mostrará un código. Cópialo con el botón que hay junto a él.
7. Pega el código en el servidor – vuelve a la ventana del servidor, donde verás la línea «Paste code here if prompted». Pega el código (en Termius con el botón derecho del ratón, en otros programas con Ctrl+Shift+V o Cmd+V) y pulsa Enter.
8. Listo – aparecerá el mensaje Login successful. Pulsa Enter y se abrirá Claude Code. Si te pregunta si confías en los archivos de esta carpeta, elige «Yes, proceed».

TIP

El código es de un solo uso. Si aparece un error o ha pasado mucho tiempo desde el inicio de sesión, escribe en Claude Code el comando /login y repite los pasos 3–8.

Si ya tienes Claude Code instalado en tu ordenador, puedes generar un token de larga duración (vale aproximadamente un año).

1. En el ordenador, ejecuta claude setup-token, confirma el acceso en el navegador y copia el token.
2. En el servidor, guarda el token en la configuración del shell:

echo 'export CLAUDE_CODE_OAUTH_TOKEN=tu-token' >> ~/.bashrc && source ~/.bashrc

WARNING

Con este token, Claude Code responde a las peticiones, pero no puede iniciar Remote Control. Si piensas trabajar desde la aplicación, inicia sesión con el navegador.

Para pagar según las tarifas de Anthropic Console, crea una clave en platform.claude.com y guárdala en el servidor:

echo 'export ANTHROPIC_API_KEY=tu-clave' >> ~/.bashrc && source ~/.bashrc

WARNING

Con una clave API la función Remote Control no está disponible – solo funciona con una suscripción de Claude.

Paso 4. Trabajar en el terminal

Ve a la carpeta del proyecto e inicia Claude Code:

mkdir -p ~/project && cd ~/project
claude

Describe la tarea con palabras normales, por ejemplo «crea una web sencilla con Flask y ponla en marcha en el puerto 5000». Antes de cambiar archivos o ejecutar comandos, Claude Code te pide permiso.

Comando	Qué hace
claude	Nueva sesión en la carpeta actual
claude --continue	Continuar la última sesión
claude --resume	Elegir una sesión de la lista
/remote-control	Abrir la sesión actual para controlarla desde la aplicación
Shift+Tab	Cambiar el modo de permisos
/exit	Salir de la sesión

Paso 5. Trabajar desde la aplicación (Remote Control)

Remote Control mantiene la sesión en el servidor y tú le escribes desde la aplicación Claude en el ordenador o en el móvil. Para que la sesión no se cierre cuando se desconecte SSH, ejecútala dentro de tmux.

1. Crea una ventana de tmux e inicia Remote Control en la carpeta del proyecto:

tmux new -s claude
cd ~/project && claude remote-control --name "Mi servidor"

La primera vez, confirma que quieres activar la función escribiendo y.

2. Sal de la ventana de tmux con Ctrl+B y después D. La sesión seguirá funcionando aunque cierres SSH.

3. Conéctate a la sesión de una de estas formas:

• en la aplicación Claude del ordenador o del móvil, abre la sección Code y elige la sesión «Mi servidor» – la sesión activa tiene un indicador verde;
• escanea el código QR con el móvil – para mostrarlo, vuelve a tmux y pulsa la barra espaciadora;
• abre en el navegador el enlace del tipo https://claude.ai/code/... que Claude Code muestra en el terminal.

Puedes volver a la ventana de tmux con el comando tmux attach -t claude.

Cómo funciona y qué conviene saber

• No hace falta abrir puertos, porque el servidor se conecta por sí mismo a Anthropic por HTTPS y no hay conexiones entrantes.
• Necesitas una suscripción, ya que Remote Control funciona cuando inicias sesión con una cuenta Claude Pro, Max, Team o Enterprise. En Team y Enterprise, primero tiene que activar la función el propietario de la organización.
• La sesión se puede continuar. Después de detenerla, puedes reanudarla con el comando claude remote-control --continue.
• Una sesión que ya está abierta se puede pasar a Remote Control con el comando /remote-control directamente en Claude Code.

INFO

Por ahora no puedes conectarte al servidor por SSH directamente desde la aplicación Claude del PC. Estas conexiones están en beta y solo las tienen los clientes corporativos que trabajan a través de las plataformas en la nube de Amazon, Google y Microsoft. Con una suscripción normal, usa Remote Control como en este paso.

Seguridad

• Usuario aparte – no ejecutes Claude Code como root.
• Sin el parámetro --dangerously-skip-permissions en un servidor de trabajo – con él, Claude Code puede cambiar o borrar cualquier archivo del usuario sin preguntar. Este modo solo sirve para contenedores desechables.
• Modo de planificación – si quieres ver primero el plan de acción, cambia a este modo con Shift+Tab.
• Los datos de inicio de sesión se guardan en el archivo ~/.claude/.credentials.json. No des a nadie ajeno acceso al usuario con el que funciona Claude Code.
• SSH con claves – configura el acceso con claves y desactiva el acceso con contraseña siguiendo nuestra guía de protección del servidor.

Si algo no funciona

Síntoma	Qué hacer
claude: command not found	Vuelve a entrar en el servidor o ejecuta source ~/.profile
El navegador no se abre en el servidor	Es normal – copia el enlace con la tecla c y ábrelo en el ordenador
Remote Control no se inicia	Inicia sesión con el navegador mediante el comando /login – con token o clave API la función no funciona
La sesión desaparece al desconectar SSH	Ejecuta Claude Code dentro de tmux, como en el paso 5
Va lento o falta memoria	Claude Code necesita desde 4 GB de RAM – elige el plan DE-RZ9-2 o superior