Démarrage rapide

1. Démarrer une instance Linux persistante

cd /srv/workspaces
aircode start

Exemple de sortie au premier démarrage :

Generated password: k6uu3U6UG8AXgTnvNgNj
Started workspaces (1a2b3c4d5e6f) on http://127.0.0.1:7860.
Service: aircode@workspaces-1a2b3c4d5e6f.service — restart after crashes and automatic boot: enabled.

AirCode Ø choisit automatiquement un port libre à partir de 7860, génère un mot de passe d’accès et enregistre la configuration privée de l’instance en dehors du dossier des projets. Si Tailscale est présent, AirCode Ø écoute aussi sur l’adresse IP de votre tailnet pour que votre téléphone puisse s’y connecter. Sinon, seule l’adresse locale est utilisée.

Sur Linux, aircode start crée par défaut un service persistant : systemd redémarre le serveur après une panne et au démarrage de la machine. Pour un processus lié au terminal actuel, utilisez plutôt aircode serve.

2. Ouvrir l’interface

Ouvrez l’URL affichée sur un appareil capable d’accéder à la machine, puis connectez-vous avec le mot de passe. Pour installer le client sur un téléphone ou une tablette, donnez d’abord à l’instance une adresse HTTPS stable avec l’accès distant, puis choisissez une méthode :

Sur la page d’installation de l’application web, saisissez uniquement cette adresse HTTPS et sélectionnez Ouvrir la page d’installation. Cette option figure aussi sur la page Télécharger. L’adresse est vérifiée dans votre navigateur ; le site public ne la reçoit et ne l’enregistre jamais.
Sur l’instance elle-même, connectez-vous et choisissez Installer l’application web depuis Plus ou Paramètres → Application web.
Dans Chromium, acceptez la proposition d’installation du navigateur. Sur iPhone ou iPad, suivez le guide intégré : Partager → Ajouter à l’écran d’accueil, gardez Ouvrir comme application web activé si cette option apparaît, puis ouvrez la nouvelle icône sur l’écran d’accueil.

L’application web reste disponible sans boutique d’applications. Elle ne dépend ni de Google Play, ni de l’App Store, ni de TestFlight, ni du manifeste des versions à télécharger. Une adresse HTTP sur le réseau local peut encore s’ouvrir dans un navigateur, mais l’installation mobile, les service workers et les notifications Web Push nécessitent HTTPS.

3. Lancer votre première session

Choisissez le dossier d’un projet.
Choisissez l’environnement d’exécution :
- Local utilise tmux sur l’hôte ou ConPTY sur Windows.
- Docker sandbox exécute une session directe compatible dans un conteneur isolé, avec le projet sélectionné monté dans ce conteneur.
Choisissez un moteur (Claude Code, Codex, Antigravity CLI, Grok Build ou Kimi Code) et un mode d’autorisation.
Lancez la session. L’agent continue de travailler sur la machine AirCode Ø même si vous fermez l’onglet ou changez d’appareil. Une notification vous prévient lorsqu’il a besoin de vous ou qu’il a terminé.

Les interfaces web, bureau et mobile natives proposent le même choix d’environnement. Docker est actuellement un aperçu disponible depuis le code source pour Codex. Consultez le guide de l’environnement Docker isolé avant d’autoriser un contournement de ses restrictions.

Changer d’agent dans une conversation

Quand votre agent est prêt, ouvrez les paramètres de rédaction de la conversation et choisissez un autre Agent. Vérifiez son modèle et son niveau d’effort, puis confirmez avec Changer d’agent. Claude Code, Codex, Grok Build et les autres moteurs disponibles partagent la même interface de conversation. Le projet reste en place et un point de contrôle transmet le contexte au nouvel agent. Envoyez votre prochain message pour continuer.

Travailler avec une équipe de plusieurs modèles

Dans Nouvelle session, choisissez Multi-modèle → Créer maintenant. Sélectionnez un moteur, un modèle et un niveau d’effort pour chacun des rôles : Auteur, Relecteur et Arbitre final. Par exemple, Claude Code peut rédiger une proposition, Codex la remettre en question et Grok Build préparer la version finale après avoir lu leurs échanges. Vous choisissez vous-même les membres de l’équipe ; cet exemple ne prescrit aucun rôle.

Définissez le nombre de passes avant de démarrer. Chaque passe comprend une proposition complète, puis une relecture. Si le relecteur demande des changements et qu’il reste des passes, ses commentaires reviennent à l’auteur. L’arbitre final lit tous les échanges et explique ses décisions. Le résultat distingue un accord entre les agents d’un arbitrage de leurs désaccords.

4. Gérer les instances comme des conteneurs

aircode ps                     # running instances
aircode ps -a                  # include stopped instances
aircode inspect                # current directory's instance
aircode logs --follow
aircode restart
aircode stop                   # stop now and disable startup at boot

Exécutez ces commandes depuis le dossier racine de l’instance, ou indiquez son nom, son identifiant complet, son identifiant court ou le chemin de ce dossier. Arrêter ou mettre à jour le serveur n’arrête jamais les sessions tmux en cours. Un redémarrage de la machine arrête nécessairement les processus du système, mais l’historique persistant des sessions reste disponible pour les récupérer.

5. Choisir les ports, les mots de passe et plusieurs dossiers racines

Vous pouvez préciser chaque valeur dans la commande de démarrage :

aircode start --projects-root /srv/client-a --port 7860 --generate-password
aircode start --projects-root /srv/client-b --port 7861 --password-file ~/.secrets/client-b
aircode start --projects-root /srv/demo --host 127.0.0.1 --port 7862 --no-password --relay private

Les fichiers contenant un mot de passe doivent rester privés (chmod 600). L’option --password-stdin convient aux systèmes de provisionnement. --password <value> fonctionne aussi, mais expose le secret dans l’historique du shell et potentiellement dans la liste des processus. La désactivation de l’authentification exige l’option explicite --no-password.

Un chemin canonique correspond normalement à une instance par défaut. Si vous demandez un autre port depuis ce même dossier, AirCode Ø crée une instance indépendante avec un nom automatique : il ne modifie ni ne redémarre l’instance par défaut.

aircode start --projects-root /srv/client-a --port 7860 --generate-password
aircode start --projects-root /srv/client-a --port 7861 --no-password --relay private

Ajoutez --name internal ou --name demo si un nom lié à l’usage de l’instance est utile. Choisissez explicitement le nom ou l’identifiant d’une instance existante si vous voulez modifier son port enregistré.

6. Se connecter avant d’utiliser le Relay géré

aircode login
aircode whoami
aircode start --relay managed

Les instances d’un même utilisateur Unix partagent l’autorisation du compte. Leurs ports, mots de passe, identités de tunnel et réglages d’activation du Relay restent distincts. Le Relay géré refuse une instance sans mot de passe. Utilisez aircode logout pour retirer les identifiants de la machine, --relay private pour un VPN sans tunnel public, ou --relay off pour désactiver un tunnel sans oublier le transport choisi.

7. Installer les CLI des agents

Les versions empaquetées d’AirCode Ø contiennent déjà les versions prévues des CLI, notamment pour Grok Build et Kimi Code. Si vous exécutez le projet depuis son code source, installez les CLI et connectez-les sous le même utilisateur Unix. Les versions actuellement ciblées sont :

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

curl -fsSL https://chatgpt.com/codex/install.sh | bash -s -- --release 0.156.1
codex login

curl -fsSL https://x.ai/cli/install.sh | bash -s 0.2.118
grok login

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash -s -- --version 0.32.0
kimi login

Une version plus ancienne ou illisible est bloquée. Une version plus récente peut démarrer et conserve les contrôles vérifiés à l’écran, sauf incompatibilité connue. Les commandes aircode doctor indiquent ce qui est disponible.

Antigravity CLI utilise l’installateur officiel de Google :

curl -fsSL https://antigravity.google/cli/install.sh | bash
agy

Chaque moteur natif conserve le mode d’authentification de son fournisseur :

Moteur	Compte ou abonnement	Accès par API
Claude Code	Connexion à un abonnement Claude	Identifiants pour l’API Anthropic
Codex	Connexion à un abonnement ChatGPT	Identifiants pour l’API OpenAI
Antigravity CLI	Compte Google avec accès de base, Google AI Pro/Ultra ou projet Google Cloud	Catalogue du compte natif
Grok Build	`grok login` avec un abonnement Grok ou une authentification SSO d’entreprise	`XAI_API_KEY`
Kimi Code	OAuth de Kimi Code	Identifiants pour l’API Moonshot

Google a retiré Gemini CLI pour les comptes individuels le 18 juin 2026 et oriente ces utilisateurs vers Antigravity. AirCode Ø suit ce changement : Antigravity CLI est le moteur Google et Gemini CLI ne peut plus être choisi. Les sessions créées auparavant avec Gemini CLI restent consultables dans l’historique. Consultez l’annonce officielle de la transition.

Un abonnement Antigravity n’est pas nécessaire pour se connecter : un compte Google donne accès à l’offre de base, tandis que Pro et Ultra élargissent l’accès aux modèles et les limites d’utilisation. AirCode Ø utilise le catalogue propre au compte renvoyé par agy models. Consultez les pages Google sur les offres Antigravity et le catalogue des modèles.

Pour connecter un fournisseur d’API intégré, ouvrez Utilisation de l’IA, choisissez le fournisseur, puis sélectionnez Connecter. AirCode Ø vérifie la clé, l’enregistre localement dans ~/.config/aircode/providers.env avec des autorisations privées et l’active immédiatement pour les nouvelles sessions. Ce même écran permet de remplacer ou de déconnecter une clé. Les clés fournies par l’environnement du serveur restent prises en charge ; elles apparaissent comme gérées à l’extérieur et ne peuvent pas être modifiées dans l’interface.

GLM / Z.AI, DeepSeek, MiniMax et Meta / Muse Spark sont temporairement indisponibles pour la v1, le temps de valider leur disponibilité et leur fiabilité en usage réel. Leurs intégrations restent dans le code pour un retour ultérieur ; ils ne peuvent pas être sélectionnés, connectés ou lancés pendant ce retrait. Les conversations existantes et l’historique d’utilisation restent consultables.

Kimi Code reste disponible avec ses modèles natifs Moonshot. AirCode Ø ne transmet chaque identifiant qu’aux sessions qui utilisent le fournisseur concerné et ne le renvoie jamais par l’API.

Grok utilise une session de navigateur enregistrée avant XAI_API_KEY. Exécutez grok logout si vous souhaitez explicitement utiliser la clé API.