Trumpas apibendrinimas: Claude Code CLI įdiegiama vienu komandos paleidimu, kuris automatiškai atsisiunčia ir sukonfigūruoja įrankį. „macOS“ ir „Linux“ naudokite oficialų apvalkalo scenarijų iš „Anthropic“ dokumentų, o „Windows“ naudotojai paleidžia „PowerShell“ arba „WSL“ komandas. Po įdiegimo autentifikuokitės savo API raktu, kad pradėtumėte naudoti Claude dirbtinio intelekto kodavimo asistentą savo terminale.
Claude Code yra agentinis kodavimo įrankis, veikiantis jūsų terminale ir suprantantis visą jūsų kodų bazę. Remiantis oficialia Claude Code dokumentacija, jis gali skaityti failus, vykdyti komandas, redaguoti kodą ir integruotis su kūrimo įrankiais per natūralios kalbos pokalbius.
Tačiau norint pradėti, reikia tinkamai įdiegti. Štai viskas, ko reikia norint įdiegti Claude Code CLI ir tinkamai jį sukonfigūruoti.
Sistemos reikalavimai prieš diegimą
Prieš diegiant Claude Code, patikrinkite, ar sistema atitinka pagrindinius reikalavimus. Remiantis oficialia „Advanced setup“ dokumentacija, pašalinkite šią eilutę visiškai.
Patikrinkite „Node.js“ diegimą atidarę terminalą ir paleidę:
| node –version |
Jei „Node.js“ neįdiegtas arba versija yra žemesnė nei 18, atsisiųskite ją iš oficialios „Node.js“ svetainės. Ilgalaikio palaikymo (LTS) versija puikiai tinka „Claude Code“.
Be „Node.js“, sistemai reikia pagrindinių reikalavimų: „macOS 13.0“ ar naujesnė versija „Mac“ naudotojams, „Windows 10“ ar naujesnė versija „Windows“ sistemoms, o dauguma modernių „Linux“ platinamųjų versijų veikia be problemų. Taip pat reikalinga „Anthropic“ „Claude“ paskyra autentifikavimui po įdiegimo.
Claude Code diegimas „macOS“ ir „Linux“
Diegimo procesas „macOS“ ir „Linux“ naudoja vieną apvalkalo komandą, kuri viską atlieka automatiškai. Šis metodas yra aprašytas oficialiame „Claude Code“ greitojo paleidimo vadove.
Atidarykite terminalą ir paleiskite diegimo scenarijų:
| curl -fsSL claude.ai/install.sh | bash |
Scenarijus atsisiunčia „Claude Code“ dvejetainį failą, įdeda jį į tinkamą katalogą ir automatiškai sukonfigūruoja PATH. Visas procesas paprastai baigiamas per mažiau nei minutę.
„macOS“ naudotojams, kurie naudoja „Homebrew“, yra alternatyvus diegimo metodas, nors jis nėra oficialiai dokumentuotas pagrindiniuose šaltiniuose. „curl“ metodas išlieka rekomenduojamas metodas pagal oficialią dokumentaciją.
Diegimo patikrinimas
Baigę diegti, patikrinkite, ar „Claude Code“ pasiekiamas:
| claude –version |
Ši komanda turėtų parodyti įdiegtą versijos numerį. Jei pasirodo klaida „command not found“, reikia sureguliuoti PATH konfigūraciją.
Pagal oficialią trikčių šalinimo dokumentaciją, PATH problemos yra dažniausia diegimo problema. Taisymas apima „Claude“ diegimo katalogo pridėjimą prie apvalkalo konfigūracijos failo.
Claude Code diegimas „macOS“ ir „Linux“
„macOS“ ir „Linux“ diegimo procesas naudoja „npm“ („Node Package Manager“). Pagal oficialią dokumentaciją, prieš tęsiant reikia įdiegti „Node.js 18+“ savo sistemoje. Skirtingai nei tradiciniai CLI įrankiai, naudojantys apvalkalo scenarijus, „Claude Code“ diegiamas globaliai per jūsų terminalą, siekiant užtikrinti, kad visos priklausomybės būtų tinkamai tvarkomos.
Atidarykite terminalą ir paleiskite šią komandą, kad įdiegtumėte paketą:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Pastaba: aplinkos kintamasis CLAUDE_CODE_RELEASE_ALPHA=1 šiuo metu yra būtinas viešos beta/alfa fazės metu, norint pripažinti įrankio peržiūros būseną.
Ši komanda atsisiunčia paketą iš oficialaus „npm“ registro ir susieja „claude“ vykdomąjį failą su jūsų sistemos globaliu „bin“ katalogu. Nors kai kurie vartotojai gali bandyti rasti „Homebrew“ formules, „npm“ metodas yra vienintelis oficialiai palaikomas ir dokumentuotas diegimo kelias.
Diegimo patikrinimas
Baigę diegti, patikrinkite, ar CLI tinkamai susietas su jūsų aplinka, paleidę:
| claude –version |
Ši komanda turėtų parodyti dabartinį versijos numerį (pvz., 0.2.9). Jei susiduriate su „command not found“ klaida, tai paprastai reiškia, kad jūsų globalus „npm“ katalogas nėra jūsų sistemos PATH.
Pagal oficialią trikčių šalinimo dokumentaciją, galite tai ištaisyti, nustatę savo „npm“ prefiksą naudodami „npm config get prefix“ ir užtikrindami, kad gautas `/bin` aplankas būtų pridėtas prie jūsų `.zshrc` arba `.bashrc` failo.
Claude Code diegimas „Windows“
„Windows“ diegimas siūlo du pagrindinius metodus: natyvus „PowerShell“ diegimas arba „Windows Subsystem for Linux“ („WSL“) naudojimas. Oficiali dokumentacija rekomenduoja „PowerShell“ daugumai vartotojų.
„PowerShell“ diegimo metodas
Atidarykite „PowerShell“ kaip administratorių (dešiniuoju pelės mygtuku spustelėkite pradžios meniu ir pasirinkite „Windows PowerShell (Admin)“). Paleiskite šią komandą:
| irm claude.ai/install.ps1 | iex |
„PowerShell“ scenarijus automatiškai tvarko atsisiuntimą, diegimą ir PATH konfigūraciją. Baigę uždarykite ir vėl atidarykite „PowerShell“, kad PATH pataisymai įsigaliotų.
„WSL“ diegimo metodas
„WSL“ jau naudojantys kūrėjai gali įdiegti „Claude Code“, naudodami „Linux“ metodą. Atidarykite „WSL“ terminalą ir paleiskite tą pačią `curl` komandą, kuri naudojama „Linux“:
| curl -fsSL claude.ai/install.sh | bash |
„WSL“ metodas veikia identiškai kaip natyvūs „Linux“ diegimai. Vienas privalumas: „WSL“ suteikia panašesnę į „Unix“ aplinką, kuri atitinka gamybos serverių konfigūracijas.
Pagal oficialią trikčių šalinimo dokumentaciją, „WSL“ naudotojai kartais susiduria su tinklo ryšio problemomis. Jei diegimas stringa, patikrinkite, ar „WSL“ gali pasiekti išorinius tinklus ir ar ugniasienės taisyklės neužblokuoja srauto.
Raskite Claude ir dirbtinio intelekto įrankių kreditus vienoje vietoje
„Claude Code CLI“ diegimas yra vienas žingsnis. Mokėti už dirbtinio intelekto įrankius ilgalaikėje perspektyvoje yra kitas. Get AI Perks renka startuolių kreditus ir programinės įrangos nuolaidas dirbtinio intelekto ir debesų įrankiams vienoje vietoje. Tai suteikia steigėjams prieigą prie 200+ pasiūlymų, įskaitant pasiūlymus iš „Anthropic“, „Claude“, „OpenAI“, „Gemini“, „ElevenLabs“, „Intercom“ ir kt. Platforma taip pat rodo pasiūlymų sąlygas ir vadovus, kaip juos gauti.
Ieškote Claude ar Anthropic kreditų?
Patikrinkite „Get AI Perks“, kad galėtumėte:
- rasti dirbtinio intelekto įrankių kreditus ir nuolaidas vienoje vietoje
- peržiūrėti pasiūlymų sąlygas prieš kreipiantis
- gauti vadovus, kaip gauti startuolių pasiūlymus
👉 Apsilankykite „Get AI Perks“, kad peržiūrėtumėte galimus „Claude“, „Anthropic“ ir kitų dirbtinio intelekto programinės įrangos pasiūlymus.
Autentifikavimas ir pirminė konfigūracija
Po diegimo „Claude Code“ reikalauja autentifikavimo, kad galėtų veikti. Įrankis naudoja „Anthropic“ API raktus prieigai patvirtinti.
Pradėkite autentifikavimo procesą paleidę:
| claude |
Pirmą kartą paleidus šią komandą, „Claude Code“ paprašys autentifikavimo. Pagal oficialų greitojo paleidimo vadovą, tai atidarys naršyklės langą, kuriame galėsite prisijungti prie „Anthropic“ paskyros.
Prisijungę per naršyklę, CLI automatiškai gaus autentifikavimo žetoną. Šis žetonas saugomas lokaliai ir išlieka tarp sesijų, todėl pakartotinis autentifikavimas nebūtinas.
Projekto lygio nustatymų konfigūravimas
„Claude Code“ palaiko konfigūraciją skirtinguose lygiuose, pagal oficialią nustatymų dokumentaciją. Dažniausiai naudojami konfigūracijos lygiai yra:
| Sritis | Vieta | Naudojimo atvejis |
|---|---|---|
| Vartotojas | ~/.claude/ katalogas | Asmeniniai nustatymai visuose projektuose |
| Projektas | .claude/ saugykloje | Bendras komandos konfigūravimas |
| Vietinis | .claude/settings.local.json | Mašinai specifiniai pakeitimai |
Pirmą kartą nustatant pakanka vartotojo lygio konfigūracijos. Projekto lygio nustatymai tampa svarbūs dirbant su komandomis, kurios dalijasi kodavimo standartais.
Pradėkite savo pirmąją Claude Code sesiją
Baigę diegimą ir autentifikavimą, paleiskite „Claude Code“ paleisdami komandą be argumentų:
| claude |
Tai pradeda interaktyvųjį režimą, kuriame „Claude“ atsako į natūralios kalbos užklausas. Oficiali dokumentacija apibūdina interaktyvųjį režimą kaip pagrindinį būdą naudoti „Claude Code“ kūrimo užduotims.
Pabandykite paprastą bandymo komandą:
| Show me the structure of this project |
„Claude Code“ analizuoja dabartinį katalogą ir pateikia kodų bazės struktūros apžvalgą. Tai parodo, kad diegimas veikia tinkamai ir „Claude“ turi prieigą skaityti failus.
Būtinos komandos kasdieniam naudojimui
Be interaktyviojo režimo, „Claude Code“ palaiko kelis komandų modelius, dokumentuotus CLI referenciniame vadove:
| Komandos modelis | Paskirtis | Pavyzdys |
|---|---|---|
| claude | Pradėti interaktyvią sesiją | claude |
| claude “task” | Vykdyti vienkartinę užduotį | claude “fix the linting errors” |
| claude -p “query” | Greita užklausa be sesijos | claude -p “what does this function do” |
Vienkartinių užduočių modelis yra ypač naudingas CI/CD procesams ir automatizavimo scenarijams, kai interaktyvioji sesija netinka.
Dažniausios diegimo trikčių šalinimo problemos
Net ir su automatizuotais diegimo scenarijais, kartais pasitaiko problemų. Oficiali trikčių šalinimo dokumentacija apima dažniausias problemas.
„Command Not Found“ klaidos
Jei po diegimo terminale rodomas pranešimas „command not found: claude“, PATH konfigūracija nebuvo tinkamai užbaigta. „macOS“ ir „Linux“ sistemose rankiniu būdu pridėkite „Claude“ dvejetainio failo vietą prie apvalkalo konfigūracijos failo.
„Bash“ naudotojams, redaguokite `~/.bashrc` arba `~/.bash_profile` ir pridėkite:
| export PATH=”$HOME/.local/bin:$PATH” |
„Zsh“ naudotojams (numatytasis šiuolaikiniuose „macOS“) redaguokite `~/.zshrc` su ta pačia eilute. Po išsaugojimo, atnaujinkite konfigūraciją su `source ~/.zshrc` arba atidarykite naują terminalo langą.
Tinklo ir ugniasienės problemos
Įmonių tinklai ir ribojančios ugniasienės kartais blokuoja diegimo scenarijų. Pagal trikčių šalinimo dokumentaciją, jei diegimas stringa arba grąžina HTML vietoj vykdymo, gali būti blokuojamas tinklo prieigimas prie „Anthropic“ serverių.
Apsukus problemą, atsisiųskite diegimo scenarijų atskirai:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Šis metodas suteikia daugiau matomumo, kas nepavyksta, jei atsiranda klaidų atsisiunčiant ar vykdant.
WSL specifinės problemos
„Windows“ naudotojai, naudojantys „WSL“, kartais susiduria su ryšio problemomis tarp „Linux“ pogrupio ir „Windows“. Oficiali dokumentacija mini, kad gali reikėti sureguliuoti ugniasienės taisykles, kad būtų leidžiamas „WSL“ srautas.
Jei „Claude Code“ sėkmingai įdiegiama, bet negali pasiekti „Anthropic“ serverių autentifikavimui, patikrinkite, ar „Windows“ ugniasienė leidžia „WSL“ tinklo prieigą. Trikčių šalinimo vadove pateikiamos konkrečios „PowerShell“ komandos ugniasienės taisyklių konfigūravimui.
Claude Code atnaujinimas
„Claude Code“ reguliariai atnaujinama naujomis funkcijomis ir patobulinimais. Pagal oficialią dokumentaciją, naujinimai diegiami naudojant tą pačią komandą kaip ir pirminis diegimas.
Paleiskite diegimo scenarijų dar kartą:
| curl -fsSL code.anthropic.com/install.sh | sh |
Scenarijus aptinka esamą diegimą ir atnaujina jį į naujausią versiją. Atnaujinimo metu neprarandama jokio konfigūravimo ar autentifikavimo.
Patikrinkite dabartinę versiją prieš ir po atnaujinimo:
| claude –version |
Oficialios „Claude Code“ dokumentacijos pakeitimų žurnale pateikiami visi pakeitimai tarp versijų, o tai padeda nustatyti, ar naujinimas pristato funkcijas, aktualias konkretiems darbo eigoms.
Kiti žingsniai po diegimo
Įdiegus ir veikiant „Claude Code“, galima ištirti pažangias funkcijas. Oficiali dokumentacija aprašo kelias vertas ištirti sritis:
- Įgūdžiai ir pritaikymas: Remiantis oficialia įgūdžių dokumentacija, „Claude Code“ palaiko pasirinktinius įgūdžius, apibrėžtus „Markdown“ failuose `.claude/skills/` kataloge. Šie įgūdžiai plečia „Claude“ galimybes specifiniais projekto komandomis ir darbo eigomis.
- Modelio konteksto protokolas (MCP): MCP integracija leidžia „Claude Code“ prisijungti prie išorinių įrankių ir paslaugų. Tai paverčia „Claude“ centru, kuris gali pasiekti duomenų bazes, API ir kitus kūrimo išteklius.
- Komandos bendradarbiavimas: Projekto lygio konfigūracijos failai `.claude/` kataloge gali būti įtraukti į versijų kontrolę, dalijantis „Claude Code“ nustatymais visose kūrimo komandose.
- Oficiali dokumentacija pateikia išsamius vadovus kiekvienai iš šių sričių, remiantis čia aprašytu pagrindiniu diegimu.
Dažnai užduodami klausimai
Ar man reikia mokamos Claude prenumeratos, kad galėčiau naudoti Claude Code CLI?
„Claude Code“ reikalinga „Anthropic“ „Claude“ paskyra, tačiau konkretus reikalingas prenumeratos lygis priklauso nuo naudojimo. Pagal oficialią dokumentaciją, autentifikavimas yra būtinas, tačiau kainodaros detales reikėtų patikrinti „Anthropic“ oficialioje svetainėje, nes planai laikui bėgant keičiasi.
Ar galiu įdiegti Claude Code be administratoriaus teisių?
„macOS“ ir „Linux“ sistemose „Claude Code“ pagal numatytuosius nustatymus diegiama vartotojo namų kataloge ir nereikalauja administratoriaus prieigos. „Windows“ naudotojams gali prireikti administratoriaus teisių „PowerShell“ diegimo metodui, nors „WSL“ diegimai administratoriaus teisių nereikalauja.
Ar Claude Code veikia neprisijungus?
Ne. „Claude Code“ yra dirbtinio intelekto įrankis, kuris bendrauja su „Anthropic“ serveriais, kad apdorotų užklausas. Pagal oficialią dokumentaciją, norint, kad „Claude“ galėtų analizuoti kodą ir generuoti atsakymus, reikalingas aktyvus interneto ryšys.
Kaip pašalinti Claude Code?
Oficialioje „Advanced setup“ dokumentacijoje paaiškinama, kad pašalinimas apima dvejetainio failo ir konfigūracijos failų pašalinimą. „macOS“ ir „Linux“ sistemose ištrinkite `~/.claude` katalogą ir pašalinkite PATH pakeitimą iš apvalkalo konfigūracijos failų. „Windows“ naudotojai turėtų pašalinti diegimo katalogą ir išvalyti PATH aplinkos kintamąjį.
Ar Claude Code gali pasiekti visą mano failų sistemą?
Pagal numatytuosius nustatymus, „Claude Code“ veikia dabartiniame darbo kataloge ir jo subkataloguose. Pagal oficialią leidimų dokumentaciją, prieiga gali būti dar labiau apribota naudojant smėlio dėžės nustatymus konfigūracijos failuose. „Claude“ visada prašo patvirtinimo prieš vykdydamas potencialiai žalingas operacijas.
Kuo skiriasi Claude Code CLI ir Claude Desktop?
„Claude Code CLI“ veikia terminale ir sutelkia dėmesį į kūrimo darbo eigas su tiesiogine failų sistemos prieiga ir komandų vykdymu. „Claude Desktop“ yra atskira programėlė su grafine sąsaja. Abu įrankiai tarnauja skirtingiems naudojimo atvejams, CLI yra optimizuotas kūrėjams, kurie mėgsta terminalo pagrindu veikiančias darbo eigas.
Kaip dažnai turėčiau atnaujinti Claude Code?
Naujinimus galima diegti bet kada, kai patogu. Oficialus pakeitimų žurnalas aprašo naujas funkcijas ir klaidų taisymus. Komandoms atnaujinimų koordinavimas užtikrina, kad visi naudotų suderinamas versijas, nors „Claude Code“ išlaiko atgalinį suderinamumą su konfigūracijos failais tarp versijų.
Išvada
„Claude Code CLI“ diegimas trunka vos kelias minutes, nepriklausomai nuo operacinės sistemos. Automatizuoti diegimo scenarijai tvarko konfigūraciją, PATH nustatymą ir dvejetainių failų pateikimą be rankinio įsikišimo.
Po diegimo ir autentifikavimo „Claude Code“ tampa galingu dirbtinio intelekto kodavimo asistentu, pasiekiamu iš bet kurio terminalo. Natūralios kalbos komandos leidžia kūrėjams rašyti kodą, taisyti klaidas ir automatizuoti užduotis neišeinant iš komandinės eilutės.
Pasiruošę patirti dirbtinio intelekto pagalbą kuriant? Paleiskite diegimo komandą savo platformai ir pradėkite savo pirmąją „Claude Code“ sesiją šiandien. Oficiali dokumentacija adresu code.claude.com pateikia išsamius vadovus pažangioms funkcijoms, kai pagrindinis nustatymas bus baigtas.
