一、基础用法codex[OPTIONS][PROMPT]# 交互式启动最常用codex[OPTIONS]COMMAND[ARGS]# 非交互式子命令二、核心选项日常使用频率最高1. 模型相关-m,--modelMODEL# 指定使用的模型如 -m gpt-4--oss# 使用开源模型提供商--local-providerPROVIDER# 配合 --oss 使用指定 lmstudio 或 ollama示例codex-mclaude-3.5-sonnet帮我写一个排序算法codex--oss--local-provider ollama解释这段代码2. 工作目录-C,--cdDIR# 设置 Agent 的工作根目录--add-dirDIR# 额外可写的目录可重复使用示例codex-C/my/project重构这个函数codex-C/project --add-dir /tmp/data读取两个目录的数据3. 沙箱安全控制-s,--sandboxSANDBOX_MODE# 沙箱策略# 可选值read-only, workspace-write, danger-full-access-a, --ask-for-approvalPOLICY# 命令审批策略# 可选值untrusted, on-failure(已弃用), on-request, never--dangerously-bypass-approvals-and-sandbox# ⚠️ 极端危险跳过所有确认和沙箱示例codex-sworkspace-write-aon-request部署这个应用codex-sdanger-full-access-anever执行自动化脚本# 完全自动化运行4. 配置文件-c,--configkeyvalue# 覆盖配置项点号路径-p,--profilePROFILE# 叠加额外的配置文件--strict-config# 遇到不识别的配置项时报错示例codex-cmodelo3-csandbox_permissions[disk-full-read-access]codex-pwork-cfeatures.experimentaltrue5. 功能开关--enableFEATURE# 启用某个特性--disableFEATURE# 禁用某个特性示例codex--enableweb_search查询今天的新闻codex--disablecode_review快速执行6. 其他实用选项-i,--imageFILE...# 给提示附加图片--search# 启用实时网络搜索--no-alt-screen# 禁用交替屏幕保留终端滚动历史--remoteADDR# 连接到远程应用服务器示例codex-iscreenshot.png描述这张图片codex--search解释量子计算codex --no-alt-screen# 适合在 tmux 或脚本中使用三、子命令主要功能执行类子命令说明示例exec非交互式运行codex exec 格式化所有py文件review代码审查codex review --diff HEAD~1apply应用 agent 生成的 diffcodex applysandbox在沙箱中运行命令codex sandbox ls -la会话管理子命令说明示例resume恢复之前的会话codex resume --lastfork复制之前的会话codex fork --lastarchive归档会话codex archive session_123delete永久删除会话codex delete session_123unarchive取消归档codex unarchive session_123配置与诊断子命令说明示例login/logout登录/登出codex logindoctor诊断安装配置codex doctorupdate更新到最新版codex updatecompletion生成 shell 补全codex completion bashfeatures查看功能开关codex features服务器/远程子命令说明示例mcp-server启动为 MCP 服务器codex mcp-serverapp-server实验性应用服务器codex app-serverremote-control管理远程控制codex remote-control startapp启动桌面应用codex appexec-server执行服务器codex exec-server其他子命令说明示例cloud实验性云任务codex cloud listdebug调试工具codex debug logsplugin插件管理codex plugin install xxxmcpMCP 服务器管理codex mcp list四、实战组合示例场景1日常交互式编程codex-C~/project-mgpt-4-aon-request场景2非交互式自动化codexexec-sdanger-full-access-anever运行所有测试并修复失败的用例场景3代码审查codex review--pr123-mclaude-3.5-sonnet场景4带额外权限和配置codex-C/app --add-dir /data-cfeatures.web_searchtrue-pprod处理数据文件场景5恢复上一次会话codex resume--last五、安全提示--dangerously-bypass-approvals-and-sandbox仅在完全受控的环境如 CI/CD 隔离容器中使用切勿在本地开发机随意使用。--dangerously-bypass-hook-trust自动化场景中确保 hook 来源可信再使用。-a never配合沙箱使用时确保-s策略足够严格。