Встановлення Claude Code на macOS. Одна команда, а потім нове вікно Терміналу

Як встановити Claude Code на Mac інсталятором, через Homebrew або npm, як перевірити встановлення, виправити command not found і все видалити.

Частина посібникаClaude Code, повний посібник. Від встановлення до власних скілів і плагінів

У цьому тексті
  1. Вимоги перед встановленням Claude Code на macOS
  2. Встановлення однією командою
  3. Homebrew і npm як інші способи
  4. Коли Термінал відповідає command not found
  5. Оновлення й видалення на Mac

Коротко

Claude Code встановлюється на Mac однією командою в Терміналі, а версія з інсталятора оновлюється сама. Розповідаємо також про Homebrew і npm, перевірку встановлення, найчастішу помилку зі шляхом PATH і повне видалення.

Ви вставляєте в Термінал одну команду, інсталятор якийсь час нічого не показує, завершує роботу, а claude однаково не працює. Саме так найчастіше виглядає перше встановлення Claude Code на macOS. Програма вже на диску, просто відкрите вікно Терміналу ще про неї не знає. Нижче весь шлях від вимог до видалення, перевірений за документацією Anthropic, станом на 10 листопада 2026.

Ми щодня працюємо в Claude Code на Mac. Що вміє сам інструмент, ми писали в статті Що таке Claude Code, а весь цикл зібрано в путівнику по Claude Code.

Вимоги перед встановленням Claude Code на macOS

Claude Code працює на macOS 13.0 і новіших, на Mac із процесором Apple і з процесором Intel. Потрібно щонайменше 4 GB оперативної пам'яті й стабільний інтернет. Git не обов'язковий, хоча для роботи з кодом знадобиться.

Для входу потрібен акаунт Claude з планом Pro, Max, Ultra, Team або Enterprise, акаунт у Claude Console або доступ через корпоративну хмару. Безкоштовний план claude.ai не містить Claude Code. Якщо термінал лякає, в Anthropic є також настільний застосунок, де Claude Code працює без введення команд. Ця стаття про версію в Терміналі.

Встановлення однією командою

Відкрийте Термінал і вставте команду інсталятора. Anthropic називає цей спосіб нативним і радить саме його.

bash
curl -fsSL https://claude.ai/install.sh | bash

Під час завантаження інсталятор не показує прогресу, тож хвилина тиші нормальна. Програма потрапляє у вашу домашню теку. Команда claude лежить у ~/.local/bin/claude як посилання на потрібну версію в ~/.local/share/claude/versions/.

Коли інсталятор закінчить, закрийте вікно й відкрийте нове. Уже в ньому перевірте встановлення.

bash
claude --version
claude doctor

Перша команда виводить номер версії з приміткою (Claude Code). Друга перевіряє встановлення й файли налаштувань без запуску сесії, показує попередження й підказує виправлення. Програма підписана Anthropic і перевірена Apple, що можна підтвердити командою codesign --verify --verbose для файлу програми.

Homebrew і npm як інші способи

Якщо ви ставите програми через Homebrew, вистачить однієї команди.

bash
brew install --cask claude-code

У Homebrew є два варіанти. claude-code йде каналом stable, який зазвичай приблизно на тиждень позаду найновішого випуску й пропускає випуски із серйозними помилками. claude-code@latest отримує кожну версію одразу. Встановлення з Homebrew саме не оновлюється. Оновлюйте його командою brew upgrade claude-code або brew upgrade claude-code@latest, залежно від варіанта. Homebrew зберігає старі версії на диску, тож час від часу запускайте brew cleanup.

Якщо brew відповідає, що claude-code не існує, ваш локальний індекс Homebrew просто застарів. Допоможе brew update і повторне встановлення.

Третій шлях через npm. Пакет потребує Node.js версії 22 або новішої й ставить ту саму програму, що й інсталятор. Ніколи не додавайте перед ним sudo, бо тоді Claude Code не зможе оновлюватися сам.

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

Оберіть один спосіб. Два встановлення одночасно закінчуються тим, що Термінал запускає іншу версію, ніж ви думаєте. Команда which -a claude покаже всі копії, які бачить система.

Коли Термінал відповідає command not found

Повідомлення zsh: command not found: claude одразу після встановлення майже завжди означає, що тека ~/.local/bin не входить у PATH. Спершу перевірте, чи програма взагалі є на диску, командою ls -la ~/.local/bin/claude. Якщо є, додайте теку в конфігурацію оболонки. На Mac типова оболонка zsh.

bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Якщо ви користуєтеся bash, допишіть цей рядок у ~/.bash_profile, а не в ~/.bashrc. Термінал на Mac запускає bash як оболонку входу, а вона пропускає ~/.bashrc. Термінал усередині редактора бере PATH від редактора, тож VS Code теж треба закрити й відкрити знову.

Документація окремо описує ще кілька симптомів, характерних для Mac.

  • zsh: permission denied: /Users/…/.zshrc означає, що файл належить іншому користувачеві, зазвичай root. Виправляє це sudo chown $(whoami) ~/.zshrc.
  • dyld: Symbol not found або dyld: cannot load означає надто стару систему. Homebrew не допоможе, бо завантажує ту саму програму. Треба оновити macOS до 13.0 або новішої.
  • У сесії SSH Keychain буває заблокований. Claude Code зберігає там вхід, а коли запис не вдається, переходить на файл ~/.claude/.credentials.json. Тоді claude doctor попереджає, що Keychain не приймає запис, а розблоковує його security unlock-keychain ~/Library/Keychains/login.keychain-db.

Скорочення з клавішею Option, наприклад Option+Enter для нового рядка, потребують налаштування Option як клавіші Meta. Найпростіше ввести в сесії /terminal-setup. У Терміналі Apple ця команда вмикає Option як Meta й вимикає звуковий сигнал.

Оновлення й видалення на Mac

Версія з інсталятора перевіряє оновлення під час запуску й у процесі роботи. Нова версія завантажується у фоні й починає діяти з наступного запуску. Щоб оновитися одразу, введіть claude update. Повільніший канал stable можна вибрати в /config або ключем autoUpdatesChannel у файлі налаштувань.

Видалення версії з інсталятора займає дві команди.

bash
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Для Homebrew це brew uninstall --cask claude-code, для npm npm uninstall -g @anthropic-ai/claude-code. Налаштування лишаються в теці ~/.claude і файлі ~/.claude.json. Якщо їх видалити, зникнуть налаштування, збережені дозволи, конфігурація серверів MCP та історія сесій. Розширення VS Code і настільний застосунок теж пишуть у ~/.claude, тож спершу видаліть їх, якщо хочете прибрати все.

Після встановлення переходьте до першого запуску й входу, а потім до основних команд. Встановлення на інших системах описують статті для Windows і Linux.

Якщо після встановлення claude не працює, почніть із нового вікна Терміналу й claude doctor, а вже потім шукайте далі. Якщо ви думаєте, чи має AI сенс у вашій фірмі взагалі, на безкоштовному аудиті AI ми подивимося, яку роботу він може зняти з вашої команди.

Що хочете змінити у своїй фірмі?

Залиште номер. Поговоримо про ваш процес і перевіримо, чи можемо допомогти. Перша розмова безкоштовна.

Коли зручно зателефонувати?
Адміністратор: Oleksandr Bondarenko (BondSoft)Політика конфіденційностіРегламент
Юридичні деталі

Адміністратором даних є Oleksandr Bondarenko, що веде господарську діяльність під фірмою Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, NIP 5833576264, e-mail: office@bondsoft.pl.

Дані обробляємо виключно з метою контакту у справі вашого запиту та надання пропозиції — на підставі вашої згоди (ст. 6 ч. 1 п. a RODO та ст. 398 закону Prawo komunikacji elektronicznej) і нашого правомірного інтересу, що полягає в опрацюванні запиту (ст. 6 ч. 1 п. f RODO).

Надання даних добровільне, але необхідне для зворотного контакту. Згоду можете відкликати будь-коли, написавши на office@bondsoft.pl — це не впливає на законність обробки до відкликання.

Ви маєте право на доступ до даних, їх виправлення, видалення, обмеження обробки, перенесення, а також на скаргу до Голови Управління охорони персональних даних.

Повна інформація: Політика конфіденційності.

Напишіть на пошту

Послуга, про яку цей текст

Автоматизація та AI / OCR

Автоматизація переписування документів, OCR і правила перевірки, а дані лишаються у вас.