Codex · устройство и практическое применение

Codex: агент для работы в вашей среде

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

Это продукт OpenAI, компании, которая создала ChatGPT. Здесь я исследую его открытую программную основу: как она организует работу агента и как использовать её со своими инструментами, провайдерами и моделями.

Почему я выбираю Codex

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

Работа от задачи до проверки

Агент связывает объяснения с действиями: изучает исходные данные, использует инструменты и получает обратную связь. Я могу уточнять задачу и проверять реальные изменения по ходу работы.

Открытое устройство

Исходники CLI и app-server доступны для изучения. Можно проследить, как собирается контекст, вызываются инструменты и продолжается работа, а затем использовать эту основу в собственных системах.

Выбор модели и провайдера

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

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

Codex не привязан жёстко к ChatGPT

Вход через ChatGPT — один из способов подключения. В открытом Codex можно настроить другого провайдера и выбрать доступную у него модель, использовать совместимый шлюз или локальный сервер модели. Программа работает в вашей среде; сама модель может работать удалённо.

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

Как настроить своего провайдера — официальная документация

Три режима работы одной программной основы

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

01 · Разовый запуск

Передать задачу и получить результат

Неинтерактивный запуск
codex exec "Изучи README.md и кратко опиши назначение проекта"

Codex принимает промпт, выполняет задачу и завершает процесс. Внутри одного запуска могут быть несколько обращений к модели и вызовов инструментов. Это удобно для скриптов, обработки документов и задач по расписанию, которые запускает внешняя программа.

Для обработки результата программой есть вывод событий JSONL через --json. Подробнее — неинтерактивный запуск.

02 · TUI

Работать в диалоге прямо в терминале

Терминальный интерфейс
codex

TUI — текстовый пользовательский интерфейс в терминале. Вы ставите задачу, читаете ответы, уточняете требования и наблюдаете за работой инструментов. Можно обсуждать результат и продолжать работу в том же потоке, не открывая отдельный графический чат.

Историю и состояние этой работы разбираем в статье «Поток или Тред».

03 · Сервер для приложений

Встроить Codex в свой интерфейс или систему

Запуск сервера приложений
codex app-server

App-server предоставляет программный интерфейс: ваше приложение создаёт потоки, передаёт задачи, получает события и обрабатывает запросы подтверждения. На этой основе можно строить графические интерфейсы и интеграции со сторонними системами.

По умолчанию обмен идёт через стандартный ввод и вывод процесса. Сам запуск сервера не открывает готовую веб-страницу: пользовательский интерфейс и подключение к нему создаёт приложение.

Протокол app-server и пример подключения

Где скачать и как начать

Для этих трёх режимов нужен Codex CLI. Исходники и готовые сборки публикуются в официальном репозитории OpenAI. Если установлен Node.js с npm, CLI можно установить командой:

Установка Codex CLI
npm install -g @openai/codex

Затем откройте рабочую папку в терминале и запустите codex. Подключите аккаунт ChatGPT либо настройте доступ к выбранному провайдеру. Для первого знакомства попросите объяснить содержимое папки и предложить план работы.

Открытая лицензия программной основы не означает бесплатный доступ ко всем моделям. Условия доступа определяет выбранный сервис; для локальной модели нужны собственные вычислительные ресурсы.

Разобраться, что происходит внутри

Начните с разбора «Как Codex собирает запрос к LLM»: от сообщения пользователя до контекста, инструментов и цикла выполнения. В статьях есть ссылки на участки исходников и упражнения для проверки.

Авторский сайт об устройстве и применении Codex. Не является официальным сайтом OpenAI.

Написать мне