Неинтерактивный режим Codex
Неинтерактивный режим позволяет использовать Codex в скриптах, CI/CD-конвейерах или headless-средах. В этом разделе подробно описано, как настроить и использовать неинтерактивный режим.
Базовое использование
Выполнить одну задачу
Базовая команда exec
# Выполнить простые задачи
codex exec "Вывести список файлов Python в текущем каталоге"
# Используйте двойные кавычки для сложных команд
codex exec "Проанализируйте структуру кода в каталоге src/"
codex exec "Вывести список файлов Python в текущем каталоге"
# Используйте двойные кавычки для сложных команд
codex exec "Проанализируйте структуру кода в каталоге src/"
Чтение из стандартного ввода
ввод stdin
# Чтение из канала
echo "Объясни этот код" | codex exec --stdin
# Чтение из файла
codex exec --stdin < task.txt
# Многострочный ввод
cat <<EOF | codex exec --stdin
Создайте функцию для вычисления факториала
Протестируйте эту функцию
EOF
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
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
[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 "Проанализировать код"
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
# Использование 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
# Пакетная проверка нескольких файлов
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
# Решить, использовать ли 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
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
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'
}
}
}
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.
Другие расширения