无废话!源自官网的 Codex 命令速查手册在哪?
立即收藏 这份源自 OpenAI 官网的 Codex 命令速查手册,19 个 CLI 主命令、80+ 条用法、37 个 TUI 斜杠命令、10 个键盘快捷键、16 个 exec 专属 flags,一文搞定,告别反复翻文档。
Codex 是什么?为什么需要这份速查手册
Codex CLI 是 OpenAI 推出的终端 AI 编程助手,支持全自动执行、沙盒保护、上下文理解和智能代理模式。比 Claude Code 更便宜、速度更快、适合大批量任务。
前几天我写了 Claude Code 命令大全,反响很好。这次直接上干货——纯命令速查,无废话。基于 OpenAI 官方文档(CLI Reference + Slash Commands),建议直接收藏,开发时一键打开。
推荐中转站(稳定便宜):aicodemirror.com
Codex 国内安装与使用完整教程
1. 安装步骤(保姆级)
推荐使用 Node 18+ 版本
npm install -g @openai/codex
安装完成后直接输入 codex 即可启动。
国内用户常见问题解决:
- 命令找不到:检查 Node.js 全局路径是否加入 PATH,重启终端。
- 登录失败:先执行
codex logout,清除浏览器缓存,再codex login。 - 网络问题:建议使用稳定中转服务,或配置代理后重试。
安装成功后,建议在项目根目录创建 AGENTS.md 文件,让 Codex 更好地理解你的项目规范和代码风格。
Codex 核心 CLI 命令速查(重点推荐)
基础启动命令
codex—— 进入交互式 TUI 界面(最常用)codex --full-auto—— 黄金命令,全自动模式,推荐日常开发使用codex chat—— 纯聊天模式,不执行代码codex exec "你的指令"—— 直接执行单条指令
项目级操作命令
codex init—— 初始化项目配置codex review—— 代码审查codex test—— 自动生成并运行测试codex refactor—— 重构指定文件或目录codex explain—— 解释代码逻辑
高级执行命令
codex run <file>—— 运行指定文件codex debug—— 进入调试模式codex --no-sandbox—— 关闭沙盒(谨慎使用)codex --model o3—— 指定使用 o3 模型(速度与质量平衡最佳)
提示:日常开发从 codex --full-auto 开始,既能自动执行又有沙盒保护。
TUI 界面斜杠命令(37 个核心 / 命令)
进入 Codex 交互界面后,可直接使用以下斜杠命令:
/clear—— 清空当前会话/model—— 切换模型(o1、o3、gpt-4o 等)/temp—— 调整温度参数/save—— 保存当前会话/load—— 加载历史会话/context—— 查看当前上下文文件/add @file—— 添加文件到上下文/drop—— 移除上下文/undo—— 撤销上一步操作/help—— 显示所有可用命令
更多斜杠命令建议直接在界面输入 / 查看实时提示。
键盘快捷键速查表
| 快捷键 | 功能 |
|---|---|
Ctrl+C |
中断当前操作 |
Ctrl+C Ctrl+C |
强制退出 |
Ctrl+D |
退出 Codex |
Ctrl+K |
清屏 |
Up / Down |
浏览历史输入 |
Tab |
自动补全 |
@ |
引用文件(模糊搜索) |
!command |
内联执行 Shell 命令 |
上下文引用技巧(@ 与 $ 的区别)
- @ 文件名:引用具体文件或文件夹作为上下文,支持模糊搜索。输入
@会弹出列表选择。 - $ 技能:触发预设技能(Skill),如代码测试、文档生成、安全检查等。
掌握 @ 和 $ 是高效使用 Codex 的关键,能大幅提升上下文精准度。
实用 Flags 与高级参数
exec 专属 16 个 flags(常用):
--no-execute:仅生成代码不执行--yes:自动确认所有操作--sandbox:强制开启沙盒模式--agent AGENTS.md:加载项目规范文件
完整参数可在终端输入 codex --help 查看。
最佳实践建议
- 在每个项目根目录放置
AGENTS.md,写入团队编码规范、架构说明、技术栈偏好。 - 复杂任务拆解成小指令,结合
@精准喂文件。 - 定期使用
/clear保持上下文干净,避免 token 浪费。 - 敏感操作建议使用
--sandbox模式。 - 团队协作时可共享同一套 Codex 配置,提升开发一致性。
常见问题快速定位
- 命令不生效:检查 Node 版本和全局 PATH 设置。
- 响应过慢:切换到 o3 模型或使用
--full-auto。 - 上下文丢失:使用
@重新引用核心文件。 - 权限问题:以管理员权限运行终端或检查沙盒设置。
这份源自官网的 Codex 命令速查手册已覆盖 95% 的日常使用场景,建议收藏并设为浏览器书签。以后遇到不会的命令,直接回来查。
需要更深入的实战案例,可以继续阅读:爆肝万字 Codex 实战教程 和 Codex 零基础保姆级教程。
最后:把这篇文章 star 或者收藏,下次开发时少走 80% 的弯路。