Codex 速查表

本附录包含命令速查表、常见问题和版本更新信息。

命令速查表

CLI 基础命令

命令说明
codex启动交互式 TUI
codex "任务"启动并执行指定任务
codex exec "任务"非交互模式执行任务
codex --version显示版本信息
codex --help显示帮助信息

斜杠命令

命令说明
/model <name>切换模型
/fast切换 Fast 模式
/plan进入计划模式
/review审查代码变更
/new开始新会话
/resume恢复历史会话
/fork克隆当前会话
/compact压缩上下文
/status显示会话状态
/clear清除屏幕
/quit退出 Codex
/approval <mode>切换审批模式

CLI 参数

参数说明
-m <model>指定模型
--sandbox <mode>设置沙箱模式
--approval-mode <mode>设置审批模式
-i <file>附加图片
-o <file>输出到文件（exec）
--full-auto全自动执行
--ephemeral不保存会话文件
--reasoning-effort <level>推理强度

Shell 命令执行

格式说明
! <command>在 Codex 中执行 Shell 命令
! git status查看 Git 状态
! npm test运行测试

配置文件路径

配置文件位置

文件路径作用
用户配置~/.codex/config.toml全局默认配置
项目配置.codex/config.toml项目特定配置
项目指令AGENTS.md项目行为规范
日志目录~/.codex/log/运行日志
会话目录~/.codex/sessions/会话记录

技能目录

位置路径
项目级.agents/skills/
用户级~/.agents/skills/
系统级/etc/codex/skills/

快捷键

CLI 快捷键

快捷键功能
Enter发送消息
Shift+Enter换行
Ctrl+C中断操作
Ctrl+C (两次)退出 Codex
Ctrl+D退出（输入空时）
Ctrl+R搜索历史
Up/Down浏览历史
Tab自动补全
Esc Esc编辑上一条消息
Ctrl+O复制最后回复

App 快捷键

快捷键功能
Cmd/Ctrl+N新建会话
Cmd/Ctrl+Shift+N新建窗口
Cmd/Ctrl+W关闭窗口/标签
Cmd/Ctrl+[上一个标签
Cmd/Ctrl+]下一个标签

常见问题

安装与认证

Q: 如何安装 Codex CLI？

使用 npm 或 Homebrew：

npm install -g @openai/codex
# 或
brew install codex

Q: 首次使用如何认证？

运行 codex 命令会自动打开浏览器进行认证，使用 ChatGPT 账号或 API Key 登录。

Q: Windows 支持情况？

Windows 原生支持为实验性，推荐使用 WSL2 获得最佳体验。

使用问题

Q: 如何查看当前配置？

使用 /status 命令查看当前会话的配置和状态。

Q: 如何禁用替代屏幕？

使用 codex --no-alt-screen 或配置 alternate_screen = "never"。

Q: 命令找不到怎么办？

确保 PATH 包含 npm 全局安装目录，或使用 Homebrew 安装。

Q: 如何查看日志？

日志位于 ~/.codex/log/ 目录。

功能问题

Q: exec 和交互模式的区别？

exec 单次执行后退出，适合自动化脚本；交互模式持续对话，适合日常开发。

Q: 如何恢复历史会话？

使用 /resume 命令或 codex resume --last。

Q: GitHub Action 可以修改文件吗？

可以，设置 sandbox: workspace-write。

Q: CI/CD 中如何认证？

使用 CODEX_API_KEY 环境变量，作为 Secrets 存储。

安全问题

Q: 如何防止 Codex 删除重要文件？

使用 read-only 或 workspace-write 沙箱模式，配置 Rules 禁止危险命令。

Q: full-auto 模式安全吗？

full-auto 会自动执行所有操作，包括删除文件，请谨慎使用。

Q: 如何处理敏感数据？

使用 Secrets 存储，仅在设置脚本中可用。

版本更新

近期更新

版本日期更新内容
v1.5.02026-04新增 GPT-5.4 系列模型支持
v1.4.02026-03改进 Worktree 功能
v1.3.02026-02新增 Review Mode
v1.2.02026-01优化 MCP Server 支持
v1.1.02025-12新增 GitHub 集成
v1.0.02025-11Codex 正式发布

更新 CLI

更新命令

# npm 更新
npm install -g @openai/codex@latest

# Homebrew 更新
brew upgrade codex

# 查看当前版本
codex --version

相关资源

官方资源

资源地址
官方文档https://developers.openai.com/codex
GitHubhttps://github.com/openai/codex
Codex Webhttps://chatgpt.com/codex
Discordhttps://discord.gg/openai

教程系列

章节标题内容
01Codex 入门核心能力、计划对比
02核心概念Prompt、Thread、Context、Sandbox
03桌面应用App 功能、Review 模式
04IDE 扩展VS Code、Cursor、Windsurf
05命令行工具CLI 安装、TUI、Approval
06云端版本Web 界面、Environments
07集成与连接GitHub、Slack、Linear、MCP
08配置与定制Config、Rules、Skills
09自动化与 CI/CDexec、SDK、GitHub Action
10工作流模式开发流程、重构、Bug 修复
11提示词最佳实践Prompt 结构、任务拆解
12安全与企业管理沙箱、权限、审计日志
13模型选择GPT-5.4 系列、推理强度
14附录命令速查表、常见问题

术语表

术语说明
AgentCodex 的核心执行单元，能理解任务并执行操作
Prompt用户发送给 Codex的任务指令
Thread会话序列，包含完整的对话历史
ContextCodex 可用的信息范围，包括文件、对话、配置
Sandbox隔离执行环境，限制 Codex 的操作范围
Approval审批策略，控制操作执行前的确认行为
AGENTS.md项目指令文件，定义 Codex 的行为规范
Skill可复用的自定义能力模块
Subagent子代理，用于并行处理复杂任务
Rules规则引擎，定义命令执行权限
MCPModel Context Protocol，连接外部工具的协议
WorktreeGit 工作树，用于隔离不同任务的工作目录

反馈与支持

获取帮助

  • 使用 /help 命令查看内置帮助
  • 访问官方文档了解详细说明
  • 加入 Discord 社区交流讨论

报告问题

Codex 持续更新迭代，关注官方渠道获取最新信息。