Как установить OpenAI Codex CLI: вход и первая задача
Установить Codex CLI, войти через ChatGPT или API-ключ, затем выполнить первую задачу в настоящем репозитории.
Нужен агент, который читает локальный репозиторий, правит файлы и запускает инструменты машины — не выходя из терминала.
Этот разбор — как установить и использовать OpenAI Codex CLI: официальный установщик, вход через ChatGPT или API-ключ и первая задача в настоящем репозитории. Шаги по developers.openai.com/codex/cli и developers.openai.com/codex/auth.
Кому это подходит
Codex CLI работает с локальным репозиторием: смотрит файлы, правит их, запускает уже установленные инструменты. Интерактивно — codex; для конвейеров — codex exec. Это не вкладка веб-ChatGPT, и расширение IDE ставить заранее не обязательно.
Начинайте в настоящем репо
Перед запуском сделайте cd в проект. Официальный вход: спросить “Tell me about this project”, затем одну сфокусированную, проверяемую правку.
Два входа, два счёта
Вход через ChatGPT тратит кредиты Plus / Pro / Business / Edu / Enterprise. API-ключ идёт по тарифам Platform — удобнее для частного CI; часть облачных функций рабочего пространства ограничена.
Сначала права
/permissions показывает песочницу и доступные для записи корни. Официально также советуют git-точки до и после задачи, чтобы можно было откатиться.
Установка, вход, первая задача
-
1
Установить CLI
macOS / Linux:
curl -fsSL https://chatgpt.com/codex/install.sh | sh. Windows: официальный установщик PowerShell. Либоnpm install -g @openai/codexилиbrew install --cask codex. Та же команда обновляет копию. -
2
Войти
В каталоге проекта запустите
codexилиcodex login, выберите Sign in with ChatGPT и завершите браузер. Безголовый хост или заблокированный localhost-колбэк:codex login --device-auth(включите коды устройства в настройках безопасности ChatGPT). Автоматизация:printenv OPENAI_API_KEY | codex login --with-api-key. Проверка —codex login status, выход —codex logout. -
3
Первая задача в репозитории
Зайдите в репозиторий и запустите
codex. Попросите объяснить устройство, затем одну сфокусированную правку — тест, типизированный фикс, явная ошибка. Перед коммитом/review./initможет написатьAGENTS.mdдля постоянных инструкций команды.
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows: irm https://chatgpt.com/codex/install.ps1 | iex
# npm install -g @openai/codex
# brew install --cask codex
codex login
# printenv OPENAI_API_KEY | codex login --with-api-key
# codex login --device-auth
cd ~/code/your-repo
codex
# Tell me about this project
Что обычно ломает первый запуск
| Способ | Оплата | Лучше для |
|---|---|---|
| Вход ChatGPT | Кредиты тарифа | Ежедневная локальная работа |
| API-ключ | Тарифы Platform | Частный CI / скрипты |
| Код устройства | Как у ChatGPT | Безголовый хост или SSH |
- auth.json как пароль
- Вход кэшируется в
~/.codex/auth.jsonили в связке ОС. Не коммитьте и не вставляйте в тикеты. CLI и расширение IDE делят этот кэш: выход с одной стороны требует повторного входа с другой. - Безголовый вход — другой путь
- Если удалённый хост блокирует localhost-колбэк, предпочитайте код устройства. Запасные варианты: скопировать кэш с машины с браузером или пробросить
localhost:1455по SSH. - Корпоративному прокси нужен CA
- При TLS-прокси или частном корне задайте
CODEX_CA_CERTIFICATEпередcodex login. Иначе откат наSSL_CERT_FILE.
Официальное предупреждение для API и CI: не выставляйте выполнение Codex в недоверенных или публичных средах.
Когда diff нужно обсудить
После правок агента часто не хватает одной схемы: что изменилось и почему можно сливать. Отдельный переговорный пакет не нужен. Откройте короткое пространство на tidemeet или смотрите как создать пространство. Холст: основы общей доски. Заметка об инциденте оценки OpenAI на этом сайте: отчёт METR.
Вопросы
Нужно ли ставить расширение IDE?
Нет. CLI работает сам. Расширение делит кэш входа, но для первой задачи в репозитории достаточно терминала.
Можно ли смешивать вход ChatGPT и API-ключ?
Один активный способ на сессию. ChatGPT использует права пространства и кредиты тарифа; API-ключ — настройки организации Platform и оплату по использованию. Codex cloud требует вход через ChatGPT.
Должна ли первая задача быть большим рефакторингом?
Нет. Официальный вход: понять репозиторий, затем одна сфокусированная правка. Проверьте /permissions и оставьте git-точку для отката.
Какое отношение это имеет к временному инструменту встреч?
Никакой продуктовой связки. Если нужно только коротко разобрать diff, сравнение временных инструментов встреч показывает, когда хватает короткого пространства в браузере.