Claude Code för nybörjare: låt agenten läsa projektet först

Det är lätt att öppna en projektmapp, se tio okända filer och tänka: "Kan inte Claude bara fixa det här?" Jo, ibland. Men den bästa första frågan är inte "fixa allt". Den är: "Läs projektet och förklara vad som finns här innan du ändrar något."

Claude Code är Anthropics kodagent. Till skillnad från vanlig Claude-chat kan den arbeta inne i en projektmapp, läsa filer, föreslå ändringar, köra kommandon och visa vad som ändrats. Det gör den kraftfullare än en vanlig chatt, men också mer beroende av att du sätter ramarna: liten uppgift, tydliga godkännanden, granskning av diffen och en enkel kontroll innan du behåller något.

Källa: Claude Code overview och Claude Code best practices.

Vem den här guiden passar

Guiden passar dig som redan har testat Claude, ChatGPT eller OpenAI Codex och vill förstå hur en kodagent känns i praktiken. Du behöver inte vara utvecklare på heltid. Du behöver däremot ett litet första projekt: en kopia av en landningssida, ett kursprojekt, ett demoprojekt eller ett enkelt skript som inte innehåller kunddata eller produktionshemligheter.

Det här fortsätter från två tidigare Hammer-guider. I Claude som kollega handlade det om återkommande arbetskontext i Claude Projects. I OpenAI Codex för nybörjare handlade det om att låta en kodagent förklara kod innan den ändrar. Här gör vi samma lugna sak med Claude Code.

Det du lär dig på 10–20 minuter

Efter guiden kan du:

• välja ett litet projekt som passar som första test,
• starta Claude Code i rätt projektmapp,
• be agenten förklara filer och struktur innan den ändrar,
• be om en liten reversibel förbättring,
• godkänna bara det du förstår,
• granska diff och kommandoresultat,
• verifiera med test, lint eller lokal förhandsvisning, eller med en manuell checklista.

Installera Claude Code

För den här guiden använder vi Claude Code i terminalen. Du behöver en terminal, ett litet projekt och ett konto med Claude Code-åtkomst, till exempel Claude Pro/Max/Team/Enterprise eller Anthropic Console.

På macOS, Linux eller WSL kör du:

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

På Windows PowerShell kör du:

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

På Windows CMD kör du i stället:

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

Om du använder macOS och föredrar Homebrew kan du också köra:

brew install --cask claude-code

När installationen är klar öppnar du terminalen i projektmappen och startar Claude Code:

cd /sökväg/till/ditt/projekt
claude

Första gången får du logga in. På Windows rekommenderar Anthropic Git for Windows om du vill att Claude Code ska kunna använda Bash-verktyget. VS Code, Desktop, Web och JetBrains finns också, men i den här guiden håller vi oss till terminalflödet.

Källa: Claude Code quickstart, advanced setup, terminal guide och VS Code integration.

Innan du börjar: välj ett litet projekt och en kontrollpunkt

Välj inte produktionskoden första gången. Ta en kopia, ett exempelprojekt eller en kursmapp där det är okej att testa. Om projektet använder Git, gör en kontrollpunkt eller commit innan du startar. Om Git känns främmande, duplicera mappen så att du kan kasta experimentet utan dramatik.

Håll också gränserna rena. Lägg inte med .env-filer, API-nycklar, kunddata, privata inspelningar eller kod du inte har rätt att använda. Första testet ska visa hur arbetsflödet fungerar, inte hur modigt du kan ge en agent åtkomst. I ett riktigt team blir samma tanke mer professionell: hemligheter i miljövariabler eller en hemlighetshanterare, begränsade behörigheter, godkännandesteg, loggar och granskning av diffen.

Claude Code är byggt med godkännandefrågor. Enligt Anthropic ber den om uttryckligt godkännande innan den redigerar filer, kör kommandon eller gör åtgärder som kan ändra systemet. Skrivåtkomst är också knuten till mappen där du startar Claude Code och undermappar, om du inte tillåter mer.

Källa: Claude Code security och Claude Code permissions.

Steg 1: öppna ett litet projekt

Öppna terminalen i en kopia eller liten projektmapp och kör claude. Första målet är inte att bygga något. Målet är att se om Claude Code kan orientera sig i projektet.

Bra första exempel: en enkel webbplats där du vill ändra en rubrik, ett kursprojekt där du vill förstå filerna, ett rapportskript som du vill få förklarat eller en kopia av ett demoprojekt där inget viktigt står på spel.

Steg 2: be Claude Code förklara innan den ändrar

Klistra in den här prompten först:

Förklara det här projektet innan du ändrar något.

Gör detta:
1. Beskriv på enkel svenska vad projektet gör.
2. Lista de 5–8 viktigaste filerna eller mapparna.
3. Berätta hur jag kan köra, förhandsvisa eller testa projektet om det framgår.
4. Peka ut sådant som verkar riskabelt, oklart eller saknas.
5. Ändra inga filer och kör inga modifierande kommandon ännu.

Läs svaret som om en kollega gick igenom projektet med dig. Förstår du inte strukturen? Be Claude Code förenkla, peka ut första filen du bör läsa eller beskriva hur data rör sig genom projektet. Det här är ofta den mest värdefulla delen för nybörjare. Du får en karta innan du börjar ändra.

Källa: Claude Code common workflows.

Steg 3: be om en liten första ändring

När förklaringen känns begriplig kan du be om ett förslag. Håll det litet. En textändring, en liten validering, en tydligare feltext eller en enkel dokumentationsrad är bättre än en större refaktorering.

Föreslå en liten, reversibel förbättring i det här projektet.

Kontext:
- Jag använder detta som min första Claude Code-övning.
- Begränsa ändringen till [en fil / en komponent / en textändring / en liten buggfix].
- Rör inte hemligheter, .env-filer, deployment-inställningar, package manager-konfiguration eller orelaterade filer.

Innan du ändrar något vill jag se:
1. exakt vilken ändring du föreslår,
2. varför den är säker och användbar,
3. vilka filer som skulle påverkas,
4. vilket kommando eller vilken manuell kontroll som verifierar ändringen.

Vänta på mitt godkännande innan du redigerar.

Om förslaget blir för stort, stoppa direkt: "Gör uppgiften mindre. Välj en fil och en ändring."

Steg 4: godkänn bara det begränsade arbetet

När planen är rimlig kan du godkänna just den ändringen. Om Claude Code ber om nätverk, parent-folder-åtkomst, nya beroenden, destruktiva Git-kommandon eller produktionsliknande åtkomst, fråga varför. För ett första pass är det nästan alltid bättre att hålla sig lokalt och smått.

Regeln är enkel: agenten får bara den åtkomst uppgiften kräver. Hemligheter hålls utanför chatten, riskfyllda steg kräver godkännande och resultatet ska lämna bevis i form av diff, logg eller testutdata.

Steg 5: granska diff och kommandoresultat

En diff är före/efter-vyn av ändrade filer. Titta efter sådant som inte hör hemma:

• filer du inte bad om,
• ändrade inställningar,
• nya beroenden,
• ändringar i .env, deployment eller package manager-konfiguration,
• stora omskrivningar när du bad om en liten sak,
• kommandon som misslyckades men ändå följs av ett självsäkert svar.

Om något känns fel, styr tillbaka:

Håll scope mindre. Åtgärda bara den ändring vi kom överens om. Ändra inga orelaterade filer eller inställningar.

I VS Code kan en visuell diff göra granskningen lättare. I terminalen kan du be Claude Code sammanfatta exakt vilka filer som ändrades och visa relevant diff.

Steg 6: verifiera innan du behåller ändringen

Be Claude Code föreslå minsta möjliga kontroll. Det kan vara ett testkommando, lint, en build, lokal preview eller en manuell checklista. Om du inte kan köra projektet själv, be agenten förklara hur en människa kan kontrollera resultatet.

Föreslå den minsta kontrollen för att verifiera ändringen.
Om projektet har test-, lint-, build- eller preview-kommandon, visa dem.
Om jag inte kan köra dem, ge mig en manuell kontrollista.

Behåll bara det du faktiskt vill ha. Committa, spara eller dokumentera ändringen om den klarar kontrollen. Ångra det som överraskar.

Återanvändbart första Claude Code-kort

Spara den här prompten för nästa lilla uppgift:

Du hjälper mig med min första lilla Claude Code-uppgift.

Regler:
- Förklara innan du ändrar.
- Håll uppgiften liten och reversibel.
- Rör inte hemligheter, .env-filer, deployment-inställningar, package manager-inställningar eller orelaterade filer.
- Fråga innan du använder nätverk, parent folders, destruktiva Git-kommandon eller nya beroenden.
- Markera allt osäkert som "behöver mänsklig kontroll".

Uppgift:
1. Förklara projektet på enkel svenska.
2. Föreslå en säker första förbättring.
3. Visa vilka filer som skulle ändras.
4. Vänta på godkännande innan du ändrar.
5. Efter ändringen: sammanfatta diffen och berätta hur jag verifierar den.

Vanliga misstag

Det vanligaste misstaget är att börja för stort: produktionsrepo, vag prompt, full auto-approval eller "fixa allt". Ett annat är att hoppa över förklaringen för att agentens första svar låter självsäkert. Kod måste fortfarande granskas.

Blanda inte heller in hela Claude Code-världen första dagen. CLAUDE.md, hooks, MCP, subagents, GitHub Actions, SDK, worktrees och bakgrundsagenter kan vara användbara senare. Första passet ska lära rytmen: läs, förklara, föreslå, godkänn, granska, verifiera.

Nästa steg

Om första övningen fungerar kan du göra en liten projektanteckning, eller senare en CLAUDE.md, med hur projektet körs, testas och granskas. Då slipper Claude Code gissa lika mycket nästa gång.

Vill du testa kodagenter i ett team utan att ge dem för mycket frihet direkt? Hammer kan hjälpa dig välja ett litet första projekt, sätta enkla behörighetsregler och bygga en rutin för plan, diff, test och mänsklig granskning.

Nästa naturliga guide i serien kan bli CLAUDE.md för nybörjare, Claude Code-behörigheter/plan mode eller en lugn jämförelse mellan Claude Code och Codex, beroende på intresse.