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'application coden et un appareil photo.

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

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

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

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

3. Appairez le téléphone

Dans une deuxième fenêtre de terminal, pendant que le Serveur tourne :

$ coden pair

Un code QR s'affiche. Dans l'application, touchez Appairer et visez-le avec l'appareil photo. Le code vaut quelques minutes et pour un seul appairage — une fois utilisé, il ne sert plus à rien.

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 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é.
« Le Serveur sert un autre appareil »: Un autre téléphone appairé est connecté. Listez-les avec la commande coden clients.

Commandes utiles

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

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