Codex常用命令

Codex常用命令

陈拓 2026/6/12-2026/6/12

1. Codex常用命令精简速查

适配 Windows 终端、Codex 桌面端，结合Codex+CC-Switch+DeepSeek 开发场景，标注用途、使用场景与注意事项。

参考《Windows安装Codex并接入DeepSeek》

https://blog.csdn.net/chentuo2000/article/details/161900600

1.1 终端启动命令（系统 cmd/powershell 执行）

codex # 进入交互式会话

codex "你的指令" # 附带指令直接启动会话

codex --continue # 继续上一次会话

codex --resume # 选择历史会话恢复

codex --version # 查看版本

codex exec "指令" # 非交互单次执行

1.2 会话内置斜杠命令（Codex 对话内输入 /xxx）

1.2.1 会话上下文

/compact 压缩历史、清理冗余/脏字段（解决image_url、上下文溢出）

/clear 清空当前对话，保留会话

/new 新建空白会话

/fork 基于当前会话新建分支

/side 打开侧边临时对话

/status 查看Token、会话状态

/save 保存当前会话

/exit 退出会话

1.2.2 模型 & 推理

/model 切换模型

/reasoning low 低推理（简单任务）

/reasoning medium 中等推理（日常开发推荐）

/reasoning high 高推理（复杂代码/架构）

/plan 先输出方案，确认再执行

1.2.3 文件 & 工具

@文件名 读取指定文件加载上下文

/review 代码审查

/edit 编辑项目文件

/settings 打开设置

/help 查看全部命令

1.2.4 全局快捷键

Ctrl+L 清空输入框

Ctrl+R 检索历史指令

Ctrl+S 保存会话

Esc 取消当前输入

2. Codex常用命令细说明

2.1 系统终端启动命令（CMD / PowerShell 执行）

• codex

功能：进入交互式会话模式，持续对话、编写代码、执行任务。

使用场景：日常本地开发、功能迭代、调试问题。

• codex "你的指令内容"

功能：启动会话并自动执行一条预设指令。

示例：codex "分析当前项目目录结构"

使用场景：单次快速查询、临时简单任务。

• codex --continue

功能：自动载入上一次关闭的会话，完整保留历史上下文与代码记录。

使用场景：中途退出后，继续未完成的开发任务。

• codex --resume

功能：列出全部历史会话，手动选择指定会话进入。

使用场景：多项目切换、找回历史开发记录。

• codex --version

功能：查看当前 Codex 客户端版本号。

使用场景：版本核对、软件兼容性排查。

• codex exec "指令"

功能：非交互式单次执行指令，执行完成后直接退出终端。

使用场景：自动化脚本、流水线调用、批量任务。

2.2 内置斜杠命令（Codex 对话窗口内输入 /xxx）

2.2.1 会话与上下文管理（重点：解决 image_url 报错、上下文溢出）

• /compact

功能：精简压缩历史对话，提炼核心内容，剔除冗余文本、无效字段。

核心作用：降低 Token 占用、清理残留 image_url 图片字段，修复接口 400 报错。

使用场景：会话卡顿、内容过长、出现图片字段解析错误。

• /clear

功能：清空当前会话所有问答记录，保留会话窗口、项目目录与权限配置。

区别：不新建会话，原有项目环境不变。

使用场景：同一项目内切换新功能开发。

• /new

功能：创建全新空白会话，上下文完全隔离。

使用场景：/compact 清理无效、脏数据无法清除时，新建会话接续任务。

• /fork

功能：基于当前会话克隆分支会话，主线会话不受影响。

使用场景：同一套代码尝试多种实现方案、对比不同逻辑写法。

• /side

功能：开启独立侧边临时对话，不干扰主会话流程。

使用场景：临时查询语法、编写小代码片段、临时答疑。

• /status

功能：查看会话实时状态：Token 用量、上下文长度、当前使用模型、路由状态。

使用场景：判断会话是否过载、确认当前运行模型。

• /save

功能：手动将当前会话保存至本地。

使用场景：重要开发节点、防止意外丢失记录。

• /exit

功能：退出当前 Codex 会话，返回系统终端。

2.2.2 模型与推理控制（代码开发专用）

• /model

功能：调出模型选择列表，快速切换已配置模型。

适配说明：可切换 deepseek-v4-pro、deepseek-coder 等模型。

使用场景：简单代码用代码专项模型，复杂架构用综合大模型。

• /reasoning low

功能：低强度推理，响应速度快、资源消耗低。

使用场景：简单问答、单行代码补全、基础脚本编写。

• /reasoning medium

功能：中等推理强度，速度与逻辑能力均衡。

推荐：日常软件开发默认档位。

• /reasoning high

功能：高强度推理，逻辑分析、问题拆解能力更强，响应耗时略增加。

使用场景：复杂算法开发、项目重构、架构设计、深度 Bug 排查。

• /plan

功能：优先输出完整执行方案、步骤规划、目录结构，人工确认后再编码。

使用场景：新项目初始化、大型功能开发、代码重构，有效减少返工。

2.2.3 文件与代码操作（工程开发常用）

• @文件名（等价 /mention 文件名）

功能：自动读取指定文件全部内容，加载到会话上下文。

示例：@main.py、@routes/book.py

使用场景：针对单个文件改代码、查 Bug、阅读源码。

• /review

功能：自动代码审查，检查语法错误、逻辑漏洞、代码规范、潜在风险。

使用场景：代码完成后自检、Git 提交前审核。

• /edit

功能：授权后直接在线编辑项目内文件。

前提：Codex 已开启「允许自动编辑文件」权限。

• /settings

功能：快速打开 Codex 系统设置面板。

使用场景：修改权限、关闭图片上传、调整界面配置。

• /help

功能：展示 Codex 全部内置斜杠命令及说明。

2.2.4 全局快捷键（图形端通用）

• Ctrl+L ：清空当前输入框内容
• Ctrl+R ：搜索历史指令、历史对话
• Ctrl+S ：快速保存当前会话
• Esc ：终止正在执行的任务、取消当前输入

3. 使用小贴士

• 常规开发搭配：新项目先用 /plan 做规划，会话臃肿执行 /compact 精简；
• 使用 DeepSeek 系列模型时，建议关闭图片上传功能，彻底杜绝解析报错；
• 多方案测试代码，优先使用 /fork 分支会话，无需反复新建会话。