Avant de quitter l'ordinateur pour la première fois

Installation du Serveur, appariement du téléphone par code QR, connexion directe contre Relais, et la première tâche pour l'Agent. Étape par étape.

12 minutes Mis à jour 2026-09-13

Ce dont vous aurez besoin

Un ordinateur avec macOS, Windows ou Ubuntu, sur lequel se trouve le projet sur lequel vous voulez travailler.
Node.js 20 ou plus récent — c'est là que tourne l'Agent.
Des identifiants à l'API Anthropic dans la variable ANTHROPIC_API_KEY, ou un abonnement Claude auquel l'Agent se connecte de lui-même.
Un téléphone avec l'app coden et un appareil photo, ou l'app coden dans une fenêtre sur l'ordinateur.

Vous n'avez pas besoin de serveur à vous. Le Rendezvous et le Relais, par lesquels le téléphone et l'ordinateur se trouvent, c'est nous qui les tenons, et le Serveur les connaît déjà.

Le Client : le téléphone, ou une fenêtre sur l'ordinateur

Le Client, c'est l'app coden — celle par laquelle vous confiez du travail à l'Agent et le suivez. C'est une seule app, à deux endroits :

Téléphone (iPhone et Android): Pour quand vous êtes loin de l'ordinateur. Vous donnez une tâche, approuvez une commande, lisez la documentation et parcourez l'app en cours dans l'Aperçu. Quand l'Agent a fini, une notification arrive — même app fermée.
Fenêtre sur l'ordinateur: Pour quand vous êtes à votre bureau. Les mêmes onglets, avec plus de place : l'arborescence des fichiers à côté du document, les fichiers ouverts en onglets et la Conversation sur le côté. Quand le Serveur tourne sur le même ordinateur, la fenêtre lit le projet directement sur le disque et vous y modifiez aussi les fichiers source. Et vous y lancez le Serveur sans terminal.

Les deux peuvent être connectés en même temps : une Conversation commencée au bureau se termine sur le téléphone, et inversement. Chaque appareil s'appaire séparément avec le Serveur.

L'app pour téléphone se télécharge sur l'App Store ou Google Play. L'app pour ordinateur est installée avec le Serveur par l'installateur.

1. Installez le Serveur

Téléchargez le paquet pour votre système depuis la page de téléchargement. Chaque système a son propre installeur et tous font la même chose : ils mettent la commande coden-server dans le PATH, vous la lancez donc ensuite de n'importe où.

macOS: Double-clic sur le .pkg et parcourir l'assistant. Le paquet est signé et notarisé, Gatekeeper ne demande donc rien.
Windows: Double-clic sur le .msi et parcourir l'assistant. Après l'installation, ouvrez une nouvelle fenêtre de ligne de commande — dans l'ancienne, la modification du PATH n'arrive pas.
Ubuntu et Debian: Un double-clic sur le .deb l'ouvre dans l'installeur du système. Depuis un terminal, c'est sudo apt install ./coden_*.deb.

$ coden-server --version

Quand la commande n'est pas trouvée, ouvrez un nouveau terminal. Le PATH n'atteint pas ceux déjà ouverts.

2. Lancez le Serveur au-dessus du projet

Le Serveur sert un répertoire. Celui que vous lui passez est exactement celui dans lequel l'Agent travaillera et lancera des commandes. Rien du projet n'est enregistré en dehors de lui.

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

Sans autre option, le Serveur sert le répertoire dans lequel vous l'avez lancé. Un autre peut être passé par --dir:

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

Le Serveur reste au premier plan et écrit ce qui se passe. Gardez cette fenêtre ouverte — c'est le seul endroit où vous verrez que quelqu'un s'est connecté.

Plus de projets veut dire plus de Serveurs, chacun dans sa fenêtre. Dans l'application vous basculez ensuite entre eux, et chacun garde ses propres Conversations, tests et historique.

Sur l'ordinateur, sans terminal

L'app coden tourne aussi dans une fenêtre sur l'ordinateur, et de là vous lancez le Serveur vous-même :

Ouvrez Réglages → Connexion.
Sous Serveur sur cet ordinateur, tapez le chemin du dossier du projet, par exemple ~/projekty/muj-projekt.
Touchez Démarrer le Serveur.

La fenêtre s'appaire aussitôt avec le Serveur, et le Serveur continue de tourner même après la fermeture de la fenêtre. Pour connecter le téléphone, utilisez Connecter un téléphone dans la barre en bas de la fenêtre — un code QR s'affiche, il suffit de le scanner.

3. Appairez le téléphone

Tant qu'aucun téléphone n'est appairé, le Serveur affiche un code QR de lui-même juste après le démarrage. Dans l'application, touchez Appairer et pointez l'appareil photo dessus. Le code vaut dix minutes et pour un seul appairage — une fois utilisé il ne sert plus à rien.

S'il expire ou si vous voulez appairer un autre appareil, créez-en un nouveau. Dans une seconde fenêtre de terminal, pendant que le Serveur tourne :

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

Les deux commandes doivent être lancées depuis le même dossier, et le Serveur doit tourner en premier. coden-server pair n'est pas un programme à part — c'est un message au Serveur en cours d'exécution, qu'il trouve par le dossier depuis lequel vous le lancez. Depuis un autre dossier, ou sans Serveur en marche, il signale qu'il n'a personne à interroger.

Ne montrez ce code à personne et ne le photographiez pas. Outre l'identité de votre ordinateur, il porte l'accès au Service. Qui l'a va plus loin que vous ne le voudriez.

4. Connexion directe ou via le Relais

Après l'appariement le téléphone se connecte de lui-même, et l'application montre par où. La différence, vous n'avez pas à la régler — la meilleure des possibilités restantes est choisie — mais il est bon de savoir ce que chaque état signifie :

Connexion directe: Les données vont du téléphone à l'ordinateur et nulle part ailleurs. Le plus rapide, aucun quota, rien ne passe par notre Service. Cela marche quand les deux appareils sont sur le même réseau ou quand la traversée du NAT réussit.
Via le Relais: C'est notre serveur qui fait passer les données. Sur les données mobiles et dans les réseaux d'entreprise, où une connexion directe est impossible, c'est le seul chemin. Le trafic est chiffré du téléphone jusqu'au Serveur, nous ne voyons donc pas le contenu — nous le transmettons seulement.

L'application essaie de basculer en direct d'elle-même dès qu'elle peut — typiquement quand vous rentrez chez vous sur le wifi. Le Relais peut être désactivé dans les Réglages ; mais alors, sur un réseau qui ne permet pas de connexion directe, vous ne vous connecterez pas du tout.

Rendezvous est la partie du Service qui présente les deux côtés. Sans elle le téléphone ne saurait pas où se connecter — l'adresse de l'ordinateur change, après tout. Mais on ne peut pas faire passer de données par elle.

5. Confiez la première tâche

Commencez par quelque chose où vous saurez juger si l'Agent l'a bien fait. Par exemple :

Parcours le README et dis-moi ce qui lui manque pour qu'on puisse lancer le projet avec sur un ordinateur vierge.

En chemin vous verrez quels fichiers l'Agent lit et ce qu'il lance. À la première commande il demande la permission — c'est normal et c'est le réglage par défaut. Quand vous voulez qu'il cesse de demander pour un certain type d'action, accordez une permission permanente ; elle se retire à tout moment dans les Réglages.

C'est Claude Code qui travaille là, c'est-à-dire le même Agent que vous connaissez du terminal. Il sait faire la même chose et se comporte pareil ; la seule différence est que l'entrée et la sortie passent par le téléphone et que CLAUDE.md, les skills et les réglages du projet valent exactement comme à l'ordinateur.

6. Éloignez-vous de l'ordinateur

C'est la partie pour laquelle coden existe. Donnez une tâche plus longue, verrouillez le téléphone et partez. L'Agent continue. Quand il aura fini, une notification arrivera ; quand vous vous connecterez, toute la sortie que vous avez manquée arrivera avec.

Pour que cela marche, l'ordinateur ne doit pas s'endormir — il y a un guide à part pour ça. Et si vous ne voulez pas revenir pour approuver, regardez l'autorisation de travailler sans approbations.

Quand le téléphone ne se connecte pas

L'application dit « le code d'appairage a expiré »: Lancez coden-server pair à nouveau. Le code est de courte durée à dessein.
Le téléphone est en données mobiles et la connexion ne s'établit pas: Certains réseaux mobiles n'autorisent pas la connexion directe. Vérifiez dans l'application que le Relais est autorisé — sans lui, vous ne vous connecterez pas sur un tel réseau.
L'application signale une clé qui ne correspond pas: Le Serveur a une identité différente de celle que le téléphone garde en mémoire — typiquement parce que vous avez supprimé son répertoire d'état. Appairez à nouveau. Continuer « quand même » n'est délibérément pas proposé.

Commandes utiles

$ coden-server status    # tourne ? qui est connecté ? depuis combien de temps ?
$ coden-server clients   # appareils appairés, dernière connexion
$ coden-server stop      # arrêt en bon ordre

Ça a coincé ailleurs que ce qui est ici ? Écrivez à support@coden-app.com.