Claude Code nie działa, co robić, troubleshooting 2026

Spis treści

• Szybka diagnoza w 5 minut
• Problem z instalacją CLI
• Brak / nieprawidłowy API key
• Problem z siecią / proxy
• Model nie odpowiada
• Permission denied
• Gdzie szukać logów
• FAQ

Claude Code nie startuje, wisi po prompcie, zwraca cryptic error. Najczęściej winowajca to jedna z 5 rzeczy: instalacja, API key, sieć, model, uprawnienia. Poniżej szybka diagnoza w 5 minut + szczegółowe rozwiązania dla każdego problemu.

Szybka diagnoza w 5 minut

Uruchom te 4 komendy po kolei i sprawdź output:

which claude
claude --version
echo $ANTHROPIC_API_KEY | head -c 12
claude --debug 2>&1 | head -30

Jeśli which claude zwraca nic, masz problem z instalacją (przejdź do sekcji niżej). Jeśli $ANTHROPIC_API_KEY jest puste albo nie zaczyna się od sk-ant-, masz problem z kluczem. Jeśli --debug pokazuje błąd sieci, problem z corporate firewall lub proxy.

Problem z instalacją CLI

Najczęstsze przyczyny problemów po npm install -g @anthropic-ai/claude-code:

• Brak npm global bin w PATH. Sprawdź npm config get prefix, dodaj <prefix>/bin do PATH (w ~/.bashrc lub ~/.zshrc)
• Permission denied na npm global. Nie używaj sudo npm install -g (psuje permissions). Zamiast tego skonfiguruj npm na własny katalog: mkdir ~/.npm-global && npm config set prefix '~/.npm-global'
• Node version < 18. Claude Code wymaga Node 18+. Sprawdź node --version i zaktualizuj przez nvm: nvm install 22 && nvm use 22
• Windows natywny. Znane problemy z PATH i CRLF endings. Rekomendowane: WSL2 z Ubuntu

Brak / nieprawidłowy API key

Dwa sposoby autoryzacji w Claude Code:

1. API key z console.anthropic.com. Wygeneruj klucz, ustaw export ANTHROPIC_API_KEY=sk-ant-xxx w ~/.bashrc. Klucz zaczyna od sk-ant-, ma około 80 znaków
2. Claude Pro / Max subscription. claude /login, OAuth flow w przeglądarce. Używa limitów subskrypcji zamiast pay-per-use

Najczęstsze błędy: klucz w cudzysłowach (usuń), spacja na końcu (usuń), klucz z console.openai.com (to inny serwis). Sprawdź claude /status żeby zobaczyć aktualne uwierzytelnienie.

Problem z siecią / proxy

Corporate networks często blokują api.anthropic.com. Test:

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

Jeśli timeout, configure proxy:

export HTTPS_PROXY=http://proxy.firma.pl:8080
export HTTP_PROXY=http://proxy.firma.pl:8080

Jeśli firma używa SSL inspection (corporate CA), dodaj firmowy CA cert: export NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem.

Model nie odpowiada

Najczęstsze przyczyny:

• Rate limit. Sprawdź usage na console.anthropic.com. Tier 1 ma niskie limity, przejdź na tier 2+ przez wpłatę credits
• Model deprecated. Sprawdź dostępne modele: claude /model. Jeśli używasz starego np. claude-3-opus, przełącz na claude-opus-4-7
• Context window exceeded. Sonnet/Opus ma 200k tokens. Przy długiej sesji wyczyść kontekst: claude /clear
• Streaming response zerwany. Problem sieci, sprawdź połączenie

Permission denied

Claude Code ma system uprawnień w .claude/settings.json:

{
  "permissions": {
    "allow": [
      "Read(*)",
      "Edit(src/**, tests/**)",
      "Bash(npm:*, git:*, npx prettier:*)"
    ],
    "deny": [
      "Bash(rm -rf:*)",
      "Edit(.env*)",
      "Edit(secrets/**)"
    ]
  }
}

Jeśli Claude zwraca permission denied, prawdopodobnie próbuje robić operację poza allow. Dodaj nowy pattern albo użyj claude --allowed-tools "Bash(*)" dla wide access (tylko w bezpiecznym środowisku).

Gdzie szukać logów

Logi sessji w ~/.claude/logs/:

• session-<id>.log - pełna historia sesji
• tool-uses.log - lista wykonanych narzędzi
• errors.log - errory globalne

Uruchom z flagą --debug żeby zobaczyć verbose output w terminalu. Jeśli problem persisting, użyj claude /bug żeby zgłosić do Anthropic z attached session log.

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