Claude Code – это AI‑агент от Anthropic, который работает прямо в терминале и помогает писать, рефакторить и отлаживать код без переключения в браузер. В 2026 году он доступен в виде нативного бинарника, Homebrew‑пакета и npm‑модуля. В этой статье мы подробно разберём, как установить Claude Code на macOS, настроить окружение и начать продуктивно работать с ним.
Содержание
- Установка Claude Code
- Базовая настройка терминала
- Первый запуск и авторизация
- Основные slash‑команды
- Файл
CLAUDE.md– память проекта - Полезные лайфхаки и типичные проблемы
- Дополнительные ресурсы
Установка Claude Code
Существует три официальных способа установки на macOS:
- Нативный бинарник – самый простой и быстрый вариант.
- Homebrew – удобен, если вы уже используете пакетный менеджер.
- npm – подходит разработчикам, которые работают с Node.js.
Установка нативного бинарника (рекомендованный способ)
Откройте Terminal (⌘ Space → введите Terminal → Enter) и выполните одну строку:
curl -fsSL https://cli.anthropic.com/install.sh | bashСкрипт скачает последнюю версию claude, разместит её в /usr/local/bin (или в ~/.local/bin, если у вас нет прав администратора) и автоматически добавит путь в ваш .zshrc (по умолчанию macOS использует zsh).
Установка через Homebrew
# Если Homebrew ещё не установлен
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install claudeУстановка через npm (не рекомендуется использовать sudo)
npm install -g @anthropic/claude-cliПосле любой из этих установок закройте текущий терминал и откройте новое окно, чтобы переменная PATH обновилась.
Базовая настройка терминала
Claude Code использует несколько особенностей терминала macOS. Чтобы всё работало гладко, выполните следующие шаги:
- Option‑key как Meta – в большинстве эмуляторов (Terminal, iTerm2, Ghostty) нужно включить Option as Meta. Это позволяет вводить команды типа
Esc+Ctrlбез конфликтов. - Уведомления – Claude может отправлять системные нотификации о завершении задачи. Разрешите их в
System Settings → Notifications → Claude Code. - Тема и шрифт – для лучшего восприятия выводимых блоков кода рекомендуется использовать моноширинный шрифт (Menlo, JetBrains Mono) и тёмную тему.
Если вы используете iTerm2, включите Preferences → Profiles → Keys → Left Option (or Right Option) acts as +Esc.
Первый запуск и авторизация
После установки введите в терминале:
claude doctorКоманда проверит корректность установки и покажет:
- Версию Claude Code
- Состояние
PATH - Наличие необходимых зависимостей (curl, openssl)
Если всё в порядке, следующей будет авторизация:
claude loginПроцесс выглядит так:
- Терминал выводит URL, например
https://claude.anthropic.com/auth?code=XYZ. - Откройте его в браузере, войдите в свой аккаунт Anthropic и скопируйте одноразовый код.
- Вернитесь в терминал и вставьте код, нажмите Enter.
После успешной авторизации вы увидите сообщение о том, что токен сохранён в ~/.config/claude/token. Теперь можно начинать работу.
Основные slash‑команды
Claude Code управляется через специальные команды, начинающиеся с символа /. Ниже перечислены самые часто используемые.
| Команда | Описание |
|---|---|
/init | Создаёт файл CLAUDE.md в корне текущего проекта. Этот файл хранит «память» агента о проекте (структура, зависимости, стилистика). |
/edit <file> | Открывает указанный файл в интерактивном режиме, позволяя задавать вопросы и получать исправления. |
/explain <code> | Поясняет, что делает переданный кусок кода. |
/refactor <file> | Предлагает улучшения и рефакторинг выбранного файла. |
/test <file> | Генерирует набор unit‑тестов для указанного файла. |
/git status | Анализирует текущие изменения в репозитории и предлагает коммиты. |
/doctor | Проверка окружения (аналог claude doctor). |
/reset | Сбрасывает контекст текущей сессии. |
Все команды можно увидеть, набрав claude /help.
Файл CLAUDE.md – память проекта
Файл CLAUDE.md играет роль «контекста» для Claude Code. Он хранит:
- Краткое описание проекта и его целей.
- Список основных технологий (React, Django, Go и т.д.).
- Требования к стилю кода (ESLint, Prettier, Pylint).
- Часто задаваемые вопросы и ответы, специфичные для проекта.
Пример содержимого:
# Project: AwesomeWebApp
Stack
- Frontend: React 18, TypeScript
- Backend: Node.js (Express), PostgreSQL
- CI: GitHub Actions
Coding style
- Use Prettier with 2‑space indent.
- All functions must have JSDoc comments.
Known quirks
- The API endpoint `/auth/login` returns a JWT in a cookie, not in the body.После создания CLAUDE.md агент будет учитывать эту информацию при генерации кода, рефакторинге и объяснении.
Полезные лайфхаки и типичные проблемы
claude не найдена, проверьте, что путь к бинарнику действительно добавлен в .zshrc (или .bash_profile для Bash). Выполните source ~/.zshrc или откройте новое окно терминала. Быстрый запуск в любой папке
# Добавьте алиас в ~/.zshrc
alias c='claude'Теперь вместо claude /edit myfile.py можно писать c /edit myfile.py.
Интеграция с Git
Claude умеет автоматически генерировать commit‑сообщения. После git add . выполните:
claude /git commitАгент предложит лаконичное сообщение, которое вы можете принять клавишей Enter.
Работа в tmux
Если вы используете tmux, включите опцию set -g escape-time 0 в .tmux.conf, чтобы комбинация Ctrl‑B + Esc (необходимая для некоторых slash‑команд) не конфликтовала.
Ошибки авторизации
- Убедитесь, что в системе нет старых токенов:
rm -rf ~/.config/claudeи выполнитеclaude loginзаново. - Если браузер не открывается автоматически, скопируйте URL вручную.
Ограничения токенов
Claude Code использует токены вашего аккаунта Anthropic. Чтобы не превысить лимит, следите за статистикой в claude usage и отключайте ненужные плагины.
Дополнительные ресурсы
- Официальная документация Claude Code
- GitHub‑репозиторий (исходный код и issue‑tracker)
- Установка через Homebrew и npm (THE.Hosting)
- Настройка терминала, Option‑as‑Meta и уведомления (PQ.Hosting)
- Гайд по slash‑командам и файлу CLAUDE.md (vc.ru)
Теперь вы полностью подготовлены к работе с Claude Code в macOS Terminal. Пробуйте, экспериментируйте и делитесь своими находками в сообществе!
Дата публикации: 04:13:03 ()