Claude Code выглядит как ещё один чат-бот в терминале ровно до первого реального проекта. Агент читает вашу кодовую базу, правит файлы, запускает команды, гоняет тесты и делает коммиты. По сути, младший разработчик, который никогда не устаёт и не обижается на правки. Настроить его можно за полчаса, если знать порядок действий. Без этого порядка вечер улетает на разбор ошибок, половина из которых придумана лично вами. Рассказываю отработанный путь.
Что проверить до установки
Подписка. Claude Code требует аккаунт Pro, Max, Team, Enterprise или Console с балансом. Бесплатный план claude.ai доступа не даёт: пакет установится, но на авторизации всё остановится. На Reddit под гайдами разработчики отмечают: фраза «у меня не запускается» в девяти случаях из десяти означает именно бесплатный тариф.
Окружение. Для установки через npm нужен Node.js версии 18 или свежее. На Windows дополнительно ставьте Git for Windows: нативная версия Claude Code использует Git Bash как shell-окружение, без него агент падает на первой же команде. Пять минут проверки экономят часы диагностики, проверено на себе.
Установка через npm: стандартный путь
Одна команда:
npm install -g @anthropic-ai/claude-codeПосле завершения установки откройте терминал в папке проекта и наберите claude. Запустится интерактивная сессия с доступом ко всей кодовой базе текущей директории. Дальше пишете задачу обычным текстом, агент сам решит, какие файлы открыть.
Загвоздка с правами. Если Node.js установлен из системного репозитория, глобальная установка может отдать ошибку EACCES. Два решения: настроить npm-префикс на пользовательскую директорию либо использовать нативные пакеты, о них ниже. Ставить через sudo npm не советую: после такого npm начинает ломаться в самых неожиданных местах.
Нативные пакеты для Linux
Debian, Fedora, RHEL и Alpine поддерживаются через системные пакетные менеджеры: apt, dnf или apk. На Fedora и RHEL сначала добавляете репозиторий Anthropic в файл /etc/yum.repos.d/claude-code.repo, затем выполняете:
sudo dnf install claude-codeРепозиторий существует в двух каналах: стабильном и latest. По умолчанию ставится стабильный. Нужны свежие функции сразу - меняете baseurl на репозиторий latest и обновляетесь. Я держу latest на ноутбуке и стабильный на рабочей машине: новые фичи достаются сразу, прод не страдает от сюрпризов.
Windows: два рабочих сценария
Классика: WSL. Ставите Ubuntu из Microsoft Store, внутри неё Node и npm, дальше весь процесс как на Linux. Стабильный вариант, на котором сидело большинство разработчиков до появления нативной поддержки.
Нативная версия работает прямо в PowerShell. Обязательное условие: установленный Git for Windows, потому что агенту нужен Git Bash. Проверка занимает секунду: наберите bash --version в PowerShell. Увидели версию, значит всё готово. Не увидели, сначала ставьте Git.
Первый запуск и вход
Набираете claude в терминале проекта. Агент предложит авторизоваться через браузер: переходите по ссылке, подтверждаете вход, возвращаетесь в консоль. На этом базовая настройка закончена.
На сервере или в CI браузера нет. Здесь выручает переменная окружения ANTHROPIC_API_KEY: когда Claude Code спросит, использовать ли найденный ключ, одобрите, и авторизация пройдёт без браузера. Тот же механизм работает с Amazon Bedrock, Google Cloud Agent Platform и Microsoft Foundry. Если компания уже платит одному из этих провайдеров, Claude Code подключается к нему напрямую без отдельной подписки Anthropic.
Частая ошибка новичков: запуск не в папке проекта. Агент строит контекст из текущей директории. Запустили в домашнем каталоге, получите вопросы «а что вообще делать» и расплывчатые ответы. Заходите в репозиторий, потом запускайте.
Если установка пошла не так
У Anthropic есть отдельный раздел документации по устранению неполадок при установке и входе, начните с него, прежде чем гуглить. Три случая из практики покрывают большинство сбоев. Ошибка EACCES при npm-установке означает права, лечится пользовательским префиксом. Зависание на этапе входа чаще всего связано с региональными ограничениями: Anthropic не работает с российскими IP, и обходы живут нестабильно. Агент не видит shell на Windows, значит отсутствует Git for Windows.
Со вторым случаем честнее поступить радикально и не тратить вечер на VPN-акробатику. Ниже расскажу схему, которой пользуюсь сам.
CLAUDE.md: главная настройка, о которой все забывают
Установка и вход составляют десять процентов настройки. Остальные девяносто приходятся на файл CLAUDE.md. Инструкция на уровне проекта: в начале каждой сессии Claude читает его первым делом и загружает содержимое в системный промпт. Всё, что вы там запишете, агент соблюдает до конца диалога: стек, стиль кода, команды, запреты.
Писать файл с нуля не нужно. Введите /init, и Claude Code сгенерирует стартовый CLAUDE.md на основе структуры проекта: соберёт стек, команды сборки и договорённости, которые смог найти в репозитории. Дальше файл уточняется руками по мере того, как вы замечаете, что агент делает не то, чего хотелось бы.
Что стоит прописать в первый день:
- стек и версии: язык, фреймворк, менеджер пакетов;
- команды сборки, тестов и линтера, чтобы агент проверял себя сам;
- соглашения по стилю: именование, структура папок, формат коммитов;
- запреты: какие файлы и директории никогда не трогать.
Второй уровень конфигурации лежит в ~/.claude/CLAUDE.md и действует во всех ваших проектах сразу: язык ответов, любимые паттерны, привычки вроде «сначала покажи план, потом пиши код». Бонус для больших репозиториев: CLAUDE.md можно класть в подпапки, и агент подхватывает их при работе с файлами этой части проекта.
Ловушка, на которую наступает почти каждая команда. Разработчик записал ключевые правила в персональный файл, у него всё работает идеально. Приходит новый человек, клонирует репозиторий, персональных настроек у него нет, и результаты начинают расходиться. Команда винит модель. Проблема в конфигурации: общие правила проекта должны жить в CLAUDE.md внутри репозитория, а личные предпочтения в домашней папке. Перепутаете места, получите загадочную «нестабильность качества ответов».
Права доступа: не отключайте подтверждения на старте
Claude Code спрашивает разрешение перед каждой записью файла и выполнением команды. Первую неделю не отключайте эти подтверждения, даже если хочется скорости. Через неделю станет ясно, какие действия безопасны, и их можно добавить в разрешённые. Автоподтверждение всего подряд с первого дня обойдётся дороже сэкономленных минут: один rm не в той папке стоит целого рабочего дня.
Что агент умеет сразу после настройки
Из коробки: чтение и запись файлов, выполнение команд, поиск в интернете, запуск тестов, коммиты. На практике это выглядит так. Просите добавить валидацию в форму. Агент находит нужный компонент, правит код, запускает тесты, показывает diff и ждёт подтверждения коммита. Ваша роль смещается с набора символов на проверку решений, и это куда более приятная работа.
Отдельно про тесты. Агент запускает их сам и читает вывод. Пропишите в CLAUDE.md команду тестового прогона, и цикл «изменил, прогнал, исправил» происходит без вашего участия. Такое самостоятельное замыкание цикла экономит мне больше времени, чем само написание кода.
Про поиск. Агент самостоятельно grep-ает репозиторий, поэтому просить «посмотри файл такой-то» руками обычно не нужно. Достаточно описать задачу: «логика расчёта скидки дублируется, найди и вынеси в один модуль». Он найдёт оба места сам. И, скорее всего, третье, о котором вы забыли.
Расширяемость: то, ради чего стоит разбираться
Настоящее преимущество Claude Code не в написании кода как таковом. Оно в слое расширяемости, который превращает инструмент из продвинутого автокомплита в настраиваемую платформу разработки. Кастомные слэш-команды для повторяющихся задач, хуки на события, подключение внешних сервисов через MCP. Всё это настраивается после базовой установки и умножает пользу от того же самого CLAUDE.md.
Мой пример: команда /review-checklist, которая прогоняет изменения по внутреннему чек-листу перед каждым пулл-реквестом. Писал её один вечер. Экономит около часа на каждый релиз. Именно такие мелочи отличают настроенный инструмент от просто установленного.
Рабочие привычки, которые окупаются
Сначала план, потом код. Для крупных правок просите агента изложить план изменений и дождитесь вашего одобрения, и только потом разрешайте писать. В Claude Code для этого есть режим планирования, переключается через Shift+Tab. Сэкономленные часы на переписывание неудачного рефакторинга окупают привычку за первый же день.
Гигиена git. Работайте на отдельной ветке и просите агента коммитить часто и мелкими шагами. Откатить один коммит проще, чем разбирать мега-диф из сорока файлов. Заодно каждый коммит становится точкой возврата, если агент увлёкся не туда.
Обновления Claude Code подтягивает сам по умолчанию. В корпоративной среде, где автообновления запрещены политиками, поведение меняется в настройках. Раз в месяц проверяйте версию: терминальные инструменты развиваются быстро, и часть «странного поведения» лечится простым апдейтом.
Три ошибки, которые вижу чаще всего
Первая: перегруженный CLAUDE.md. Файл на 500 строк Claude держит в контексте всю сессию, и важные правила тонут в описаниях очевидного. Держите файл коротким и пишите туда то, что модель не может вывести из кода сама. «Используем pnpm, а не npm» работает. «Пиши чистый код» не работает, это шум.
Вторая: правила в личной папке вместо репозитория. Разобрал выше, повторю коротко. Команда должна видеть одни и те же правила. Общее в проект, личное в домашнюю директорию.
Третья: ожидание, что настройка одноразовая. CLAUDE.md должен жить и меняться. Агент ошибся в соглашениях - добавили строку. Прислали новый стандарт кодирования - добавили строку. За месяц файл превращается в точную карту проекта, и качество ответов растёт ощутимо. Статичный файл, написанный в первый день и забытый, работает вполсилы.
Сколько стоит и как платить из России
Подписка Pro стоит $20 в месяц, Max стартует от $100. Для регулярной работы выбор фактически один: на Pro лимиты заканчиваются раньше рабочего дня, особенно если агент гоняет тесты. Console работает по модели pre-paid API: платите за токены, сколько намолотили, столько и списали. Для редких задач выгоднее подписки, для ежедневной почти всегда дороже.
Здесь главная проблема для нас: оплата требует зарубежной карты, прямой доступ из России закрыт, а перепродажа аккаунтов у посредников живёт от месяца до трёх. Рабочая схема, которой пользуюсь сам и советую знакомым разработчикам: 3GPT от 3SELLER. ИИ-роутер с прямым доступом к флагманским моделям из России: Chat GPT 6 Astra, Claude Fable 5, Claude Fable 5.1, Claude Opus 5.5, Chat GPT 5.5, Chat GPT 6.1 Sol, Nano Banana для генерации изображений плюс генерация видео. Старт от 149₽, пополнение российской картой, через СБП или криптой. Ни иностранных карт, ни танцев с VPN.
Для сценариев, где Claude Code в терминале недоступен, модели Claude Fable через 3GPT закрывают большую часть задач: рефакторинг, код-ревью, генерация продающих текстов, прототипы сайтов. Плюс обработка максимально реалистичных изображений, видеоролики и генерация голоса, когда работа выходит за пределы кода.
Готовые ИИ-агенты под конкретные задачи
Отдельная фишка платформы: готовые ИИ-агенты. Выбираете агента под свою задачу и сразу начинаете работать, без сборки промптов с нуля. Модель агента меняется прямо в чате. Сегодня гоняете задачу на Claude Fable, завтра переключились на GPT 6 и сравнили результат на своей реальной задаче, а не на абстрактных бенчмарках.
Порядок первых шагов
Последовательность, которая отрабатывает без сюрпризов. Проверьте подписку или ключ API. Поставьте Claude Code через npm или нативный пакет под вашу систему. Запустите claude в папке проекта и пройдите авторизацию. Введите /init и получите стартовый CLAUDE.md. Допишите пять-семь правил под ваш стек. Через неделю начните добавлять безопасные операции в разрешённые.
На настройку уйдёт полчаса. Зато каждый следующий день Claude Code работает как настроенный инструмент, а не как лотерея. Первый же день сэкономит вам больше времени, чем потрачено на эту статью. Если же нужен доступ к моделям Claude и другим флагманам из России без зарубежных карт, 3GPT решает вопрос за пару минут и от 149₽.