Codex CLI 命令速查表 - OpenAI 终端编码代理全参数
Codex CLI 终端编码代理命令都在这里了，从安装登录到非交互执行、从沙箱批准到 MCP 接入，按场景分类整理，复制即用。
返回 AI 命令行安装与认证 7
npm install -g @openai/codex通过 npm 全局安装（全平台）
brew install --cask codexmacOS 通过 Homebrew 安装
codex --version验证安装并显示版本
codex login浏览器 OAuth 登录 ChatGPT 账号
codex login --with-api-key从 stdin 读取 API key 登录
codex login --device-auth无头/SSH 设备码登录
codex logout注销登录
交互模式 5
codex启动交互式 TUI 会话
codex "解释这个代码库"带初始提示启动 TUI
codex --search "修复登录 bug"启用实时网络搜索
codex -i ./screenshot.png "实现这个 UI"附带图片（可逗号分隔多张）
codex --oss使用本地开源模型（Ollama 等）
非交互执行（codex exec） 5
codex exec "修复失败的测试"非交互自动化模式（别名 codex e）
echo "重构 utils" | codex exec --oss管道输入 + 本地模型
codex exec --json "列出所有 API 端点"输出 JSONL 便于脚本解析
codex exec -o result.txt "总结架构"把最终回答保存到文件
codex exec --output-schema '{...}' "提取配置"用 JSON Schema 约束输出结构
会话管理 5
codex resume恢复上一次会话
codex fork把上一次会话派生为新线程
codex apply把最新 diff 应用为 git apply（别名 codex a）
codex --restore恢复上一次会话（部分版本）
codex --history浏览历史会话记录
模型与配置 5
codex -m gpt-5.4 "复杂任务"指定模型（如 gpt-5.4 / gpt-5.4-mini）
codex -p openai "生成组件"加载命名配置 profile
codex -C /path/to/repo设置工作根目录（--cd）
codex -c覆盖 config.toml 中的配置值
codex completion bash生成 bash 补全脚本
沙箱与批准模式 8
codex -s read-only沙箱只读（默认，最安全）
codex -s workspace-write沙箱可写工作目录
codex -s danger-full-access完全访问（容器内谨慎使用）
codex -a untrusted不信任操作需逐条批准（默认）
codex -a never从不批准（只读探索用）
codex --full-auto "完成实现"自动批准：workspace-write + on-failure
codex --yolo "紧急修复"跳过所有沙箱与批准（危险，慎用）
codex --dangerously-bypass-approvals-and-sandbox完全绕过沙箱与批准（容器内用）
MCP 与 Codex Cloud 7
codex mcp list列出已配置的 MCP 服务器
codex mcp add -- <args...>添加 stdio 类型 MCP 服务器
codex mcp add --url https://example.com/mcp添加 HTTP MCP 服务器
codex mcp get <name>查看服务器配置
codex mcp remove <name>删除服务器
codex cloud exec --env "任务"向 Codex Cloud 提交任务
codex cloud exec --env --attempts 3 "任务"提交任务并指定重试次数（1-4）
交互斜杠命令 12
/clear重置 UI 与对话
/compact总结对话释放 token
/new在同会话中开新对话
/fork克隆当前对话到新线程
/diff显示 git diff（含未跟踪文件）
/status显示会话配置与 token 用量
/init生成 AGENTS.md 项目脚手架
/review对工作区改动做代码审查
/plan切换到 plan 只读探索模式
/model选择模型与推理强度
/permissions设置 Codex 可自动执行的范围
/exit退出 Codex CLI
💡 提示
- 非交互自动化一律用 `codex exec` + `--json`，配合 CI 流水线做代码生成/审查，是 Codex 的招牌用法。
- 默认 `--full-auto` 会在网络禁用的沙箱内自动批准，安全且省心；需要联网装依赖时才会退出沙箱询问。
- 把项目约定写进 AGENTS.md（根目录或 ~/.codex/），Codex 会自动合并加载，比每次在提示词里重复更高效。
- 只读探索用 `-a never -s read-only`，既不弹确认又能读全系统文件，适合审计/调研类任务。
由 LaoHand 维护
公开更新于 2026年8月5日，内容持续校对官方文档。