Раньше мой сценарий с нейросетями для кода выглядел так: скопировать кусок файла, вставить в чат, получить патч, вручную перенести, запустить тесты, вернуться с ошибкой. На маленьких задачах терпимо. На реальном проекте — тормозит процесс.
Вокруг модели много запросов: claude ai, claude нейросеть, кто-то ищет claude подписка или сразу хочет claude купить доступ. Через BotHub всё это решается одним ключом.
Claude Code решает это иначе: ассистент живёт прямо в терминале, видит структуру репозитория, читает файлы, предлагает план, вносит изменения, запускает команды и помогает с git. То есть это уже не «чат про код», а агентный CLI для разработки.
В этом гайде разберём, как установить Claude Code, подключить доступ к Claude через BotHub, дать агенту контекст проекта и какие команды реально использовать в работе.
Что такое Claude Code
Claude Code — это CLI-ассистент Anthropic для программирования. Он работает из терминала и может:
-
анализировать кодовую базу;
-
искать нужные файлы и зависимости;
-
править код;
-
писать тесты;
-
запускать команды;
-
объяснять архитектуру проекта;
-
готовить коммиты, PR-описания и ревью.
Главное отличие от обычного чата: Claude Code не ждёт, пока вы принесёте ему каждый файл вручную. Он сам исследует проект и действует как младший разработчик, которому можно поручить задачу — но которого всё равно надо ревьюить.
Установка Claude Code
На macOS и Linux самый простой вариант:
curl -fsSL https://claude.ai/install.sh | bash
Через Homebrew:
brew install —cask claude-code
На Windows:
irm https://claude.ai/install.ps1 | iex
После установки проверьте, что CLI доступен:
claude doctor
Переходим в проект:
cd my-projectclaude
Если всё хорошо, откроется интерактивная сессия Claude Code.
Подключение Claude через BotHub
Обычно Claude Code используют с аккаунтом Anthropic. Но если хочется работать с Claude и другими моделями из одного места, удобнее завести API-ключ в BotHub.
Маршрут такой:
-
Зарегистрируйтесь в BotHub.
-
Откройте профиль → «Для разработчиков».
-
Создайте API-ключ.
-
Возьмите Base URL для Anthropic-compatible подключения из кабинета.
-
Передайте параметры Claude Code через переменные окружения.
Пример для macOS/Linux:
export ANTHROPIC_BASE_URL="BOT_HUB_ANTHROPIC_BASE_URL"export ANTHROPIC_AUTH_TOKEN="BOT_HUB_API_KEY"export ANTHROPIC_MODEL="claude-sonnet"export ANTHROPIC_SMALL_FAST_MODEL="claude-sonnet"
Для PowerShell:
$env:ANTHROPIC_BASE_URL="BOT_HUB_ANTHROPIC_BASE_URL"$env:ANTHROPIC_AUTH_TOKEN="BOT_HUB_API_KEY"$env:ANTHROPIC_MODEL="claude-sonnet"
Чтобы не вводить это каждый раз, добавьте настройки в ~/.claude/settings.json:
{ "env": { "ANTHROPIC_BASE_URL": "BOT_HUB_ANTHROPIC_BASE_URL", "ANTHROPIC_AUTH_TOKEN": "BOT_HUB_API_KEY", "ANTHROPIC_MODEL": "claude-sonnet", "ANTHROPIC_SMALL_FAST_MODEL": "claude-sonnet" }}
Название модели лучше копировать из кабинета BotHub: там же можно переключаться между Claude Sonnet для повседневного кодинга и Claude Opus для сложной архитектуры, рефакторинга и анализа больших проектов.
Первый запуск в кодовой базе
В новом проекте я начинаю не с просьбы «напиши фичу», а с онбординга:
Изучи проект. Составь краткую карту: стек, ключевые директории,
точки входа, команды запуска, тесты и потенциально рискованные зоны.
Пока ничего не меняй.
Дальше полезно выполнить:
/init
Команда создаёт CLAUDE.md — файл с инструкциями для агента. Туда стоит добавить правила проекта: стиль кода, команды тестов, запреты, архитектурные договорённости.
Например:
# Project instructions
— Перед изменениями показывай план.
— Не меняй публичные API без согласования.
— После правок запускай npm test.
— Для новых фич добавляй тесты.
— Не трогай.env и секреты.
Теперь Claude Code будет учитывать эти правила в следующих сессиях.
Команды, которые пригодятся каждый день
Проверить состояние подключения и модель:
/status
Сжать длинный диалог, чтобы не потерять контекст:
/compact сохрани принятые решения, изменённые файлы и оставшиеся TODO
Быстрый одноразовый запрос без интерактивной сессии:
claude -p «Найди в проекте места, где используется устаревший метод loginUser»
Попросить план перед правками:
Нужно добавить rate limit для POST /api/orders.
Сначала найди текущий middleware, предложи план и дождись подтверждения.
Починить тест:
Тест падает в OrderService. Найди причину, объясни её,
предложи минимальный фикс и после подтверждения внеси изменения.
Сделать ревью перед коммитом:
Посмотри diff текущей ветки относительно main.
Найди баги, рискованные изменения, проблемы с типами и тестами.
Не переписывай код, сначала дай список замечаний.
Какие агентные задачи можно отдавать Claude Code
Лучше всего Claude Code справляется не с «сделай мне весь проект», а с ограниченными задачами, где есть проверяемый результат.
1. Разбор легаси-кода
Объясни, как работает модуль billing. Отдельно опиши,
где создаётся invoice, где списываются деньги и где обрабатываются ошибки.
2. Рефакторинг
Разбей большой файл userController.ts на сервисы.
Сохрани публичное поведение и добавь тесты на существующие сценарии.
3. Написание тестов
Добавь unit-тесты для функции calculateDiscount.
Покрой граничные случаи, пустой ввод и некорректные данные.
4. Поиск бага
После миграции пользователи без avatar получают 500.
Найди причину, предложи фикс и проверь тестами.
5. Документация
Обнови README: добавь установку, переменные окружения,
локальный запуск и команды тестирования.
Как не сломать проект агентом
Claude Code сильный, но это не повод отключать голову. Мой минимальный набор правил:
-
Всегда просить план перед изменениями.
-
Работать в отдельной ветке.
-
Не давать доступ к production-секретам.
-
Проверять git diff.
-
Запускать тесты после правок.
-
Для больших задач просить делать изменения маленькими шагами.
Хороший промпт звучит так:
Действуй итеративно. Сначала план, потом один небольшой шаг,
затем покажи diff и дождись подтверждения.
Claude Code — один из самых удобных способов использовать Claude для программирования: он понимает репозиторий, работает в терминале и умеет выполнять агентные задачи от анализа до тестов и git-рутины.
Если нужен ежедневный AI-ассистент для кода, берите Claude Sonnet. Если задача сложная — архитектура, большой рефакторинг, глубокий поиск бага — переключайтесь на Claude Opus.
А чтобы не заводить отдельные подписки и ключи под каждый сценарий, можно подключить Claude для агентного кодинга через BotHub: создать API-ключ, прописать его в Claude Code и работать с моделями Anthropic из одного окна.
ссылка на оригинал статьи https://habr.com/ru/articles/1067684/