Återställa Claude Code: säkert läge, /cd och reservmodell

Praktiskt material om att arbeta med agenter: Ailoot-dokumentation.

Vad förändras i Claude Code i juni 2026?#

Tidigare fanns det bara en utväg när Claude Code började bete sig konstigt – en oändlig laddningssnurra, en krasch vid start, agenten som ignorerade regler i CLAUDE.md eller en hook som inte kördes utan att säga till: kommentera manuellt bort delar av .claude/settings.json, inaktivera MCP-servrar en i taget eller, i värsta fall, radera ~/.claude och installera om. I ett beskrivet fall raderades ~/.claude, och MCP-serverkonfigurationen som hade tagit en och en halv timme att sätta ihop gick förlorad. Senare visade det sig att en rad i CLAUDE.md var boven och kunde ha hittats på 10 sekunder – men det blev tydligt först efter en fullständig återställning.

I juni 2026 rullade Anthropic ut tre mekanismer som förändrar det här scenariot. Kortfattat: vad som kom och när:

Nedan förklaras varje mekanism steg för steg, tillsammans med i vilken ordning du bör använda dem när en Claude Code-session hamnar på avvägar.

Vad får oftast Claude Code att sluta fungera?#

I det beskrivna exemplet sattes CLAUDE.md först ihop på 80 rader – och det fungerade i en månad. Under den andra månaden började det märkas att Claude en gång i veckan bröt mot alla regler som hade satts upp: rörde .env, körde git push --force, rotade runt i node_modules. Inte avsiktligt – den glömde helt enkelt. En gång raderades .gitignore, och orsaken var inte omedelbart tydlig. Scenariot behandlas mer ingående i guiden om CLAUDE.md.

När CLAUDE.md växer till 400+ rader börjar den skapa problem i det tysta: den tar upp en betydande del av kontextfönstret när sessionen startar och späder ut viktiga instruktioner med mindre viktiga. Claude läser fortfarande formellt filen, så utifrån ser det ut som ”reglerna finns där, men de fungerar inte” – ett typiskt tecken på ett överlastat avtal.

Hooks är den näst vanligaste felkällan. Claude Code hooks har en egenhet som Anthropic inte betonar.

Det innebär att sys.exit(1) i en Python-hook (eller något annat Unix-konventionellt ”misslyckades med ett fel”) inte stoppar Claude. Endast kod 2 är blockerande. I det beskrivna fallet betraktades hooken som ett ”absolut förbud”, men i praktiken loggade den ett klagomål och tillät åtgärden.

MCP-servrar är det tredje lagret, och de kan också fallera på sitt eget sätt.

Symptomet ser ofta likadant ut: MCP-kommandon är tillgängliga men returnerar failed utan en stacktrace. Mer om att konfigurera MCP och lägga till servrar med claude mcp add finns i den separata guiden.

Den fjärde felkällan är den hierarki med tre nivåer som settings.json har. Du har ~/.claude/settings.json (användarnivå), .claude/settings.json i projektets rot (projekt), .claude/settings.local.json (lokalt) och eventuellt hanterade inställningar från en företagsadministratör. De slås samman enligt prioritetsregler. När någon lägger till en MCP-server på projektnivå samtidigt som du har en liknande post med en annan startkonfiguration på användarnivå uppstår en tyst konflikt, som ser ut som att ”Claude Code är trasigt”.

Hur fungerar --safe-mode, och vad inaktiverar det?#

Anthropics ursprungliga formulering i ändringsloggen för v2.1.169 lyder:

Anthropic förtydligar i dokumentationen om modellkonfiguration:

Det här är ett diagnosverktyg, inte en ”ren miljö”. Säkert läge hjälper dig att besvara en fråga: ligger problemet i Claude Codes standardbeteende eller i de anpassningar som lagts till? Det här är en del av kontextteknik – att hantera vad Claude ser och inte ser vid varje given tidpunkt. Om allt fungerar i säkert läge är det tydligt att lagren behöver kontrolleras med binärsökning. Om det inte fungerar ligger problemet i själva installationen, auktoriseringen, nätverket eller infrastrukturen, och då är det rimligt att titta på claude doctor och loggarna.

Det här inaktiverar säkert läge (Anthropics officiella lista – 5 huvudlager):

• CLAUDE.md på alla nivåer (användare / projekt)
• Plugins
• Skills
• Hooks
• MCP-servrar

Det här fortsätter att fungera:

• Auktorisering (din OAuth-session eller API-nyckel)
• Modellval (--model sonnet, --model opus)
• Inbyggda verktyg (Read, Write, Bash, Grep och så vidare)
• Behörigheter
• Git-status
• Katalognamn

En viktig detalj: säkert läge inaktiverar inte hanterade/policyinställningar från en företagsadministratör. Om du arbetar i ett team där Bedrock GovCloud eller en MDM-konfiguration anger availableModels, gäller de begränsningarna fortfarande – säkert läge inaktiverar endast dina anpassningar, inte företagspolicyer.

Hur isolerar du ett lager och hittar boven på 60 sekunder?#

Ett felsökningsscenario för när Claude Code har ”slutat lyssna”. Den lägsta versionen för alla kommandon nedan är Claude Code v2.1.169. Om din version är äldre uppdaterar du först (npm update -g @anthropic-ai/claude-code eller Anthropics inbyggda installationsprogram).

1. Öppna samma mapp där problemen uppstod.
2. Kör claude --safe-mode.
3. Om programmet startar utan problem kontrollerar du din ursprungliga begäran. Fungerade den? Då ligger problemet i ett av lagren. Gå till steg 4.
4. Om det fortfarande inte fungerar i säkert läge ska du inte röra konfigurationerna. Kör först claude doctor; kontrollera auth, version och motstridiga installationer.

När säkert läge startar utan problem aktiverar du lagren ett i taget, med den mest sannolika boven först. Ordningen utgår från den beskrivna erfarenheten:

1. CLAUDE.md. Kör claude utan säkert läge, men byt tillfälligt namn på filen: mv CLAUDE.md CLAUDE.md.bak. Om det fungerar är filen orsaken. Sedan kan du göra en binärsökning: behåll hälften av raderna och kontrollera.
2. Hooks. Öppna .claude/settings.json och ange tillfälligt [] i avsnittet hooks. Starta om claude. Fungerar det? Då ligger problemet i en av hookarna. Aktivera dem en i taget.
3. MCP-servrar. Ange på samma sätt tillfälligt ett tomt objekt i avsnittet mcpServers i ~/.claude.json eller .claude/settings.json, starta sedan om och kontrollera.
4. Skills. Flytta .claude/skills/ till en tillfällig mapp. Starta och kontrollera.

Vad innebär ”tillfälligt namnbyte”? Filer raderas inte under felsökningen. mv eller git stash gör att du kan återställa allt med ett enda kommando om det visar sig att det lagret inte var boven.

Hur byter du arbetsmapp med /cd utan att förlora kontexten?#

Från ändringsloggen för v2.1.169 den 8 juni:

Varför är det användbart vid felsökning? Anta att du befinner dig i projektmappen ~/work/myapp och Claude Code beter sig konstigt. Tidigare var det enda sättet att kontrollera ”fungerar det över huvud taget?” att avsluta sessionen, gå till en annan mapp och starta igen. Du förlorade kontexten, historiken och den uppvärmda promptcachen. Nu kan du göra så här:

# In the same session:
/cd ~/sandbox/test

Claude byter till den nya mappen och läser dess CLAUDE.md (om den finns) som ett meddelande, inte som en ersättning för systemprompten – det innebär att cachen bevaras. Om allt fungerar i ~/sandbox/test är det tydligt att problemet låg i konfigurationen för ~/work/myapp.

Den 12 juni rättade v2.1.176 en besvärlig regression – /cd visade den gamla git-grenen tills programmet startades om helt. Om din version är äldre uppdaterar du eller ignorerar helt enkelt git status under de första meddelandena efter bytet – det hinner komma i kapp.

Hur konfigurerar du reservmodeller för ett 529-fel?#

I det beskrivna scenariot körs en lång uppgift i Opus i ett projekt en gång i veckan. Efter 10 minuter returnerar API:t 529 Overloaded och sessionen kraschar. Tidigare var du tvungen att antingen vänta eller byta manuellt till Sonnet med --model sonnet och förlora all uppvärmd kontext. I en stor business/-mapp med en second-brain-konfiguration tar det ungefär tjugo minuters arbete. Nu finns det en riktig mekanism.

Det exakta citatet från den officiella dokumentationen:

Och separat: så fungerar kedjan:

Det finns två sätt att konfigurera detta. Via CLI:

claude --fallback-model sonnet,haiku

Via ~/.claude/settings.json:

{
  "fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5"]
}

En separat detalj gäller hastighetsbegränsningar. Anthropic skickar avsiktligt inte ett 429-fel vidare genom kedjan, så att du inte kan kringgå begäransgränsen genom att växla till nästa modell. Reservmodellen används endast när den primära modellen är överbelastad, otillgänglig eller returnerar ett icke-återförsökbart serverfel (till exempel 529 Overloaded). Hastighetsbegränsningar följer den vanliga logiken för återförsök och väntetid.

Ytterligare en detalj: den 12 juni rättade v2.1.174 en regression där komprimering inte hade följt --fallback-model. Om du har en lång session som komprimeras när tjänsten är överbelastad anropades reservmodellen inte före den här rättningen. Om du arbetar med långa sessioner (/compact, /loop över natten) bör du uppdatera till minst v2.1.174.

Vad ska du åtgärda när CLAUDE.md, en hook, MCP eller en skill är boven?#

Här är konkreta strategier för varje lager.

Om CLAUDE.md är boven

Öppna filen och kontrollera storleken. Utifrån den beskrivna erfarenheten bör du hålla den aktiva CLAUDE.md på högst 200 rader och flytta resten till routrar och stödjande dokument bredvid projektet (hela strukturen för second brain finns i guiden om second brain). Om du har 400+ rader är filen nästan säkert boven. Steg:

1. Gör en säkerhetskopia: cp CLAUDE.md CLAUDE.md.full.
2. Återgå till en kort fungerande mall. En färdig mall finns i guiden ”Så konfigurerar du CLAUDE.md”.
3. Starta om Claude Code. Kontrollera.
4. Om det fungerar återställer du regler i små block om 10–20 rader och kontrollerar efter varje block.
5. Hitta blocket som försämrar beteendet. Skriv om det till en hook med rätt slutkod (slutkoder för hooks behandlas i nästa underavsnitt av den här H2-rubriken).

Om en hook är boven

Den viktigaste frågan är om slutkoden är korrekt. Claude Code-hooks använder:

• Slutkod 0 – allt är bra; åtgärden fortsätter.
• Slutkod 1 – ett fel, men inte blockerande. Claude fortsätter som om ingenting hade hänt.
• Slutkod 2 – ett blockerande fel. Endast den stoppar faktiskt åtgärden.

Om du skrev sys.exit(1) eller exit 1 i en shell-hook i tron att du blockerade, fungerar den koden som en varningslogg i Claude Code utan att stoppa åtgärden. Ändra den till 2. Mer information om hooks och hur du konfigurerar dem utan den här fallgropen finns i den separata guiden.

Ett annat vanligt fall är att en hook returnerar ogiltig JSON till stdout. Claude Code tolkar hookens svar som JSON, och om det finns ovidkommande innehåll (en logg, en förloppsmarkör, en emoji) betraktas hooken som misslyckad och åtgärden fortsätter. Regeln är: stdout innehåller endast JSON; allt annat går till stderr.

Det tredje fallet är en hook som läser något från ~/.claude/ som säkert läge har dolt. Det är ett normalt scenario. Lösningen är inte att ändra hooken, utan att kontrollera os.environ.get('CLAUDE_CODE_SAFE_MODE') i början och avsluta med 0.

Om en MCP-server är boven

Symtom: MCP-kommandon är tillgängliga men returnerar failed utan en tydlig stacktrace. Steg:

1. Kör claude mcp list – vilka servrar är definierade?
2. Inaktivera servrar en i taget i ~/.claude.json: byt namn på nyckeln claude-server-A till _claude-server-A (det inaktiverar den utan att radera den).
3. Starta om claude. Kontrollera vilka anrop som fungerar.
4. När du har hittat den skyldiga servern kontrollerar du dess logg: claude mcp logs <name>.
5. Om det är en tredjepartsserver (@modelcontextprotocol/server-postgres och liknande) kontrollerar du om den har en ny version. MCP-ekosystemet är fortfarande turbulent; servrar går regelbundet sönder i samband med uppdateringar av Claude Code.

Om du stöter på ”kraschar vid start, och bara med två MCP-servrar” jämför du beteendet i säkert läge utan MCP.

Om en skill är boven

En skill består av SKILL.md plus kod i .claude/skills/<name>/. Symtom: Claude ignorerar skillen, tillämpar den vid fel tillfälle eller tillämpar den men producerar skräp. Steg:

1. Öppna SKILL.md. Kontrollera beskrivningen – den bör vara 1–2 meningar och tydligt beskriva när den ska användas. Om det står ”en universell hjälpreda för allt” förstår Claude inte när den ska anropas.
2. Kontrollera om den motsäger CLAUDE.md. Om CLAUDE.md säger ”skriv alltid tester” men skillens beskrivning säger ”använd för snabb prototypning utan tester” finns det en konflikt.
3. Om skillen använder externa kommandon (npm, python, git) kontrollerar du att de är tillgängliga i systemets PATH. En skill har en egen minimal miljö.

Vad gör du om säkert läge inte hjälpte: diagnostisera och bevara tillstånd före reparation#

Radering av användartillstånd är ingen genväg för diagnostik. Identifiera felet med kontrollerna nedan; om de inte ger svar bevarar du underlaget och fortsätter undersöka. Varje installationsreparation börjar med verifierad säkerhetskopia och behåller befintligt konto och autentiseringslagringens identitet. Ordning:

1. claude doctor – automatisk diagnostik. Anthropic skriver i sin dokumentation:

2. Kontrollera om det finns motstridiga installationer. Många har både en global npm-version och det inbyggda installationsprogrammet installerade samtidigt:

3. Kontrollera om ANTHROPIC_API_KEY tar över din OAuth-session. Det här är en vanlig orsak till att ”ingenting fungerar, nyckeln har gått ut”:

Lösning: kör unset ANTHROPIC_API_KEY i den aktuella shell-sessionen eller ta bort variabeln från ~/.zshrc / ~/.bashrc.

4. Reparera bara installationen som diagnostiken identifierar; bevara allt användartillstånd först. Ett fel i säkert läge eller en oklar doctor-rapport fastställer inte att användardata måste tas bort. Stoppa alla Claude-sessioner och andra skrivande processer före en konsekvent säkerhetskopia. Behåll samma Unix-konto, HOME, operativsystemets säkra autentiseringslagring och Anthropic-konto; rotera inte nycklar och skapa ingen ersättningsidentitet.

Säkerhetskopieexemplet gäller Linux med GNU tar. Använd på macOS eller Windows ett verktyg som bevarar plattformens ACL:er, utökade attribut, länkar och metadata, och verifiera återställning före fortsatt arbete; anta inte att GNU-specifika flaggor fungerar där. Arkivet innehåller autentiseringsuppgifter och sessionstranskript: håll det privat och utanför kodförråd.

# Run as the same user who owns the Claude state, after stopping writers.
set -eu
umask 077
backup_dir=$(mktemp -d "$HOME/.claude-recovery-XXXXXXXX")
set --
if [ -e "$HOME/.claude" ] || [ -L "$HOME/.claude" ]; then
  set -- "$@" .claude
fi
if [ -e "$HOME/.claude.json" ] || [ -L "$HOME/.claude.json" ]; then
  set -- "$@" .claude.json
fi
[ "$#" -gt 0 ] || exit 1
tar --acls --xattrs --numeric-owner -cpf "$backup_dir/claude-state.tar" -C "$HOME" "$@"
tar --acls --xattrs --compare -f "$backup_dir/claude-state.tar" -C "$HOME"
sha256sum "$backup_dir/claude-state.tar" > "$backup_dir/claude-state.sha256"
(cd "$backup_dir" && sha256sum -c claude-state.sha256)
mkdir "$backup_dir/restore-check"
tar --acls --xattrs -xpf "$backup_dir/claude-state.tar" -C "$backup_dir/restore-check"
tar --acls --xattrs --compare -f "$backup_dir/claude-state.tar" -C "$backup_dir/restore-check"
printf 'Verified recovery directory: %s\n' "$backup_dir"

Alla kommandon måste lyckas. Arkivet täcker hela befintliga .claude-trädet, inklusive ignorerade/ospårade sessioner och pluginläge samt .claude.json, inte bara git-spårade inställningar. Om någon sökväg är en symbolisk länk eller data finns på en separat konfigurerad plats stannar du och inkluderar det upplösta målet i samma verifierade säkerhetskopia; att arkivera länken ensam kopierar inte målet. Arkivet innehåller inte macOS Keychain eller annan extern autentiseringslagring, så behåll de identiteterna på plats.

Om diagnostiken särskilt identifierar den äldre lokala installationen som den konkurrerande kopian flyttar du bara den installationen till den privata återställningskatalogen i stället för att radera konfiguration och sessioner:

# Use the verified backup_dir from the previous block.
if [ -d "$HOME/.claude/local" ]; then
  mv "$HOME/.claude/local" "$backup_dir/legacy-local"
fi

Avinstallera npm-installationen bara om diagnostiken identifierar den som konflikt och du avser behålla den fristående installationen. Använd sedan dokumenterat fristående installationsprogram utan att radera .claude eller .claude.json:

curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor

På Windows är det fristående installationskommandot fortfarande:

irm https://claude.ai/install.ps1 | iex

Återställ separat. Stoppa skrivande processer igen. Kontrollera arkivets kontrollsumma och extrahera till en tom återställningskatalog enligt ovan; jämför framgångsrikt före användning. Om flyttad äldre installation ska återställas bekräftar du först att $HOME/.claude/local inte finns och flyttar sedan $backup_dir/legacy-local tillbaka till exakt den sökvägen. Återställ en diagnostiserad inställningsfil från verifierad extraktion först efter att aktuell ersättare bevarats; skriv inte blint över hela trädet. Sessioner, MCP-inställningar och ursprunglig identitet bevaras. En git-ögonblicksbild ensam täcker inte ignorerade/ospårade transkript, autentiseringsuppgifter eller filsystemsmetadata.

Vad bör du INTE göra när Claude Code är trasigt?#

Ändra inte nycklar före felsökning

”Auktoriseringen fungerar inte” beror i 90% av fallen antingen på att ANTHROPIC_API_KEY tar över prenumerationen, ett UI-fel i en hook eller en MCP som har misslyckats. Att byta nycklar löser inget av detta, men orsakar ytterligare en timmes avbrott: du måste återkalla den gamla nyckeln, utfärda en ny, signera om CI med den och uppdatera variablerna i produktion. Kör claude --safe-mode först. Fungerar det? Då ligger problemet i anpassningarna; du behöver inte röra nycklarna.

Gör inte en fullständig återställning innan du har provat säkert läge

Säkert läge ger dig en isolerad miljö på 1 sekund. Radering av .claude kan förstöra sessioner, MCP-konfiguration och annat ospårat tillstånd. Diagnostisera först, verifiera en privat säkerhetskopia och använd reversibel flytt bara för installations- eller konfigurationslagret som faktiskt pekats ut.

Få inte panik över ett UI-fel i en hook

Innan du åtgärdar något kontrollerar du om hooken faktiskt kördes (genom en logg till stderr eller en uttrycklig utskrift) i stället för att lita på den visuella indikatorn.

Höj inte en hooks slutkod innan du har rättat logiken

När din blockerande hook inte blockerar är det frestande att ange exit 2 och kalla saken klar. Det är en fungerande korrigering, men den döljer ett annat problem: om blockeringen inte fungerade på en månad så gick allt som hooken skulle förbjuda igenom. Gå först igenom git-loggen och ta reda på exakt vad som slank igenom. Lägg sedan till blockeringen. Annars kan en stängd blockering inte göra det ogjort som redan har hänt.

Redigera inte produktionsfilen CLAUDE.md utan skyddsåtgärd för säkert läge

I det beskrivna fallet redigerar du CLAUDE.md, Claude börjar bete sig konstigt och du kör git diff och ser att någon också lade till en MCP-server och en hook i repot samma kväll. Du skyller på din redigering, återställer den och Claude beter sig fortfarande konstigt. Regeln: innan du kör git revert provar du claude --safe-mode. Om problemet kvarstår i säkert läge hade din redigering ingenting med det att göra; du behöver inte återställa den.

Tro inte att ”Claude lagar sin egen MCP”

Ett typiskt scenario: du ber Claude att ”lägga till ett visst verktyg på MCP-servern”, Claude skriver om den fungerande konfigurationen, allt går sönder och sedan ägnar Claude flera omgångar åt att felsöka skadan den orsakat – och förbrukar sessionens kvot under tiden. När MCP inte fungerar ska du hämta konfigurationen manuellt; lämna det inte åt agenten. En del av dess verktygsarsenal körs också på MCP, och en trasig MCP innebär en trasig diagnostiker.

Vart går du efter att du har åtgärdat det?#

Efter att du har analyserat incidenten ska du inte återgå till arbetet direkt. Lägg först till förebyggande åtgärder så att incidenten inte upprepas. Du kan förlora timmar på en second brain (mappen business/ med projektstrukturen) och CLAUDE.md, och det är svårt att återställa dem manuellt – det är ett starkt skäl. Minsta uppsättning:

1. ~/.claude/settings.json med permissions.disableBypassPermissionsMode: "disable" – ett arkitektoniskt förbud mot bypass-läge, så att ett oavsiktligt startat --dangerously-skip-permissions helt enkelt inte fungerar.
2. Hooks för Read(./env*), Bash(git push --force), Write(./node_modules/**) – sådant som måste fångas upp som en regel, inte en önskan.
3. Sandlådekonfiguration för långa autonoma körningar (/loop, /schedule).
4. /compact med dina egna regler för vad som ska tas bort ur kontexten, så att Claude inte förbrukar sig självt.

Det fullständiga skyddet i fyra lager finns i guiden ”Så konfigurerar du Claude Code så att det inte förstör projektet över natten”. Den ena guiden behandlar förebyggande åtgärder innan du startar /loop; den andra handlar om återställning efter att /loop redan har förstört något. Ett logiskt par.

Praktiskt material: Ailoot-dokumentation.

Mer material och verktyg: Ailoot.