Problèmes fréquents

Impossible de se connecter au serveur

Symptômes : La connexion expire ou échoue immédiatement.

Correctifs :

• Vérifiez que les deux appareils sont sur le même WiFi (en mode local).
• Vérifiez que l'app Mac / le serveur est bien en cours d'exécution.
• Confirmez que l'adresse IP et le port sont corrects. Exécutez ipconfig getifaddr en0 sur votre Mac.
• Si le pare-feu macOS est activé, autorisez les connexions entrantes pour l'app.
• Désactivez le VPN sur les deux appareils s'il route le trafic différemment.
• Le WiFi d'entreprise/hôtel peut isoler les appareils. Essayez un réseau domestique ou un partage de connexion.

Impossible de taper des points dans l'adresse IP

Symptôme : Certaines locales (allemande, française) affichent une virgule , au lieu d'un . sur le clavier numérique.

Correctif : Basculez sur le clavier alphabétique standard pour taper les points, ou collez l'adresse IP depuis Notes.

Connecté mais terminal vide

Symptôme : Indicateur de connexion vert, mais la vue terminal n'affiche rien.

Correctifs :

1. Ouvrez le sélecteur de session et re-sélectionnez votre session.
2. Si aucune session n'apparaît, créez-en une nouvelle.
3. Si une session existe mais n'a pas de sortie, tapez Start pour lancer Claude Code.

Taper Start ne semble rien faire

Symptôme : Vous tapez Start mais rien ne change.

C'est le comportement attendu si Claude Code est déjà en cours d'exécution. L'app dispose d'une protection anti-doublon. Vérifiez l'indicateur d'état -- s'il affiche Running (vert), Claude Code est déjà actif. Envoyez simplement vos prompts.

Les notifications n'arrivent pas

Symptôme : Claude Code termine des tâches mais aucune notification push n'apparaît.

Correctifs :

• Vérifiez Réglages iOS > Tactic Remote > Notifications -- doit être activé.
• Assurez-vous que le serveur et l'app sont à la dernière version.
• Les notifications nécessitent les événements de hook de Claude Code. Ceux-ci sont envoyés automatiquement mais dépendent de l'accessibilité de la connexion WebSocket.

La connexion tombe quand l'app est en arrière-plan

Symptôme : En revenant dans l'app après un moment, elle affiche un état déconnecté.

C'est le comportement normal d'iOS. iOS suspend les connexions réseau en arrière-plan pour économiser la batterie. L'app se reconnecte automatiquement quand vous revenez.

Pour les tâches longues, fiez-vous aux notifications push plutôt que de garder l'app ouverte.

L'IP du serveur change constamment

Symptôme : Votre Mac reçoit une IP différente à chaque fois, cassant la connexion enregistrée.

Correctifs :

• Assignez une IP statique à votre Mac dans Réglages Système > Réseau.
• Utilisez la découverte automatique Bonjour au lieu d'une IP manuelle.
• Utilisez un Cloudflare Tunnel pour une URL stable.

Claude Code dit « API key not set »

C'est une erreur de Claude Code, pas de Tactic Remote. Claude Code a besoin d'une clé API Anthropic pour fonctionner.

Définissez-la dans votre terminal :

export ANTHROPIC_API_KEY="your-anthropic-api-key"

Ou exécutez claude config pour la définir de manière permanente.

Note : C'est séparé de la clé API du serveur Tactic Remote. La clé Anthropic est pour le service Claude AI. La clé API du serveur est pour authentifier la connexion iPhone-Mac.

Besoin d'aide supplémentaire ?

Visitez la page de support ou ouvrez une issue sur GitHub avec :

• La version de l'app
• Le mode de connexion (Local ou Cloudflare Tunnel)
• Ce que vous avez essayé et ce qui s'est passé