Odzyskiwanie po błędach i odporność

Naucz się elegancko obsługiwać awarie, odzyskiwać po błędach i budować odporne przepływy pracy z Claude Code. Ten przewodnik obejmuje wszystko od prostych ponownych prób po złożone strategie odzyskiwania, zapewniając, że twoje programowanie wspomagane AI pozostanie produktywne nawet gdy coś pójdzie nie tak.

Zrozumienie błędów Claude Code

Główne kategorie błędów

Błędy Claude Code zazwyczaj należą do tych kategorii:

1. Błędy uprawnień - Wykonanie narzędzia zablokowane
2. Błędy kontekstu - Limity tokenów lub problemy z pamięcią
3. Błędy wykonania - Niepowodzenia poleceń lub problemy składniowe
4. Błędy połączenia - Problemy z siecią lub serwerem MCP
5. Błędy modelu - Zamieszanie AI lub niepoprawne wyniki

Wskaźniki błędów

Claude zapewnia wyraźną wizualną informację zwrotną, gdy występują błędy:

1. Czerwone komunikaty błędów - Bezpośrednie niepowodzenia poleceń
2. Żółte ostrzeżenia - Problemy niekrytyczne
3. Niepowodzenia wykonania narzędzi - Wyraźny komunikat błędu
4. Sugestie ponownych prób - Claude często sugeruje poprawki

Odzyskiwanie oparte na uprawnieniach

Problem uprawnień

Domyślnie Claude pyta o pozwolenie na każdą potencjalnie ryzykowną operację:

# To jest ciągle przerywane:
claude "Refactor the authentication system"
# → "Can I edit auth/login.js?" [y/n]
# → "Can I run git add?" [y/n]
# → "Can I edit auth/session.js?" [y/n]

Rozwiązanie 1: Pomiń uprawnienia (zalecane dla rozwoju)

Tryb YOLO

# Pomiń wszystkie prośby o pozwolenie dla nieprzerwanego przepływu pracy
claude --dangerously-skip-permissions

Ten tryb jest bezpieczny dla:

• Środowisk programistycznych
• Przestrzeni roboczych w kontenerach
• Projektów z dobrymi kopiami zapasowymi

Rozwiązanie 2: Skonfiguruj dozwolone narzędzia

1. Użyj polecenia /permissions do zarządzania dozwolonymi narzędziami
2. Dodaj konkretne narzędzia do listy dozwolonych: Edit, View, Bash(git:*)
3. Zapisz preferencje w .claude/settings.json:

{
  "allowedTools": [
    "Edit",
    "View",
    "Bash(git:*)",
    "Bash(npm:*)",
    "mcp__git__*"
  ]
}

Rozwiązanie 3: Uprawnienia specyficzne dla sesji

# Zezwól na konkretne narzędzia tylko dla tej sesji
claude --allowedTools "Edit,View,Bash(git:*)"

Odzyskiwanie po błędach wykonania

Niepowodzenia poleceń

Gdy polecenia zawodzą, Claude zazwyczaj:

1. Pokazuje błąd - Pełny komunikat stderr
2. Analizuje przyczynę - Identyfikuje, co poszło nie tak
3. Sugeruje poprawki - Proponuje rozwiązania
4. Ponawia automatycznie - Jeśli zatwierdzisz

Wskazówka

Claude uczy się z błędów w trakcie sesji. Jeśli npm install nie powiedzie się z powodu uprawnień, może zasugerować użycie innego podejścia lub naprawienie uprawnień w pierwszej kolejności.

Techniki ręcznego odzyskiwania

Cofnij zmiany

# Cofnij ostatnią zmianę
/undo

# Lub poproś Claude o przywrócenie
"Please undo the last file edit"

# Odzyskiwanie oparte na Git
"git checkout -- filename.js"

Odzyskiwanie edycji

# Jeśli edycja poszła źle
"The last change broke the syntax, please fix it"

# Claude ponownie odczyta plik i poprawi błędy

Odzyskiwanie sesji

# Rozgałęź od poprzedniego punktu
# Naciśnij Esc dwukrotnie, następnie wybierz poprzednią wiadomość

# Lub zacznij od nowa
/clear

Błędy kontekstu i pamięci

Odzyskiwanie po przekroczeniu limitu tokenów

Gdy osiągasz limity kontekstu:

1. Wyczyść niepotrzebny kontekst: /clear
2. Rozpocznij nową sesję ze skupionym kontekstem
3. Eksportuj ważny stan do CLAUDE.md
4. Użyj modularnych plików pamięci

Wzorzec zarządzania kontekstem

# W CLAUDE.md
## Aktualny stan zadania
- Ukończone: Refaktoryzacja uwierzytelniania
- W trakcie: Zarządzanie sesją
- Następne: Implementacja testów

## Kluczowe decyzje
- Używanie JWT dla sesji
- Redis do przechowywania sesji
- Wygaśnięcie po 24 godzinach

Zapobieganie przepełnieniu pamięci

# Zanim kontekst stanie się zbyt duży
claude "Save our current progress to CLAUDE.md"

# Następnie wyczyść i kontynuuj
/clear
claude "Continue from CLAUDE.md progress"

Błędy połączenia i MCP

Odzyskiwanie serwera MCP

Problemy z połączeniem

# Sprawdź status serwera MCP
claude mcp list

# Uruchom ponownie konkretny serwer
# (Uruchom ponownie aplikację zapewniającą serwer)

# Debuguj problemy MCP
claude --mcp-debug

Problemy z timeout

# Zwiększ timeout dla wolnych operacji
export MCP_TIMEOUT=30000  # 30 sekund

# Lub skonfiguruj w ustawieniach
{
  "mcpTimeout": 30000
}

Błędy konfiguracji

# Zwaliduj konfigurację MCP
cat .mcp.json | jq .

# Przetestuj pojedynczy serwer
claude "Test the GitHub MCP connection"

Odzyskiwanie po zamieszaniu modelu

Gdy Claude się myli

Oznaki zamieszania modelu:

• Powtarzanie tych samych błędów
• Niezrozumienie wymagań
• Krążenie w kółko
• Sugerowanie niepoprawnych rozwiązań

Strategie odzyskiwania

1. Wyczyść i uruchom ponownie z lepszym kontekstem
2. Podziel problem na mniejsze części
3. Zapewnij wyraźne przykłady pożądanego wyniku
4. Przełącz modele jeśli dostępne
5. Użyj uporządkowanych promptów z jasnymi krokami

Szablon odzyskiwania po zamieszaniu

Zacznijmy od nowa. Oto czego potrzebujemy:

1. Stan obecny: [opisz, co istnieje]
2. Pożądany wynik: [opisz, czego chcesz]
3. Ograniczenia: [wszelkie limitacje]
4. Przykład: [podaj konkretny przykład]

Proszę podejdź do tego krok po kroku.

Zaawansowane wzorce odzyskiwania

Odzyskiwanie oparte na punktach kontrolnych

Twórz punkty kontrolne odzyskiwania podczas złożonych operacji:

# Przed ryzykownymi zmianami
git add -A && git commit -m "Checkpoint: before auth refactor"

# Lub użyj Claude
claude "Create a git checkpoint before we proceed"

Uporządkowana obsługa błędów

Implementuj przepływy pracy świadome błędów:

# Powiedz Claude, żeby był ostrożny
claude "Implement the API client with comprehensive error handling"

# Claude doda bloki try-catch, walidację i rozwiązania zapasowe

Skrypty odzyskiwania

Twórz polecenia odzyskiwania w .claude/commands/:

.claude/commands/recover.md

Podczas odzyskiwania po błędach:
1. Uruchom git status, aby sprawdzić zmiany
2. Uruchom testy, aby zweryfikować funkcjonalność
3. Sprawdź logi pod kątem ostatnich błędów
4. Przywróć z ostatniego znanego dobrego stanu jeśli potrzeba

Wykonaj: $ARGUMENTS

Przewodnik rozwiązywania problemów

Częste problemy i rozwiązania

Problemy z instalacją

Błędy uprawnień NPM:

# Napraw prefix npm
npm config set prefix ~/.npm-global
export PATH=$PATH:~/.npm-global/bin

# Lub zmigruj do instalacji lokalnej
claude migrate-installer

Brakujące polecenia:

# Zweryfikuj instalację
which claude
claude doctor

# Przeinstaluj jeśli potrzeba
npm install -g @anthropic-ai/claude-code

Problemy z uwierzytelnianiem

Problemy z logowaniem:

# Wyczyść auth i uruchom ponownie
rm -rf ~/.config/claude-code/auth.json
claude

# Lub użyj polecenia /logout
/logout

Problemy z kluczem API:

# Sprawdź środowisko
echo $ANTHROPIC_API_KEY

# Ustaw jeśli brakuje
export ANTHROPIC_API_KEY="your-key"

Problemy z wydajnością

Wysokie zużycie CPU/pamięci:

# Sprawdź procesy Claude
ps aux | grep claude

# Uruchom ponownie jeśli potrzeba
pkill -f claude
claude

Wolne odpowiedzi:

• Wyczyść kontekst z /clear
• Ogranicz dołączenia plików
• Używaj skupionych promptów
• Sprawdź łączność sieciową

Budowanie odpornych przepływów pracy

Wzorce tolerancji błędów

Odporny przepływ programistyczny

1. Zawsze pracuj na gałęziach - Łatwy rollback
2. Commituj często - Więcej punktów odzyskiwania
3. Testuj przyrostowo - Wyłap błędy wcześnie
4. Używaj ostrożnych promptów - Proś o obsługę błędów
5. Utrzymuj kopie zapasowe - Zewnętrzne względem git

Automatyczne odzyskiwanie

Skonfiguruj haki dla automatycznego odzyskiwania:

{
  "hooks": {
    "postToolUse": [
      {
        "match": "Error",
        "command": "git status && npm test"
      }
    ]
  }
}

Wzorce błędów zespołowych

Dokumentuj częste błędy w CLAUDE.md:

## Częste błędy i poprawki

### Module Not Found
- Przyczyna: Brakujący npm install
- Poprawka: Uruchom `npm install` lub sprawdź package.json

### Błędy typów
- Przyczyna: Tryb strict TypeScript
- Poprawka: Dodaj odpowiednie adnotacje typów

### Permission Denied
- Przyczyna: Uprawnienia plików
- Poprawka: Sprawdź właściciela z `ls -la`

Awaryjne odzyskiwanie

Gdy wszystko idzie źle:

1. Zatrzymaj Claude: Naciśnij Esc lub Ctrl+C
2. Oceń szkody: git status i git diff
3. Przywróć jeśli potrzeba: git checkout .
4. Sprawdź kopie zapasowe: Time Machine, snapshoty, itp.
5. Zacznij od nowa: Nowy terminal, nowa sesja
6. Zgłoś problemy: Jeśli błąd Claude, zgłoś do Anthropic

Uwaga

Zawsze utrzymuj kopie zapasowe poza git dla kluczowych projektów. Claude jest potężny, ale nie nieomylny.

Wskazówki zapobiegania błędom

Proaktywne zapobieganie błędom

• Używaj kontenerów dla izolowanych środowisk
• Skonfiguruj CI/CD do wczesnego wyłapywania błędów
• Skonfiguruj lintery, które Claude szanuje
• Dokumentuj pułapki w CLAUDE.md
• Testuj na stagingu przed produkcją
• Używaj kontroli wersji religijnie

Co dalej?

Ukończyłeś przewodnik szybkiego startu Claude Code! Oto twoje następne kroki:

Zaawansowane techniki Opanuj funkcje Claude Code na poziomie eksperta

Ekosystem MCP Eksploruj zaawansowane konfiguracje serwerów MCP

Przepływy pracy zespołowe Skaluj Claude Code w swojej organizacji

Pamiętaj: błędy to możliwości uczenia się. Każde niepowodzenie uczy Claude (i ciebie), jak lepiej radzić sobie z podobnymi sytuacjami w przyszłości. Przyjmij iteracyjny proces i buduj coraz bardziej odporne przepływy pracy.