Codex: Codex 斜杆命令与速查表
最后更新：2026-08-31
Codex 提供丰富的斜杆命令（Slash Commands），让你快速执行常见操作，无需退出对话。
📋 前置知识：已完成 Codex 基本使用（见第 3 课）
1. 你将学到
- 所有斜杆命令详解
- 命令行参数
- 速查表
2. 斜杆命令一览
(1) 会话管理
| 命令 | 说明 |
|---|---|
/new |
开始新会话 |
/clear |
清空当前对话历史 |
/status |
查看会话状态、上下文使用量 |
/compact |
手动压缩上下文 |
/quit |
退出 Codex |
(2) 文件操作
| 命令 | 说明 |
|---|---|
/read <file> |
读取文件内容 |
/add <file> |
添加文件到上下文 |
/remove <file> |
从上下文移除文件 |
/diff |
查看当前未提交的修改 |
(3) 模式切换
| 命令 | 说明 |
|---|---|
/mode suggest |
切换到 Suggest 模式 |
/mode auto-edit |
切换到 Auto Edit 模式 |
/mode full-auto |
切换到 Full Auto 模式 |
(4) 信息查看
| 命令 | 说明 |
|---|---|
/help |
查看帮助信息 |
/version |
查看版本号 |
/config |
查看当前配置 |
/models |
查看可用模型列表 |
/history |
查看对话历史 |
3. 命令行参数
(1) 启动参数
BASH
# 基本启动
codex
# 指定模型
codex --model gpt-5-codex
# 指定沙箱模式
codex --sandbox workspace-write
# 指定审批策略
codex --approval-policy ask
# Full Auto 模式
codex --full-auto
# Auto Edit 模式
codex --auto-edit
(2) 常用参数
| 参数 | 说明 | 示例 |
|---|---|---|
--model |
指定模型 | --model o3 |
--sandbox |
沙箱模式 | --sandbox readonly |
--approval-policy |
审批策略 | --approval-policy ask |
--auto-edit |
Auto Edit 模式 | — |
--full-auto |
Full Auto 模式 | — |
--quiet |
静默模式 | — |
--version |
查看版本 | — |
--help |
查看帮助 | — |
--upgrade |
更新 Codex | — |
4. 速查表
(1) 快速启动
BASH
codex # 默认模式启动
codex "修复登录 bug" # 直接提交任务
codex --model deepseek-coder # 指定模型
codex --full-auto "运行测试" # Full Auto + 任务
(2) 会话内操作
TEXT
📖 仅展示
/new 新会话
/status 查看状态
/compact 压缩上下文
/mode full-auto 切换模式
/add src/auth.ts 添加上下文
/diff 查看修改
(3) 任务模板
TEXT
📖 仅展示
# 修复 Bug
"修复 <文件> 中的 <问题>，确保测试通过"
# 添加功能
"在 <模块> 添加 <功能>，参考 <已有文件> 的风格"
# 重构代码
"将 <旧实现> 重构为 <新实现>，保持功能一致，确保测试通过"
# 写测试
"为 <文件> 编写单元测试，覆盖正常流程和边缘情况"
# 代码审查
"审查 <文件/PR>，关注安全性、性能和可维护性"
5. 高级命令
(1) 上下文管理
TEXT
📖 仅展示
/add src/**/*.ts 添加所有 TypeScript 文件
/remove src/test.ts 移除测试文件
/status 查看上下文使用量
/compact 手动压缩
(2) 多任务管理（App 模式）
TEXT
📖 仅展示
/tasks 列出所有任务
/task new 创建新任务
/task switch <id> 切换任务
/task cancel <id> 取消任务
▶ 示例 1: Alice 的高效操作流
TEXT
📖 仅展示
# Alice 开始工作
/new # 新会话
/add src/auth.ts src/user.ts # 添加上下文
"将认证从 Session 迁移到 JWT" # 提交任务
# 任务完成后
/diff # 查看修改
/status # 检查上下文
/compact # 压缩历史
# 继续下一个任务
"为 JWT 认证添加刷新令牌功能"
❓ 常见问题
Q 斜杆命令区分大小写吗？
A 不区分。
/New 和 /new 效果相同。Q 可以在任务描述中使用斜杆命令吗？
A 不可以。斜杆命令必须单独输入，不能嵌入在任务描述中。
Q 如何查看所有可用命令？
A 输入
/help 查看完整列表。Q
/compact 会丢失信息吗？A 会压缩不太重要的历史细节，但核心上下文保留。如果发现 Codex 遗忘了关键信息，用
/add 重新添加。Q 可以用自定义斜杆命令吗？
A 目前不支持自定义斜杆命令，但可以通过 AGENTS.md 和 Skills 实现类似效果。
📖 小节
- 斜杆命令：会话管理 / 文件操作 / 模式切换 / 信息查看
- 启动参数：
--model/--sandbox/--approval-policy - 任务模板：修复 Bug / 添加功能 / 重构 / 测试 / 审查
- 善用
/status和/compact管理上下文
📝 作业
- 基础题（难度⭐）：使用至少 5 个斜杆命令，记录每个命令的效果。
- 进阶题（难度⭐⭐）：用任务模板完成一个完整功能开发，从添加功能到写测试到代码审查。
- 挑战题（难度⭐⭐⭐）：整理一份你自己的 Codex 速查卡，包含你最常用的命令和任务模板。
