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

Неинтерактивный режим позволяет использовать Codex в скриптах, CI/CD-конвейерах или headless-средах. В этом разделе подробно описано, как настроить и использовать неинтерактивный режим.


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

Выполнить одну задачу

Базовая команда exec

# Выполнить простые задачи
codex exec "Вывести список файлов Python в текущем каталоге"

# Используйте двойные кавычки для сложных команд
codex exec "Проанализируйте структуру кода в каталоге src/"

Чтение из стандартного ввода

ввод stdin

# Чтение из канала
echo "Объясни этот код" | codex exec --stdin

# Чтение из файла
codex exec --stdin < task.txt

# Многострочный ввод
cat <<EOF | codex exec --stdin
Создайте функцию для вычисления факториала
Протестируйте эту функцию
EOF
Неинтерактивный режим идеально подходит для автоматизированных задач и интеграции со скриптами.

Аргументы командной строки

Общие параметры

ПараметрОписание
exec "任务"Выполнить указанную задачу
--stdinЧтение задач из стандартного ввода
--model, -mУказать модель
--no-auto-approveОтключить автоматическое подтверждение
--output, -oВывод в файл

Полный пример

Полный пример параметров

# Указать модель
codex exec -m gpt-5.4-mini "Проверить код"

# Вывод в файл
codex exec "Создать README" -o README.md

# Отключить авто-подтверждение
codex exec --no-auto-approve "Запустить тесты"

# Комбинированное использование
codex exec -m gpt-5.4 "Проверить PR" --output review.md

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

Настройки файла конфигурации

Настроить неинтерактивный режим

# Настройки неинтерактивного режима по умолчанию
[exec]
# Модель по умолчанию
default_model = "gpt-5.4"

# Порог автоодобрения
auto_approve_threshold = "medium"

# Тайм-аут (секунды)
timeout = 300

Стратегия выполнения

В неинтерактивном режиме по умолчанию обычно используется политикаdeny(отклоняющая операции, которые могут иметь побочные эффекты):

Установить политику выполнения

# Использовать стратегию ask
codex exec --approval ask "Создать файл"

# Использовать стратегию approve (используйте с осторожностью)
codex exec --approval approve "Запустить тесты"

# Использовать стратегию deny (только для чтения)
codex exec --approval deny "Проанализировать код"
Из соображений безопасности операции, которые могут иметь побочные эффекты, по умолчанию отключены в неинтерактивном режиме.

Интеграция с shell-скриптами

Базовый скрипт

Пример shell-скрипта

#!/bin/bash

# Использование Codex для проверки кода
codex exec Проверить код в каталоге src/ --output review.md

if [ $? -eq 0 ]; then
    echo Проверка завершена, результаты сохранены в review.md
else
    echo Проверка не удалась
fi

Пакетная обработка

Скрипт пакетной обработки

#!/bin/bash

# Пакетная проверка нескольких файлов
for file in $(find src -name "*.py"); do
    echo Проверка:$file"
    codex exec Review$fileFile --output "review_$(basename $file).md"
done

Условное выполнение

Условное выполнение

#!/bin/bash

# Решить, использовать ли Codex в зависимости от количества файлов
FILE_COUNT=$(find src -name "*.py" | wc -l)

if [ $FILE_COUNT -gt 10 ]; then
    echo Есть много файлов, используйте Codex для пакетной проверки
    codex exec Проверьте все файлы Python --output full_review.md
else
    echo Файлов мало, проверьте их по одному
    for file in $(find src -name "*.py"); do
        codex exec Простая проверка$file"
    done
fi

Интеграция CI/CD

GitHub Actions

Рабочий процесс GitHub Actions

span style="color: green;">
name: Проверка кода

on
: [pull_request]

jobs
:
  codex-review
:
    runs-on
: ubuntu-latest
    steps
:
      - uses
: actions/checkout@v4

      - name
: Настройка Codex
        uses
: openai/codex-action@v1

      - name
: Запуск проверки кода
        run
: |
         codex exec "Проверьте изменения кода в этом PR" \
            --output review.md

      - name
: Загрузить ревью
        uses
: actions/upload-artifact@v4
        with
:
          name
: code-review
          path
: review.md

GitLab CI

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

span style="color: #0053A6;">
codex_review:
  image
: node:20
  before_script
:
   - npm install -g @openai/codex
  script
:
   - codex exec "Проверьте изменения в этом запросе на слияние" --output review.md
  artifacts
:
    paths
:
     - review.md

Jenkins

Jenkins Pipeline

pipeline {
    agent any

    stages {
        stage('Проверка кода') {
            steps {
                sh 'codex exec "Проверьте изменённые файлы" --output review.md'
            }
        }
    }

    post {
        всегда {
            archiveArtifacts 'review.md'
        }
    }
}
Интеграция Codex в рабочие процессы CI/CD позволяет автоматизировать проверку кода и контроль качества.

Лучшие практики

Обработка вывода

  • Использование--outputСохранение результатов в файл
  • Проверка кода возврата для определения успешности выполнения
  • Обработка возможных случаев ошибок

Оптимизация производительности

  • Использованиеgpt-5.4-miniСнижение затрат
  • Пакетная обработка нескольких задач
  • Установите разумный тайм-аут

Безопасность

  • Избегайте использования--approval approve
  • Использование режима только для чтения в CI/CD
  • Защита ключей API
При использовании неинтерактивного режима в производственных средах уделяйте особое внимание вопросам безопасности.

ЧАВО

В: Поддерживает ли неинтерактивный режим все функции?

Большинство функций поддерживается, но некоторые функции, требующие интерактивного подтверждения, могут быть недоступны.

В: Как обрабатываются операции, требующие подтверждения?

Использование--no-auto-approveпараметр, или задайте политику выполнения в файле конфигурации.

В: Можно ли настроить формат вывода?

В настоящее время поддерживаются вывод в виде простого текста и вывод в формате Markdown.

В: Как использовать его в Docker?

Установите Codex в образ Docker, затем вызывайте его в рабочем процессе CI/CD.

Другие расширения