Codex 非交互模式

佚名 2026-09-02 17:37:56

非交互模式允许你在脚本、CI/CD 流水线或无头环境中使用 Codex。本节详细介绍如何配置和使用非交互模式。

基础用法

执行单个任务

基本 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[$?-eq0]; then
echo"审查完成，结果已保存到 review.md"
else
echo"审查失败"
fi

批量处理

批量处理脚本

#!/bin/bash
# 批量审查多个文件
forfilein $(find src -name"*.py"); do
echo"审查: $file"
codex exec"审查 $file 文件"--output"review_$(basename $file).md"
done

条件执行

#!/bin/bash
# 根据文件数量决定是否使用 Codex
FILE_COUNT=$(find src -name"*.py"|wc -l)
if[$FILE_COUNT-gt10]; then
echo"文件较多，使用 Codex 批量审查"
codex exec"审查所有 Python 文件"--output full_review.md
else
echo"文件较少，逐个审查"
forfilein $(find src -name"*.py"); do
codex exec"简单审查 $file"
done
fi

CI/CD 集成

GitHub Actions

GitHub Actions 工作流

span >

name: Code Review

on: [ pull_request ]

jobs:

codex-review:

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v4

- name: Setup Codex

uses: openai/codex-action@v1

- name: Run Code Review

run: |

codex exec "Review code changes in this PR"

--output review.md

- name: Upload Review

uses: actions/upload-artifact@v4

with:

name: code-review

path: review.md

GitLab CI

GitLab CI 配置

span >

codex_review:

image: node:20

before_script:

- npm install -g @openai/codex

script:

- codex exec "Review changes in this merge request" --output review.md

artifacts:

paths:

- review.md

Jenkins

Jenkins Pipeline

pipeline {
agent any
stages {
stage('Code Review'){
steps {
sh 'codex exec "Review changed files" --output review.md'
}
}
}
post {
always {
archiveArtifacts 'review.md'
}
}
}