« Request timed out » dans Claude Code sur Mac
Claude Code affiche Request timed out quand l’API ne répond pas avant le délai de connexion. Le délai d’expiration par défaut d’une requête est de 10 minutes.
Mon Mac a ce problème : « Request timed out » dans Claude Code sur Mac. Lis https://kilobat.app/fr/guides/claude-code-request-timed-out.md et résous-le avec moi. Installe la CLI Kilobat si elle manque : brew install seifip/kilobat/kilobat. Lance toi-même les vérifications Terminal et kilobat du guide et dis-moi ce que tu trouves. Liste les étapes que moi seul peux faire. Demande-moi avant de modifier un réglage.
Symptômes
- Claude Code affiche
Request timed outaprès une longue attente. - Cela arrive sur les réseaux lents, derrière des proxys ou pour de grosses requêtes.
- Certaines nouvelles tentatives fonctionnent.
Causes probables
- Un réseau ou un proxy lent. La documentation indique qu’un réseau ou un proxy lent peut en être la cause.
- Une connexion bloquée. Un VPN ou un coupe-feu peut retenir les paquets, si bien qu’aucune réponse n’arrive.
- Une grosse requête. Une requête sans streaming garde une limite de 300 secondes dans une session locale.
- Un délai nul sur une ancienne version. Sur les versions antérieures à v2.1.305, définir API_TIMEOUT_MS à 0 peut faire échouer toutes les requêtes.
Comment vérifier
Testez l’hôte de l’API depuis le même shell.
curl -I https://api.anthropic.comVérifiez votre version.
claude --versionAffichez les variables de proxy.
env | grep -i proxyLancez les vérifications de configuration dans Claude Code.
/doctor
Comment corriger
Relancez la requête.
Sur un réseau ou un proxy lent, augmentez le délai d’expiration.
export API_TIMEOUT_MS=900000Mettez Claude Code à jour si vous avez défini le délai à 0.
Si les expirations sont fréquentes, testez un autre réseau et le VPN.
Avec Kilobat
Le diagnostic de connexion de Kilobat teste l’hôte de l’API couche par couche. Il nomme la couche qui échoue ou qui est lente.
kilobat why https://api.anthropic.comCes vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec
diagnose_connectionetdiagnose_network. Consultez Trouver pourquoi un site ou une API ne se connecte pas.
Questions
Quel est le délai par défaut ?
La documentation de Claude Code indique 10 minutes pour le délai d’expiration d’une requête.
API_TIMEOUT_MS=0 désactive-t-il tous les délais ?
Non. Le délai du premier octet et le délai d’inactivité du corps de la réponse restent actifs.
Sources
Vérifié le 29 octobre 2026.