OpenAI Codex CLI「/斜杠命令」完全操作指南 — 每一个命令都给你讲透 说明本文详细拆解 Codex CLI 交互模式下的全部/斜杠命令每个命令都包含功能说明、语法格式、参数详解、使用场景、实操示例和注意事项。建议收藏备查。 目录文章目录 OpenAI Codex CLI「/斜杠命令」完全操作指南 — 每一个命令都给你讲透 目录[toc]一、什么是「/斜杠命令」 斜杠命令 vs 自然语言的区别二、命令总览速查表三、每个命令详细拆解3.1 /help — 帮助信息 基本说明️ 实操演示 使用建议3.2 /model — 查看与切换模型 基本说明️ 实操演示 常见模型名称参考 实战场景⚠️ 注意事项3.3 /approval — 查看与切换审批模式 基本说明️ 实操演示 三种模式对比 实战场景⚠️ 注意事项3.4 /context — 查看上下文窗口使用情况 基本说明️ 实操演示 实战场景⚠️ 注意事项3.5 /clear — 清空对话历史 基本说明️ 实操演示 什么时候该用 /clear /clear vs /compact 的区别3.6 /history — 查看对话历史 基本说明️ 实操演示 使用场景3.7 /undo — 撤销上一次文件修改 ⭐ 最重要的安全命令 基本说明️ 实操演示一、什么是「/斜杠命令」在 Codex CLI 的交互模式直接输入codex回车进入中除了用自然语言对话还可以输入以/开头的元命令来控制 Codex 自身的行为。# 先进入交互模式cdyour-project codex# 然后就可以使用 / 命令了/help/model o3/diff 斜杠命令 vs 自然语言的区别┌─────────────────────────────────────────────────────────┐ │ 自然语言输入 │ │ 帮我重构 auth.py → 发送给 AI 模型处理 │ │ │ │ / 斜杠命令 │ │ /model o3 → 由 Codex 客户端本地处理 │ │ 不消耗 Token不发送给 AI │ └─────────────────────────────────────────────────────────┘二、命令总览速查表命令作用消耗Token/help显示帮助信息❌/model查看/切换模型❌/approval查看/切换审批模式❌/context查看上下文使用情况❌/clear清空对话历史❌/history查看对话历史记录❌/undo撤销上一次文件修改❌/diff查看本次会话所有文件改动❌/compact压缩对话历史释放上下文窗口⚠️ 少量/bug提交 Bug 报告❌/quit/exit退出 Codex❌三、每个命令详细拆解3.1/help— 帮助信息 基本说明功能显示所有可用的斜杠命令及简要说明 语法/help 参数无 别名无️ 实操演示/help Available commands: /help Show thishelpmessage /model Show or change the current model /approval Show or change the approval mode /context Show context window usage /clear Clear conversationhistory/history Show conversationhistory/undo Undo the lastfilechange /diff Show allfilechangesinthis session /compact Compact conversationhistory/bug Report a bug /quit Exit Codex 使用建议✅ 刚开始用 Codex 时第一个敲的命令 ✅ 忘记某个命令的名字时查一下 ✅ 不消耗任何 Token3.2/model— 查看与切换模型 基本说明功能查看当前使用的模型 / 实时切换到其他模型 语法 /model ← 查看当前模型 /model model_name ← 切换到指定模型 参数model_name — 目标模型的名称️ 实操演示# 查看当前模型/model Current model: o4-mini# 切换到 GPT-4.1/model gpt-4.1 Model changed to: gpt-4.1 ✓# 切换到 o3最强推理/model o3 Model changed to: o3 ✓# 切换回便宜的模型/model o4-mini Model changed to: o4-mini ✓ 常见模型名称参考# OpenAI 官方模型/model o4-mini# 默认快速便宜日常首选/model o3# 最强推理复杂任务用/model gpt-4.1# 综合能力强/model gpt-4.1-mini# 4.1 的轻量版/model gpt-4.1-nano# 最便宜简单任务用# 如果配置了其他 Provider/model deepseek-coder-v2# Ollama 本地模型/model claude-sonnet-4# 通过 OpenRouter/model gemini-2.5-pro# Google Gemini 实战场景# 场景1先用便宜模型探索再用强模型精修/model o4-mini帮我分析这个项目的架构# ... 看完分析结果觉得需要更深入的设计 .../model o3基于刚才的分析设计一个更好的微服务拆分方案# 场景2写注释用便宜的写核心逻辑用贵的/model gpt-4.1-nano给 src/utils.py 的所有函数加上 docstring/model gpt-4.1实现 src/auth.py 的 JWT 认证逻辑注意安全性⚠️ 注意事项1. 切换模型后之前的对话历史会保留在上下文中 2. 不同模型的上下文窗口大小不同切换后可能需要 /compact 3. 如果模型名称输错会报错提示 4. 切换模型不会中断当前会话 5. 切换到本地模型如 Ollama需要先在配置中设置好 provider3.3/approval— 查看与切换审批模式 基本说明功能查看当前审批模式 / 实时切换审批权限级别 语法 /approval ← 查看当前模式 /approval mode ← 切换到指定模式 参数mode — suggest | auto-edit | full-auto️ 实操演示# 查看当前模式/approval Current approval mode: suggest# 切换到自动编辑/approval auto-edit Approval mode changed to: auto-edit ✓# 切换到全自动/approval full-auto Approval mode changed to: full-auto ✓ ⚠️ Warning: Codex will now automatically execute commandsinsandbox.# 切回保守模式/approval suggest Approval mode changed to: suggest ✓ 三种模式对比┌──────────────────────────────────────────────────────────┐ │ /approval suggest │ │ ├── 读文件: ✅ 自动 │ │ ├── 改文件: ❌ 每次都问你 │ │ ├── 跑命令: ❌ 每次都问你 │ │ └── 适合初次接触项目、生产环境、不确定 AI 会干啥时 │ ├──────────────────────────────────────────────────────────┤ │ /approval auto-edit │ │ ├── 读文件: ✅ 自动 │ │ ├── 改文件: ✅ 自动执行 │ │ ├── 跑命令: ❌ 每次都问你 │ │ └── 适合日常开发信任 AI 改代码但命令要自己把关 │ ├──────────────────────────────────────────────────────────┤ │ /approval full-auto │ │ ├── 读文件: ✅ 自动 │ │ ├── 改文件: ✅ 自动执行 │ │ ├── 跑命令: ✅ 自动执行沙箱内 │ │ └── 适合有 Git 保底、跑测试修 Bug、自动化流水线 │ └──────────────────────────────────────────────────────────┘ 实战场景# 场景从保守到激进逐步放权# 第一步先用 suggest 看看 AI 打算怎么改/approval suggest优化 src/database.py 的连接池管理# AI 展示了修改方案你看了觉得靠谱 ...# 第二步切换到 auto-edit 让它动手/approval auto-edit按你刚才的方案来改吧# AI 自动编辑文件 ✓# 第三步需要跑测试了切到 full-auto/approval full-auto运行 pytest 确认改动没有破坏已有功能# AI 自动执行 pytest 并报告结果 ✓⚠️ 注意事项1. suggest → auto-edit → full-auto 权限递增随时可切 2. full-auto 模式下命令在沙箱中运行但仍需谨慎 3. 建议在有 Git 版本控制的项目中才使用 full-auto 4. 模式切换立即生效不影响已有对话历史 5. 可以在 config.yaml 中设置默认模式免得每次手动切3.4/context— 查看上下文窗口使用情况 基本说明功能显示当前对话消耗了多少上下文窗口Token 用量 语法/context 参数无️ 实操演示/context Context window usage: Model: o4-mini Max tokens:128,000Used tokens:23,456(18.3%)Remaining:104,544(81.7%)Breakdown: System prompt:1,200(0.9%)Instructions:800(0.6%)Conversation:18,456(14.4%)File contents:3,000(2.3%)██████░░░░░░░░░░░░░░░░░░░18.3% 实战场景# 场景1长时间对话后检查剩余空间/context# 发现已经用了 85%该压缩了/compact# 场景2决定是否需要切换到更大上下文的模型/context# 发现 128k 快满了但任务还没完/model gpt-4.1# 切到支持更大上下文的模型# 场景3排查为什么 AI 忘记了之前的对话/context# 发现上下文已经 95%早期对话被截断了/compact# 或者 /clear 重新开始⚠️ 注意事项1. 上下文窗口满了之后AI 会遗忘最早的对话内容 2. 文件内容AI 读取的源码也占用上下文空间 3. 不同模型的上下文窗口大小不同 - o4-mini: 128k - gpt-4.1: 1M (超大) - o3: 200k 4. 接近上限时建议用 /compact 压缩或 /clear 重置 5. 项目越大文件越多上下文消耗越快3.5/clear— 清空对话历史 基本说明功能清空当前会话的全部对话历史回到初始状态 语法/clear 参数无️ 实操演示# 当前对话已经很长了/context Used tokens:98,000(76.6%)# 清空重来/clear Conversationhistorycleared. ✓ Starting fresh with system instructions only.# 验证/context Used tokens:2,000(1.6%)# 只剩系统指令的开销 什么时候该用/clear# ✅ 场景1切换到完全不同的任务帮我写认证模块# 前面聊了半天认证.../clear# 清掉认证相关的上下文帮我设计数据库表结构# 全新的任务# ✅ 场景2AI 产生了幻觉越聊越偏/clear# 直接清空从头来过# ✅ 场景3上下文快满了/context# 95% 了/clear# 清空释放空间# ❌ 不该用的场景任务还没做完就 clear# 如果只是想节省上下文用 /compact 更好/clearvs/compact的区别┌────────────────────────────────────────┐ │ /clear │ │ - 彻底删除所有对话记录 │ │ - AI 完全忘记之前聊了什么 │ │ - 上下文几乎回到 0 │ │ - 适合换任务、重头来过 │ ├────────────────────────────────────────┤ │ /compact │ │ - 压缩对话保留关键信息摘要 │ │ - AI 还记得大概聊了什么 │ │ - 上下文显著减少但不归零 │ │ - 适合继续当前任务但省空间 │ └────────────────────────────────────────┘3.6/history— 查看对话历史 基本说明功能显示当前会话中的完整对话历史记录 语法/history 参数无️ 实操演示/historyConversation History[1]User: 帮我看看 src/auth.py 的代码质量[2]Assistant: 我来分析一下 src/auth.py...(阅读了 src/auth.py)发现以下问题1. login()函数没有限流2. 密码没有使用 bcrypt 加密3. JWT token 没有设置过期时间...[3]User: 修复问题1和2[4]Assistant: 好的我来修复这两个问题。(修改了 src/auth.py)(修改了 requirements.txt — 添加了 bcrypt)...[5]User: /history ← 你在这里End of History(5messages,12,345tokens) 使用场景# 场景1回顾 AI 做了哪些修改/history# 可以看到完整的对话流程和每一步的操作# 场景2写工作日志/周报时回顾/history# 复制关键内容作为开发记录# 场景3调试 — AI 的回答不对看看上下文是什么/history# 检查是否有误导 AI 的对话内容3.7/undo— 撤销上一次文件修改 ⭐ 最重要的安全命令 基本说明功能撤销 Codex 最近一次对文件的修改恢复到修改前的状态 语法/undo 参数无️ 实操演示# AI 修改了文件把 src/config.py 中的数据库连接改成环境变量读取