CLI 命令与参数

codex 启动交互终端；codex exec 用于脚本任务。启动参数在 shell 输入，斜杠命令则在 Codex 输入框使用。大部分默认值来自 ~/.codex/config.toml，单次 CLI 覆盖优先。

工作范围与权限

参数	值与用途
--cd、-C	开始处理请求前切换工作目录
--add-dir	增加工作区以外的可写目录，可重复
--sandbox、-s	read-only、workspace-write、danger-full-access
--ask-for-approval、-a	on-request 或 never
--strict-config	遇到当前版本不认识的配置字段时报错

额外目录写权限应优先通过 --add-dir 精确指定。--dangerously-bypass-approvals-and-sandbox（别名 --yolo）同时跳过审批与沙箱，只适用于已经有外部隔离的环境。

配置、模型与输入

参数	值与用途
--config、-c	key=value，先按 TOML 解析，可用于配置覆盖
--profile、-p	加载 $CODEX_HOME/profile-name.config.toml
--model、-m	指定模型，需账号可访问
--enable、--disable	单次启用或禁用 feature，可重复
--image、-i	图片路径，用逗号分隔或重复参数
--search	为本次运行启用 live 搜索
--oss	使用本地 provider
--local-provider	ollama 或 lmstudio，覆盖 oss_provider

全局参数向子命令传播的范围以对应命令帮助为准；例如应写 codex exec --oss ...，把 exec 的参数放在该子命令后。

非交互输出

codex exec 可直接接提示词，或以 - 从 stdin 读取。--json 输出 JSONL 事件，--output-last-message（-o）将最后回复写到文件，--output-schema 指定最后响应的 JSON Schema 文件。

--ephemeral 不把 session rollout 文件持久化到磁盘；--skip-git-repo-check 允许在非 Git 目录运行。旧的 --full-auto 已弃用，会显示警告，官方建议改用 --sandbox workspace-write。

常用子命令

子命令	用途
login、logout	登录或移除保存的凭据
resume、fork	恢复或分叉会话
archive、unarchive、delete	管理保存的会话
review	非交互代码评审
cloud、apply	管理云任务，或应用云任务差异
mcp	管理外部 MCP server 配置
plugin、plugin marketplace	管理插件和市场来源
completion	生成 shell 补全
doctor	生成安装、配置、认证等诊断报告
app-server	启动客户端协议服务

codex mcp-server 已移除；构建客户端应改用 App Server。