Antes de irte por primera vez del ordenador

Instalación del Servidor, emparejamiento del móvil con un código QR, conexión directa frente al Relay y la primera tarea para el Agente. Paso a paso.

12 minutos Actualizado 2026-09-13

Qué vas a necesitar

Un ordenador con macOS, Windows o Ubuntu en el que esté el proyecto en el que quieres trabajar.
Node.js 20 o más nuevo — es donde corre el Agente.
Credenciales de la API de Anthropic en la variable ANTHROPIC_API_KEY, o una suscripción de Claude con la que el Agente inicia sesión por su cuenta.
Un móvil con la app coden y cámara.

No necesitas servidor propio. El Rendezvous y el Relay por los que el móvil y el ordenador se encuentran los llevamos nosotros, y el Servidor ya los conoce.

1. Instala el Servidor

Descarga el paquete para tu sistema desde la página de descarga. Cada sistema tiene su propio instalador y todos hacen lo mismo: ponen la orden coden en el PATH, así que después la ejecutas desde donde sea.

macOS: Doble clic en el .pkg y pasar por el asistente. El paquete está firmado y notarizado, así que Gatekeeper no pregunta.
Windows: Doble clic en el .msi y pasar por el asistente. Después de instalar, abre una ventana nueva de la línea de órdenes: a la antigua no le llega el cambio del PATH.
Ubuntu y Debian: Un doble clic en el .deb lo abre en el instalador del sistema. Desde el terminal es sudo apt install ./coden_*.deb.

$ coden --version

Cuando la orden no se encuentra, abre un terminal nuevo. El PATH no llega a los que ya están abiertos.

2. Arranca el Servidor sobre el proyecto

El Servidor sirve un directorio. El que le pases es exactamente aquel en el que el Agente trabajará y ejecutará órdenes. Nada del proyecto se guarda fuera de él.

$ cd ~/projekty/muj-projekt
$ coden start

Sin más opciones el Servidor atiende el directorio en el que lo has arrancado. Otro se le puede pasar con --dir:

$ coden start --dir ~/projekty/jiny-projekt

El Servidor se queda en primer plano e imprime lo que pasa. Deja esa ventana abierta — es el único sitio donde verás que alguien se ha conectado.

Más proyectos significa más Servidores, cada uno en su ventana. En la aplicación cambias luego entre ellos, y cada uno guarda sus propias Conversaciones, pruebas e historial.

3. Empareja el móvil

En una segunda ventana de terminal, mientras el Servidor corre:

$ coden pair

Aparece un código QR. En la app toca Emparejar y apunta la cámara. El código vale unos minutos y solo para un emparejamiento — usado, ya no sirve.

No enseñes ese código a nadie y no lo fotografíes. Además de la identidad de tu ordenador lleva acceso al Servicio. Quien lo tenga llega más lejos de lo que querrías.

4. Conexión directa o a través del Relay

Después del emparejamiento el móvil se conecta solo, y en la aplicación se ve por dónde. La diferencia no tienes que configurarla —se elige la mejor de las posibilidades que quedan—, pero conviene saber qué significa cada estado:

Conexión directa: Los datos van del móvil al ordenador y a ningún otro sitio. Lo más rápido, sin cuota, nada pasa por nuestro Servicio. Funciona cuando los dos dispositivos están en la misma red o cuando se logra atravesar el NAT.
A través del Relay: Los datos los pasa nuestro servidor. Con datos móviles y en redes de empresa, donde una conexión directa no es posible, es el único camino. El tráfico va cifrado del móvil al Servidor, así que el contenido no lo vemos: solo lo reenviamos.

La aplicación intenta cambiar a directa por su cuenta en cuanto puede, típicamente cuando llegas a casa al wifi. El Relay se puede desactivar en los Ajustes; pero entonces, en una red que no permite conexión directa, no te conectarás en absoluto.

Rendezvous es la parte del Servicio que presenta a las dos partes. Sin ella el móvil no sabría a dónde conectarse, porque la dirección del ordenador cambia. Pero transportar datos por ella no se puede.

5. Encarga la primera tarea

Empieza por algo donde puedas juzgar si el Agente lo ha hecho bien. Por ejemplo:

Repasa el README y dime qué le falta para poder levantar el proyecto con él en un ordenador limpio.

Por el camino verás qué archivos lee el Agente y qué ejecuta. En el primer comando te pedirá permiso — es normal y es lo que viene por defecto. Cuando quieras que deje de preguntar por cierto tipo de acción, concede un permiso permanente; se puede retirar cuando quieras en Ajustes.

Ahí trabaja Claude Code, es decir, el mismo Agente que conoces del terminal. Sabe hacer lo mismo y se comporta igual; la única diferencia es que la entrada y la salida van por el móvil y que CLAUDE.md, los skills y los ajustes del proyecto valen exactamente igual que en el ordenador.

6. Vete del ordenador

Esta es la parte por la que coden existe. Da una tarea más larga, bloquea el móvil y márchate. El Agente sigue trabajando. Cuando acabe llegará un aviso; cuando te conectes llegará toda la salida que te has perdido.

Para que eso funcione, el ordenador no debe dormirse: hay una guía propia para eso. Y si no quieres tener que volver para aprobar, mira el permiso para trabajar sin aprobaciones.

Cuando el móvil no se conecta

La app dice «el código de emparejamiento ha caducado»: Ejecuta coden pair otra vez. El código dura poco a propósito.
El móvil va con datos móviles y la conexión no se establece: Algunas redes móviles no permiten la conexión directa. Comprueba en la app que tienes el Relay permitido — sin él no te conectarás en una red así.
La app avisa de que la clave no coincide: El Servidor tiene una identidad distinta de la que el móvil recuerda — normalmente porque borraste su directorio de estado. Empareja otra vez. Continuar «de todos modos» la app no te lo ofrece a propósito.
«El Servidor está sirviendo a otro dispositivo»: Hay otro móvil emparejado conectado. Lístalos con el comando coden clients.

Comandos útiles

$ coden status    # ¿corre? ¿quién está conectado? ¿cuánto tiempo?
$ coden clients   # dispositivos emparejados, última conexión
$ coden stop      # apagado ordenado

¿Se ha atascado en otro sitio distinto de lo que hay aquí? Escribe a support@coden-app.com.