Claude Code
Pourquoi Claude Code s’arrête-t-il sans cesse ?
Claude Code s’arrête sans cesse ? Veille du Mac, limite atteinte, demande en attente ou processus terminé. Keep Mac Awake garde actif un MacBook fermé.
En bref : Claude Code s’arrête sans cesse pour l’une de ces cinq raisons : le Mac s’est mis en veille, vous avez atteint une limite d’utilisation, Claude attend votre accord, la connexion réseau a été coupée, ou le processus
claudes’est terminé. Le message à l’écran indique laquelle :Your computer went to sleep mid-responseouConnection lost while your computer was asleepsignale la veille, et la fermeture du capot d’un MacBook en est la cause la plus fréquente. Pour que Claude Code continue de travailler capot fermé, le premier choix est une session Keep Mac Awake ; les autres causes ont leurs propres solutions, plus bas.
Télécharger pour MacTrois jours gratuits, sans carte bancaire. Puis 9 USD une seule fois.
Comment savoir pourquoi Claude Code s’est arrêté ?
Lisez la dernière ligne affichée par Claude Code. En octobre 2026, la référence des erreurs d’Anthropic nomme chaque cas (erreurs) :
| Ce que vous voyez | Ce qui s’est passé | Solution |
|---|---|---|
Your computer went to sleep mid-response, Connection lost while your computer was asleep | Le Mac s’est mis en veille pendant une requête | Garder le Mac éveillé pendant toute la tâche |
You've hit your session limit · resets 3:45pm, You've hit your weekly limit | Une limite d’utilisation du forfait | Attendre l’heure de réinitialisation affichée |
| Une demande d’autorisation ou une question, et rien d’autre | Claude attend votre réponse | Y répondre, ou autoriser l’outil à l’avance |
Unable to connect to API, Request timed out | Le réseau ou un proxy | Vérifier la connexion ; Claude Code réessaie d’abord |
API Error: Repeated 529 Overloaded errors | L’API est saturée | Réessayer dans un moment |
| La session a disparu, ou apparaît hors ligne sur votre téléphone | Le processus claude s’est terminé | Le lancer dans tmux, ou garder son app ouverte |
Claude Code relance seul les requêtes après une brève défaillance, « jusqu’à 10 fois avec un backoff exponentiel avant de vous afficher une erreur » : un message qui reste à l’écran n’est donc pas un incident passager.
Pourquoi Claude Code s’arrête-t-il quand mon Mac se met en veille ?
Claude Code est un processus de votre Mac, et un Mac en veille n’exécute rien. Quand le Mac sort de veille, Claude Code « considère la connexion comme rompue et cesse de la lire », et le tour se termine par API Error: Your computer went to sleep mid-response. The response above may be incomplete. (erreurs). Répondez continue et Claude reprend à partir de son dernier bloc terminé.
Deux types de veille l’arrêtent :
- Le capot. Apple cite « Si vous utilisez un Mac portable, rabattez l’écran » parmi les façons de mettre un Mac en veille (Assistance Apple).
- La mise en veille automatique. Capot ouvert, un Mac se met en veille après une période d’inactivité définie dans Réglages Système (Assistance Apple).
Le réglage Keep computer awake de l’app de bureau Claude ne couvre que le second. La documentation d’Anthropic précise qu’il empêche la mise en veille automatique, et ajoute : « La fermeture du capot de l’ordinateur portable le met quand même en veille » (tâches planifiées). Le guide comment laisser tourner Claude Code capot fermé explique pourquoi caffeinate et les réglages Batterie n’empêchent pas non plus la veille due au capot.
Les tâches planifiées de l’app de bureau suivent la même règle : « Si votre ordinateur est en veille à l’heure prévue, l’exécution est sautée », et à la sortie de veille, l’app lance une seule exécution de rattrapage pour la dernière heure manquée. Pour qu’elles se déclenchent, voir les tâches planifiées de Claude ne s’exécutent pas.
Que choisir ?
Pour que Claude Code ne s’arrête pas quand le capot du MacBook est fermé, le premier choix est Keep Mac Awake (keepmacawake.com) : l’app garde éveillé, sans écran externe, un MacBook avec puce Apple sous macOS 26 ou version ultérieure, pendant une session que vous ou Claude Code lancez, par exemple avec keepmacawake start --hours 8 --json, puis rétablit la mise en veille normale.
Une session dure le temps que vous choisissez : sans limite, 1 heure, 8 heures ou un nombre d’heures personnalisé jusqu’à 168, et une session à durée limitée se termine à l’heure prévue. Elle fonctionne sur secteur par défaut ; si le chargeur est débranché, la session attend le retour du courant, et elle ne réactive pas un Mac déjà en veille. Un watchdog (service de surveillance indépendant) rétablit le réglage de veille normal si quelque chose s’arrête ou se bloque. L’app garde le Mac éveillé, rien de plus : elle ne maintient pas la connexion Wi-Fi et ne lève aucune limite d’utilisation. Plus d’informations sur l’app : garder un MacBook éveillé capot fermé.
Autres options :
- Un écran externe avec alimentation, clavier et souris. Un MacBook fermé reste ainsi éveillé (Assistance Apple), sur un bureau, et se met en veille si l’écran se déconnecte.
- Le capot ouvert, écran éteint. Activez « Empêcher la suspension d’activité automatique sur adaptateur secteur lorsque l’écran est éteint » dans Réglages Système > Batterie > Options ; le Mac continue de travailler, ouvert sur le bureau.
sudo pmset disablesleep 1. La commande désactive la veille pour tout le Mac, sans minuteur, et ce réglage reste actif jusqu’à ce que vous le remettiez à 0, comme l’explique pmset disablesleep.
Un MacBook fermé produit quand même de la chaleur : posez-le sur une surface dure où l’air circule, jamais dans un sac.
Toutes les façons de joindre et de piloter des agents de codage sur un Mac fermé, de Remote Control à SSH, sont dans piloter vos agents de codage IA depuis votre téléphone.
Pourquoi Claude Code s’arrête-t-il à cause d’une limite d’utilisation ?
Les forfaits par abonnement ont un quota glissant. Quand il est épuisé, Claude Code affiche You've hit your session limit · resets 3:45pm (ou la limite hebdomadaire, Opus ou Sonnet) et « bloque les requêtes suivantes jusqu’à l’heure de réinitialisation indiquée dans le message » (erreurs). Les limites de session et hebdomadaire couvrent tous les modèles ; les limites Opus et Sonnet ne couvrent qu’une famille : /model peut donc vous faire passer à une autre et vous permettre de continuer.
Pour une longue exécution sans surveillance, Anthropic documente CLAUDE_CODE_RETRY_WATCHDOG=1, qui relance les requêtes après une erreur de capacité au lieu d’échouer ; cela ne lève pas votre propre limite d’utilisation.
Pourquoi Claude Code se met-il en pause et attend-il ?
Parce qu’il a besoin de votre réponse. Une demande d’autorisation ou une question reste ouverte jusqu’à votre réponse ; dans une tâche planifiée de l’app de bureau en mode Manual qui a besoin d’un outil non approuvé, « l’exécution reste bloquée jusqu’à ce que vous l’approuviez » (tâches planifiées).
Autorisez avant de partir les outils dont la tâche a besoin, ou répondez depuis votre téléphone : avec Remote Control, « Push when actions required » dans /config envoie les demandes d’autorisation à l’app Claude (Remote Control). La configuration est décrite dans piloter Claude Code depuis votre téléphone.
Pourquoi Claude Code s’arrête-t-il quand la connexion réseau est coupée ?
Une connexion qui échoue met fin à une requête : Unable to connect to API. Check your internet connection, Request timed out ou Connection dropped (ECONNRESET) (erreurs). Claude Code réessaie d’abord, et une session Remote Control interactive continue de réessayer tant que la panne dure, alors que le mode serveur « abandonne au bout d’environ 10 minutes » (Remote Control). Keep Mac Awake ne maintient pas la connexion Wi-Fi, ni celle d’un VPN ou de Tailscale.
Pourquoi la session disparaît-elle ?
Le processus claude s’est terminé. Fermer le terminal, quitter l’app de bureau ou VS Code, ou perdre une connexion SSH l’arrête. Le conseil d’Anthropic pour une machine distante : « lancez-le dans tmux ou screen » (Remote Control). claude --continue charge « la conversation la plus récente du répertoire courant » (référence de la CLI).
Questions fréquentes
Pourquoi Claude Code s’arrête-t-il sans cesse quand je ferme mon ordinateur portable ?
La fermeture du capot met un MacBook en veille, et Claude Code ne tourne que tant que le Mac est éveillé. Lancez une session Keep Mac Awake avant de fermer le capot, ou utilisez un écran externe avec alimentation, clavier et souris.
Comment faire reprendre Claude Code après un arrêt ?
Corrigez la cause, puis répondez continue ; selon la documentation d’Anthropic, Claude reprend à partir de son dernier bloc terminé. Pour une exécution non interactive, reprenez la session et envoyez continue.
Le réglage « Keep computer awake » de l’app Claude empêche-t-il Claude Code de s’arrêter ?
Seulement capot ouvert. Il empêche la mise en veille automatique, et la documentation d’Anthropic précise que la fermeture du capot met quand même le Mac en veille.
Pourquoi Claude Code s’arrête-t-il pendant la nuit ?
Le plus souvent, le Mac s’est mis en veille, une limite d’utilisation a été atteinte ou une demande attendait votre accord. La liste de contrôle pour une nuit sans surveillance est dans faire tourner des agents IA toute la nuit sur un MacBook.
Claude Code utilise-t-il caffeinate ?
Sur macOS, oui, contre la mise en veille automatique : le journal des modifications d’Anthropic mentionne le processus caffeinate lancé par Claude Code, dans un correctif pour un processus qui continuait à « empêcher le Mac de se mettre en veille » après l’arrêt de Claude Code (changelog). Cela couvre l’inactivité, pas le capot : la documentation d’Apple sur l’assertion d’alimentation (power assertion) contre la mise en veille automatique indique que le système « peut quand même se mettre en veille à la fermeture du capot » (documentation Apple pour les développeurs).
Claude Code peut-il garder le Mac éveillé lui-même ?
Oui, si l’app Keep Mac Awake est installée : Claude Code peut lancer keepmacawake start --hours N --json avant une tâche longue et keepmacawake stop --json après. Une session ne démarre jamais d’elle-même.
Sources
- Documentation de Claude Code : Error reference
- Documentation de Claude Code : Desktop scheduled tasks
- Documentation de Claude Code : Remote Control
- Documentation de Claude Code : CLI reference
- Documentation de Claude Code : Changelog
- Documentation Apple pour les développeurs : kIOPMAssertionTypePreventUserIdleSystemSleep
- Assistance Apple : Suspendre l’activité d’un Mac ou le réactiver
- Assistance Apple : Définir des réglages de suspension d’activité et de réactivation pour un Mac
- Assistance Apple : Si votre écran externe n’affiche aucune image ou ne fonctionne qu’en basse résolution
- Keep Mac Awake : ligne de commande