Claude Code-handledning: Installation, refaktorisering 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 av Claude Codes viktigaste funktioner:

• Redigering och refaktorisering: Modifiera, 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.
• Automatiserad testning och lintning: Kör och fixa fallerande tester, kör lint-kommandon och förbättra kodkvaliteten.
• Git-integration: Sök i git-historik, lös sammanslagningskonflikter, skapa commits och generera pull requests utan ansträngning.

Oavsett om du arbetar med ett open source-projekt eller hanterar företagskodbaser kan Claude Code hjälpa dig med intelligent automatisering som anpassar sig till din kodstil och projektets krav. Nya uppdateringar har lagt till autoläge (färre avbrott för behörighet), planläge (design-först-arbetsflöden) och Routines (schemalagda molnagenter som körs på triggers utan att din maskin är igång).

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

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

Claude Code använder nu som standard Claude Opus 4.7 på Max- och Team Premium-abonnemang. Pro-användare startar 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 resonemangsdjupet med reglaget /effort. Du kan också bygga fristående AI-agenter med Claude Agents SDK.

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

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 installerade via npm kan du migrera med claude install.

När installationen är klar går du till din projektkatalog och startar 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 debitering.

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ön

För den här demon använder jag Supabase Python-biblioteket supabase-py, en öppen Python-klient för interaktion med Supabase, en backend-tjänst byggd på PostgreSQL. Supabase erbjuder en uppsättning verktyg, inklusive autentisering, realtidsprenumerationer, lagring och autogenererade API:er.

Låt oss börja med att klona repot och ställa in vår utvecklingsmiljö.

1. Öppna din terminal, navigera till den katalog där du vill klona Supabase-py-repot (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-repot 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 inline-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 katalogen supabase 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 mappen supabase-py. Låt oss nu experimentera.

Refaktorisera kod

Som en del av att förbättra Supabase Python SDK refaktorerar vi filen client.py för bättre läsbarhet, underhållbarhet och organisering. Skriv helt enkelt följande prompt i kommandoraden:

Prompt: Refaktorisera koden i filen client.py som finns 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 gjorde vi följande förbättringar i client.py:

• Organiserade importer:  Claude Code grupperade relaterade importer i logiska sektioner (auth-fel, API-typer, funktionsfel), bytte namn på importer för tydlighet och tog bort redundanta alias för konsekvens.
• Förbättrad läsbarhet: Den lade till sektionskommentarer för att klassificera importer och tog bort dubbleringar i listan __all__ för renare struktur.
• Förenklade klientalternativ: Den minskade också antalet rader genom att kombinera liknande importer i en enda sats.

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

Dokumentera kod

Utöver refaktorisering 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 modulnivå-docstrings som förklarar filens syfte.
• Detaljerade sektionskommentarer som kategoriserar importer (feltyper, klientimplementationer, lagringstjänster).
• Inline-kommentarer för att beskriva 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 som förbättrar 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.

Fixa buggar

Felsökning kan vara tidskrävande, men Claude Code förkortar cykeln genom att analysera felmeddelanden, identifiera grundorsaker och föreslå åtgärder. Oavsett om du har saknade importer, körtidsfel eller logiska problem minskar den sökområdet och föreslår riktade 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ärder: 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 undertrycka IDE- och typkontrollvarningar för olösta importer.
• Konsekvent felkategorisering: Claude Code såg till att felimporter från autentisering, databas, lagring och funktioner tydligt grupperas.
• Bibehållen kodläsbarhet: Kommentarer lades till för att ange varför vissa importer ignorerades istället för att tas bort.

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

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

Claude Code-kommandon

Här är några kommandon du kan prova med Claude.

Jag rekommenderar också att du kollar in Anthropics officiella handledningar och vår guide till bästa praxis för Claude Code.

Avancerade funktioner i Claude Code

När du behärskar grunderna i refaktorisering 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 händelse-åtgärdssystem där du definierar tre saker:

• Händelsen: När triggas hooken?

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

• Kommandot: 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ände, vilket möjliggör smarta beslut baserat på filtyper eller sökvägar. De kan skriva ut till Claudes transkript eller skicka felmeddelanden direkt till Claude för att blockera åtgärder.

Vanliga användningsområden för hooks inkluderar följande

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

• 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-automatisering: Skapa smarta commits och validera branchskyddspolicys

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

• Regelefterlevnad: Tvinga igenom licenshuvuden eller kodningsstandarder 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 utökningar som kopplar Claude Code till externa verktyg, tjänster och API:er. Medan hooks automatiserar lokala shell-kommandon integrerar plugins din bredare utvecklingsekologi som CI/CD-pipelines, projektverktyg 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 ansluta till 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 där Claude Code-plugins passar utmärkt:

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

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

• Teamkommunikation: Publicera uppdateringar till 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öretagskodskanning

• Egna verktyg: Integrera med företagsspecifika system och arbetsflöden

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

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 under 2026 som utökar hur och var du kan använda det:

• Planläge: Ett design-först-arbetsflöde där Claude skapar en detaljerad genomförandeplan 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 molnagenter som körs enligt cron-schema, en GitHub-händelse (som öppnad PR) eller ett webhook-anrop. Din maskin 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ärrkontroll och Channels: 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 refaktorisera, dokumentera och felsöka en fil i Supabase 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 nästa steg rekommenderar jag vår handledning Claude Code Best Practices som lär dig utnyttja Claudes kontextfönster maximalt. Om du vill bygga ett projekt från grunden rekommenderar jag vår handledning om specdriven utveckling med Claude Code.