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 teléfono con la app coden y cámara, o la app coden en una ventana del ordenador.

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.

El Cliente: el teléfono o una ventana en el ordenador

El Cliente es la app coden: con ella le das trabajo al Agente y lo sigues. Es una sola app en dos sitios:

Teléfono (iPhone y Android): Para cuando estás lejos del ordenador. Das una tarea, apruebas un comando, lees la documentación y en Vista previa pruebas la app en desarrollo. Cuando el Agente termina, llega una notificación, incluso con la app cerrada.
Ventana en el ordenador: Para cuando estás en tu mesa. Las mismas pestañas, con más espacio: el árbol de archivos junto al documento, los archivos abiertos en pestañas y la Conversación al lado. Si el Servidor corre en el mismo ordenador, la ventana lee el proyecto directamente del disco y en ella también editas archivos de código. Y desde ella inicias el Servidor sin terminal.

Ambos pueden estar conectados a la vez: una Conversación empezada en la mesa la terminas en el teléfono y al revés. Cada dispositivo se empareja con el Servidor por separado.

La app para el teléfono se descarga del App Store o de Google Play. La app para el ordenador la instala el instalador junto con el Servidor.

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-server 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-server --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-server start

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

$ coden-server 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.

En el ordenador, sin terminal

La app coden también funciona en una ventana del ordenador y desde ahí puedes iniciar el Servidor tú mismo:

Abre Ajustes → Conexión.
En Servidor en este ordenador, escribe la ruta de la carpeta del proyecto, por ejemplo ~/projekty/muj-projekt.
Toca Iniciar Servidor.

La ventana se empareja con el Servidor al momento y el Servidor sigue funcionando aunque cierres la ventana. Para conectar el teléfono, usa Conectar un teléfono en la barra inferior de la ventana: muestra un código QR que basta con escanear.

3. Empareja el móvil

Mientras no haya ningún teléfono emparejado, el Servidor imprime un código QR por sí mismo justo después de arrancar. En la aplicación toque Emparejar y apunte la cámara hacia él. El código dura diez minutos y sirve para un solo emparejamiento — una vez usado no vale nada.

Cuando caduque, o necesite emparejar otro dispositivo, haga uno nuevo. En una segunda ventana del terminal, mientras el Servidor está en marcha:

$ cd ~/projekty/muj-projekt
$ coden-server pair

Ambos comandos deben ejecutarse desde la misma carpeta, y el Servidor debe estar en marcha primero. coden-server pair no es un programa aparte — es un mensaje al Servidor en marcha, que encuentra por la carpeta desde la que usted lo ejecuta. Desde otra carpeta, o sin Servidor en marcha, avisa de que no tiene a quién preguntar.

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

Comandos útiles

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

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