Встановлення Claude Code на macOS. Одна команда, а потім нове вікно Терміналу
Як встановити Claude Code на Mac інсталятором, через Homebrew або npm, як перевірити встановлення, виправити command not found і все видалити.
Частина посібникаClaude Code, повний посібник. Від встановлення до власних скілів і плагінів
У цьому тексті
Коротко
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 називає цей спосіб нативним і радить саме його.
curl -fsSL https://claude.ai/install.sh | bashПід час завантаження інсталятор не показує прогресу, тож хвилина тиші нормальна. Програма потрапляє у вашу домашню теку. Команда claude лежить у ~/.local/bin/claude як посилання на потрібну версію в ~/.local/share/claude/versions/.
Коли інсталятор закінчить, закрийте вікно й відкрийте нове. Уже в ньому перевірте встановлення.
claude --version
claude doctorПерша команда виводить номер версії з приміткою (Claude Code). Друга перевіряє встановлення й файли налаштувань без запуску сесії, показує попередження й підказує виправлення. Програма підписана Anthropic і перевірена Apple, що можна підтвердити командою codesign --verify --verbose для файлу програми.
Homebrew і npm як інші способи
Якщо ви ставите програми через Homebrew, вистачить однієї команди.
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 не зможе оновлюватися сам.
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.
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 у файлі налаштувань.
Видалення версії з інсталятора займає дві команди.
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 ми подивимося, яку роботу він може зняти з вашої команди.
Що хочете змінити у своїй фірмі?
Залиште номер. Поговоримо про ваш процес і перевіримо, чи можемо допомогти. Перша розмова безкоштовна.
Послуга, про яку цей текст
Автоматизація та AI / OCRАвтоматизація переписування документів, OCR і правила перевірки, а дані лишаються у вас.