Codex CLI: локальный ИИ-агент для кодинга от OpenAI 131

小编 ·

Codex CLI: локальный ИИ-агент для кодинга от OpenAI

Codex CLI — это легковесный инструмент командной строки от OpenAI, предоставляющий пользователям терминала возможности рассуждения, аналогичные ChatGPT. Он может реально запускать код, работать с файлами и выполнять итерации, при этом все операции проходят под контролем версий. Поддерживает мультимодальный ввод, позволяя пользователям выполнять задачи генерации, редактирования и запуска кода с помощью инструкций на естественном языке.

Codex CLI: локальный ИИ-агент для кодинга от OpenAI

Что такое Codex CLI?

Codex CLI — это лёгкий инструмент командной строки, выпущенный OpenAI, который предоставляет пользователям терминала возможности рассуждения, подобные ChatGPT, и позволяет фактически запускать код, работать с файлами и выполнять итерации — всё это под контролем версий. Он поддерживает мультимодальный ввод, позволяя пользователям выполнять такие задачи, как генерация, редактирование и запуск кода, с помощью инструкций на естественном языке.

Codex CLI: локальный ИИ-агент для кодирования от OpenAI.jpg

Основные функции Codex CLI

  • Генерация и редактирование кода: пользователи могут с помощью простых инструкций на английском языке попросить Codex CLI сгенерировать код, например: «Создай Python-скрипт, который читает CSV-файл и выводит среднее значение определённого столбца».

  • Управление файлами: поддерживает выполнение файловых операций, таких как «переместить все файлы .txt в папку с именем notes».

  • Помощь в отладке: пользователи могут вставить сообщение об ошибке, и Codex CLI предложит варианты исправления.

  • Создание проектов: позволяет быстро генерировать шаблоны проектов, например «создать базовый сервер Node.js».

  • Мультимодальная поддержка: поддерживает ввод в виде скриншотов или диаграмм для реализации функций.

  • Локальный запуск: Codex CLI работает локально; всё чтение, запись файлов и выполнение команд осуществляются на локальной машине, и если пользователь сам не решит поделиться данными, исходный код не покидает локальную среду.

Особенности Codex CLI

  • Открытый исходный код и бесплатность: Codex CLI полностью открыт, пользователи могут свободно просматривать и изменять код, а также вносить свой вклад в его разработку.

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

  • Независимость от модели: по умолчанию используется модель OpenAI GPT-4-turbo, но пользователи могут переключиться на другие совместимые конечные точки API, такие как o3 и o4-mini.

  • Гибкая настройка: конфигурация осуществляется через файл .codex в формате YAML, поддерживаются пользовательские переменные и шаблоны.

Модель безопасности и разрешения

Codex CLI предоставляет три режима подтверждения, которые пользователь может выбрать с помощью параметра --approval-mode:

  • Режим предложения (по умолчанию): может читать любые файлы в репозитории, но требует одобрения пользователя для всех операций записи в файлы и команд оболочки.

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

  • Полностью автоматический режим: может читать и записывать файлы, а также выполнять команды оболочки без одобрения пользователя.

Сценарии использования Codex CLI

Codex CLI в первую очередь ориентирован на разработчиков, работающих в терминальной среде, и помогает им более эффективно выполнять повседневные задачи разработки. Он не является полностью автоматизированным помощником по кодированию, а служит для поддержки и ускорения рутинных задач.

Установка Codex CLI

Установка через npm (рекомендуется):

npm install -g @openai/codex

Сборка из исходного кода:

  • Клонируйте репозиторий и перейдите в каталог пакета CLI:

git clone https://github.com/openai/codex.git
cd codex/codex-cli
  • Установите зависимости и выполните сборку:

npm install
npm run build
  • Запустите локально собранный CLI или глобально подключите его через npm link.

Конфигурация

  • Codex CLI ищет файлы конфигурации в каталоге ~/.codex/:

  • config.yaml: можно задать модель по умолчанию и другие параметры конфигурации.

  • instructions.md: можно определить пользовательские инструкции.

Использование

  • Интерактивный запуск:

codex
  • Выполнение конкретной команды:

codex "explain this codebase to me"
  • Полностью автоматический режим:

codex --approval-mode full-auto "create the fanciest todo-list app"

Неинтерактивный режим / режим CI

Codex CLI можно запускать в автономном режиме в конвейерах CI/CD. Например:

- name: Update changelog via Codex
run: |
npm install -g @openai/codex
export OPENAI_API_KEY="${{ secrets.OPENAI_KEY }}"
codex -a auto-edit --quiet "update CHANGELOG for next release"

Адрес на GitHub:https://github.com/openai/codex

Подробная информация:https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started