Codex CLI · 常用命令

v0.145.02026-07-21Apache-2.0GitHub

适用场景

查询 Codex CLI 当前交互、自动化、审批和沙箱参数

面向读者

已安装 Codex CLI 的开发者

TL;DR

codex 进入交互 → codex exec 非交互 → 用审批与沙箱限制权限

启动方式

命令

效果

codex

进入交互式 TUI

codex "帮我检查当前改动"

带初始提示启动交互会话

codex exec "总结这个仓库"

非交互执行并把结果输出到终端

codex app

启动桌面 App；未安装时打开官方安装流程

codex --help

查看当前版本的完整参数

旧版文档中的 -q、--quiet、--approval-mode suggest/auto-edit/full-auto 已从本页撤下；当前自动化入口是 codex exec，权限由审批策略和沙箱两组参数共同控制。

审批与沙箱

参数

当前值

--ask-for-approval, -a

untrusted / on-request / never

--sandbox, -s

read-only / workspace-write / danger-full-access

常用的受控组合：

# 只读分析；需要越界动作时再询问
codex --sandbox read-only --ask-for-approval on-request
 
# 允许写当前工作区，网络默认仍受限制
codex --sandbox workspace-write --ask-for-approval on-request

非交互模式

# 一次性执行
codex exec "用中文总结这个 PR 的改动"
 
# 指定只读沙箱
codex exec --sandbox read-only "检查 src/ 中潜在的注入风险，只输出报告"
 
# 指定模型（仅当当前登录或 provider 实际提供该模型）
codex exec --model gpt-5.6-sol "审查当前变更"

在 CI 中应把 API Key 限制在单次命令环境，避免写入仓库或全局日志。官方文档为非交互执行提供 CODEX_API_KEY；它只适用于 codex exec。

模型选择

OpenAI 当前 Codex 文档建议从默认 Power 设置开始，该设置使用 gpt-5.6-sol 与 medium reasoning；Sol、Terra、Luna 分别覆盖复杂高价值、日常通用和清晰重复任务。交互会话可用 /model，启动时可用 --model / -m。

Profile 与项目配置

# ~/.codex/deep-review.config.toml
codex --profile deep-review
codex exec --profile deep-review "review this change"

Codex 0.134.0 及以后，Profile 文件为 ~/.codex/<profile-name>.config.toml，通过 --profile 选择；不再使用旧 CODEX_PROFILE=... 或 [profiles.<name>] 方式。项目级 .codex/config.toml 只会在信任该项目时加载。

AGENTS.md 用于仓库级持久说明，离当前目录更近的文件对其子树生效。具体 slash 命令会随版本变化，请以会话中的 /help 为准。

Codex CLI · 常用命令​

启动方式​

审批与沙箱​

非交互模式​

模型选择​

Profile 与项目配置​

相关