Claude Code-ის სახელმძღვანელო 5: როგორ დავაყენოთ Claude Code?

როგორ დავაყენოთ Claude Code

Claude Code-ის ინსტალაციას არ აქვს გრაფიკული ინტერფეისის „შემდეგი“ ღილაკი, ყველაფერი ტერმინალში კეთდება. თუ იყენებთ npm-ს, მთელი პროცესი ორ წუთზე ნაკლებს გაგრძელებთ.

წინაპირობები

დაწყებამდე დარწმუნდით, რომ გაქვთ:

• Node.js 18 ან უფრო მაღალი ვერსია
  შემოწმება: ტერმინალში გაუშვით node -v. თუ ვერსია 18-ზე დაბალია, განაახლეთ nvm-ით, fnm-ით ან nodejs.org-დან.
• Anthropic ანგარიში
  რეგისტრაციის მისამართი: https://console.anthropic.com. ანგარიში გამოგიგზავნით API Key-ს, რომელიც ინსტალაციის შემდეგ დაგჭირდებათ. რეგისტრაცია უფასოა, გადახდა ხდება გამოყენების მიხედვით.
• ქსელის წვდომა Anthropic-ის API-ზე
  ნაგულისხმევი დომენია api.anthropic.com. თუ გარემო მოითხოვს პროქსის კონფიგურაციას, ტერმინალში დააყენეთ HTTP_PROXY ან HTTPS_PROXY.

ინსტალაციის მეთოდი 1: npm გლობალური ინსტალაცია

ეს ყველაზე გავრცელებული მეთოდია – ერთხელ დააყენებთ და ყველგან გამოიყენებთ.

npm install -g @anthropic-ai/claude-code

დასრულების შემდეგ გაუშვით claude --version. თუ ვერსიის ნომერი გამოჩნდა, ინსტალაცია წარმატებულია. გლობალური ინსტალაციის შემდეგ claude ბრძანება ნებისმიერი დირექტორიიდან იქნება ხელმისაწვდომი.

თუ შეგხვდებათ უფლებების შეცდომა (ხშირია macOS-ის /usr/local/lib დირექტორიაში), ორი გამოსავალი:

1. გამოიყენეთ sudo ინსტალაციისთვის (მარტივია, მაგრამ უსაფრთხოების საკითხია).
2. კონფიგურაცია npm-ის მომხმარებლის დირექტორიის გამოყენებაზე, sudo-ს თავიდან ასაცილებლად:
   bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
   შემდეგ დაამატეთ ~/.npm-global/bin PATH-ში და გახსენით ახალი ტერმინალი.

ინსტალაციის მეთოდი 2: npx – გამოიყენე და წაშალე

თუ არ გსურთ გლობალური ინსტალაცია, ან უბრალოდ დროებით გამოცდა გინდათ, npx უფრო პირდაპირი გზაა.

npx @anthropic-ai/claude-code

npx დროებით გადმოტვირთავს უახლეს პაკეტს, გაუშვებს და გლობალურ ბრძანებას არ დატოვებს. ყოველ ჯერზე ამოწმებს განახლებებს, ამიტომ ყოველთვის უახლესი ვერსია გექნებათ. მინუსი: ცოტა ნელია (ყოველ ჯერზე ჩამოტვირთვა) და არ არის შესაფერისი ავტომატურ სკრიპტებში ხშირი გამოძახებისთვის.

შესაფერისი სიტუაციები: პირველი გაცნობა, სხვის კომპიუტერზე დროებით გამოყენება, ან იშვიათი მოხმარება.

გადამოწმება, მუშაობს თუ არა

ინსტალაციის შემდეგ ნუ იჩქარებთ ავტორიზაციას. გაუშვით მარტივი ბრძანება, რომ ნახოთ ინსტრუმენტი იწყება თუ არა:

claude --help

თუ დახმარების ინფორმაცია გამოჩნდა, ესე იგი ორობითი ფაილი მუშაობს. შემდეგი ნაბიჯი ანგარიშთან დაკავშირებაა, რაც შემდგომში აიხსნება.

ორივე მეთოდის შედეგად მიღებული ბრძანება ერთი და იგივეა; შემდგომი ავტორიზაცია და გამოყენება სრულიად იდენტურია. აირჩიეთ ის, რომელიც თქვენთვის მოსახერხებელია.

ხშირი კითხვები

• Node-ს ვერსია ძალიან დაბალია
  18-ზე ქვემოთ პირდაპირ შეცდომას გამოიწვევს, გაფრთხილების გარეშე. Node-ს განახლება ყველაზე პირდაპირი გამოსავალია.
• ქსელის დროის ამოწურვა
  npm-ით პაკეტის ჩამოტვირთვა თუ API-სთან შეერთება შეიძლება პროქსის ან firewall-ის გამო ჩაიჭრას. ჯერ შეამოწმეთ curl https://api.anthropic.com – თუ მუშაობს, შემდეგ გააგრძელეთ.
• Windows-ზე ორიგინალური cmd-ის გამოყენება
  თეორიულად შესაძლებელია, მაგრამ რეკომენდებულია Git Bash, WSL2 ან Windows Terminal, რათა თავიდან აიცილოთ უცნაური გზის გარდაქმნის პრობლემები.