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

---

命令速查表

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.0	2026-04	新增 GPT-5.4 系列模型支持
v1.4.0	2026-03	改进 Worktree 功能
v1.3.0	2026-02	新增 Review Mode
v1.2.0	2026-01	优化 MCP Server 支持
v1.1.0	2025-12	新增 GitHub 集成
v1.0.0	2025-11	Codex 正式发布

更新 CLI

更新命令

# npm 更新

npm install-g@openai/codex@latest

# Homebrew 更新

brew upgrade codex

# 查看当前版本

codex --version

---