---
title: "« Request timed out » dans Claude Code sur Mac · Guides Kilobat"
url: "https://kilobat.app/fr/guides/claude-code-request-timed-out"
description: "Claude Code sur votre Mac affiche Request timed out. L’API n’a pas répondu avant le délai. Vérifiez le réseau, un proxy et le réglage du délai d’expiration."
---

# « 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.

**Réglez-le avec votre agent**Copie un prompt pour Claude Code, Codex ou tout agent capable d’utiliser Terminal.

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.

S’applique à : Claude Code dans un terminal, sur toutes les versions actuelles de macOS. · Vérifié le 29 octobre 2026

## Symptômes

- Claude Code affiche `Request timed out` aprè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

1. Testez l’hôte de l’API depuis le même shell.

   ```
   curl -I https://api.anthropic.com
   ```
2. Vérifiez votre version.

   ```
   claude --version
   ```
3. Affichez les variables de proxy.

   ```
   env | grep -i proxy
   ```
4. Lancez les vérifications de configuration dans Claude Code.

   ```
   /doctor
   ```

## Comment corriger

1. Relancez la requête.
2. Sur un réseau ou un proxy lent, augmentez le délai d’expiration.

   ```
   export API_TIMEOUT_MS=900000
   ```
3. Mettez Claude Code à jour si vous avez défini le délai à 0.
4. Si les expirations sont fréquentes, testez un autre réseau et le VPN.

## Avec Kilobat

1. 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.com
   ```
2. Ces vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec `diagnose_connection` et `diagnose_network`. Consultez [Trouver pourquoi un site ou une API ne se connecte pas](https://kilobat.app/fr/guides/recipes/why-cant-it-connect).

## 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

- [Claude Code : référence des erreurs](https://code.claude.com/docs/en/errors.md)
- [Claude Code : configuration réseau en entreprise](https://code.claude.com/docs/en/network-config.md)

Vérifié le 29 octobre 2026.

## Guides associés

- [« Unable to connect to API » dans Claude Code sur Mac](https://kilobat.app/fr/guides/claude-code-unable-to-connect-to-api): Claude Code affiche Unable to connect to API quand une requête n’atteint pas api.anthropic.com.
- [ERR_CONNECTION_TIMED_OUT dans Chrome sur Mac](https://kilobat.app/fr/guides/err-connection-timed-out): Chromium décrit cette erreur ainsi : « A connection attempt timed out. » (une tentative de connexion a expiré). Chrome a trouvé l’adresse, mais le serveur n’a pas répondu à temps.
- [Bufferbloat : les appels rament quand le réseau est chargé](https://kilobat.app/fr/guides/bufferbloat-mac): Le bufferbloat est la latence qu’ajoutent les appareils réseau quand ils gardent trop de données dans leurs tampons.
- [Tester la perte de paquets sur un Mac avec ping](https://kilobat.app/fr/guides/packet-loss-mac): La perte de paquets hache les appels et bloque le chargement des pages.
