Démarrage rapide

Windows: Connecter Windows avec votre compte.

Ce guide vous accompagne dans l'installation de Tactic Remote et votre première connexion. Vous aurez besoin d'un Mac (ou PC Windows) et d'un iPhone.

Durée : Environ 10 minutes pour la première configuration. Les reconnexions ultérieures prennent quelques secondes.

Prérequis

Sur votre Mac

• App Mac Tactic Remote -- elle inclut le serveur local et un runtime Node figé. Au premier lancement, elle vérifie les dépendances locales et peut aider à installer les bases manquantes comme Homebrew et tmux.

• Au moins une CLI d'agent de codage IA -- Tactic Remote peut lancer Claude Code, OpenAI Codex ou Sourcegraph Amp. Installez l'agent que vous voulez utiliser et connectez-vous avant de créer votre première session.

  # Claude Code (installateur natif recommandé par la documentation Claude Code)
  curl -fsSL https://claude.ai/install.sh | bash
   
  # OpenAI Codex
  npm install -g @openai/codex
   
  # Sourcegraph Amp
  npm install -g @sourcegraph/amp

  Si claude, codex ou amp fonctionne déjà dans votre terminal, Tactic Remote peut l'utiliser.

• tmux -- maintient les sessions Terminal Mac/Linux actives malgré les déconnexions. L'app Mac le vérifie et peut aider à l'installer ; les utilisateurs CLI peuvent exécuter brew install tmux sur macOS.

Si vous utilisez le démarrage CLI en une commande au lieu de l'app Mac et que vous n'avez pas Node.js ou Homebrew, installez-les d'abord :

# Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
# Node.js
brew install node

Sur votre iPhone

• iOS 16.4 ou ultérieur.
• L'app Tactic Remote iOS (disponible sur App Store).

Étape 1 : Choisissez comment configurer votre Mac

Tactic Remote propose deux modes de configuration sur Mac :

Option A : App Mac (recommandée pour la plupart des utilisateurs)

Téléchargez l'app Tactic Remote Mac depuis la page de téléchargement. Ouvrez le DMG et glissez l'app dans Applications.

Au premier lancement, l'app apparaît dans votre barre de menu. Cliquez sur l'icône pour voir :

• L'état du serveur (en cours / arrêté)
• Votre IP locale et port (par ex. 192.168.1.42:8765)
• Un QR code pour l'appairage rapide avec l'iPhone

L'app Mac intègre le serveur en interne, guide mieux la configuration et constitue généralement l'option la plus simple pour les utilisateurs qui ne vivent pas dans Terminal.

Option B : Démarrage Terminal en une commande (CLI)

Exécutez cette commande dans votre terminal :

npx tacticremote

Le serveur démarre et affiche un QR code. Scannez-le avec votre iPhone pour vous connecter. C'est tout.

Prérequis : Node.js 16+, tmux (brew install tmux sur macOS) et au moins une CLI d'agent installée (claude, codex ou amp).

Fonctionne sur macOS et Linux.

Étape 2 : Se connecter depuis l'iPhone

1. Ouvrez l'app Tactic Remote iOS.

2. Scannez le QR code affiché par l'app Mac ou par le CLI. Cela remplit automatiquement l'adresse du serveur et la clé API.

   Ou connectez-vous manuellement :

   • Entrez l'adresse IP et le port de votre Mac (par ex. 192.168.1.42:8765)
   • Entrez la clé API si elle est définie
   • Tapez Connecter

3. Vous devriez voir un indicateur Connecté vert en quelques secondes.

Quelle option choisir ? Pour la plupart des utilisateurs, l'app Mac est le meilleur choix par défaut, car elle guide la configuration et affiche le QR code directement dans la barre de menu. Le CLI reste idéal si vous travaillez déjà dans Terminal ou si vous voulez le même flux sur macOS et Linux.

Découverte automatique Bonjour : Si les deux appareils sont sur le même WiFi, l'app iOS peut aussi découvrir votre Mac automatiquement via Bonjour -- cherchez-le dans la liste des serveurs.

Étape 3 : Créer une session

1. Tapez sur le sélecteur de session (en haut à gauche).
2. Tapez sur Nouvelle session.
3. Naviguez et sélectionnez un répertoire de projet sur votre Mac -- c'est le répertoire de travail de l'agent sélectionné.
4. Donnez un nom à la session (par ex. my-project).
5. Tapez Créer.

Étape 4 : Choisir et démarrer un agent

1. Dans les réglages, choisissez l'agent à lancer : Claude Code, Codex ou Amp. Claude Code est le choix par défaut.
2. Tapez sur le bouton Start.
3. L'agent sélectionné se lance dans une session tmux sur votre Mac. Vous verrez la sortie terminal streamer vers votre iPhone en temps réel.
4. Envoyez un prompt de test :

List the files in the current directory.

Si vous voyez la réponse de l'agent streamer sur votre téléphone, tout fonctionne.

Étape 5 : Vérifier

Et ensuite

• L’Agent ne répond pas — Vérifiez la file d’attente et l’état de transmission avant de renvoyer la demande.
• Essayer une petite correction — Suivez un cas concret, de la demande à la vérification du résultat.
• Configuration réseau local -- optimisez votre connexion sur le même WiFi
• Cloudflare Tunnel -- accédez à votre Mac de n'importe où
• Sessions et workflow -- comprenez les sessions, le démarrage et la reconnexion
• Sécurité -- gestion des clés API et contrôles d'accès