Как подключить Claude Code к существующему проекту

Запуск Claude Code в проекте, который писали не вы, отличается от старта с чистого листа. Агент не знает договорённостей команды, структуры модулей и того, какие директории лучше не трогать. Ниже — порядок действий для первого запуска в существующей кодовой базе.

Что агент читает при старте

При запуске в корне репозитория Claude Code ориентируется по содержимому каталога: структуре папок, файлам конфигурации, зависимостям. Он не загружает весь проект в контекст сразу — файлы подтягиваются по мере необходимости, когда относятся к текущей задаче.

Это значит, что формулировка первого запроса важна. Просьба «разберись в проекте» заставит агента блуждать по дереву. Точный запрос — «найди, где обрабатывается авторизация, и опиши поток» — сужает область и экономит токены.

Перед первым запуском стоит проверить, что в репозитории есть актуальный .gitignore. Агент уважает его границы и не будет читать то, что исключено.

Как ограничить область работы

В большом монорепозитории агенту незачем видеть всё. Есть несколько способов сузить область.

• Запускать Claude Code из подкаталога, а не из корня — тогда рабочей областью станет он.
• Явно называть пути в запросе: «работай только в packages/api».
• Просить сначала план, потом изменения. План можно прочитать и отклонить до того, как агент тронет файлы.

Для первых сессий разумно держать агента в режиме, где он спрашивает подтверждение перед записью. Так проще заметить, если он собрался редактировать не тот модуль.

Файл с инструкциями проекта

Отдельный файл с инструкциями — способ передать агенту то, что обычно живёт в головах команды: соглашения об именовании, запрет на правку сгенерированного кода, команду для запуска тестов, стиль коммитов.

Агент читает такой файл в начале работы и держит его указания в контексте. Это надёжнее, чем повторять требования в каждом запросе. Один короткий файл в корне снимает большую часть повторяющихся уточнений.

Содержимое стоит держать конкретным: не «пиши хороший код», а «после изменений запускай npm test, не трогай файлы в dist/».

Подключение через Zukko

Claude Code берёт адрес шлюза и ключ из переменных окружения. Именно ANTHROPIC_AUTH_TOKEN, не ANTHROPIC_API_KEY: с ANTHROPIC_API_KEY клиент потребует вход в аккаунт Anthropic.

export ANTHROPIC_BASE_URL=https://api.zukko.pro
export ANTHROPIC_AUTH_TOKEN=fetch_...

Базовый URL указывается без суффикса /v1 — клиент добавит путь сам.

Модель выбирается по задаче и бюджету. Ориентиры по ценам за миллион токенов (вход/выход):

Набор моделей меняется, актуальный список — GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете. Учтите, что у GLM контекст 128K и нет vision, у остальных — 1M.

Для сравнения: официальная цена Anthropic на Claude Opus 5.5 — $4 за вход и $20 за выход на миллион токенов. Оговорка: у вендоров чтение из кэша промптов стоит ~10% цены входа, а в Zukko кэшированные токены идут по обычной цене, поэтому для агента с большим контекстом реальная разница меньше, чем «в лоб».

Первый запуск в чужом проекте лучше начать с узкой задачи и режима с подтверждениями — так границы становятся видны до того, как что-то изменится. Подключить Claude Code через Zukko можно этими же переменными; вопросы по доступу — в поддержке https://t.me/zukkopro?direct↗