Claude Code peut-il tourner 24h/24 sur un Mac distant ? Guide 2026

État actuel

Pourquoi, en septembre 2026, on tape encore « Claude Code 24h/24 »

Ce n’est pas parce que Claude Code « habite tout seul dans le cloud ». C’est parce que Remote Control est devenu une fonction officielle : vous lancez une tâche au bureau, puis vous la suivez depuis le téléphone ou un autre navigateur. Beaucoup en déduisent qu’ils peuvent fermer le capot, sortir, voire éteindre. La doc dit l’inverse : la session continue sur la machine qui a déjà démarré Claude Code. Dès que le portable dort, l’exécution s’arrête ; elle ne reprend qu’au réveil. Détail dans la documentation Claude Code Remote Control.

Deuxième raison : les sessions ont allongé. On n’attend plus trois fonctions à compléter, mais un enchaînement tests + refactor + outils MCP + sous-agents qui tient dix ou quinze minutes. Fermer le capot, c’est couper volontairement. Troisième raison : iOS et macOS restent coincés sur du matériel Apple réel. Un VPS Linux accueille le CLI ; il n’accueille pas Xcode, le simulateur ni la signature.

Le mot-clé vaut donc la recherche, non pas pour une fiche « qu’est-ce que Claude Code », mais pour séparer trois gestes : regarder à distance, exécuter à distance, et vraiment ne plus éteindre. Si vous calculez aussi le prochain achat machine plutôt qu’un nœud déjà allumé, le calendrier matériel compte : Quand aura lieu l’événement d’automne Apple 2026 ? Quels nouveaux Mac ?

Cinq façons : local, Remote Control, mini perso, Mac distant, CI

Choisissez d’abord selon la douleur, pas selon le vocabulaire produit. Les cinq options « font tourner Claude Code ». Seules les trois dernières ont une chance de continuer après la fermeture du laptop.

Chemin 1 : laisser le portable ouvert. Le plus simple, et le plus souvent pris pour du 24h/24. Tant que le capot reste levé et que macOS ne dort pas, Claude Code peut tenir toute la nuit. Le hic : cette machine est aussi votre écran, votre clavier et votre bagage. Capot, métro, veille automatique — la tâche s’arrête. Utile pour « finir cette session cet après-midi », pas pour « regarder le résultat demain matin ».

Chemin 2 : local plus Remote Control. C’est l’outil officiel pour « je quitte le clavier, la machine reste sur le bureau ». Téléphone et navigateur ne sont que des fenêtres ; MCP, dépôt et certificats restent locaux. Ça règle « je peux valider une permission pendant le déjeuner », pas « je fourre le Mac dans la valise ». Team / Enterprise exigent en plus l’interrupteur admin ; une clé API ne suffit pas.

Chemin 3 : un Mac mini à la maison ou au bureau. Pour un développeur solo, c’est l’auto-hébergement le plus proche du 24h/24. La machine reste sous tension, vous arrivez en SSH ou en partage d’écran. Vous assumez l’exposition réseau, l’IP dynamique, une coupure EDF et le disque. Pour ouvrir la connexion à distance, suivez la page Apple « Autoriser un ordinateur distant à accéder à votre Mac » : uniquement les comptes nécessaires, jamais le mot de passe admin jeté sur Internet.

Chemin 4 : Mac distant / Mac cloud. La différence avec le chemin 3 n’est pas « Claude Code peut-il s’installer ». C’est : voulez-vous encore gérer secteur, réseau, disque et révocation des comptes. Fermer le portable, laisser un agent retravailler les tests la nuit, ou partager une Xcode figée avec un collègue : c’est là que l’intention d’achat apparaît. Avant d’acheter une machine de plus pour le bureau d’automne, comparez aussi le calendrier des nouveaux Mac de l’événement d’automne Apple 2026 : acheter pour le bureau n’est pas la même décision que louer un hôte déjà allumé.

Chemin 5 : CI hébergée. Xcode Cloud ou un runner macOS GitHub enchaînent builds et tests. Ils ne remplacent pas une session où vous restez dans le dialogue et ajustez les prompts. « La file CI tourne 24h/24 » n’est pas « la session Claude Code interactive tourne 24h/24 ».

Remote Control et SSH + tmux ne sont pas le même outil

Les deux requêtes atterrissent souvent sur la même page, mais elles ne réparent pas le même problème. Remote Control branche un compte claude.ai (ou l’app Claude) déjà connecté sur un processus local déjà lancé. SSH vous connecte à un autre macOS, et c’est là que vous démarrez le processus. Le 24h/24 demande de changer de « propriétaire de processus », pas d’ajouter un écran.

Les limites officielles sont nettes : fermer le terminal, quitter VS Code ou tuer le processus claude affiche la session distante hors ligne en quelques secondes. Pour survivre à une coupure SSH, il faut tmux ou screen. En mode serveur, une coupure réseau d’environ 10 minutes fait aussi sortir le processus : il faudra relancer claude remote-control. Ce n’est pas du folklore Discord, c’est la section Limitations de la même doc Remote Control.

Les modes de connexion se séparent aussi. claude setup-token et CLAUDE_CODE_OAUTH_TOKEN conviennent au CI et aux scripts, avec une durée de vie longue, mais ils n’ouvrent pas Remote Control : ils n’appellent que le modèle. Pour reprendre la session sur téléphone, il faut une connexion claude.ai complète, pas une clé API. La page d’authentification Claude Code évite le piège classique : poser un token sur une boîte sans écran, puis s’étonner que claude remote-control réclame un « full-scope login token ».

Autre homonyme : Claude Code on the web. L’interface claude.ai/code est partagée avec Remote Control, mais la session tourne sur l’infra cloud. Certificats, DerivedData et MCP locaux de votre Mac distant n’y sont pas. Signer un IPA, toucher le trousseau ou un MCP intranet exige encore un processus posé sur un vrai macOS.

Ce qu’il faut avoir avant de lancer les commandes

Listez l’environnement une fois : sinon vous bloquerez sur l’écran de connexion.

• Un hôte macOS qui ne s’endort pas tout seul : mini hors du laptop, ou Mac distant.
• La connexion à distance activée, et un SSH qui entre déjà depuis votre machine.
• Le CLI Claude Code installé sur cet hôte, pas lancé depuis le portable contre un disque monté.
• tmux ou screen sur l’hôte ; la première commande après login doit ouvrir la session multiplexée.
• Pour Remote Control : offre Pro / Max / Team / Enterprise, plus une connexion claude.ai. Team / Enterprise : l’admin doit aussi activer l’option.
• Le dépôt a déjà accepté la confiance d’espace de travail une fois via claude ; Remote Control ne mémorise pas le dossier personnel comme fiable.
• Ne laissez pas ANTHROPIC_API_KEY comme seul mode de connexion, et n’attendez pas Remote Control derrière un ANTHROPIC_BASE_URL custom.

N’achetez pas la RAM « au minimum qui démarre ». CLI + dépôt petit ou moyen : 16 Go tiennent en général. Xcode, simulateur ou plus d’un agent en parallèle : 24 Go évitent plus souvent le swap aux pics. C’est un dimensionnement, pas un score de labo.

Faire tenir la session sur le Mac distant

On suppose que le SSH vers le Mac cible fonctionne déjà. L’objectif n’est pas « installer pour discuter », c’est « le processus survit à la coupure ».

1. Couper la veille d’abord

Réglages Système → Batterie / Adaptateur : empêcher la mise en veille automatique. L’écran peut s’éteindre si le système reste réveillé. Si l’hôte dort, tmux ne sauvera pas une requête modèle en cours.

2. Activer la connexion à distance et vérifier

Réglages Système → Général → Partage → Connexion à distance. Uniquement les comptes utiles. Depuis le portable :

ssh user@mac-host.local
uname -m
sw_vers

Architecture et version visibles : continuez. Sinon, pare-feu, VPN d’entreprise et options du type « uniquement le même compte iCloud » d’abord — pas Claude Code.

3. Entrer dans tmux dès le login

tmux new -A -s claude
# installer ou lancer Claude Code ensuite
# pour quitter : Ctrl-b puis d
# plus tard : tmux attach -t claude

La doc officielle se résume ainsi : si le SSH tombe et que la session doit rester, elle vit dans tmux ou screen. Sans cette étape, Remote Control ne maquille qu’un processus qui meurt avec le tunnel.

4. Se connecter et démarrer sur l’hôte

Dans tmux, allez dans le projet, lancez claude, puis /login vers claude.ai. Sur une boîte sans navigateur, vous pouvez d’abord faire claude setup-token depuis une machine graphique et n’utiliser ce jeton que pour scripts ou CI ; si le téléphone doit reprendre la session, revenez faire une connexion complète. Pour une session interactive 24h/24 au quotidien :

cd ~/Projects/ios-app
claude --remote-control "night-agent"

Vous gardez un terminal où taper, et claude.ai / l’app Claude peuvent se brancher. Si cette machine n’est qu’un serveur et que vous tapez uniquement sur le téléphone, utilisez claude remote-control. Dans les deux cas, ce processus ne doit pas quitter.

5. Couper exprès pour valider

Ne croyez pas « ça devrait encore tourner ». Passez la liste :

• Detach dans tmux, fermez la fenêtre SSH du portable.
• Reconnectez-vous, tmux attach -t claude : session et historique toujours là.
• Si Remote Control est actif : après fermeture du SSH, le téléphone voit encore la session en ligne.
• Endormez l’hôte 2 minutes puis réveillez : la session doit pauser puis reprendre, pas faire semblant de n’avoir jamais bougé.
• Regardez tmux ls. « no server » = vous n’avez jamais lancé dans tmux.

Coupure, veille, login : par où chercher

La session a disparu. D’abord tmux ls. Pas de server : ce n’est pas une perte, c’est une absence d’accroche. Habitude : première commande après login = tmux new -A -s claude.

Remote Control demande une connexion complète. Vous êtes probablement passé par setup-token ou CLAUDE_CODE_OAUTH_TOKEN. Retirez les variables, lancez claude auth login, choisissez claude.ai. S’il reste un ANTHROPIC_API_KEY, videz-le avant de vous reconnecter.

Après fermeture du capot, le téléphone affiche hors ligne ou reste coincé. Comportement attendu, pas un mauvais réglage. Remote Control se reconnecte au réveil de l’hôte ; il ne continue pas d’écrire des fichiers sur un portable endormi. Pour sortir, déplacez le processus sur un autre Mac qui ne dort pas.

Le mode serveur s’arrête tout seul. Hôte réveillé, mais réseau coupé environ 10 minutes : claude remote-control abandonne. Le mode interactif, lui, continue de réessayer en local. Revenez en SSH dans tmux, relancez le mode serveur.

Passerelle custom ou Bedrock. Remote Control exige api.anthropic.com. Avec ANTHROPIC_BASE_URL, Bedrock, Vertex ou une passerelle entreprise, considérez la fonction absente et restez en SSH + tmux pur terminal.

Une boîte de permission que personne ne clique. Remote Control peut renvoyer une partie des confirmations sur le téléphone, pas toutes. En longue absence, resserrez le mode d’autorisation à ce que vous acceptez d’approuver automatiquement, et partez du principe qu’un humain devra encore regarder une étape.

Pour qui c’est utile — et pour qui ça ne l’est pas

Questions fréquentes