Vinnige Opsomming: Claude Code is 'n terminaalgebaseerde AI-kodeerassistent wat plaaslik op macOS en Linux loop, of op Windows via WSL2. Om dit op te stel, moet jy 'n Anthropic API-sleutel skep, 'n platform-spesifieke installeerder laat loop, met die sleutel autentiseer, en die installasie verifieer met 'n toetsopdrag.
Claude Code verteenwoordig Anthropic’s amptelike terminaalgebaseerde kodeerassistent. Dit is direk in die command line geleë en hanteer alles van kode generasie tot foutoplossings deur middel van natuurlike taalopdragte.
Maar die opstelproses is nie altyd reguit nie. Windows-gebruikers benodig WSL2. API-autentikasie kan beginners laat struikel. Weergawekonflikte gebeur.
Hierdie gids loop deur die volledige opstelproses vir alle platforms, van stelselvereistes tot jou eerste kodessie.
Wat Claude Code Eintlik Is
Claude Code is 'n agentiese terminaaltoepassing wat met ontwikkelingsomgewings integreer. Dit verstaan kodebasisse, voer roetinatake uit, en bestuur git-werkvloeie deur middel van gespreksopdragte.
Anders as blaaiervenstergebaseerde gereedskap, loop Claude Code plaaslik in die terminaal. Dit het direkte toegang tot projeklêers, handhaaf konteks oor sessies, en integreer met bestaande ontwikkelingsvloeie. Volgens die amptelike Claude Code dokumentasie, skakel die gereedskap met Anthropic’s API en ondersteun integrasie met Amazon Bedrock, Google Cloud Vertex AI, en Azure AI.
Die gereedskap werk anders as tradisionele kodeerassistente. Om die waarheid te sê: dit is meer soos om 'n paring-programmeerder in jou terminaal te hê as 'n kode-aanvullingsgereedskap.
Stelselvereistes vir Claude Code
Voor installasie, moet stelsels aan spesifieke vereistes voldoen. Hier is wat elke platform benodig:
| Platform | Vereistes | Notas |
|---|---|---|
| macOS | macOS 13.0 of later | Native ondersteuning, reguit installasie |
| Linux | 64-bis verspreiding met glibc 2.28+ | Native ondersteuning vir die meeste moderne verspreidings |
| Windows | Windows 10 Bou 19041+ of Windows 11 | Vereis WSL2 installasie eers |
Alle platforms benodig 'n stabiele internetverbinding vir API-oproepe. Claude Code aflaaie benodig tipies ongeveer 50MB, met WSL2 op Windows wat ongeveer 500MB byvoeg vir die Linux-substelsel.
Wat stoorplek betref, verwag ten minste 4GB vrye spasie. Die toepassing self is klein, maar ruimte vir afhanklikhede en projeklêers is belangrik.
Windows-spesifieke vereistes
Claude Code kan op Windows via PowerShell of Command Prompt loop as Node.js geïnstalleer is. Die gereedskap vereis Windows Subsystem for Linux 2 om 'n Linux-omgewing te skep.
Volgens installasiegidse van claude.ai, benodig Windows 10 stelsels Weergawe 1903 of later met Bou 19041 of hoër. Windows 11 gebruikers het WSL2 ondersteuning ingebou. Administrateurvoorregte word benodig vir die aanvanklike WSL2 opstelling.
Die proses behels die inskakeling van virtualisasie in BIOS, die aktivering van Windows-kenmerke, en die installering van 'n Linux-verspreiding. Ubuntu 22.04 LTS is die aanbevole verspreiding vir versoenbaarheid.
Claude Code Installeer: Stap-vir-stap proses
Die installasieproses verskil per platform. Hier is hoe om Claude Code op elke bedryfstelsel te laat loop.
Installeer op macOS en Linux
macOS en Linux installasies volg dieselfde patroon. Beide platforms ondersteun inheemse installasie sonder bykomende opstelling.
Die proses begin met die aflaai van die installeerder. Maak 'n terminaal oop en voer uit:
curl -fsSL claude.ai/install.sh | sh
Die skrip identifiseer die bedryfstelsel, laai die toepaslike binêre lêer af, en installeer Claude Code in die plaaslike bin-gids. Installasie voltooi tipies binne twee minute met 'n stabiele verbinding.
Vir stelsels sonder curl, werk wget as 'n alternatief. Die installeerder voeg Claude Code outomaties by die stelsel PATH.
Installeer op Windows via WSL2
Windows installasie vereis dat WSL2 eers opgestel word. Hier is die volledige proses:
Maak PowerShell oop as Administrator en skakel WSL aan:
wsl –install
Hierdie opdrag skakel vereiste Windows-kenmerke aan, laai die WSL2-kern af, en installeer Ubuntu as standaard. Die stelsel sal vra vir 'n herlaai. Na herlaai, sal Ubuntu outomaties begin om gebruikeropstelling te voltooi.
Skep 'n gebruikersnaam en wagwoord wanneer gevra. Hierdie geloofsbriewe is vir die Linux-omgewing, apart van Windows-aanmeldingsbesonderhede.
Sodra WSL2 loop, is die Linux-installasieproses van toepassing. In die Ubuntu-terminaal, voer die curl-opdrag uit die macOS/Linux-afdeling hierbo uit.
Die installeerder hanteer die res. Claude Code installeer binne die WSL2-omgewing en loop deur die Ubuntu-terminaal.
Kry 'n Anthropic API-sleutel
Claude Code benodig 'n Anthropic API-sleutel vir autentikasie. Die sleutel skakel die plaaslike installasie met Anthropic’s bedieners.
Besoek die Anthropic Console by console.anthropic.com. Skep 'n rekening of teken aan met bestaande geloofsbriewe. Navigeer na API Keys in die rekeninginstellings.
Klik “Create Key” om 'n nuwe API-sleutel te genereer. Die sleutel verskyn een keer—kopieer dit onmiddellik. Anthropic wys nie die volledige sleutel weer nadat die bladsy verlaat is nie.
Stoor die sleutel veilig. Dit bied volle toegang tot die Anthropic API en enige geassosieerde fakturering.
Begrip van API-kostes
Claude Code funksioneer op 'n betaal-per-gebruik model deur die Anthropic API. Gebaseer op data van claude.ai installasiegidse, wissel kostes per model:
| Model | Invoer Kost | Uitvoer Kost |
|---|---|---|
| Claude Opus 4.6 | $5 per miljoen tokens | $25 per miljoen tokens |
| Claude Sonnet 4.6 | $3 per miljoen tokens | $15 per miljoen tokens |
Die minimum aankoop om fakturering te aktiveer is $5, hoewel gemeenskapsbesprekings voorstel dat $20-30 beter hoofruimte vir toetsing bied. Alternatiewe intekenopsies sluit in Claude Pro teen $20 maandeliks of Claude Max teen $100 maandeliks vir swaar gebruik.
Standaard gedrag gebruik Opus totdat 50% van gebruiksperke bereik word, dan skakel dit oor na Sonnet vir koste-effektiwiteit.
Autentikasie en Eerste Begin
Na installasie, benodig Claude Code autentikasie voor eerste gebruik. Begin Claude Code deur die volgende te laat loop:
claude
Die eerste begin vra vir die API-sleutel. Plak die sleutel van die Anthropic Console en druk Enter. Claude Code valideer die sleutel en stoor dit veilig in plaaslike konfigurasielêers.
Autentikasie bly oor sessies heen. Die API-sleutel hoef nie weer ingevoer te word nie, tensy dit eksplisiet verwyder word of wanneer rekeninge gewissel word.
Om te verifieer dat autentikasie gewerk het, vertoon Claude Code 'n welkomsboodskap en opdragreël. Die koppelvlak wys beskikbare opdragte en bevestig verbinding met Anthropic’s API.
Model Voorkeure Konfigureer
Claude Code gebruik standaard outomatiese modelkeuse, maar handmatige konfigurasie is moontlik. Volgens die amptelike dokumentasie, kan gebruikers modelkeuse aanpas deur die /model opdrag of deur die CLAUDE_CODE_EFFORT_LEVEL omgewingsvariabele te stel.
Die moeivlak beheer denke diepte vir Opus 4.6 en Sonnet 4.6 modelle: laag, medium, of hoog. Hoër moeivlakke verhoog redeneervermoë, maar ook koste en responstyd.
Vir projekte wat diep analise benodig, stel “ultrathink” in opdragte tydelik die moeite op hoog vir daardie spesifieke draai.
Installasie Sukses Verifieer
Na autentikasie, verifieer dat Claude Code korrek werk. Voer hierdie basiese toetse uit:
claude –help
claude –version
Die help-opdrag vertoon beskikbare opsies en opdragte. Weergawe-uitvoer bevestig watter uitgawe geïnstalleer is. Beide opdragte moet sonder foute uitgevoer word.
Vervolgens, toets Claude Code in 'n projekgids. Skep 'n toetsvouer:
mkdir test-project
cd test-project
echo “# Test Project” > README.md
claude
Binne die Claude Code sessie, probeer basiese interaksies:
- Tik “help” om beskikbare opdragte te sien
- Vra “explain what you can do”
- Vra “summarize this project”
- Toets die /help opdrag
Hierdie interaksies bevestig dat Claude Code projeklêers kan lees en op navrae kan reageer. Suksesvolle antwoorde beteken die installasie is funksioneel.
Claude Code vir Projekte Konfigureer
Claude Code stoor projek-spesifieke instellings in konfigurasielêers. Hierdie lêers pas gedrag aan, definieer geheue, en vestig werkvloeie.
Die primêre konfigurasielêer is CLAUDE.md in die projek wortel. Hierdie lêer bevat instruksies, konteks, en projek-spesifieke riglyne wat Claude Code gedurende sessies verwys.
Skep 'n basiese CLAUDE.md lêer:
# Projek Konteks
Dit is 'n [projek tipe] gebou met [tegnologieë].
## Sleutel Riglyne
– [Belangrike reël 1]
– [Belangrike reël 2]
## Projek Struktuur
[Kort verduideliking van vouer organisasie]
Die lêer aanvaar Markdown formatering. Claude Code lees hierdie konteks by sessie begin en hou dit deur die gesprek.
Gevorderde Konfigurasie Opsies
Behalwe basiese konteks, ondersteun Claude Code gevorderde konfigurasie deur die .claude gids. Hierdie gids kan bevat:
- Vaardighede: Gespecialiseerde vermoëns gedefinieer in .claude/skills/SKILL.md
- Opdragte: Pasgemaakte skuinsopdragte in .claude/commands/*.md
- Hooks: Outomatiese werkvloeie wat deur gebeure getrigger word
- Plugins: Uitgebreide funksionaliteit deur programmatiese integrasie
Volgens die amptelike Agent SDK dokumentasie, maak hierdie kenmerke gesofistikeerde aanpassing moontlik. Vaardighede definieer hergebruikbare vermoëns. Opdragte skep kortpaaie vir algemene take. Hooks outomatiseer antwoorde op lêerveranderinge of gereedskapgebruik.
Claude Code Gebruik: Basiese Werkvloeie
Met installasie voltooi, hanteer Claude Code algemene ontwikkelingstake deur natuurlike taal.
Begin 'n sessie deur na 'n projekgids te navigeer en die volgende te laat loop:
claude
Die opdraglyn aanvaar gewone taalnavrae. Sommige algemene werk vloeie:
- Kode Generasie: “Skep 'n Python funksie wat e-posadresse met behoorlike fout hantering valideer.”
- Foutoplossing: “Hierdie funksie gooi 'n null pointer exception. Kan jy die probleem identifiseer en oplos?”
- Refaktorering: “Refaktoriseer hierdie komponent om afhanklikheidsinjeksie te gebruik in plaas van direkte instansiering.”
- Git Operasies: “Skep 'n nuwe tak, committen hierdie veranderinge met 'n beskrywende boodskap, en push na origin.”
Claude Code handhaaf konteks oor die sessie heen. Dit onthou vorige interaksies, volg lêerveranderinge, en verstaan die breër projekstruktuur.
Begrip van Plan Modus
Vir komplekse veranderinge, bied Claude Code Plan Modus. Hierdie modus skep 'n gedetailleerde uitvoeringsplan voordat veranderinge gemaak word.
Aktiveer Plan Modus deur navrae met “plan:” te prefiks of deur die /plan opdrag te gebruik. Claude Code skets dan voorgestelde veranderinge, verduidelik die rede, en wag vir goedkeuring voor uitvoering.
Plan Modus is veral nuttig vir refaktorering, argitektoniese veranderinge, of veranderinge wat verskeie lêers raak. Dit bied sigbaarheid in wat Claude Code van plan is om te doen voordat veranderinge toegewyd word.
Integrasie met VS Code en IDE's
Terwyl Claude Code in die terminaal loop, verbeter integrasie met kode-redakteurs die werk vloei. Die amptelike VS Code uitbreiding bring Claude Code vermoëns direk in die redakteur.
Installeer die uitbreiding vanaf die VS Code markplek. Soek vir “Claude Code” en klik Installeer. Die uitbreiding voeg 'n Claude Code paneel by die sybalk.
Volgens die amptelike VS Code dokumentasie, ondersteun die uitbreiding:
| Kenmerk | Kortpad | Beskrywing |
|---|---|---|
| Fokus Invoer | Cmd+Esc / Ctrl+Esc | Wissel tussen redakteur en Claude |
| Open in Nuwe Tab | Cmd+Shift+Esc / Ctrl+Shift+Esc | Begin nuwe gesprek as tab |
| Open in Terminaal | – | Begin terminaal modus vanaf VS Code |
Die uitbreiding handhaaf funksionele gelykwaardigheid met die terminaal weergawe terwyl dit IDE-spesifieke geriewe byvoeg soos inline diffs en @-noem lêer verwysings.
Claude Code Opdateer en Bestuur
Claude Code opdateer outomaties as standaard. Die toepassing kyk periodiek vir nuwe weergawes en installeer opdaterings in die agtergrond.
Om handmatig op te dateer, voer uit:
claude –update
Dit dwing 'n onmiddellike kontrole en installasie van die nuutste weergawe af. Die opdateringsproses bewaar konfigurasielêers en autentikasie geloofsbriewe.
Vir organisasies wat weergawebeheer benodig, kan outomatiese opdaterings gedeaktiveer word. Stel die CLAUDE_CODE_AUTO_UPDATE omgewingsvariabele op vals of konfigureer deur bediener-bestuurde instellings.
Om 'n spesifieke weergawe te installeer, gebruik:
curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z
Vervang X.Y.Z met die teiken weergawe nommer.
Algemene Opstelprobleme en Oplossings
Verskeie probleme kom algemeen voor tydens opstelling. Hier is hoe om dit op te los:
- API Sleutel Verwerping: As Claude Code die API-sleutel verwerp, verifieer dat daar geen ekstra spasies of karakters is nie. Kopieer die sleutel weer vanaf die Anthropic Console. Kyk of fakturering geaktiveer is—sleutels sal nie werk sonder 'n betaalmetode op lêer nie.
- WSL2 Installasie Mislukkings: Windows stelsels misluk soms WSL2 installasie as gevolg van virtualisasie-instellings. Gaan BIOS in en skakel virtualisasie aan (Intel VT-x of AMD-V). Verseker dat die Windows-weergawe aan minimum vereistes voldoen.
- Opdrag Nie Gevind Nie: As die terminaal die claude-opdrag nie herken nie, is die PATH nie korrek opgedateer nie. Maak die terminaal toe en maak dit weer oop. Vir volgehoue probleme, voeg die installasiegids handmatig by die PATH.
- Konnekteer Tydboue: Netwerkbeperkings of brandmure kan API-oproepe blokkeer. Claude Code benodig HTTPS-toegang tot api.anthropic.com. Korporatiewe netwerke benodig moontlik proxy-konfigurasie.
- Toestemmingsfoute: Linux en macOS installasies kom af en toe met toestemmingsprobleme te staan. Voer die installeerder uit met gepaste toestemmings of installeer na 'n gebruikersgids in plaas van stelselwye liggings.
Kontroleer Beskikbare AI-krediete Voor Claude Code Op te Stel
Claude Code opstel behels gewoonlik eksperimentering—navrae laat loop, integrasies toets, en klein prototipes bou voordat iets in produksie gaan. Daardie vroeë stadium lei dikwels tot baie API-gebruik. In plaas daarvan om vir elke versoek reguit te betaal, soek baie ontwikkelaars eers na beskikbare krediete of beginprogramme wat help om daardie aanvanklike kostes te verminder.
Get AI Perks versamel hierdie geleenthede op een plek. Die platform lys AI-krediete, afslag, en vennootprogramme oor AI-verskaffers, wolkplatforms, en ontwikkelaar gereedskap, met stap-vir-stap gidse wat verduidelik hoe om dit op te eis. In totaal, die databasis sluit voordele van meer as 200 gereedskap en miljoene dollars in beskikbare krediete wat beginners en bouers kan aansoek doen.
Voordat jy Claude Code opstel voltooi, kyk na Get AI Perks en eis die AI-krediete wat jou eerste eksperimente kan dek.
Gereelde Vrae
Moet ek betaal vir Claude Code?
Claude Code self is gratis sagteware, maar dit benodig 'n Anthropic API-sleutel wat op 'n betaal-per-gebruik model funksioneer. Die minimum rekeningaktivering is $5, hoewel praktiese gebruik tipies $20-30 in krediete benodig. Alternatiewe intekenplanne soos Claude Pro ($20/maand) of Claude Max ($100/maand) bied verskillende prystrukture vir swaar gebruikers.
Kan Claude Code heeltemal vanlyn loop?
Nee. Claude Code benodig 'n aktiewe internetverbinding om met Anthropic’s API-bedieners te kommunikeer. Die toepassing verwerk versoeke plaaslik, maar stuur opdragte na Claude-modelle wat op Anthropic’s infrastruktuur loop. Daar is geen vanlyn modus of plaaslike model opsie nie.
Wat is die verskil tussen Claude Code en Claude.ai?
Claude.ai is 'n webgebaseerde kletskoppelvlak vir algemene Claude-interaksies. Claude Code is 'n gespesialiseerde terminaaltoepassing wat spesifiek ontwerp is vir sagteware ontwikkeling. Claude Code integreer met git, lees projeklêers direk, handhaaf langer ontwikkelingskonteks, en sluit kode-spesifieke kenmerke soos Plan Modus en lêer wysigingsvermoëns in.
Hoe wissel ek tussen Claude-modelle?
Gebruik die /model opdrag binne 'n Claude Code sessie om tussen beskikbare modelle te wissel. Die standaardkonfigurasie gebruik Opus totdat 50% gebruik bereik word, dan skakel dit oor na Sonnet. Handmatige keuse laat toe om spesifieke modelle te kies op grond van taakvereistes—Opus vir komplekse redenering, Sonnet vir vinniger, koste-effektiewe antwoorde.
Kan ek Claude Code in VS Code gebruik?
Ja. 'n Amptelike VS Code uitbreiding bring Claude Code funksionaliteit in die redakteur. Installeer dit vanaf die VS Code markplek. Die uitbreiding bied dieselfde vermoëns as die terminaal weergawe met bykomende IDE-integrasie soos inline diffs, sybalkpanele, en sleutelbordkortpaaie vir vinnige toegang.
Stoor Claude Code my kode of gesprekke?
Volgens Anthropic’s datagebruiksbeleide, word API-interaksies nie gebruik om modelle te oefen nie. Organisasionne kan nul dataretensiebeleide konfigureer deur ondernemingsinstellings. Kode en opdragte word na Anthropic’s bedieners gestuur vir verwerking, maar die hantering hang af van rekeningkonfigurasie en dataretensie-instellings.
Wat gebeur as Claude Code 'n fout maak?
Claude Code sluit veiligheidskenmerke in soos git-integrasie en Plan Modus om foute te minimaliseer. Vir foute wat wel voorkom, is standaard weergawebeheerpraktyke van toepassing—git-geskiedenis bied terugrolvermoë. Die toestemmingstelsel vereis goedkeuring vir sensitiewe operasies. Sommige gemeenskapsbesprekings dui op suksesyfers in die 80-90% reeks vir roetinatake, met toesig aanbeveel vir kritieke veranderinge.
Verder Gaan met Claude Code
Claude Code transformeer terminaalgebaseerde ontwikkeling deur AI-hulp direk in die command line te integreer. Opstelling vereis platform-spesifieke installasie, API-autentikasie, en basiese konfigurasie, maar die proses is reguit wanneer die regte stappe gevolg word.
Die gereedskap presteer uitstekend by roetinatake, kode generasie, en git-werkvloeibestuur. Plan Modus bied veiligheid vir komplekse operasies. IDE-integrasie brei vermoëns buite die terminaal uit.
Begin met eenvoudige take om te verstaan hoe Claude Code navrae interpreteer. Bou op na meer komplekse werkvloeie soos familiariteit groei. Gebruik die /clear opdrag tussen onderskeibare take om skoon konteks te handhaaf. Konfigureer CLAUDE.md lêers vir projek-spesifieke leiding.
Spanne kan bediener-bestuurde instellings en plugin markplekke ondersoek. Individuele ontwikkelaars kan voordeel trek uit vaardighede en pasgemaakte opdragte wat op gereelde patrone ingestel is.
Die GitHub-bewaarplek by anthropics/claude-code bevat bykomende voorbeelde, gemeenskap plugins, en foutsporing hulpbronne. Amptelike dokumentasie by docs.anthropic.com bied omvattende tegniese verwysings.
Nou is dit tyd om te begin kodeer. Gaan na 'n projek, begin Claude Code, en sien hoe AI-ondersteunde ontwikkeling jou werk vloei verander.
