GETPROFF
Claude Code — это агент для программирования от Anthropic, который работает в терминале и умеет читать файлы вашего проекта, вносить в них правки и запускать команды. На Mac он ставится за несколько минут, но новички чаще всего спотыкаются не на самой установке, а на мелочах: не тот способ, не открыт новый Terminal, не тот каталог при первом запуске. Разберём весь путь от чистой системы до первой рабочей сессии в проекте и отдельно — что делать, если что-то пошло не так.
Что понадобится перед установкой Claude Code на Mac
Подготовка занимает пять минут, но сэкономит время на диагностике. Проверьте четыре вещи.
- Версия macOS 13.0 или новее. Это минимальное требование из официальной документации Claude Code. Узнать свою версию можно через меню Apple → «Об этом Mac». О поддержке более старых версий подтверждённых сведений нет, поэтому не рассчитывайте на них.
- Доступ к Terminal. Это стандартное приложение macOS: откройте Spotlight (Cmd + Пробел), введите Terminal и нажмите Enter. Командная строка здесь — основной интерфейс, поэтому все команды ниже вводятся именно в нём.
- Аккаунт с доступом к Claude Code. Для работы понадобится учётная запись Anthropic с подходящим доступом либо ключ API. Актуальные условия, регионы и способы оплаты проверяйте на официальных страницах Anthropic: здесь мы их не обещаем, потому что они меняются.
- Папка проекта. Claude Code работает в контексте каталога, из которого вы его запустили. Лучше сразу определить, с каким проектом будете работать — пусть даже это пустая учебная папка.
Отдельно про Homebrew: он нужен только если вы решите ставить Claude Code этим способом. Для нативной установки через официальный скрипт ничего дополнительно ставить не требуется. Если хотите сначала разобраться, что вообще умеет этот инструмент и для каких задач он подходит, загляните в материал «Что такое Claude Code и как его использовать».
И ещё одна честная оговорка до начала. Claude Code — инструмент для человека, который готов работать с терминалом и проектом на своём компьютере: он ускоряет разработку, но не размещает готовый продукт за вас. Если ваша цель не «писать код с агентом», а «получить работающий сайт с формой, базой заявок и публикацией», рассмотрите другой путь. В Chatium вы описываете задачу AI-агенту внутри рабочего пространства, а код, таблицы, формы и публикация находятся в одной среде — без установки чего-либо на Mac. Это не замена Claude Code в любой ситуации, а другой способ решить прикладную задачу; ниже, в конце статьи, мы сравним оба подхода подробнее.
Как установить Claude Code на macOS
Есть два способа, подтверждённых официальной документацией: нативная установка через скрипт (её и рекомендуют) и установка через Homebrew. Начнём с основного.
Официальный способ установки
Нативная установка — рекомендуемый вариант для macOS и Linux. Откройте Terminal и выполните одну команду:
Что здесь происходит простыми словами: curl скачивает установочный скрипт с сайта claude.ai, а символ | передаёт его оболочке bash, которая скрипт выполняет. Скрипт устанавливает Claude Code в вашу пользовательскую папку — по официальным командам удаления видно, что исполняемый файл лежит в ~/.local/bin/claude, а данные — в ~/.local/share/claude. Права администратора для этого не нужны, поэтому sudo добавлять не надо.
Если вы не привыкли запускать скрипты «по трубе» из интернета, это нормальная осторожность. Команда взята из официальной документации Anthropic; проверьте, что вы копируете её именно оттуда и не изменили адрес, а если хочется — сначала скачайте скрипт и прочитайте его перед запуском. Практика хорошая для любого установщика, не только этого.
Порядок действий:
- Откройте Terminal.
- Вставьте команду curl -fsSL https://claude.ai/install.sh | bash и нажмите Enter.
- Дождитесь завершения и прочитайте последние строки вывода: установщик сообщает, всё ли прошло успешно.
- Закройте окно Terminal и откройте новое — так оболочка перечитает настройки PATH.
Альтернатива — Homebrew. Если Homebrew у вас уже установлен и вы привыкли управлять программами через него, выполните:
Разница между способами важна дальше, поэтому запомните её сейчас: нативная установка обновляется автоматически в фоне, а версия из Homebrew сама не обновляется — вручную нужна команда brew upgrade claude-code. Смешивать два способа на одном компьютере не стоит: потом сложно понять, какая именно копия запускается по команде claude. Выберите один.
Про устаревшие варианты: в интернете вы можете встретить инструкции с установкой через npm. В подтверждённых нами источниках рекомендуемым названо именно нативное скриптом, поэтому мы опираемся на него. Если наткнулись на чужую инструкцию с другим способом, сверяйтесь с официальной страницей установки, а не копируйте вслепую.
Проверка установленной версии
В новом окне Terminal выполните:
Если всё в порядке, вы увидите номер версии. По документации, эта же команда помогает получить диагностику установки, когда что-то не так. Ответ вроде «command not found» означает, что оболочка не находит программу — переходите к разделу об ошибках ниже.
Авторизация и первый запуск в папке проекта
Когда версия отображается, можно запускать сам инструмент. Здесь два момента: где вы находитесь в файловой системе и как входите в аккаунт.
Сначала перейдите в папку проекта. Claude Code воспринимает текущий каталог как границу своей работы, поэтому запускайте его именно оттуда. Если проекта пока нет, создайте учебную папку:
Если проект уже есть, просто перейдите в него командой cd и путь к каталогу. Не запускайте агента из домашней папки целиком или из каталога «Документы»: ему там нечего делать, а вы рискуете дать доступ к лишнему.
Запустите Claude Code:
При первом запуске откроется браузер для входа. Авторизуйтесь в своей учётной записи Anthropic и подтвердите доступ — после этого терминал продолжит работу, и повторно входить каждый раз не придётся.
Есть и второй сценарий — вход через API-ключ. Если в окружении задана переменная ANTHROPIC_API_KEY, то, по документации, Claude Code обходится без браузера и просит только однократно подтвердить ключ. Для этого в текущей сессии Terminal можно выполнить export ANTHROPIC_API_KEY=ваш_ключ, а затем claude. Относитесь к ключу как к паролю: не вставляйте его в скриншоты, не публикуйте в чатах и не добавляйте в репозиторий. Какой способ входа подходит вашему типу аккаунта, смотрите в официальном разделе Authentication.
После входа вы окажетесь в интерактивной сессии. Хорошая первая задача — не «сделай мне приложение», а безопасное чтение: попросите объяснить структуру проекта, найти точку входа или описать, как запускаются тесты. Так вы проверите, что агент видит нужные файлы, и поймёте стиль его ответов, ничего не меняя. Для пустой учебной папки можно попросить создать небольшой скрипт и объяснить, что именно он сделал.
Качество результата здесь зависит от постановки задачи так же, как у любого AI-агента: какой файл менять, какого поведения ждёте, что трогать нельзя. Если формулировка расплывчатая, ответ будет усреднённым.
Теперь о том, что будет после первого удачного запуска. Локальный агент даёт вам код на вашем компьютере. Но продукт, которым пользуются другие люди, требует ещё хостинга, базы данных, обработки форм, отправки писем и приёма платежей — и это отдельные задачи вне терминала. Если проект именно такой — лендинг с заявками, кабинет, простая CRM — стоит заранее прикинуть, где всё это будет жить. В Чатиум сайт, таблицы с данными, формы, автоматизации и публикация собираются внутри одного рабочего пространства, поэтому между «код написан» и «страница открывается по ссылке» не нужно отдельно настраивать сервер и базу. Для сложной кастомной логики и полного контроля над кодом локальный агент по-прежнему уместнее; для типовых бизнес-продуктов готовая среда часто сокращает путь.
Базовые настройки и безопасная работа с разрешениями
Claude Code — это не чат, а агент с доступом к вашим файлам и терминалу. Он может читать код, изменять файлы и запускать команды. Отсюда простая логика безопасности: чем меньше доступ и чем внимательнее вы читаете, что именно предлагает агент, тем меньше сюрпризов. Ниже — практические правила, а не перечень настроек: полный список параметров и режимов разрешений лучше смотреть в актуальной официальной документации, потому что они обновляются.
- Запускайте только в папке нужного проекта. Это самый действенный способ ограничить область работы агента.
- Используйте Git. Перед крупной задачей зафиксируйте текущее состояние коммитом или создайте отдельную ветку. Если результат не понравится, вы вернётесь к исходному коду одной командой.
- Читайте запросы на разрешения, а не нажимайте подтверждение автоматически. Особенно внимательно относитесь к командам, которые удаляют файлы, ставят зависимости или обращаются к сети.
- Не держите секреты в открытом виде в проекте. Пароли, токены и ключи API лучше хранить вне репозитория и не давать агенту читать файлы с ними без необходимости.
- Проверяйте результат сами. Запустите тесты, откройте изменённые файлы, просмотрите diff. Агент ускоряет работу, но ответственность за то, что уйдёт в продакшен, остаётся на вас.
- Не смешивайте несколько задач в одном запросе. Небольшие последовательные шаги проще проверять и откатывать.
Отдельно для тех, кто не разработчик: если вы предприниматель или специалист и просто хотите получить рабочий инструмент, не стоит давать агенту доступ к каталогам, в которых лежат личные документы, сканы и рабочие таблицы. Заведите отдельную папку под проект, и пусть агент живёт в ней.
Частые ошибки на Mac и способы исправления
Команда claude не найдена (command not found)
Самая частая проблема после установки. По официальному разделу устранения неполадок, причина обычно в том, что каталог установки не добавлен в PATH — переменную, по которой оболочка ищет программы. Порядок действий:
- Закройте окно Terminal и откройте новое. Установщик мог обновить настройки оболочки, а старое окно их не подхватило.
- Повторите claude --version.
- Если не помогло, проверьте, существует ли файл: ls ~/.local/bin/claude. Если файл на месте, проблема именно в PATH.
- Посмотрите текущее значение переменной командой echo $PATH и убедитесь, что в списке есть каталог ~/.local/bin (в записи пути он будет с вашим именем пользователя).
- Если каталога нет, добавьте его вручную. В современных версиях macOS по умолчанию используется оболочка zsh, поэтому добавляйте строку в файл ~/.zshrc: export PATH="$HOME/.local/bin:$PATH". Затем откройте новое окно Terminal.
- Если ставили через Homebrew, проверьте, что сам Homebrew корректно подключён в оболочке, — иначе команды из него тоже не будут находиться.
Если ни один шаг не помог, сверьтесь с разделом troubleshoot-install в документации Claude Code: там описаны и другие случаи.
Установка прервалась или скрипт не скачался
Проверьте подключение к интернету и повторите команду. Если curl возвращает ошибку сети или сертификата, проблема чаще всего в локальной сети, прокси или корпоративных ограничениях, а не в самом Claude Code. Не будем гадать о конкретных причинах для вашего региона и провайдера: подтверждённых данных о необходимости VPN или особенностях доступа у нас нет, поэтому ориентируйтесь на сообщения ошибки и официальную документацию.
Запускается не та версия или две копии
Бывает, если вы ставили и скриптом, и через Homebrew. Определить, какая копия запускается, помогает команда which claude. Оставьте один способ установки, а лишнюю копию удалите (команды удаления — в следующем разделе), после чего откройте новый Terminal.
Браузер не открылся или вход не завершился
Проверьте, что вы вошли в правильный аккаунт Anthropic и что у него есть доступ к Claude Code. Если вы пользуетесь ключом API, убедитесь, что переменная ANTHROPIC_API_KEY задана в текущей сессии Terminal: после закрытия окна значение, заданное через export, не сохраняется. Ошибка при входе может означать также, что у аккаунта нет нужного доступа — это вопрос к вашему плану, а не к установке.
Агент «не видит» файлы проекта
Проверьте, из какой папки вы запустили claude. Выйдите из сессии, перейдите командой cd в корень проекта и запустите снова. Команда pwd покажет текущий каталог.
Как обновить или удалить Claude Code
Порядок зависит от того, каким способом вы устанавливали.
Обновление
- Нативная установка. Обновляется автоматически в фоне. Обычно ничего делать не нужно; версию можно сверить командой claude --version.
- Homebrew. Автообновления нет, обновляйте вручную: brew upgrade claude-code.
Удаление
Для нативной установки по официальной документации удаляются два объекта — исполняемый файл и данные:
Будьте внимательны: команда rm -rf удаляет каталог без возможности восстановления из корзины, поэтому проверьте путь перед нажатием Enter. Если установка была через Homebrew:
После удаления откройте новый Terminal и выполните claude --version: должна появиться ошибка «command not found». Ваши проекты и файлы в них при этом не затрагиваются — удаляется только сам инструмент. Настройки, которые Claude Code мог сохранить в других местах, документация в разделе удаления описывает отдельно; если хотите полностью очистить следы, сверьтесь с ней.
Когда удобнее использовать Chatium как готовую среду для продукта
Установка позади, Claude Code запускается — теперь главный вопрос: подходит ли он для вашей задачи целиком. Здесь стоит разделить два разных сценария.
Claude Code — персональный агент-разработчик. Он хорош, когда у вас есть репозиторий, вы понимаете, что хотите изменить, и готовы контролировать результат: читать код, запускать тесты, разбираться с окружением. Вы сами отвечаете за то, где код будет работать, как хранятся данные, как настроены домен, почта и оплата. Это гибкий путь для разработчика и для специалиста, которому нужен полный контроль над кодом.
Готовая среда для продукта. Если задача звучит как «нужен сайт с формой заявок, таблицей клиентов, оплатой и уведомлением в Telegram», код — лишь часть работы. В Chatium вы формулируете задачу AI-агенту «Ботан» внутри рабочего пространства, и он создаёт страницы, таблицы, формы и серверную часть, а результат публикуется по ссылке. Поддерживаются в том числе сценарии с CRM, платежами и личным кабинетом — подробные разборы есть в базе знаний GETPROFF, а общую логику сравнения инструментов — в материале про инфраструктуру Chatium для бизнеса рядом с Claude Code и Codex.
Сравнивайте по критериям, которые важны именно вам:
- Характер задач. Claude Code — работа с существующей кодовой базой, рефакторинг, исправление ошибок, новые функции. Chatium — сборка готового цифрового продукта: сайта, кабинета, CRM, ИИ-консультанта, автоворонки.
- Инфраструктура и хостинг. С Claude Code сервер, среду запуска и публикацию вы организуете сами. В Chatium публикация проекта происходит внутри платформы.
- База данных и формы. С локальным агентом базу, обработку форм и почту придётся подключать отдельно. В Chatium таблицы, формы и автоматизации находятся в том же рабочем пространстве.
- Автоматизации и интеграции. В обоих случаях можно строить автоматизации, но в Claude Code вы сами решаете, чем и как их запускать; в Chatium часть сценариев — платежи, CRM, уведомления в Telegram — уже встроена в среду.
- Порог входа. Для Claude Code нужны Terminal и базовое понимание проекта. Для Chatium достаточно уметь ставить задачу обычным языком и проверять результат, хотя ответы на уточняющие вопросы агента и итерации правок — часть процесса.
- Доступность и оплата. Условия доступа, тарифы и способы оплаты у обоих сервисов могут меняться, поэтому проверяйте их на официальных страницах Anthropic и Chatium перед стартом. Мы намеренно не даём здесь цен и обещаний по регионам.
Честный вывод такой. Если вы разработчик или ведёте технический проект, Claude Code даёт полный контроль и хорошо ложится в привычный рабочий процесс. Если вы предприниматель, маркетолог, эксперт или интегратор и вам нужен работающий продукт для клиентов, а не отдельный кодовый репозиторий, логичнее начинать с готовой среды: зарегистрироваться в Чатиум, создать рабочее пространство и собрать первую версию через диалог с агентом. Эти подходы не исключают друг друга: многие используют локальный агент для кода и облачную среду для запуска продукта. Ценность определяется не выбранным инструментом, а тем, решена ли задача бизнеса.
Автор материалаАндрей Власенко