Как уберечь свои секреты от кода, сгенерированного ИИ, и от коммитов Git

ИИ-агенты для кодинга работают быстро, но у них есть слепое пятно: они спокойно вставят API-ключ в файл, выведут токен в лог или закоммитят .env, который вы хотели оставить локальным. Любой агент с доступом к терминалу — Claude Code, Cursor, Gemini CLI, Codex — также может читать конфигурацию вашей оболочки и файлы проекта, а именно там обычно и прячутся учётные данные. Это руководство шаг за шагом проведёт вас через практичную многоуровневую настройку, чтобы ваши секреты не попадали в код, сгенерированный ИИ, и в историю Git.

Почему с ИИ это важнее

Утечка ключа — одна из самых частых и самых дорогих ошибок в разработке, и ИИ-ассистенты повышают ставки двумя способами. Во-первых, они генерируют код быстро, поэтому захардкоженный ключ может попасть в десяток файлов прежде, чем вы заметите. Во-вторых, агенты агрессивно поглощают контекст — как сказано в одной статье об управлении секретами, конфигурация вашей оболочки должна ссылаться на ключи, а не содержать их, потому что агент может прочитать всё, что раскрывают ваши dotfiles. Решение не в том, чтобы не доверять инструменту; оно в том, чтобы вообще не оставлять секретов в открытом виде, которые он мог бы найти.

Шаг 1: Храните секреты в переменных окружения, никогда — в коде

Базовое правило: ни один API-ключ, пароль или токен никогда не должен появляться в виде строкового литерала в исходном коде. Поместите их в файл .env в корне проекта и читайте во время выполнения.

# .env  — никогда не коммитится
ANTHROPIC_API_KEY=sk-ant-...
DATABASE_URL=postgres://...

// app.js — читает из окружения, в файле нет секрета
const apiKey = process.env.ANTHROPIC_API_KEY;

Так код, который редактируете вы (и ваш ИИ-агент), содержит только имя секрета, но никогда его значение.

Шаг 2: Убедитесь, что .env никогда не сможет быть закоммичен

Добавьте его в .gitignore ещё до того, как впишете хоть один секрет:

.env
.env.local
*.env

Вместо этого закоммитьте .env.example с пустыми заполнителями, чтобы коллеги знали, какие переменные нужно задать:

ANTHROPIC_API_KEY=
DATABASE_URL=

Если вы уже закоммитили настоящий .env, удаления его новым коммитом недостаточно — он остаётся в истории. Немедленно смените раскрытый ключ и считайте его скомпрометированным.

Шаг 3: Включите push protection в GitHub

Push protection в GitHub сканирует коммиты во время отправки и блокирует push, если обнаружит секрет, останавливая утечку прежде, чем она достигнет удалённого репозитория. Он распознаёт более 200 паттернов секретов от провайдеров вроде AWS, OpenAI, Stripe и многих других, а обновления 2026 года расширили набор паттернов, блокируемых по умолчанию. Для публичных репозиториев это бесплатно — включите в настройках репозитория: Settings → Code security. Думайте об этом как о ремне безопасности на тот момент, когда агент (или вы) допустит промах.

Шаг 4: Не позволяйте агентам собирать данные из конфигурации оболочки

Агенты с доступом к оболочке могут читать .zshrc, .bashrc и .zshenv. Если вы для удобства экспортировали туда ключи, агент их увидит. Держите общесистемные секреты вне dotfiles — загружайте их из менеджера секретов или связки ключей ОС по требованию, а не экспортируйте открытый текст при запуске оболочки.

Шаг 5: Ограничивайте и ротируйте

Две привычки ограничивают ущерб, если что-то всё же утекает, — совет, повторяемый и в руководстве OpenAI по безопасности API-ключей:

• Минимум привилегий: давайте каждому ключу самый узкий объём прав, какой ему нужен, и используйте отдельные ключи для каждого проекта и окружения, чтобы одна утечка не раскрыла всё.
• Регулярная ротация: ротируйте ключи по расписанию и немедленно — каждый раз, когда подозреваете раскрытие. Ротированный ключ превращает взлом в несобытие.

Краткий чек-лист

Прежде чем выпускать агента в репозиторий:

1. Секреты лежат в .env и читаются через process.env — никогда не захардкожены.
2. .env есть в .gitignore; коммитится только .env.example.
3. На удалённом репозитории включён push protection.
4. В dotfiles оболочки нет ключей в открытом виде.
5. Ключи узко ограничены по правам и ротируются по расписанию.

Ничто из этого не замедлит вас, как только всё настроено, — и это позволит передавать агенту больше работы, переживая куда меньше.