Кратко резюме: Claude Code CLI се инсталира с една команда, която автоматично изтегля и конфигурира инструмента. На macOS и Linux използвайте официалния скрипт на обвивката от документацията на Anthropic, докато потребителите на Windows изпълняват команди на PowerShell или WSL. След инсталацията се удостоверете с вашия API ключ, за да започнете да използвате AI асистент за кодиране на Claude във вашия терминал.
Claude Code е кодинг агент, който живее във вашия терминал и разбира целия ви код. Според официалната документация на Claude Code, той може да чете файлове, да изпълнява команди, да редактира код и да се интегрира с инструменти за разработка чрез разговори на естествен език.
Но започването изисква правилна инсталация. Ето всичко необходимо за инсталирането на Claude Code CLI и правилното му конфигуриране.
Системни изисквания преди инсталация
Преди да инсталирате Claude Code, проверете дали системата отговаря на основните изисквания. Според официалната документация за разширена настройка, премахнете това изречение изцяло.
Проверете инсталацията на Node.js, като отворите терминал и изпълните:
| node –version |
Ако Node.js не е инсталиран или версията е под 18, изтеглете го от официалния уебсайт на Node.js. Версията с дългосрочна поддръжка (LTS) работи перфектно за Claude Code.
Освен Node.js, системата се нуждае от основни изисквания: macOS 13.0 или по-нова за потребители на Mac, Windows 10 или по-нова за системи с Windows и повечето модерни дистрибуции на Linux работят без проблеми. Необходим е и акаунт в Claude от Anthropic за удостоверяване след инсталацията.
Инсталиране на Claude Code на macOS и Linux
Процесът на инсталация за macOS и Linux използва една команда на обвивката, която автоматично се грижи за всичко. Този метод е документиран в официалното ръководство за бърз старт на Claude Code.
Отворете терминал и изпълнете скрипта за инсталация:
| curl -fsSL claude.ai/install.sh | bash |
Скриптът изтегля двоичния файл на Claude Code, поставя го в правилната директория и автоматично конфигурира PATH. Целият процес обикновено приключва за по-малко от минута.
За потребители на macOS, които предпочитат Homebrew, съществува алтернативен метод за инсталация, въпреки че не е официално документиран в основните източници. Методът с curl остава препоръчителният подход според официалната документация.
Проверка на инсталацията
След като инсталацията завърши, проверете дали Claude Code е достъпен:
| claude –version |
Тази команда трябва да покаже номера на инсталираната версия. Ако се появи грешка "command not found", конфигурацията на PATH трябва да бъде коригирана.
Според официалната документация за отстраняване на проблеми, проблеми с PATH са най-често срещаният проблем при инсталация. Решението включва добавяне на директорията за инсталация на Claude към файла за конфигурация на обвивката.
Инсталиране на Claude Code на macOS и Linux
Процесът на инсталация за macOS и Linux разчита на npm (Node Package Manager). Според официалната документация, трябва да имате инсталиран Node.js 18+ на вашата система, преди да продължите. За разлика от традиционните CLI инструменти, които използват скриптове на обвивката, Claude Code се инсталира глобално чрез вашия терминал, за да се гарантира, че всички зависимости са обработени правилно.
Отворете вашия терминал и изпълнете следната команда, за да инсталирате пакета:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Забележка: Променливата на средата CLAUDE_CODE_RELEASE_ALPHA=1 е необходима в момента по време на публичната бета/алфа фаза, за да се признае статусът на преглед на инструмента.
Тази команда изтегля пакета от официалния npm регистър и свързва изпълнимия файл claude към глобалната директория bin на вашата система. Докато някои потребители може да опитат да намерят формули за Homebrew, методът с npm е единственият официално поддържан и документиран път за инсталация.
Проверка на инсталацията
След като инсталацията приключи, проверете дали CLI е правилно картографиран към вашата среда, като изпълните:
| claude –version |
Тази команда трябва да покаже номера на текущата версия (напр. 0.2.9). Ако срещнете грешка "command not found", това обикновено означава, че вашата глобална npm директория не е в PATH на вашата система.
Според официалната документация за отстраняване на проблеми, можете да коригирате това, като идентифицирате вашия npm префикс с npm config get prefix и се уверите, че получената папка /bin е добавена към вашия .zshrc или .bashrc файл.
Инсталиране на Claude Code на Windows
Инсталацията на Windows предлага два основни подхода: нативна инсталация чрез PowerShell или използване на Windows Subsystem for Linux (WSL). Официалната документация препоръчва PowerShell за повечето потребители.
Метод за инсталация чрез PowerShell
Отворете PowerShell като администратор (щракнете с десния бутон върху менюто "Старт" и изберете "Windows PowerShell (Admin)"). Изпълнете тази команда:
| irm claude.ai/install.ps1 | iex |
Скриптът на PowerShell автоматично се грижи за изтеглянето, инсталацията и конфигурацията на PATH. След приключване затворете и отворете отново PowerShell, за да се приложат актуализациите на PATH.
Метод за инсталация чрез WSL
Разработчиците, които вече използват WSL, могат да инсталират Claude Code, като използват метода за Linux. Отворете терминала на WSL и изпълнете същата команда curl, използвана за Linux:
| curl -fsSL claude.ai/install.sh | bash |
Подходът с WSL работи идентично на нативните инсталации на Linux. Едно предимство: WSL предоставя среда, по-близка до Unix, която съответства на конфигурациите на сървъри за производство.
Според официалната документация за отстраняване на проблеми, потребителите на WSL понякога срещат проблеми с мрежовата свързаност. Ако инсталацията зацикли, проверете дали WSL може да осъществява достъп до външни мрежи и дали правилата на защитната стена не блокират трафика.
Намерете кредити за Claude и AI инструменти на едно място
Инсталирането на Claude Code CLI е една стъпка. Плащането за AI инструменти в дългосрочен план е друга. Get AI Perks събира стартови кредити и отстъпки за софтуер за AI и облачни инструменти на едно място. Той дава достъп на основателите до над 200 предимства, включително предложения от Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom и други. Платформата също така показва условията на предимствата и ръководства за заявяване на всяка оферта.
Търсите кредити за Claude или Anthropic?
Проверете Get AI Perks, за да:
- намерите кредити и отстъпки за AI инструменти на едно място
- прегледате условията на предимствата преди да кандидатствате
- получите достъп до ръководства за заявяване на стартиращи оферти
👉 Посетете Get AI Perks, за да разгледате наличните предимства за Claude, Anthropic и други AI софтуерни инструменти.
Удостоверяване и първоначална конфигурация
След инсталацията, Claude Code изисква удостоверяване, преди да може да функционира. Инструментът използва API ключове от Anthropic за проверка на достъпа.
Започнете процеса на удостоверяване, като изпълните:
| claude |
Първия път, когато тази команда се изпълни, Claude Code ще поиска удостоверяване. Според официалното ръководство за бърз старт, това отваря прозорец на браузъра за вход в акаунта в Anthropic.
След като влезете чрез браузъра, CLI автоматично получава токен за удостоверяване. Този токен се съхранява локално и остава валиден между сесиите, така че повторното удостоверяване не е необходимо.
Конфигуриране на настройки на ниво проект
Claude Code поддържа конфигуриране на множество нива според официалната документация за настройки. Най-често срещаните нива на конфигуриране са:
| Обхват | Местоположение | Употреба |
|---|---|---|
| Потребител | ~/.claude/ директория | Лични предпочитания за всички проекти |
| Проект | .claude/ в хранилището | Споделена конфигурация на екипа |
| Локално | .claude/settings.local.json | Отмени за специфична машина |
За първоначална настройка, конфигурацията на потребителско ниво е достатъчна. Настройките на ниво проект стават важни при работа с екипи, които споделят стандарти за кодиране.
Стартиране на първата сесия на Claude Code
След като инсталацията и удостоверяването са завършени, стартирайте Claude Code, като изпълните командата без аргументи:
| claude |
Това стартира интерактивен режим, където Claude отговаря на заявки на естествен език. Официалната документация описва интерактивния режим като основен начин за използване на Claude Code за задачи по разработка.
Опитайте проста тестова команда:
| Покажи ми структурата на този проект |
Claude Code анализира текущата директория и предоставя преглед на структурата на кода. Това демонстрира, че инсталацията работи правилно и Claude има достъп за четене на файлове.
Основни команди за ежедневна употреба
Освен интерактивния режим, Claude Code поддържа няколко командни шаблона, документирани в справочника за CLI:
| Команден шаблон | Предназначение | Пример |
|---|---|---|
| claude | Стартиране на интерактивна сесия | claude |
| claude “задача” | Изпълнение на еднократна задача | claude “поправи грешките в линтинга” |
| claude -p “заявка” | Бърза заявка без сесия | claude -p “какво прави тази функция” |
Шаблонът за еднократна задача е особено полезен за CI/CD пайплайни и скриптове за автоматизация, където интерактивната сесия не е подходяща.
Често срещани проблеми при инсталация
Дори с автоматизирани скриптове за инсталация, понякога възникват проблеми. Официалната документация за отстраняване на проблеми обхваща най-честите проблеми.
Грешки "Command Not Found"
Ако терминалът покаже "command not found: claude" след инсталацията, конфигурацията на PATH не е завършена правилно. За macOS и Linux, добавете ръчно местоположението на двоичния файл на Claude към файла за конфигурация на обвивката.
За потребители на bash, редактирайте ~/.bashrc или ~/.bash_profile и добавете:
| export PATH=”$HOME/.local/bin:$PATH” |
За потребители на zsh (по подразбиране на модерно macOS), редактирайте ~/.zshrc със същия ред. След като запишете, презаредете конфигурацията с source ~/.zshrc или отворете нов прозорец на терминал.
Мрежови проблеми и проблеми със защитната стена
Корпоративните мрежи и рестриктивните защитни стени понякога блокират скрипта за инсталация. Според документацията за отстраняване на проблеми, ако инсталацията зацикли или върне HTML вместо да се изпълни, мрежовият достъп до сървърите на Anthropic може да бъде блокиран.
Заобиколното решение включва изтегляне на скрипта за инсталация поотделно:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Този подход предоставя по-добра видимост към това, което се проваля, ако възникнат грешки по време на изтегляне или изпълнение.
Проблеми, специфични за WSL
Потребителите на Windows, които използват WSL, понякога срещат проблеми със свързаността между подсистемата на Linux и Windows. Официалната документация споменава, че може да се наложи коригиране на правилата на защитната стена, за да се разреши трафикът на WSL.
Ако Claude Code се инсталира успешно, но не може да достигне сървърите на Anthropic за удостоверяване, проверете дали защитната стена на Windows позволява достъп до мрежата на WSL. Ръководството за отстраняване на проблеми предоставя специфични команди на PowerShell за конфигуриране на правила за защитната стена.
Актуализиране на Claude Code
Claude Code получава редовни актуализации с нови функции и подобрения. Според официалната документация, актуализациите се инсталират със същата команда като първоначалната инсталация.
Изпълнете отново скрипта за инсталация:
| curl -fsSL code.anthropic.com/install.sh | sh |
Скриптът открива съществуващата инсталация и я надгражда до най-новата версия. Никоя конфигурация или удостоверяване не се губи по време на процеса на актуализация.
Проверете текущата версия преди и след актуализацията:
| claude –version |
Дневникът на промените в официалната документация на Claude Code изброява всички промени между версиите, което помага да се определи дали актуализацията въвежда функции, релевантни за конкретни работни процеси.
Следващи стъпки след инсталация
С инсталиран и работещ Claude Code, става възможно изследването на разширени функции. Официалната документация описва няколко области, които си струва да бъдат проучени:
- Умения и персонализация: Според официалната документация за умения, Claude Code поддържа потребителски умения, дефинирани в Markdown файлове в директорията .claude/skills/. Тези умения разширяват възможностите на Claude с команди и работни процеси, специфични за проекта.
- Колаборация в екип: Конфигурационни файлове на ниво проект в директорията .claude/ могат да бъдат добавени към контрола на версиите, споделяйки настройките на Claude Code в целия екип за разработка.
- Model Context Protocol (MCP): Интеграцията с MCP позволява на Claude Code да се свързва с външни инструменти и услуги. Това превръща Claude в хъб, който може да достъпва бази данни, API и други ресурси за разработка.
- Официалната документация предоставя подробни ръководства за всяка от тези области, надграждайки основната инсталация, разгледана тук.
Често задавани въпроси
Необходим ли ми е платен абонамент за Claude, за да използвам Claude Code CLI?
Claude Code изисква акаунт в Claude от Anthropic, но конкретното ниво на абонамент, което е необходимо, зависи от употребата. Според официалната документация, удостоверяването е необходимо, но подробностите за цените трябва да бъдат проверени на официалния уебсайт на Anthropic, тъй като плановете се променят с времето.
Мога ли да инсталирам Claude Code без администраторски права?
На macOS и Linux, Claude Code се инсталира по подразбиране в домашната директория на потребителя и не изисква администраторски достъп. Потребителите на Windows може да се нуждаят от администраторски права за метода на инсталация чрез PowerShell, въпреки че инсталациите на WSL не изискват администраторски достъп.
Работи ли Claude Code офлайн?
Не. Claude Code е AI-базиран инструмент, който комуникира със сървърите на Anthropic за обработка на заявки. Според официалната документация, активна интернет връзка е необходима, за да може Claude да анализира код и да генерира отговори.
Как да деинсталирам Claude Code?
Официалната документация за разширена настройка обяснява, че деинсталацията включва премахване на двоичния файл и конфигурационните файлове. На macOS и Linux, изтрийте директорията ~/.claude и премахнете модификацията на PATH от файловете за конфигурация на обвивката. Потребителите на Windows трябва да премахнат инсталационната директория и да изчистят променливата на средата PATH.
Може ли Claude Code да достъпи цялата ми файлова система?
По подразбиране, Claude Code работи в рамките на текущата работна директория и нейните поддиректории. Според официалната документация за правата, достъпът може да бъде допълнително ограничен чрез настройки за пясъчник (sandbox) във файловете за конфигурация. Claude винаги иска потвърждение преди да изпълни потенциално разрушителни операции.
Каква е разликата между Claude Code CLI и Claude Desktop?
Claude Code CLI работи в терминала и се фокусира върху работни процеси за разработка с директен достъп до файловата система и изпълнение на команди. Claude Desktop е самостоятелно приложение с графичен интерфейс. И двата инструмента служат за различни цели, като CLI е оптимизиран за разработчици, които предпочитат работни процеси, базирани на терминал.
Колко често трябва да актуализирам Claude Code?
Актуализациите могат да бъдат инсталирани, когато е удобно. Официалният дневник на промените документира нови функции и корекции на грешки. За екипи, координирането на актуализациите гарантира, че всички използват съвместими версии, въпреки че Claude Code поддържа обратна съвместимост с конфигурационни файлове между версиите.
Заключение
Инсталирането на Claude Code CLI отнема само няколко минути, независимо от операционната система. Автоматизираните скриптове за инсталация се грижат за конфигурирането, настройката на PATH и поставянето на двоичните файлове без ръчна намеса.
След инсталацията и удостоверяването, Claude Code се превръща в мощен AI асистент за кодиране, достъпен от всеки терминал. Командите на естествен език позволяват на разработчиците да пишат код, да коригират грешки и да автоматизират задачи, без да напускат командния ред.
Готови ли сте да изпитате разработка, подпомагана от AI? Изпълнете командата за инсталация за вашата платформа и започнете първата си сесия на Claude Code днес. Официалната документация на code.claude.com предоставя изчерпателни ръководства за разширени функции, след като основната настройка е завършена.
