API Error: Connection lost mid-response. The response above may be incomplete. Ce message, vous le connaissez peut-être déjà par cœur si vous utilisez régulièrement Claude Code CLI. Comme un mauvais ex qui revient toujours, il a le chic pour apparaître au pire moment : en plein debug, pendant une analyse un peu longue ou alors que Claude est en train de modifier plusieurs fichiers. Et bien sûr, rarement au début. Non, plutôt après plusieurs minutes de boulot, quand tout semblait parfaitement bien parti.
Pourquoi Claude Code perd-il la connexion ?
Derrière ce message se cache finalement quelque chose d’assez simple : Claude Code était en train de recevoir une réponse et la connexion a été interrompue avant la fin. Cela peut venir de votre connexion, d’un VPN, d’un proxy, d’un équipement réseau intermédiaire ou simplement d’un problème temporaire côté service.
Le plus pénible reste le manque d’informations. Pas vraiment de cause précise, juste Connection lost mid-response et l’avertissement que la réponse peut être incomplète. Sur Claude Code, c’est particulièrement gênant puisque le CLI peut avoir analysé ou modifié plusieurs fichiers avant de s’arrêter. On ne sait donc pas immédiatement jusqu’où il est allé.
Comment limiter la casse ?
Premier réflexe : ne relancez pas immédiatement toute la tâche. Regardez d’abord ce que Claude a réellement fait :
git status git diff
Vous saurez rapidement si des fichiers ont déjà été modifiés et si le travail semble complet. Ensuite, Claude Code permet justement de reprendre une conversation interrompue. Pour continuer la dernière session :
claude --continue
Vous pouvez alors simplement lui demander de vérifier où il s’est arrêté et de terminer la tâche précédente. C’est généralement préférable à une nouvelle session qui repartirait sans connaître précisément le travail déjà effectué.
Pour les grosses modifications, Git reste également votre meilleure sécurité. Faites un commit avant de laisser Claude attaquer un gros refactoring. En cas de coupure, un simple git diff permet de voir exactement ce qui a été fait.
Enfin, si l’erreur revient très régulièrement, essayez Claude Code depuis une autre connexion, notamment sans VPN ou via un partage de connexion mobile. Cela permet rapidement de déterminer si le problème semble lié à votre réseau ou s’il se produit indépendamment de votre environnement.
En résumé : oui, c’est chiant, surtout quand Claude Code travaille depuis plusieurs minutes. Mais une coupure ne signifie pas forcément que tout est perdu. Vérifiez les modifications, reprenez la session et demandez-lui de contrôler puis terminer son travail. Dans la majorité des cas, c’est beaucoup moins douloureux que de repartir complètement de zéro.