Claude Code timeout, jak naprawić 2026

Spis treści

• Co to timeout w Claude Code
• Typowe przyczyny
• Konfiguracja timeoutów
• Wybór modelu pod task
• Problemy sieciowe
• FAQ

Claude Code zwraca "Request timed out after 60s" w środku ważnego refactoru. Frustrujące, ale zwykle naprawialne. Poniżej co to znaczy, dlaczego się dzieje, jak skonfigurować timeouts i kiedy lepiej użyć Plan Mode / subagents zamiast walczyć z timeoutem.

Co to timeout w Claude Code

Timeout to maksymalny czas, jaki Claude Code czeka na odpowiedź od Anthropic API. Default 60-120 sekund (zależy od wersji). Po przekroczeniu klient HTTP zrywa połączenie i zwraca error. Inference Claude może trwać długo dla bardzo długich response (10k+ output tokens) lub przy heavy reasoning (Opus na trudnym debugu).

Typowe przyczyny timeoutów

1. Bardzo długi task. Refactor 50+ plików w jednym kroku, generowanie 10 stron dokumentacji. Claude potrzebuje minut
2. Slow network. Corporate proxy, VPN, wolny DNS. Test: time curl https://api.anthropic.com
3. Anthropic outage / degradacja. Sprawdź status.anthropic.com
4. Rate limit z retry-after > timeout. Anthropic mówi "retry za 90s", twój timeout 60s, request umiera
5. MCP server hangs. Server nie odpowiada, Claude czeka, timeout

Konfiguracja timeoutów

Per session (zmienna środowiskowa)

export ANTHROPIC_TIMEOUT=300000  # 5 minut w milisekundach
claude

Per project (settings.json)

{
  "timeout_ms": 300000,
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["@linear/mcp-server"],
      "timeout": 30000
    }
  }
}

SDK (Python / TypeScript)

# Python
from anthropic import Anthropic
client = Anthropic(timeout=300.0)  # 5 minut

# TypeScript
const client = new Anthropic({ timeout: 300000 });

Wybór modelu pod task

Im mocniejszy model, tym wolniejszy. Opus 4.7 dla średnio złożonego refactoru łatwo przekracza 60s. Sonnet 4.6 ten sam task zrobi w 20-30s.

Task	Rekomendacja	Typowy czas
Klasyfikacja / format	Haiku 4.5	1-3s
Code generation pojedyncza funkcja	Sonnet 4.6	3-10s
Multi-file refactor (5-10 plików)	Sonnet 4.6	15-45s
Complex debug (analiza algo)	Opus 4.7	30-120s
Migracja stacku (30+ plików)	Sonnet + Plan Mode	Multi-step, każdy < 60s

Problemy sieciowe

Test latency:

time curl -I https://api.anthropic.com/v1/models -H "x-api-key: $ANTHROPIC_API_KEY"

Normalne: < 500ms. Powyżej 2s problem sieci.

Fix:

• Proxy: export HTTPS_PROXY=http://proxy.firma.pl:8080
• VPN: spróbuj split tunneling albo bez VPN
• DNS: zmień na Cloudflare 1.1.1.1 lub Google 8.8.8.8
• Corporate CA: export NODE_EXTRA_CA_CERTS=/path/corp-ca.pem

Alternatywa do walki z timeoutami: użyj Plan Mode (rozbija zadanie na mniejsze kroki) albo subagents (parallel execution, każdy z własnym timeout). Czasem lepsze niż próba zwiększenia timeout.

Najczęściej zadawane pytania

Powiązane artykuły

Claude Code•9 min

Claude Code cena 2026, ile kosztuje i czy jest darmowy

Claude Code cena w PLN i USD, plany Pro i Max, API pay-as-you-go, darmowe kredyty i alternatywy. Najtańsza legalna ścieżka. Stan maj 2026.

Czytaj

Claude Code•9 min

Claude Max plan po polsku, ceny i limity 2026

Plan Claude Max po polsku: ceny Max 5x i 20x, ile zapytań daje, Claude Pro vs Max, Max vs API. Limity sesji i tygodniowe. Stan maj 2026, dla kogo warto.

Czytaj

Claude Code•15 min

Claude Code Skills po polsku, tutorial Agent Skills 2026

Pierwszy polski tutorial Agent Skills w Claude Code. SKILL.md, frontmatter, progressive disclosure, jak tworzyć skille krok po kroku, vs subagents i MCP.

Czytaj