Как проверить API-ключи после вайбкодинга с Claude Code?

Как проверить API-ключи после вайбкодинга с Claude Code?

Начните с проверки файлов проекта, истории Git и кода, который сайт отправляет в браузер. Claude Code поможет найти подозрительные места, но его отчёт нужно сверить с настройками сервисов и опубликованной версией сайта. Если секретный API-ключ уже попал в открытый доступ, удаление строки не решит проблему: ключ нужно отозвать. Ниже разберём, что поручить ИИ, как проверить находки и какие подтверждения запросить у разработчика перед запуском сайта.

Где искать API-ключи и как отличить секрет от публичного ключа?

API-ключ даёт программе доступ к внешнему сервису. Например, сайт использует его, чтобы отправить запрос к нейросети или запустить рассылку. Если ключ разрешает платные операции, посторонний человек с этим ключом получает возможность расходовать ваш баланс в пределах доступных прав.

При этом название API_KEY само по себе ещё не означает утечку. Существуют публичные идентификаторы и ключи, которые сервис разрешает использовать в браузере. Проверьте назначение ключа в документации сервиса: какие действия он разрешает, где его допустимо размещать и какие ограничения доступны в настройках.

Начните с мест, куда секрет мог попасть при разработке:

  • Файлы настроек, включая .env и его локальные копии. Наличие секрета в таком файле допустимо только при правильных ограничениях доступа.
  • Исходный код страниц и серверных обработчиков, особенно примеры подключения внешних сервисов.
  • История Git: старые версии файлов сохраняют строки, которые уже удалили из текущего кода.
  • Готовая сборка сайта, которую браузер скачивает с сервера.
  • Отладочные журналы, тестовые файлы и инструкции по запуску проекта.

Для небольшого бизнеса полезно сначала составить список подключений: какой сервис использует сайт, где находится его кабинет и кто управляет доступом. Без этого списка трудно понять, относится найденная строка к действующему ключу или к учебному примеру. Значения ключей в список не переносите.

Как поручить Claude Code проверку без изменения сайта?

Откройте копию проекта и начните с аудита без правок. Не давайте агенту доступ к рабочему серверу только ради поиска секретов. Если рабочая среда ещё не настроена, пригодится инструкция как установить Claude Code и проверить его на копии сайта.

Перед проверкой уточните, какие файлы агенту разрешено читать и куда инструмент передаёт содержимое проекта. Секреты не стоит вставлять в чат для распознавания. Для первого прохода достаточно искать подозрительные имена переменных и места подключения сервисов, скрывая сами значения в отчёте.

Задание для Claude Code можно сформулировать так:

«Проведи аудит проекта на возможные утечки секретов. Пока ничего не меняй, не отправляй сетевые запросы и не устанавливай инструменты. Найди места, где встречаются API-ключи, токены и заголовки авторизации. Проверь, какие настройки попадают в браузерную сборку. Если доступна история Git, проверь и её. Не выводи значения секретов в ответ, команды или журналы. Для каждой находки укажи путь, расположение в файле, причину подозрения и способ ручной проверки. Отдельно перечисли то, что проверить не удалось».

Попросите агента искать не только слово key. Ключ может лежать в переменной с произвольным именем, в адресе запроса или в заголовке Authorization. Полезно дополнить такой разбор сканером секретов: он ищет характерные шаблоны, а Claude Code помогает понять, как найденное значение связано с работой сайта. Ни один из этих способов не гарантирует отсутствие утечек.

Принимать отчёт проще, если каждая находка отвечает на конкретный вопрос: «В каком файле находится значение и может ли его получить посетитель?» Формулировка «всё безопасно» без перечня проверенных мест для приёмки не подходит.

Как проверить, не попал ли секрет в браузер и историю Git?

Откройте опубликованный сайт и инструменты разработчика в браузере. Во вкладке Network просмотрите запросы, которые возникают при действии с внешним сервисом. Например, отправьте тестовый запрос через форму ИИ-помощника, если она есть на сайте. Проверьте адрес запроса, его заголовки и содержимое.

Если браузер передаёт секретный ключ внешнему сервису, посетитель тоже сможет его увидеть. Перенос значения в другую переменную или сжатие JavaScript этого не исправят. Для секретного ключа обычно нужен серверный обработчик: браузер обращается к вашему серверу, а сервер выполняет разрешённую операцию с внешним сервисом. Сам обработчик тоже требует ограничений, иначе посторонние смогут расходовать ресурс через него.

Затем проверьте файлы JavaScript, которые сайт загрузил в браузер. Ищите названия подключённых сервисов, подозрительные переменные и фрагменты авторизации. Файл .env не защищает секрет автоматически: система сборки может подставить значение переменной прямо в код для посетителей. Правила такого подставления зависят от проекта.

Проверку Git поручите разработчику или агенту отдельной задачей. Нужен просмотр истории, доступных веток и тегов, а не только текущих файлов. Добавление .env в .gitignore предотвращает его случайное добавление в будущем, но не убирает файл из прежних коммитов и не прекращает отслеживание файла, который уже попал в Git.

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

Что делать, если секретный API-ключ уже опубликован?

Сначала определите, кто управляет ключом и какую функцию сайта затронет его отключение. Если ключ оказался в публичном репозитории или браузерном коде, считайте его скомпрометированным. Удаление из файла не отменяет доступ у человека, который успел сохранить значение.

  1. В кабинете сервиса отзовите ключ, который попал в открытый доступ. Учтите, что связанные с ним функции перестанут работать до замены.
  2. Создайте замену с минимальными нужными правами и доступными ограничениями. Передайте её через настройки серверного окружения, без вставки в чат или исходный код.
  3. Исправьте подключение и опубликуйте новую сборку. Убедитесь, что браузер больше не получает секрет, а нужная операция проходит через сервер.
  4. Проверьте журнал использования и расходы в кабинете сервиса. Сохраните сведения о подозрительных операциях для обращения в поддержку.
  5. Согласуйте очистку истории Git и доступных копий с теми, кто работает над проектом. Переписывание истории влияет на совместную работу и требует отдельного подтверждения.

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

Какие ошибки мешают проверить сайт перед запуском?

  • Проверяют только текущую папку проекта. Исправление: включить в задание историю Git и опубликованную сборку.
  • Принимают любое совпадение за утечку. Исправление: выяснить назначение значения по документации и настройкам сервиса.
  • Считают скрытое поле или сжатый JavaScript защитой. Исправление: проверить всё, что получает браузер, и убрать оттуда секретный доступ.
  • Просят ИИ показать найденные ключи полностью. Исправление: запрашивать пути и описание риска с маскировкой значений.
  • Разрешают агенту сразу удалить файлы и переписать историю. Исправление: сначала получить отчёт, затем отдельно согласовать изменения и способ восстановления.

Если сайт делает подрядчик, включите проверку секретов в приёмку. Попросите перечень подключённых сервисов, описание серверных настроек и отчёт по браузерной сборке. Для отдельной технической проверки передайте копию проекта без действующих секретов и список функций, которые нужно проверить. Результатом должен стать список находок с подтверждениями исправлений, а не обещание «ИИ всё посмотрел».

Начните с действия на две минуты: откройте проект и добавьте задачу «Проверить секреты в файлах, истории Git и браузерной сборке; значения ключей в отчёт не включать».