Урок 5 от поредицата за Claude Code: Как да инсталирате Claude Code?

Как да инсталирате Claude Code

Инсталирането на Claude Code няма графичен интерфейс с "Напред" – всичко става в командния ред. Ако използвате npm редовно, целият процес ще отнеме по-малко от две минути.

Предварителни изисквания

Преди да започнете, уверете се, че разполагате със следното:

Node.js 18 или по-нова версия
Проверка: изпълнете node -v в терминала. Ако версията е под 18, обновете чрез nvm, fnm или като изтеглите от nodejs.org.
Акаунт в Anthropic
Регистрирайте се на https://console.anthropic.com. Акаунтът ще предостави API ключ, който ще ви трябва след инсталиране. Регистрацията е безплатна, разходите се таксуват според използването.
Мрежов достъп до API крайните точки на Anthropic
Основният домейн е api.anthropic.com. Ако средата изисква прокси, задайте HTTP_PROXY или HTTPS_PROXY в терминала.

Начин на инсталиране 1: глобално с npm

Това е най-често срещаният начин – инсталирате веднъж и използвате навсякъде.

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

След завършване изпълнете claude --version. Ако се покаже версия, инсталацията е успешна. След глобална инсталация командата claude може да се извиква от всяка директория.

Ако срещнете грешка за права (често в macOS в директорията /usr/local/lib), има два начина:

Използвайте sudo за инсталиране (удобно, но с опасения за сигурност).
Конфигурирайте 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, може да има проблеми поради прокси или защитна стена. Първо проверете дали curl https://api.anthropic.com работи, след това продължете.
Използване на оригиналния cmd в Windows
Въпреки че теоретично е възможно, препоръчваме Git Bash, WSL2 или Windows Terminal, за да избегнете странни проблеми с екраниране на пътища.