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.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

---

相关资源

官方资源

资源	地址
官方文档	https://developers.openai.com/codex
GitHub	https://github.com/openai/codex
Codex Web	https://chatgpt.com/codex
Discord	https://discord.gg/openai

教程系列

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

---

术语表

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

---

反馈与支持

获取帮助

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

报告问题

• GitHub Issues：提交 Bug 或功能请求
• 通过 Codex 反馈功能提交建议

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