Как настроить Claude Code: установка, вход и первый конфиг
Ты слышишь «Claude Code» и представляешь чёрное окно для программистов, куда без диплома лучше не лезть. На деле это проще: Claude Code - это способ дать ИИ доступ к твоим файлам и заставить его делать работу руками. Сайты, боты, автоматизация, тексты, таблицы - по описанию словами. Терминал тут просто пульт. Разберём Claude Code как настроить с нуля: установка одной командой, вход под подпиской, первый конфиг через CLAUDE.md и settings.json, команды первого дня и главные ошибки новичка. И сразу закрою страх: если терминал пугает, у Claude Code есть Desktop-приложение и веб-версия - там всё то же самое, но мышкой. А в конце - зачем эта настройка нужна на самом деле, если ты зарабатываешь онлайн.
- Что такое Claude Code простыми словами и почему терминал - не преграда
- Как установить Claude Code на Mac и Windows одной командой
- Почему нужна платная подписка и как войти под ней, а не по API-ключу
- Затык №1 новичка: ошибка про отключённую организацию и как её лечить
- Первый конфиг: CLAUDE.md, settings.json и режимы разрешений
- Команды первого дня и частые ошибки при настройке Claude Code
Что такое Claude Code простыми словами
Claude Code - это ИИ-агент, которому ты даёшь доступ к своим файлам, и он делает работу руками: читает проект целиком, сам правит файлы, запускает команды - по задаче, описанной обычным языком. Официально это звучит как «agentic coding tool», но для нашей задачи важнее суть: не ты возишься с кодом, а он, а ты ставишь задачи словами.
Ключевой сдвиг в голове. Claude Code - это не «программа для программистов в чёрном окне». Чёрное окно (терминал) тут - просто пульт: место, куда ты вводишь команду и пишешь, что нужно сделать. Собрать лендинг с оффером, поднять простого бота-продавца, разложить выгрузку в таблицу, переписать сотню текстов по шаблону - всё это задачи, которые он выполняет в твоих файлах, пока ты смотришь.
И сразу снимаю главный барьер: терминала можно вообще не касаться. У Claude Code есть Desktop-приложение для macOS и Windows (графический интерфейс, визуальные правки, несколько сессий сразу) и веб-версия на claude.ai/code прямо в браузере, плюс приложения для iOS и Android. Все они подключены к одному движку: настройки, память и правила общие. То есть освоишь логику - и неважно, откуда работаешь.
Простая аналогия: раньше, чтобы сделать сайт, ты нанимал исполнителя и объяснял ему задачу. Claude Code - это исполнитель, который живёт у тебя в проекте, работает мгновенно и берёт задачу с одного сообщения. Терминал - просто окошко, через которое ты ему пишешь.
Под капотом у Claude Code несколько моделей Claude - от быстрой и дешёвой до самой мощной. Выбираешь под задачу: простое - на лёгкой, тяжёлое - на сильной. Вот как они называются в 2026 году.
| Псевдоним | Модель | Для чего |
|---|---|---|
haiku | Claude Haiku 4.5 | Быстро и дёшево: простые правки, мелкие задачи |
sonnet | Claude Sonnet 5 | Ежедневная работа, окно памяти на 1 млн токенов |
opus | Claude Opus 4.8 | Сложные рассуждения, крупные задачи |
fable | Claude Fable 5 | Самая мощная, для долгих автономных задач. Включается /model fable |
Не обязательно держать всё в голове с первого дня. По умолчанию Claude Code сам подбирает разумную модель, а сменить её на лету можно командой /model. Запомни только правило: не гонять каждую мелочь на самой дорогой модели - об экономии ещё поговорим ниже.
Что нужно перед стартом: подписка, а не бесплатный тариф
TL;DR: чтобы войти в Claude Code, нужна платная подписка Claude (Pro, Max, Team, Enterprise) либо аккаунт Console с оплаченными кредитами. Бесплатный тариф Claude доступа к Claude Code не даёт. Это первое, обо что спотыкаются: ставят инструмент, а войти не могут, потому что аккаунт бесплатный.
Дословно из официальной документации: «The free Claude.ai plan does not include Claude Code access.» Перевод: на бесплатном тарифе Claude Code не работает. Так что порядок такой - сначала подписка, потом установка.
Хорошая новость: если ты уже платишь за Claude в вебе (Pro или Max), отдельно за Claude Code платить не нужно - вход идёт под той же подпиской, лимиты общие. Для нашей аудитории это самый простой путь: одна подписка закрывает и веб-чат, и Claude Code.
- macOS 13.0 и новее, Windows 10 (сборка 1809+) или новее, Linux Ubuntu 20.04+ / Debian 10+.
- От 4 ГБ оперативной памяти, обычный процессор - подойдёт почти любой ноутбук.
- Нужен интернет. И важный момент: доступ есть только из поддерживаемых стран - если у тебя всё упирается в ошибку про регион, вернись к разделу про частые ошибки ниже.
Установка Claude Code: нативный установщик
TL;DR: рекомендованный способ - нативный установщик, одна строка в терминале. Node.js для него не нужен, и он сам обновляется в фоне. Забудь про старые гайды, где первым делом ставят Node и гоняют npm install - в 2026 это уже не дефолт.
Открой терминал (на Mac - приложение «Терминал», на Windows - PowerShell) и вставь одну команду под свою систему. Кнопка справа в блоке скопирует её целиком.
- macOS или Linux. Вставь строку ниже и нажми Enter. Установщик всё скачает и настроит сам.
Установка на macOS / Linuxcurl -fsSL https://claude.ai/install.sh | bash
- Windows. Открой PowerShell и вставь эту строку.
Установка на Windows (PowerShell)irm https://claude.ai/install.ps1 | iex
- Проверь, что установилось. Набери команду ниже - рабочая установка напечатает номер версии вида
2.1.211 (Claude Code).Проверка версииclaude --version - Если что-то пошло не так - запусти диагностику. Команда
claude doctorпроверит установку, найдёт ошибки в настройках и подскажет, что чинить.Диагностика установкиclaude doctor
Права администратора для установки не нужны. На Windows Claude Code работает и нативно, но если тебе понадобятся Linux-инструменты, в документации рекомендуют WSL 2 - это «Linux внутри Windows». Для старта достаточно обычного PowerShell.
Если сама мысль про вставку команд некомфортна - скачай Desktop-приложение Claude Code для macOS или Windows и установи мышкой, как любую программу. Либо вообще открой веб-версию на claude.ai/code - там не нужно ничего ставить. Логика работы дальше одна и та же, и этот гайд подойдёт целиком.
Установка через npm и другие способы
TL;DR: npm - способ для тех, у кого уже стоит Node.js. Требует Node 22 или новее, и его нельзя ставить через sudo. Если ты не знаешь, что такое Node, - тебе сюда не нужно, ставь нативным установщиком из предыдущего раздела.
Для тех, у кого Node уже есть, команда такая.
Два жёстких правила, чтобы не поймать проблемы.
- Node.js версии 22 или выше. На старой Node увидишь предупреждение
EBADENGINE- установка пройдёт, но лучше обновить Node. Проверить версию:node -v. Если в другом гайде написано «Node 18+» - это устаревшая инфа, актуальный порог 22. - Никогда не через
sudo npm install -g. Это прямое предупреждение из документации: sudo ведёт к проблемам с правами и рискам безопасности. Если уже ставил через sudo и ловишь ошибки прав - удали и перейди на нативный установщик.
Есть и другие пути под конкретную систему: на macOS - Homebrew (brew install --cask claude-code), на Windows - WinGet (winget install Anthropic.ClaudeCode), на Linux - подписанные apt/dnf/apk репозитории. Все рабочие, но для большинства проще всего именно нативный установщик - он один и тот же на всех системах и сам держит себя в актуальном состоянии.
Claude Code: первый запуск и вход
TL;DR: перейди в папку проекта, набери claude - откроется сессия и предложит войти. Рекомендованный вход - через браузер под своей подпиской. Это и есть первый запуск Claude Code: дальше ты уже пишешь ему задачи.
Порядок простой. Сначала заходишь в папку, с которой хочешь работать, потом запускаешь агента.
Откроется интерактивная сессия. При первом старте Claude Code предложит войти. Есть два способа входа, и для нашей аудитории правильный - первый.
- Через браузер под подпиской (рекомендую). Запускаешь
claude, открывается окно браузера, входишь в свой аккаунт Claude - и всё. Учётные данные сохранятся локально, заново логиниться не придётся. Сменить аккаунт потом - команда/loginвнутри сессии. - Через API-ключ. Это для тех, кто работает через Claude Console по кредитам. Если в системе задана переменная
ANTHROPIC_API_KEY, Claude Code один раз спросит подтверждение ключа вместо браузера. Способ рабочий, но именно он - источник затыка №1, о котором ниже.
После входа набери первую задачу словами - например, «посмотри, что в этой папке, и опиши проект». Он прочитает файлы и ответит. Поздравляю, Claude Code настроен и работает. Дальше - доводим до ума конфиг, но сначала разберём ту самую ошибку, на которой застревает больше всего людей.
Затык №1: подписка против API-ключа
TL;DR: если при живой подписке видишь ошибку «This organization has been disabled» - у тебя в системе висит старый ANTHROPIC_API_KEY, и Claude Code берёт его вместо подписки. Лечится командой unset ANTHROPIC_API_KEY и проверкой через /status.
Картина такая: подписка Claude оплачена и активна, а Claude Code падает с ошибкой вида API Error: 400 ... "This organization has been disabled". Человек думает, что сломалась подписка, и идёт её переоформлять - зря.
Причина в путанице двух способов входа. Где-то раньше (в другом проекте, в туториале) ты прописал API-ключ в файл профиля - ~/.zshrc на Mac или ~/.bashrc на Linux. Переменная ANTHROPIC_API_KEY так и висит. Claude Code видит её и решает, что ты хочешь входить по ключу, - и упирается в пустой или отключённый API-аккаунт, игнорируя твою живую подписку.
Лечение занимает минуту. Сначала убери переменную из текущей сессии.
Затем открой файл профиля (~/.zshrc или ~/.bashrc) и удали строку, где прописан ANTHROPIC_API_KEY, - иначе она вернётся при следующем запуске терминала. После этого перезапусти claude и проверь, каким способом ты вошёл.
Команда /status покажет, идёт ли вход по подписке или по ключу. Если по подписке - всё, ошибка ушла. Запомни развилку раз и навсегда: подписка и API-ключ - это два разных кошелька, и смешивать их нельзя. Для нашей задачи почти всегда нужна именно подписка.
CLAUDE.md: память проекта и первый конфиг
TL;DR: CLAUDE.md - это файл-память проекта. Обычный текстовый файл, где ты словами описываешь правила, а Claude читает его в начале каждой сессии. Создаётся командой /init. Это первое, что стоит настроить после установки, - и это даёт больше всего пользы сразу.
Проблема без него такая: каждую новую сессию Claude Code начинает с чистого листа. Не знает, какой командой у тебя собирается проект, каким стилем писать, что в проекте трогать нельзя. Ты объясняешь это заново - и жжёшь на это токены и время. CLAUDE.md закрывает ровно это: ты один раз описываешь проект в файле, и он читает его сам при каждом старте.
Самый быстрый способ завести файл - команда внутри сессии.
По официальному описанию, /init «анализирует твой проект и создаёт файл с командами сборки, инструкциями по тестам и найденными соглашениями». То есть на выходе - готовый черновик, который останется поправить под себя. Дальше правишь его как обычный текстовый файл в любом редакторе.
Файлов памяти на самом деле несколько, и они наследуются от общего к частному. Понимать иерархию полезно: от неё зависит, где писать правило, чтобы оно действовало там, где надо.
| Уровень | Путь | Для чего |
|---|---|---|
| Проектный | ./CLAUDE.md | Правила проекта, едет в git - видит вся команда |
| Локальный | ./CLAUDE.local.md | Личные заметки по этому проекту (не в git) |
| Пользовательский | ~/.claude/CLAUDE.md | Твои привычки для всех проектов (например, «отвечай на русском») |
| Организация | системный путь | Корпоративные политики (в командах) |
Два правила хорошего CLAUDE.md, дословно из документации: держи файл короче 200 строк («longer files consume more context and reduce adherence» - длинные файлы съедают контекст и хуже соблюдаются) и пиши конкретно вместо общего. Не «форматируй код правильно», а «отступ 2 пробела»; не «тестируй изменения», а «запускай npm test перед коммитом». Расплывчатую формулировку модель поймёт как угодно, точную - однозначно.
Здесь я даю только базу для старта. Что именно писать в файл памяти, готовый шаблон под копирование и почему Claude иногда «игнорирует» правила - подробно разобрано в отдельном гайде «CLAUDE.md: как настроить файл памяти Claude Code». А как разложить сам проект под Claude Code - папки, контекст, что куда - в гайде «Как настроить проект в Claude Code».
settings.json и режимы разрешений
TL;DR: settings.json - технические настройки Claude Code (модель, что разрешено без спроса, переменные, автодействия). Правь их через команду /config, не редактируя JSON руками. Если CLAUDE.md - это «как со мной работать» словами, то settings.json - «что тебе можно» технически.
Как и память, настройки наследуются по уровням: пользовательские (~/.claude/settings.json, на все проекты), проектные (.claude/settings.json, в git на команду) и локальные (.claude/settings.local.json, только у тебя). Что там настраивают новичку - коротко:
- model - какая модель по умолчанию. Меняется и на лету через
/model. - permissions - что разрешено или запрещено без спроса. Например, разрешить запуск линтера, но запретить читать файл с ключами.
- env - переменные окружения для сессии.
- hooks - shell-команды на события: автоформат после каждой правки, линт перед коммитом. Это для продвинутых - на старте не трогай.
Проще всего открыть удобный интерфейс с вкладками командой /config и настроить всё там, не редактируя JSON руками. Гораздо важнее для новичка - режимы разрешений: они определяют, что Claude Code делает сам, а что спрашивает. Переключаются на лету клавишами Shift+Tab.
| Режим | Что делает без спроса | Кому |
|---|---|---|
default | Только читает, на правки спрашивает | Старт, чувствительная работа |
acceptEdits | Читает и правит файлы без вопросов | Когда сам просматриваешь изменения |
plan | Только читает, пишет план без правок | Разведка перед изменениями |
bypassPermissions | Всё без единого вопроса | Только в изолированной среде (контейнер, VM) |
Совет новичку однозначный: начинай в default или plan. В режиме plan Claude сначала покажет, что собирается сделать, - идеально, чтобы понять его логику и не бояться. А bypassPermissions не трогай: в документации прямое предупреждение - только для изолированных сред, где агент физически не может навредить твоей системе.
Команды первого дня
TL;DR: тебе хватит десятка команд. Часть пишется в терминале (запуск), часть - внутри сессии со слэшем (управление). Не заучивай всё - держи под рукой этот список и подглядывай.
Команды из терминала - для запуска:
claude- открыть интерактивную сессию.claude "задача"- сразу выполнить одну задачу.claude -p "вопрос"- разовый запрос и выход (удобно для скриптов).claude -c- продолжить прошлый разговор в этой папке.
Слэш-команды - внутри сессии, для управления:
/init- создать CLAUDE.md,/help- список команд./model- сменить модель,/login- войти или сменить аккаунт./config- настройки,/status- проверить способ входа./clear- начать разговор с чистого листа,/context- показать, чем занят контекст,/compact- сжать разговор и освободить память.
Здесь - минимум на первый день. Разбор всех команд Claude Code с примерами - в отдельном гайде «Команды Claude Code: полная шпаргалка». Добавь в закладки, чтобы не держать в голове.
Установить и настроить Claude Code - дело часа. Но настроенный инструмент сам по себе денег не приносит: это мощность станка, а не результат. Куда направить эту мощность, чтобы вечера в Claude превращались в продукт и продажи без лица, - разбираем по шагам в Клубе «Трафик-машина без лица». Об этом - в финале статьи.
MCP-серверы: коротко
TL;DR: MCP - способ подключить Claude Code к внешним сервисам (Google Drive, GitHub, базам данных, Figma), чтобы он сам читал и писал в них, а ты не копировал данные вручную. На старте это не обязательно - но знать, что такая возможность есть, полезно.
Идея простая: как только ловишь себя на том, что копируешь данные в чат из другого инструмента, - самое время подключить его как MCP-сервер. Базовая команда добавления выглядит так.
Управлять подключёнными серверами можно командой /mcp внутри сессии. Углубляться здесь не будем - это отдельная тема. Если захочешь настроить конкретные интеграции, смотри разбор в гайде «MCP-серверы для Claude Code: что это и как подключить».
Частые ошибки новичка
TL;DR: почти все проблемы при настройке Claude Code - из короткого списка: PATH, sudo, старая Node, конфликт входа, регион. Собрал их в таблицу, чтобы ты не гуглил по форумам, а сразу видел решение.
| Симптом | Причина | Что делать |
|---|---|---|
command not found: claude | Папка установки не в PATH | Добавь в ~/.zshrc: export PATH="$HOME/.local/bin:$PATH" |
| Ошибки прав после установки | Ставил через sudo npm | Удали и перейди на нативный установщик; не смешивай установки |
Предупреждение EBADENGINE | Старая версия Node.js | Обнови Node до 22+; проверь через node -v |
| «This organization has been disabled» | Висит старый ANTHROPIC_API_KEY | unset ANTHROPIC_API_KEY + удали строку из профиля |
| Вход в браузере не срабатывает | WSL, SSH или контейнер | Скопируй код входа и вставь в терминал вручную |
| Постоянно просит войти заново (Mac) | Заблокирован Keychain | claude doctor, затем разблокируй связку ключей |
| «App unavailable in region» / 403 | Доступ недоступен из твоей страны | Нужен доступ из поддерживаемой страны |
Последний пункт отдельно про нашу реальность. Claude Code доступен только из поддерживаемых стран, и для доступа из России это придётся учитывать - тема тонкая, разжёвывать в статье не буду, но имей в виду: если всё упирается в ошибку про регион, дело именно в этом, а не в твоих настройках.
И общий совет по экономии, раз уж настраиваешь с нуля: держи CLAUDE.md коротким (он грузится каждую сессию), чисти контекст между задачами через /clear или /compact и выбирай модель под задачу, а не гоняй всё на самой дорогой. Подробнее - в гайдах «Как экономить токены в Claude Code» и «Трекеры расхода токенов».
Зачем это всё на самом деле
А теперь честный разворот, ради которого стоит дочитать. Можно идеально установить Claude Code, вылизать CLAUDE.md, настроить каждый режим разрешений - и остаться ровно там же, где был. Потому что настроенный инструмент - это не цель. Это мощность станка. И сама по себе она не приносит ни копейки.
У большинства всё так и застывает: человек освоил Claude Code, собирает проекты быстро и красиво - и они лежат в папке. Вечера потрачены, навык реально крутой, а денег ноль. Это вайбкодинг в пустоту: ты собираешь, оно работает, тебе нравится - но это игрушка для себя, а не продукт для рынка.
«Умею настраивать Claude Code» и «зарабатываю на Claude Code» - две разные вселенные, и между ними пропасть. Установить, войти, настроить конфиг легко - это делают тысячи. Превратить навык в актив, который приносит деньги, - почти никто. Не потому что сложно, а потому что дальше «прикольно получилось» мысль не идёт.
Вся суть в одном: Claude Code - это инструмент, а не цель. И всё, что ты настроил выше, ценно ровно тем, что на этом станке ты за вечер собираешь не игрушку, а продаваемую вещь: лендинг с оффером, бота-продавца, мини-сервис. А самое сильное направление здесь - цифровой продукт без лица. Ты упаковываешь то, что научился собирать, в продукт, который продаётся много раз: без блога, без съёмок, без тебя в кадре. Собрал один раз - продаётся в фоне, пока делаешь следующий.
Я зарабатываю не на том, что у меня идеально настроен Claude Code. Я зарабатываю на продуктах, собранных в нём. Инструмент - это мощность станка. Без продукта станок крутится вхолостую, как его ни настрой.
Дальше у тебя два пути - и оба ведут к своему продукту. Разница в скорости и в том, сколько шишек набьёшь по дороге.
Разбираться по крупицам
- Месяцами собирать систему по гайдам
- Самому искать, что и как продавать
- Дойти реально, но дольше и через ошибки
Собрать систему в Клубе
- Настраиваем нейросети под твой продукт
- Собираем реалистичного ИИ-блогера и продукт без лица
- Заливаем охватами и доводим до продаж
Частые вопросы
Что такое Claude Code простыми словами?
Claude Code - это ИИ-агент, которому ты даёшь доступ к своим файлам и папкам, а он делает работу руками: пишет и правит код, запускает команды, собирает сайты, ботов, автоматизацию, тексты и таблицы. Ты описываешь задачу обычными словами, а он выполняет её в твоём проекте. Работает в терминале, в редакторе кода, в отдельном приложении на компьютере и в браузере. Терминал тут - просто пульт: чёрное окно, куда ты пишешь команды. Ставится одной строкой, входишь под своей подпиской Claude, дальше просто ставишь задачи текстом.
Нужна ли платная подписка для Claude Code?
Да. Бесплатный тариф Claude не даёт доступа к Claude Code. Нужна платная подписка (Pro, Max, Team или Enterprise) либо аккаунт Claude Console с оплаченными кредитами по API. Для нашей аудитории проще всего подписка: запускаешь claude, открывается браузер, входишь в свой аккаунт Claude - и всё работает. Если ты уже платишь за Claude в вебе, отдельно за Claude Code платить не нужно, вход идёт под той же подпиской.
Как установить Claude Code на Windows/Mac?
На macOS и Linux открой терминал и вставь одну строку: curl -fsSL https://claude.ai/install.sh | bash. На Windows открой PowerShell и вставь: irm https://claude.ai/install.ps1 | iex. Это рекомендованный нативный установщик - он не требует Node.js и сам обновляется в фоне. После установки проверь версию командой claude --version: рабочая установка печатает номер версии. Если пугает терминал, есть Desktop-приложение для macOS и Windows и веб-версия на claude.ai/code - они делают то же самое мышкой.
Почему Claude Code выдаёт ошибку про отключённую организацию?
Ошибка вида «This organization has been disabled» при живой подписке почти всегда означает конфликт способов входа. У тебя в системе висит переменная ANTHROPIC_API_KEY - старый API-ключ от прошлого проекта, прописанный в файле профиля (~/.zshrc или ~/.bashrc). Claude Code берёт этот ключ вместо твоей подписки и упирается в отключённый или пустой API-аккаунт. Лечится так: выполни unset ANTHROPIC_API_KEY, удали строку с ключом из файла профиля, а затем проверь активный способ входа командой /status внутри сессии.
Обязательно ли уметь программировать?
Нет. Claude Code задуман так, что задачи ставятся обычным языком: ты пишешь, что нужно, а код пишет и правит он. Программировать самому не обязательно - но полезно понимать общую логику: что такое папка проекта, файл, команда. Для не-программиста заходит режим plan (агент сначала показывает план, потом делает) и режим default, где он спрашивает разрешение перед изменениями. Начни на простой задаче: собрать лендинг, поправить текст на сайте, сделать простого бота. А если терминал пугает, начни с Desktop-приложения или веб-версии - там всё мышкой.
Чем настроить Claude Code: CLAUDE.md или settings.json?
Это два разных файла для разных задач, и нужны оба. CLAUDE.md - это память проекта: текстовый файл, где ты обычными словами описываешь правила и контекст (какие команды запускать, стиль, что не трогать, отвечать на русском). settings.json - технические настройки: какая модель по умолчанию, что разрешено без спроса, переменные окружения, автодействия-хуки. Проще всего: CLAUDE.md создаёшь командой /init и правишь как обычный текст, а settings.json настраиваешь через команду /config, не редактируя JSON руками. Начни с CLAUDE.md - он даёт больше всего пользы сразу.
Хочешь, чтобы настройка Claude превращалась в деньги?
В Клубе «Трафик-машина без лица» собираем систему целиком: реалистичного ИИ-блогера, контент-машину на нейросетях и продукт без лица - заливаем охватами и доводим до продаж. Claude Code тут - станок, на котором ты собираешь связки без лица. Доступ навсегда.
Вступить в клуб · 12 000 ₽Была статья полезной?
Собираю цифровые продукты без лица на нейросетях и довожу до продаж. В блоге и канале - разборы по Claude, нейросетям и вайбкодингу и то, как на этом строить деньги, без инфоцыганщины.