OpenAI Codex — агент для программирования, который запускается прямо в терминале. Его открытая часть, Codex CLI, работает локально на компьютере: читает выбранный репозиторий, предлагает правки и выполняет разрешённые команды. Исходный код опубликован в репозитории openai/codex.
Агент оказывается рядом с Git, сборкой и тестами. Это удобно, но ответ в чате ничего не доказывает сам по себе. Результат виден в diff, выводе проверок и списке затронутых файлов.
Что такое OpenAI Codex CLI
README репозитория называет Codex CLI coding agent от OpenAI, который работает локально на компьютере пользователя. По данным GitHub, основной язык репозитория — Rust. Код распространяется по Apache-2.0.
Репозиторий относится к открытой разработке CLI и связанных компонентов. README отдельно указывает расширение для IDE, desktop app и Codex Web. Это разные поверхности продукта. Локальный процесс в терминале и задача в облачной среде работают с разным контекстом и разными границами доступа.
Codex CLI получает контекст из файлов проекта и пользовательских инструкций. В зависимости от задачи он может читать код, редактировать файлы и запускать команды. Реальный доступ задают sandbox, approval policy и ограничения среды. Возможность выполнить команду не означает, что её следует запускать без подтверждения.
Как установить и запустить Codex CLI
В актуальном README есть официальные install scripts, package managers и готовые binaries из GitHub Releases. Через npm CLI устанавливается так:
npm install -g @openai/codexДля macOS доступен Homebrew:
brew install --cask codexИнтерактивный terminal UI запускается одной командой:
codexREADME рекомендует вход через ChatGPT. Второй документированный вариант — API key, для которого нужна отдельная настройка. Планы, лимиты и условия API меняются, поэтому проверять их лучше в текущей документации по authentication, а не в старом обзоре.
Перед установкой на рабочую машину откройте официальный README и сверьте команды. Номер последнего релиза быстро устаревает и мало говорит о том, подходит ли CLI под правила конкретной команды.
Рабочий цикл в репозитории
Для первого запуска лучше взять репозиторий с Git и понятной командой проверки. Начните с git status, затем опишите задачу, допустимую область правок и критерий готовности. Попросите Codex прочитать инструкции и нужные файлы до редактирования.
Когда агент предложит план, проверьте его вместе с командами, для которых нужен approval. После правок изучите diff и запустите tests, относящиеся к изменению. Commit имеет смысл создавать только после этой проверки.
Такой порядок не является специальным protocol Codex. Он просто делает результат проверяемым. В одном проекте достаточно теста, в другом нужны сборка, линтер, типизация или воспроизводимый ручной сценарий. Универсальной команды здесь нет: её определяет сам репозиторий.
AGENTS.md как инструкция для агента
AGENTS.md хранит постоянные правила работы Codex в репозитории. Туда можно записать команды сборки и тестов, стиль кода, границы модулей, требования к проверке и список файлов, которые нельзя менять. Документация OpenAI по AGENTS.md описывает этот файл как открытый формат инструкций для coding agents.
Хорошая инструкция конкретна. Точная команда теста с рабочей директорией полезнее просьбы «проверь всё». Секреты, tokens и содержимое credential files в AGENTS.md помещать нельзя: файл является частью контекста проекта и часто хранится в version control.
Интерактивная работа, exec и review
Команда codex запускает интерактивную сессию. Справочник CLI также описывает codex exec для non-interactive выполнения, codex resume для продолжения сохранённой сессии и codex review для проверки изменений.
Non-interactive режим полезен в повторяемом workflow, когда команда уже понимает его входы, разрешения и критерии остановки. Расплывчатую задачу автоматизация не исправит. Она лишь будет быстрее повторять ту же неопределённость.
Sandbox, approvals и credentials
Codex работает с настоящими файлами и командами, поэтому access level влияет на риск. Sandbox очерчивает доступный контур, а approval policy определяет, когда агент должен остановиться и запросить разрешение. Для знакомства разумно ограничить его рабочим каталогом и отдельно подтверждать действия за его пределами.
Текущие режимы и параметры нужно сверять с официальной документацией по sandbox и approvals. В managed environment действуют и дополнительные ограничения, поэтому локальная конфигурация не всегда является последним уровнем контроля.
Authentication требует той же аккуратности. CLI может хранить сведения о входе в OS credential store или в локальном auth file. С таким файлом обращаются как с паролем: его не добавляют в Git, не прикладывают к issue и не передают агенту обычным текстом.
Риск может находиться и внутри недоверенного repository. Его инструкции, build scripts и зависимости способны запросить сеть, запуск внешнего кода или данные вне текущей задачи. Прежде чем расширять permissions, стоит выяснить, зачем нужно конкретное действие.
CLI, IDE, desktop app и web
Codex CLI работает из terminal с локальным repository. IDE extension переносит взаимодействие ближе к редактору. Desktop app даёт отдельный интерфейс, а Codex Web относится к cloud-based agent. README направляет пользователей этих вариантов на разные страницы.
Поэтому feature одной поверхности нельзя без проверки приписывать другой. Описание cloud task не объясняет поведение локального codex, а наличие команды в CLI не гарантирует тот же workflow в web или IDE.
Кому подходит терминальный формат
Codex CLI проще всего встроить в работу тем, кто уже пользуется terminal, Git и project-specific commands. Особенно прозрачен он там, где задачу можно проверить diff, тестом или сборкой, а правила лежат рядом с кодом.
Технический review всё равно остаётся за человеком. Агент также не создаёт тестовую стратегию из ничего. Если repository не объясняет, как проверить изменение, критерий придётся сформулировать до передачи задачи.
Для чувствительных данных сначала нужны правила доступа, credential storage и audit. Высокие permissions не стоит включать только ради тишины: запросов approvals станет меньше, зато область возможного воздействия вырастет.
Перед первым рабочим заданием
Проверьте, что установка ведёт на официальный openai/codex, OpenAI docs или официальный package. Рабочее дерево Git должно быть чистым либо текущие правки следует зафиксировать отдельно. Ограничьте задачу конкретными файлами или наблюдаемым поведением.
В AGENTS.md нужны настоящие команды проверки, но не credentials. Sandbox и approval policy должны соответствовать риску repository. После выполнения просмотрите diff, выполненные команды и результаты tests. Сведения о plans, models и limits всегда перепроверяйте в текущей документации OpenAI.
OdiRouter и границы публикации
Материал подготовлен OdiRouter как независимая русская публикация. Команды, которые оценивают облачную AI-инфраструктуру, могут изучить платформу на официальном сайте OdiRouter.
OdiRouter не заявляет, что размещает Codex, интегрирован с Codex или действует от имени OpenAI. Исследованные источники не подтверждают такую связь.
Источники
Состояние репозитория и документации проверено 26 августа 2026 года. Условия доступа, install routes и команды могут измениться позже.