Claude Code-handledning: Installation, refaktorering och felsökning i praktiken

Vad är Claude Code?

Claude Code är ett verktyg som körs direkt i din terminal, förstår din kodbas och hjälper till med utvecklingsuppgifter via kommandon på naturligt språk. Det integreras i din utvecklingsmiljö med minimal konfiguration, så att du kan fokusera på att skriva och förbättra kod.

Här är några centrala funktioner i Claude Code:

• Redigering och refaktorering: Ändra, optimera och förbättra din kodbas med AI-drivna förslag.
• Buggfixar: Identifiera och åtgärda fel, saknade beroenden och prestandaflaskhalsar.
• Förståelse av kod: Ställ frågor om din kods arkitektur, logik och beroenden.
• Automatiska tester och linting: Kör och fixa fallerade tester, kör linting-kommandon och förbättra kodkvaliteten.
• Git-integration: Sök i git-historik, lös merge-konflikter, skapa commits och generera pull requests utan krångel.

Oavsett om du arbetar med ett open source-projekt eller hanterar kodbaser på företagsnivå kan Claude Code hjälpa dig med smart automation som anpassar sig till din kodstil och dina projektkrav. Senaste uppdateringarna har lagt till autoläge (färre avbrott för behörigheter), planläge (design först) och Routines (schemalagda moln-agenter som körs på triggers utan att din dator är igång).

Här är några ideala användare för tjänsten:

• Programvaruutvecklare: Förbättra kodkvalitet och underhållbarhet.
• Open source-bidragsgivare: Förstå och förbättra obekanta kodbaser.
• DevOps-ingenjörer: Automatisera kodgranskning och linting-uppgifter.

Claude Code använder nu som standard Claude Opus 4.7 på Max- och Team Premium-abonnemang. Pro-användare börjar med Sonnet 4.6 men kan växla till Opus-modeller för krävande uppgifter. Du kan byta modell mitt i en session med kommandot /model eller justera resonemangsdjup med reglaget /effort. Du kan också bygga fristående AI-agenter med Claude Agents SDK.

Anthropic har även introducerat Cowork för agentliknande hjälp med vardagliga fil- och dokumentuppgifter bortom kodning. Det är tillgängligt för alla betalande abonnenter (Pro, Max, Team, Enterprise) i Claude Desktop-appen.

Om du väger Claude Code mot xAI:s terminalagent testar vår Grok Build vs. Claude Code-jämförelse båda på samma uppgift.

Nu sätter vi igång med vårt praktiska projekt.

Steg 1: Installera Claude Code

För att komma igång med Claude Code behöver du en terminal, ett kodprojekt att arbeta i och antingen ett Claude-abonnemang (Pro/Max/Teams/Enterprise) eller ett Claude Console-konto med aktiv fakturering.​

Installera Claude Code genom att köra ett av följande kommandon i din terminal, beroende på operativsystem och terminal.

macOS / Linux / WSL: 

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

Windows PowerShell: 

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

Windows CMD:  

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Obs: Installation via npm install -g @anthropic-ai/claude-code finns kvar men är utfasad, så du bör föredra den inbyggda installationsprocessen ovan. Om du tidigare installerat via npm kan du migrera med claude install.

När installationen är klar, navigera till din projektkatalog och starta Claude genom att köra:

cd your-project-directory
claude

För autentisering blir du tillfrågad om du vill använda Claude Code baserat på ett betalt abonnemang eller API-baserad fakturering.

Därefter får du en inloggningslänk som leder till en verifieringskod som du ska ange i terminalen där Claude Code körs. Sedan är du klar och en dedikerad arbetsyta ”Claude Code” skapas automatiskt för användningsspårning och kostnadshantering.

Nu är Claude Code redo att användas.

Steg 2: Konfigurera utvecklingsmiljö

I den här demonstrationen använder jag Supabases Python-bibliotek supabase-py, en öppen källkodsklient i Python för att interagera med Supabase, en backend-som-tjänst byggd på PostgreSQL. Supabase erbjuder en uppsättning verktyg, inklusive autentisering, realtidsprenumerationer, lagring och automatiskt genererade API:er.

Låt oss börja med att klona repo:t och sätta upp vår utvecklingsmiljö.

1. Öppna din terminal, navigera till katalogen där du vill klona supabase-py-repo:t (t.ex. cd Desktop) och kör följande kommando:

git clone https://github.com/supabase/supabase-py.git
cd  supabase-py

2. Skapa sedan en virtuell miljö och installera nödvändiga beroenden genom att köra följande kommandon i din terminal, ett i taget

python3 -m venv env
source env/bin/activate  # On Windows, use ./env/Scripts/activate
pip install -e .

Din Python-miljö är nu konfigurerad med alla nödvändiga beroenden för att köra Supabase-biblioteket, och ditt repo är redo att utforskas. 

Steg 3: Identifiera områden att bidra till

Ett bra sätt att bidra är att utforska fliken Issues på GitHub. I Supabase-repo:t identifierade jag ett problem i client.py relaterat till kodläsbarhet, struktur och brist på meningsfulla kommentarer.

Det här ska vi göra med Claude Code:

• Vi refaktorerar koden för att förbättra läsbarhet, underhållbarhet och struktur.
• Lägga till meningsfulla docstrings och kommentarer för att förtydliga syftet med olika komponenter.
• Identifiera och åtgärda buggar genom att analysera issues och andra potentiella fel.

Steg 4: Experimentera med Claude Code

Eftersom vi redan är i mappen supabase-py, navigera till supabase-katalogen som innehåller filen client.py och kör Claude Code:

cd supabase
claude

Claude Code har nu tillgång till alla filer och mappar i supabase-py-mappen. Låt oss nu experimentera.

Refaktorera kod

Som en del av att förbättra Supabases Python-SDK ska vi refaktorera filen client.py för att öka läsbarhet, underhållbarhet och struktur. Skriv helt enkelt följande prompt i kommandoraden:

Prompt: Refaktorera koden i filen client.py som ligger i mappen Supabase.

Claude ber om bekräftelse innan den fortsätter. Tryck på Enter för att godkänna ändringarna. När det är klart uppdaterar Claude Code filen, visar ändringarna i terminalen och ger en sammanfattning av vad som gjorts.

Med Claude Code tillämpade vi följande förbättringar på client.py:

• Organiserade imports:  Claude Code grupperade relaterade imports i logiska sektioner (auth-fel, API-typer, funktionsfel), döpte om imports för tydlighet och tog bort onödiga alias för konsekvens.
• Förbättrad läsbarhet: Den lade till sektionskommentarer för att klassificera imports och tog bort duplicering i listan __all__ för en renare struktur.
• Förenklade klientalternativ: Den minskade också antalet rader genom att kombinera liknande imports i ett enda uttryck.

Här är en jämförelse sida vid sida av original och refaktorerad kod.

Dokumentera kod

Förutom refaktorering kan Claude Code generera, uppdatera och standardisera koddokumentation i ett helt projekt. Det kan identifiera odokumenterade avsnitt, generera strukturerade docstrings eller kommentarer och kontrollera efterlevnad av projektets dokumentationsstandarder.

Vi använde Claude Code för att förbättra dokumentationen i client.py, vilket resulterade i:

• Tydliga docstrings på modulnivå som förklarar filens syfte.
• Detaljerade sektionskommentarer som kategoriserar imports (feltyper, klientimplementationer, lagringstjänster).
• Inline-kommentarer som beskriver feltyper, klientfunktioner och viktiga komponenter.

Här är en jämförelse sida vid sida av refaktorerad och dokumenterad kod.

Prompt: Dokumentera koden i client.py genom att lägga till kommentarer för att förbättra förståelsen.

När dokumentationen har lagts till kan du verifiera att den följer dina projektstandarder genom att be Claude:

Prompt: Kontrollera om dokumentationen följer våra projektstandarder.

Åtgärda buggar

Felsökning kan vara tidskrävande, men Claude Code kortar cykeln genom att analysera felmeddelanden, identifiera grundorsaker och föreslå åtgärder. Oavsett om du hanterar saknade imports, körningsfel eller logiska problem minskar den sökutrymmet och föreslår målinriktade korrigeringar.

Så här använder du Claude Code för felsökning:

1. Identifiera problemet:  Dela felmeddelandet med Claude.
2. Få förslag på åtgärd: Be Claude om möjliga lösningar.
3. Tillämpa och verifiera fixen:  Implementera Claudes förslag och kontrollera om problemet är löst.

Claude Code gjorde följande åtgärder för att lösa importrelaterade problem i filen client.py: 

• Type ignore-kommentarer: Lade till kommentaren # type: ignore för att dölja varningar i IDE och typkontroll för olösta imports.
• Konsekvent kategorisering av fel: Claude Code säkerställde att felimports från autentisering, databas, lagring och funktioner är tydligt grupperade.
• Bibehållen läsbarhet: Kommentarer lades till för att ange varför vissa imports ignorerades istället för att ta bort dem.

Här är en jämförelse sida vid sida av originalkoden och den åtgärdade koden.

Prompt: Jag ser några buggar, som att ”Import gotrue.errors” inte kunde lösas. Hjälp mig att fixa alla fel i client.py.

Claude Code-kommandon

Här är några kommandon att prova med Claude.

För en fördjupning rekommenderar jag vår guide Claude Code slash-kommandon.

Avancerade funktioner i Claude Code

När du är bekväm med grunderna i refaktorering och felsökning kan du utöka Claude Codes möjligheter genom att anpassa hur det beter sig. Hooks och plugins låter dig automatisera repetitiva uppgifter och integrera externa system.

Claude Code hooks

Claude Code hooks är automatiska triggers som kör shell-kommandon när specifika händelser inträffar under din Claude Code-session. De automatiserar repetitiva uppgifter som kodformatering, testkörning och säkerhetskontroller som Claude annars kan hoppa över.

Hooks använder ett event–action-system där du definierar tre saker:

• Eventet: När triggas hooken?

• Matchern: Vilka åtgärder påverkas?

• Kommando: Vad körs när hooken triggas?

Till exempel kan en hook triggas efter att Claude skriver en Python-fil och automatiskt köra black för att formatera koden. Hooks tar emot JSON-kontekst om vad som hänt, vilket möjliggör smarta beslut baserade på filtyper eller sökvägar. De kan skriva ut till Claudes transcript eller skicka felmeddelanden direkt till Claude för att blockera operationer.

Vanliga användningsfall för hooks inkluderar följande

• Kodformatering: Kör automatiskt linters och formatterare efter kodskrivningar

• Testning: Kör testsuiter efter ändringar för att fånga buggar tidigt

• Säkerhet: Blockera ändringar i känsliga filer som produktionskonfigurationer eller API-nycklar

• Dokumentation: Generera API-dokumentation automatiskt när källfiler ändras

• Git-automation: Skapa smarta commits och validera skyddsregler för grenar

• Notiser: Meddela ditt team via Slack när viktiga filer ändras

• Regelefterlevnad: Tvinga igenom licenshuvuden eller kodstandarder innan ändringar tillåts

Ställ in hooks med kommandot /hooks i Claude Code eller redigera ~/.claude/settings.json direkt.

Claude Code-plugins

Plugins är tillägg som kopplar Claude Code till externa verktyg, tjänster och API:er. Medan hooks automatiserar lokala shell-kommandon integrerar plugins med ditt bredare utvecklingsekosystem som CI/CD-pipelines, projektledning och teamkommunikation.

Plugins kan paketera flera komponenter—subagenter (specialiserade Claude-assistenter för specifika uppgifter), MCP-servrar (standardiserade verktygsintegrationer) och hooks—i ett enda paket som orkestrerar dem tillsammans.

Ett plugin kan analysera kodändringar och automatiskt skapa ärenden i Jira, eller koppla upp sig mot din interna testinfrastruktur. Plugins reagerar på samma händelser som hooks men skickar data till externa tjänster och bearbetar svar för att påverka Claudes arbetsflöde.

Här är några uppgifter som Claude Code-plugins är utmärkta för:

• CI/CD-integration: Trigga byggen, tester och driftsättningar när filer ändras

• Projektledning: Skapa eller uppdatera ärenden i Jira, GitHub eller Linear automatiskt

• Teamkommunikation: Publicera uppdateringar i Slack eller Teams när ändringar sker

• Kodgranskning: Skapa pull requests automatiskt och hantera granskningar på GitHub/GitLab

• Extern analys: Anropa SonarQube, CodeClimate eller Snyk för företagsmässig kodskanning

• Egna verktyg: Integrera med proprietära system och arbetsflöden

• IDE-tillägg: Lägg till egna kommandon och navigationshjälpmedel

Installera plugins från ett register eller bygg dem internt för din organisation och konfigurera sedan vilka händelser de ska svara på. Tillsammans skapar hooks och plugins en utbyggbar plattform som anpassar Claude Code till din befintliga infrastruktur.

Andra avancerade funktioner

Claude Code har lagt till flera större funktioner 2026 som utökar hur och var du kan använda det:

• Planläge: Ett arbetsflöde med design först där Claude skapar en detaljerad implementationsplan innan någon kod skrivs. Jag använder detta för alla icke-triviala uppgifter.
• Autoläge: En behörighetsklassificerare som låter Claude arbeta med färre avbrott, användbart för längre uppgifter där du inte vill godkänna varje filskrivning.
• Routines: Schemalagda moln-agenter som triggas via cron-schema, GitHub-händelse (som öppnad PR) eller webhook-anrop. Din dator behöver inte vara igång.
• IDE-integration: Claude Code har officiella tillägg för VS Code, Cursor och JetBrains IDE:er med inline-diffar, checkpoints och stöd för flera sessioner.
• Fjärrstyrning och kanaler: Kör Claude Code-sessioner och interagera med dem från din telefon eller andra enheter.

Avslutande tankar

I den här handledningen använde jag Claude Code för att refaktorera, dokumentera och felsöka en fil i Supabases Python-SDK. Vi förbättrade kodläsbarheten, lade till strukturerad dokumentation och löste importproblem.

Claude Code utvecklas aktivt med funktioner som planläge, autoläge och Routines, så det är värt att experimentera i dina egna projekt för att se hur det passar ditt arbetsflöde.

För att ta nästa steg rekommenderar jag vår handledning Claude Code Best Practices som lär dig få ut det mesta av Claudes kontextfönster. Om du vill bygga ett projekt från grunden rekommenderar jag vår handledning om specdriven utveckling med Claude Code.