Kopsavilkums: Claude Code var instalēt, izmantojot natīvos instalētājus operētājsistēmās macOS, Windows un Linux no oficiālās Claude Code vietnes. Windows lietotājiem pirms Claude Code palaišanas ir jāinstalē WSL2. Pēc instalēšanas autentificējieties ar savu Claude kontu, kad Claude Code pirmajā palaišanas reizē atvērs pārlūkprogrammas logu, lai jūs varētu sākt kodēt ar mākslīgā intelekta palīdzību tieši no termināļa vai darbvirsmas lietotnes.
Claude Code ir Anthropic centieni izveidot rīkus aģentiskai mākslīgā intelekta izstrādei. Šis komandrindas palīgs lasa kodu bāzes, rediģē failus, izpilda komandas un integrējas izstrādes darbplūsmās.
Taču tā instalēšana ne vienmēr ir vienkārša. Dažādām platformām nepieciešamas atšķirīgas pieejas. Windows ir nepieciešama papildu iestatīšana. Un dokumentācija, lai gan visaptveroša, var būt pārlieku liela jaunpienācējiem.
Šī rokasgrāmata izskaidro sarežģītību. Tā aptver sistēmas prasības, platformai specifiskas instalēšanas darbības, autentifikāciju un verifikāciju — visu nepieciešamo, lai Claude Code darbotos pareizi.
Sistēmas prasības pirms instalēšanas
Saskaņā ar oficiālo Claude Code dokumentāciju, rīks atbalsta macOS, Windows un Linux. Tomēr katrai platformai ir specifiskas priekšrocības.
macOS prasības ir minimālas. Sistēmai nepieciešams macOS 13.0 vai jaunāka versija. Gan Intel, gan Apple Silicon mikroshēmas darbojas labi.
Windows rada lielāku sarežģītību. Operētājsistēmai jābūt Windows 10 Build 19041 vai jaunākas versijas, vai Windows 11. Bet šeit ir āķis — Claude Code nedarbojas natīvi operētājsistēmā Windows.
Windows Subsystem for Linux 2 (WSL2) ir obligāts. Tas izveido Linux vidi, kurā faktiski darbojas Claude Code. Bez WSL2 instalēšana neizdodas.
Linux lietotājiem nepieciešama 64-bitu izplatīšana. Oficiālā dokumentācija apstiprina atbalstu Ubuntu, Debian, Fedora un citām galvenajām izplatīšanām. Alpine Linux un musl bāzētām sistēmām nepieciešama papildu konfigurācija.
Visām platformām instalēšanas laikā nepieciešams stabils interneta savienojums. Lejupielādes izmēri atšķiras, bet parasti svārstās no 50 MB līdz 500 MB atkarībā no tā, kas jau ir instalēts.
| Platforma | Minimālā versija | Īpašas prasības |
|---|---|---|
| macOS | 13.0 | Nav |
| Windows | 10 Build 19041 vai 11 | Nepieciešams WSL2 |
| Linux | 64-bitu izplatīšana | Vēlams glibc bāzēta |
Claude Code instalēšana operētājsistēmā macOS
macOS instalēšanas procesā tiek izmantots natīvs instalētājs. Tas ir vienkāršākais ceļš starp visām platformām.
Vispirms lejupielādējiet instalētāju no oficiālās Claude Code vietnes. Lejupielādes lapa automātiski nosaka macOS un piedāvā atbilstošo paketi.
Atveriet lejupielādēto .dmg failu. Pārvietojiet Claude Code lietotni uz Applications mapi. Standarta macOS instalēšana — nekas neparasts šeit.
Daži lietotāji saskaras ar drošības uzvedni pirmajā palaišanas reizē. macOS pēc noklusējuma bloķē lietotnes no neidentificētiem izstrādātājiem. Ar peles labo pogu noklikšķiniet uz Claude Code lietotnes un atlasiet "Open", lai apietu šo vienreizējo brīdinājumu.
Komandrindas rīks tiek instalēts automātiski kopā ar darbvirsmas lietotni. Atveriet Terminal un ierakstiet "claude --version", lai pārbaudītu. Ja parādās versijas numurs, instalēšana ir veiksmīga.
macOS instalēšanas pārbaude
Palaidiet šīs komandas, lai pārliecinātos, ka viss darbojas:
| claude --version claude --help |
Abām komandām ir jāatgriež izvade bez kļūdām. Komanda "version" parāda instalēto Claude Code versiju. Komanda "help" parāda pieejamās opcijas un komandas.
Testa direktorija izveide palīdz pārbaudīt pilnu funkcionalitāti. Navigējiet uz projekta mapi un palaidiet "claude", lai sāktu interaktīvu sesiju. Rīkam vajadzētu inicializēties un pieprasīt autentifikāciju, ja vēl neesat pieteicies.
Windows instalēšana ar WSL2
Windows instalēšanai ir nepieciešamas vairākas darbības. Process aizņem ilgāku laiku nekā macOS, taču tas joprojām ir vadāms.
Vispirms jāinstalē WSL2. Atveriet PowerShell kā administrators un palaidiet:
| wsl --install |
Šī komanda pēc noklusējuma instalē WSL2 un Ubuntu. Sistēmai būs nepieciešama restartēšana. Pēc restartēšanas Ubuntu automātiski palaidīsies, lai pabeigtu sākotnējo iestatīšanu.
Kad tiks prasīts, izveidojiet Unix lietotājvārdu un paroli. Šīs akreditācijas dati ir atsevišķi no Windows pieteikšanās datiem.
Kad WSL2 darbojas, tiek piemērots Linux instalēšanas process. Atveriet Ubuntu termināli (instalēts ar WSL2) un lejupielādējiet Claude Code instalētāju Linux.
Claude Code instalēšana WSL2
Saskaņā ar oficiālo dokumentāciju, instalēšanas komanda lejupielādē un palaiž natīvo instalētāju:
| curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
Šis skripts automātiski apstrādā atkarības. Tas instalē Node.js, ja nepieciešams, iestata Claude Code bināro failu un konfigurē PATH mainīgos.
Instalēšana aizņem dažas minūtes. Progresa joslas un statusa ziņojumi norāda, kas notiek. Kad tas ir pabeigts, aizveriet un atkārtoti atveriet termināli, lai atsvaidzinātu vides mainīgos.
Instalēšanas pārbaude notiek tāpat kā macOS. Palaidiet "claude --version", lai pārbaudītu.
Linux instalēšanas process
Linux lietotājiem ir visvienkāršākais instalēšanas ceļš. Natīvais instalētājs darbojas tieši bez papildu slāņiem, piemēram, WSL2.
Lejupielādējiet un palaidiet instalēšanas skriptu:
| curl -fsSL claude.ai/install.sh | bash |
Tas lejupielādē Claude Code bināro failu, instalē atkarības un konfigurē apvalka vidi. Skripts nosaka izplatīšanu un attiecīgi pielāgojas.
Ubuntu un Debian bāzētām sistēmām skripts konfigurē instalēšanu. Oficiālā dokumentācija apstiprina atbalstu Ubuntu 20.04+, Debian 10+ un citām izplatīšanām.
Alpine Linux apsvērumi
Alpine Linux un musl bāzētām izplatīšanām nepieciešami papildu soļi. Oficiālā dokumentācija norāda, ka šīm sistēmām nepieciešama manuāla konfigurācija.
Standarta instalētājs var neizdoties operētājsistēmā Alpine. Tā vietā lejupielādējiet musl saderīgo bināro failu tieši no izlaidumu lapas. Izpakojiet to direktorijā sistēmas PATH, parasti /usr/local/bin.
Iestatiet izpildāmas atļaujas:
| chmod +x /usr/local/bin/claude |
Alpine lietotājiem pirms turpināšanas ir jāpārbauda saderība. Dažas funkcijas var nedarboties identiski kā glibc bāzētām izplatīšanām.
Autentifikācija un konta iestatīšana
Pēc Claude Code instalēšanas palaidiet "claude" savā terminālā. Pirmajā palaišanas reizē Claude Code atvērs pārlūkprogrammas logu, lai jūs varētu pieteikties.
Tas atvērs Claude autentifikācijas lapu. Piesakieties ar esošu Claude kontu vai izveidojiet jaunu.
Pārlūkprogrammā tiks parādīts autorizācijas kods. Kopējiet šo kodu un atgriezieties terminālā. Ievietojiet kodu, kad tiks prasīts.
Veiksmīga autentifikācija saglabā akreditācijas datus lokāli. Turpmākās sesijas neprasīs pieteikšanos, ja vien akreditācijas dati nebeidzas vai netiek manuāli dzēsti.
Komandas un uzņēmuma autentifikācija
Saskaņā ar oficiālo autentifikācijas dokumentāciju, komandām, kas izmanto Claude for Teams vai Enterprise, ir papildu iespējas. Organizācijas var konfigurēt vienreizēju pierakstīšanos (SSO) vai mākoņdatošanas pakalpojumu sniedzēja autentifikāciju.
SSO iestatīšanai nepieciešama administratora konfigurācija. Individuālie izstrādātāji pēc tam autentificējas caur savas organizācijas identitātes nodrošinātāju, nevis personīgos Claude kontus.
Mākoņdatošanas pakalpojumu sniedzēja autentifikācija darbojas AWS, Google Cloud un Azure izvietojumiem. Šī metode izmanto esošos mākoņdatošanas akreditācijas datus, nevis atsevišķus Claude kontus.
| Autentifikācijas metode | Lietošanas gadījums | Iestatīšanas sarežģītība |
|---|---|---|
| Personīgais konts | Individuālie izstrādātāji | Vienkārša |
| Komandas/Uzņēmuma SSO | Organizācijas | Nepieciešams administrators |
| Mākoņdatošanas pakalpojumu sniedzējs | AWS/GCP/Azure lietotāji | Vidēja |
Darbvirsmmas lietotnes instalēšana
Claude Code piedāvā gan komandrindas, gan darbvirsmas lietotnes. Darbvirsmas lietotne nodrošina grafisko saskarni, vienlaikus saglabājot pilnu termināļa funkcionalitāti.
Lejupielādējiet darbvirsmas instalētāju no oficiālās Claude vietnes. Lapa piedāvā macOS, Windows un Windows ARM64 versijas. Atlasiet atbilstošo versiju sistēmai.
macOS instalēšana notiek, izmantojot to pašu .dmg procesu, kas aprakstīts iepriekš. Windows lietotāji var lejupielādēt darbvirsmas lietotni grafiskai saskarnei, neprasot WSL2 iestatīšanu.
Darbvirsmmas lietotne ietver integrētu termināļa piekļuvi. Tā var palaist Claude Code sesijas, nepārslēdzoties uz ārējām termināļa lietotnēm.
Viens no darbvirsmas lietotnes priekšrocībām ir pieejamība fonā. Saskaņā ar oficiālo lejupielādes lapu, lietotne "paliek gatava fonā" un to var atvērt no jebkuras lietotnes, nepārslēdzot logus vai nepazaudējot fokusu.
Izmantojiet Get AI Perks, lai atrastu kredītus savai Claude Code sistēmai
Instalēšana ir vieglākā daļa. Īstās izmaksas parasti rodas no visa, kas saistīts ar to: infrastruktūra, atbalsta rīki un maksas pakalpojumi, ko izmanto iestatīšanas un testēšanas laikā. Get AI Perks var palīdzēt, uzskaitot starta kredītus un atlaides vienuviet, kā arī sniedzot norādījumus, kā tos pieteikt.
Izmantojot Get AI Perks, jūs varat:
- Atrast kredītus mākoņdatošanas un ar mākslīgo intelektu saistītiem rīkiem
- Pirms pieteikšanās pārbaudīt priekšrocību nosacījumus
- Izvairīties no laika tērēšanas piedāvājumiem, kuriem jūs, iespējams, neatbilstat
- Samazināt izmaksas, lai izveidotu savu iestatījumu
Apmeklējiet Get AI Perks, lai uzzinātu, vai pieejamie piedāvājumi atbilst rīkiem, ko plānojat izmantot ar Claude Code.
IDE paplašinājumi un integrācijas
Papildus atsevišķai instalēšanai, Claude Code integrējas ar populārām izstrādes vidēm. Ir paplašinājumi Visual Studio Code un JetBrains IDE.
VS Code paplašinājums tiek instalēts caur tirgus vietu. Meklējiet "Claude Code" paplašinājumu panelī un noklikšķiniet uz Install. Paplašinājumam ir nepieciešams, lai komandrindas rīks būtu instalēts vispirms.
Daži lietotāji ziņo par problēmām ar komplektā iekļauto VS Code paplašinājuma failu. Ja automātiskā instalēšana neizdodas ar kļūdu "End of central directory record signature not found", komplektā iekļautais .vsix fails var būt bojāts.
Risinājums ir paplašinājuma manuāla instalēšana no VS Code tirgus vietas, nepaļaujoties uz CLI komplektā iekļauto versiju. Tas atdala abus komponentus un novērš instalēšanas konfliktus.
JetBrains integrācija darbojas līdzīgi. Instalējiet spraudni no JetBrains tirgus vietas IntelliJ IDEA, PyCharm, WebStorm vai citos JetBrains produktos.
Instalēšanas panākumu pārbaude
Pareiza pārbaude nodrošina, ka Claude Code darbojas pareizi pirms faktisko izstrādes uzdevumu uzsākšanas.
Pamata pārbaude pārbauda komandu pieejamību:
| claude --help claude --version |
Šīm komandām ir jāizpildās bez kļūdām. "help" komanda uzskaita pieejamās opcijas. "version" komanda parāda instalēto laidienu.
Funkcionālās testēšanas nepieciešama sesijas palaišana. Izveidojiet testa direktoriju:
| mkdir test-project cd test-project claude |
Tas inicializē interaktīvu Claude Code sesiju. Rīkam vajadzētu analizēt direktoriju (šajā gadījumā tukšu) un parādīt uzvedni.
Mēģiniet izpildīt pamata komandas sesijas laikā. Ierakstiet "help", lai redzētu pieejamās darbības. Pieprasiet vienkāršus uzdevumus, piemēram, "izveido README failu" vai "paskaidro, ko tu vari darīt".
Veiksmīgas atbildes norāda uz pareizu instalēšanu. Ja rodas kļūdas, tās parasti ir saistītas ar autentifikāciju, tīkla savienojamību vai trūkstošām atkarībām.
Atjaunināšana un versiju pārvaldība
Claude Code pēc noklusējuma atjauninās automātiski. Oficiālā dokumentācija skaidro, ka rīks pārbauda jaunas versijas un instalē tās bez lietotāja iejaukšanās.
Atjaunināšanas uzvedību var konfigurēt, izmantojot Claude Code iestatījumus. Oficiālā dokumentācija aptver izlaidumu kanālu konfigurāciju un manuālās atjaunināšanas iespējas.
Manuālai atjaunināšanai nepieciešams vēlreiz palaist instalēšanas skriptu. Tā pati komanda, kas tika izmantota sākotnējai instalēšanai, lejupielādē jaunāko versiju:
| curl -fsSL claude.ai/install.sh | bash |
Ir iespējama specifisku versiju instalēšana testēšanas vai saderības nolūkos. Paplašinātā iestatīšanas dokumentācija aptver versiju fiksēšanu un izlaidumu kanālu konfigurāciju.
Izlaidumu kanāli ietver stabilo, beta un nakts. Stabilā versija ir ieteicama ražošanas darbiem. Beta un nakts kanāli nodrošina agrīnu piekļuvi jaunām funkcijām, bet var saturēt kļūdas.
Izplatītas instalēšanas problēmas
Vairākas problēmas bieži parādās kopienas diskusijās par Claude Code instalēšanu.
PATH konfigurācija rada daudzas problēmas. Ja "claude" komanda netiek atrasta pēc instalēšanas, binārais direktorijs nav sistēmas PATH.
Operētājsistēmās macOS un Linux direktorija pievienošana PATH parasti ietver ~/.bashrc, ~/.zshrc vai līdzīgu apvalka konfigurācijas failu rediģēšanu. Instalēšanas skripts parasti to apstrādā automātiski, taču manuāla pārbaude palīdz novērst problēmas.
Windows lietotājiem WSL2 var būt nepieciešams aizvērt un atkārtoti atvērt termināli pēc instalēšanas. Vides mainīgie netiek atsvaidzināti esošajās sesijās.
Tīkla ierobežojumi bloķē dažas instalēšanas. Korporatīvie ugunsmūri vai starpniekserveri var kavēt instalētāja lejupielādi vai savienojumu ar autentifikācijas serveriem.
Starpniekservera konfigurācija prasa vides mainīgos:
| export HTTP_PROXY= proxy.example.com:8080 export HTTPS_PROXY= proxy.example.com:8080 |
Atļauju kļūdas rodas, instalējot aizsargātos direktorijos. Instalētājam ir nepieciešama rakstīšanas piekļuve uz /usr/local/bin vai līdzīgām vietām. Palaišana ar sudo to novērš, taču tas jāizvairās, ja vien nav nepieciešams.
Bieži uzdotie jautājumi
Vai Claude Code var darboties bez interneta savienojuma?
Nē. Claude Code, lai darbotos, nepieciešams interneta savienojums. Rīks sūta kodu un vaicājumus uz Anthropic serveriem apstrādei. Lokālā kešošana var ļaut dažām operācijām darboties īslaicīgi bezsaistē, taču pilnai funkcionalitātei nepieciešams aktīvs savienojums.
Vai Claude Code darbojas ar esošajiem AI kodēšanas rīkiem?
Jā. Claude Code var darboties kopā ar GitHub Copilot, Cursor vai citiem AI izstrādes rīkiem. Tie darbojas neatkarīgi un nesadarbojas. Tomēr, vienlaicīgi izmantojot vairākus AI palīgus, var rasties neskaidrības par to, kurš rīks veic kuru uzdevumu.
Vai WSL2 ir nepieciešams visām Windows funkcijām?
Komandrindas rīks Windows prasa WSL2. Tomēr darbvirsmas lietotne darbojas natīvi operētājsistēmā Windows bez WSL2. Darbvirsmas lietotne nodrošina līdzīgu funkcionalitāti, izmantojot grafisko saskarni, nevis tīru komandrindas mijiedarbību.
Cik maksā Claude Code lietošana?
Cenas svārstās atkarībā no lietošanas un abonēšanas līmeņa. Pārbaudiet oficiālo Claude vietni, lai uzzinātu pašreizējās cenas, jo izmaksas un plānu struktūras laika gaitā mainās. Dažām funkcijām nepieciešami Claude Pro vai Enterprise abonementi.
Vai Claude Code var rediģēt failus ārpus projekta direktorija?
Pēc noklusējuma Claude Code drošības nolūkos ierobežo piekļuvi failiem uz pašreizējo projekta direktoriju. Konfigurācijas iestatījumi var paplašināt atļaujas, taču tas prasa skaidru autorizāciju. Sandboksēšanas dokumentācija detalizēti aptver atļauju pārvaldību.
Kāda ir atšķirība starp Claude Code un Claude API?
Claude Code ir izstrādes rīks interaktīvai kodēšanas palīdzībai. Claude API nodrošina programmatisku piekļuvi, lai veidotu lietotnes, kas izmanto Claude AI spējas. Tie kalpo dažādiem mērķiem — viens izstrādātājiem, kas raksta kodu, otrs lietotnēm, kas integrē AI funkcijas.
Vai Claude Code dzēšana noņem visus Claude Code datus?
Atinstalēšana noņem lietotnes bināro failu, bet var atstāt konfigurācijas failus un kešētos datus. Pilna noņemšana prasa manuāli dzēst ~/.claude direktoriju operētājsistēmās macOS un Linux vai atbilstošo AppData atrašanās vietu operētājsistēmā Windows.
Darba sākšana pēc instalēšanas
Kad Claude Code ir instalēts un pārbaudīts, nākamais solis ir saprast, kā to efektīvi izmantot.
Ātrās uzsākšanas dokumentācija iesaka sākt ar vienkāršiem uzdevumiem. Navigējiet uz esošu projektu un palaidiet "claude", lai sāktu interaktīvu sesiju.
Lūdziet Claude paskaidrot projekta struktūru. Pieprasiet kopsavilkumu par to, ko kodu bāze dara. Šie izpētes vaicājumi palīdz saprast, kā rīks interpretē kodu.
Mēģiniet veikt nelielas izmaiņas. Lūdziet Claude pievienot komentārus funkcijām, izveidot vienkāršus testu failus vai refaktorēt vienkāršus koda blokus. Šie uzdevumi demonstrē rediģēšanas spējas bez riska.
Git integrācija darbojas automātiski, ja projekts izmanto versiju kontroli. Claude Code var izveidot komitus, paskaidrot izmaiņas un ieteikt uzlabojumus, pamatojoties uz izmaiņām.
Oficiālā dokumentācija ietver darba plūsmas piemērus izplatītiem izstrādes uzdevumiem. Tie aptver kļūdu labošanu, funkciju ieviešanu, koda pārskatīšanu un automatizētu testēšanu.
Claude Code ir attīstības rīks. Instalēšana ir tikai pamats. Tās spēju, ierobežojumu un paraugprakses izpratne prasa eksperimentēšanu un praksi.
Gatavi instalēt Claude Code? Lejupielādējiet atbilstošo instalētāju savai platformai no oficiālās vietnes un sekojiet šajā rokasgrāmatā izklāstītajām darbībām. Autentificējieties ar savu Claude kontu, pārbaudiet, vai instalēšana darbojas pareizi, un sāciet izpētīt AI palīdzības izstrādi.
