API-ключ для Codex: когда он нужен, куда сохранить и как не отправить в GitHub

API-ключ нужен Codex не всегда. В приложении, CLI и расширении для редактора можно войти через ChatGPT и использовать доступ своей подписки. Ключ выбирают для тарификации через API, автоматизации или отдельного проекта OpenAI. Codex Cloud работает через вход в ChatGPT.

Сначала выберите способ входа

Если вы просто запускаете Codex на своем компьютере, начните со входа через ChatGPT. Так вы не создадите лишний секрет и не перепутаете оплату подписки с расходами API.

API-ключ оправдан, когда нужно:

• оплачивать запросы по фактическому API-использованию;

• разделить личную подписку и рабочий проект;

• запускать Codex в среде, где интерактивный вход неудобен;

• контролировать расходы и доступ на уровне API-проекта.

Подписка ChatGPT и баланс API не являются одним кошельком. Перед использованием ключа проверьте биллинг и лимиты именно в API Platform.

Создайте отдельный ключ

Не используйте один ключ для всех ноутбуков, проектов и серверов. Создайте ключ в нужном API-проекте и назовите его по назначению, например codex-personal-mac. Тогда его можно отозвать, не останавливая остальные интеграции.

После создания значение показывается как секрет. Не отправляйте его в мессенджер и не сохраняйте в заметку внутри репозитория.

Сохраните ключ вне проекта

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

Проверьте защиту до первого коммита:

1. создайте .env.example только с названием переменной и пустым значением;

2. убедитесь, что реальный .env игнорируется Git;

3. выполните git status;

4. поищите начало ключа в отслеживаемых файлах;

5. задайте небольшой бюджет или лимит проекта.

Проверьте, какой вход использует Codex

Откройте настройки авторизации или выполните штатную команду входа для своей версии Codex. Не публикуйте вывод, если в нем есть сведения об учетной записи. После переключения на ключ дайте безопасную задачу без внешних сервисов:

Прочитай README этого учебного проекта и перечисли команды проверки. Ничего не меняй и не запускай команды.

Если ответ получен, способ входа работает. Теперь вернитесь к биллингу и убедитесь, что расход появился в ожидаемом API-проекте. Так вы не обнаружите через неделю, что Codex использовал не ту организацию или не тот способ оплаты.

Что делать при утечке

Не удаляйте строку и не считайте вопрос закрытым. Сразу отзовите ключ, создайте новый и очистите историю Git, если секрет попал в коммит. Обычный новый коммит не удаляет ключ из старых версий.

В проектах ИИ-лаборатории Глеба Кудрявцева «Вайбкодинг на максималках» Codex используется в связке с VS Code, Git, базой и деплоем, поэтому работа с секретами рассматривается как часть процесса, а не как последняя проверка.

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