> La lista completa de artículos está en [llms.txt](https://docs.f3cloud.com/llms.txt). Cada página tiene versión en Markdown, basta con añadir .md a su dirección. Esta página en Markdown: [https://docs.f3cloud.com/es/software-setup/claude-code-on-vps.md](https://docs.f3cloud.com/es/software-setup/claude-code-on-vps.md).

# Claude Code en un VPS – instalación, inicio de sesión y uso desde la aplicación

Cómo instalar Claude Code en un VPS, iniciar sesión en tu cuenta en un servidor sin navegador y controlar la sesión desde el ordenador o el móvil con la aplicación Claude gracias a Remote Control.

**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](https://docs.f3cloud.com/es/vps/termius-connection.md) |

### 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.

```bash
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`.

<details>

<summary>¿Hay que dar permisos sudo al usuario?</summary>

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.

</details>

### Paso 2. Instalar Claude Code

Ejecuta el instalador oficial con el usuario `dev`:

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

Comprueba la instalación:

```bash
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.

#### Con el navegador del PC

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».

> **Consejo.**
>
> 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.

#### Token de Claude Code en el PC

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:

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

> **Atención.**
>
> 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.

#### Clave API

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

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

> **Atención.**
>
> 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:

```bash
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:

```bash
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`.

<details>

<summary>Cómo funciona y qué conviene saber</summary>

* **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.

</details>

> **Nota.**
>
> **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](https://docs.f3cloud.com/es/client-area/protect-vps-from-unauthorised-access.md).

### 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          |