官方原文索引： Codex CLI Features / Slash Commands / Interactive Mode
1. 核心架构与原理解析
Codex CLI 的交互界面是一个全屏终端 UI（TUI），基于 Rust 的终端渲染引擎构建。理解其输入模式是高效使用的前提：
| 输入类型 | 触发方式 | 用途 |
|---|---|---|
| 自然语言任务 | 直接输入 | 描述需求，Agent 规划执行 |
| 斜杠命令 | / 前缀 | 切换模型、查看状态、管理会话 |
| 文件引用 | @ 前缀 | 快速引用项目内文件，节省 Token |
| Shell 内联 | ! 前缀 | 不退出 Codex 执行临时命令 |
TUI 状态机：
2. 工程落地与代码示例
启动与退出
# 启动交互式 TUI
codex
# 启动并直接进入指定目录
codex --path ~/projects/my-api
# 启动并执行单条命令后退出
codex "解释 src/auth.ts 的作用"
# 退出
Ctrl+D 或 /quit
# 强制中断当前任务
Ctrl+C（按一次取消请求，按两次强制退出）高频斜杠命令速查表
会话控制
─────────
/new 开启新会话（保留上下文但切换主题）
/compact 压缩上下文（Token 预算紧张时使用）
/resume 恢复历史会话（选择器）
/resume --last 恢复最近会话
/fork 分叉当前会话（尝试不同方案）
/status 查看当前模型、Token 用量、配置
/export 导出当前会话为 markdown
配置与模型
───────────
/model 切换模型或推理级别（medium → high）
/approvals 切换审批模式（Read Only / Auto / Full Access）
/init 在当前项目生成 AGENTS.md 模板
/settings 打开配置文件
/config 查看当前配置
开发辅助
─────────
/diff 查看当前 Git 差异（含未跟踪文件）
/review 让另一个 Agent 审查你的代码
/plan 仅规划不执行（先看方案再动手）
/ask 只提问不执行任何文件操作
/mention 引用文件（等同于 @）
工具与集成
───────────
/mcp 查看已连接的 MCP 工具列表
/skills 浏览可用 Skill
/theme 切换 TUI 主题
/history 查看对话历史
/help 显示帮助信息
文件引用与多模态
# 在对话中引用文件（节省 Token，比粘贴代码更高效）
> 检查 @src/auth.ts 中的登录逻辑是否有漏洞
# 引用多个文件
> 对比 @src/old_parser.py 和 @src/new_parser.py 的差异
# 引用特定行范围
> 审查 @src/api.ts:45-60 的错误处理逻辑
# 附加图片（错误截图、设计稿）
codex -i screenshot.png "解释这个报错原因"
codex --image mockup.png "按照这个设计稿实现前端组件"
# 多图输入
codex -i design1.png -i design2.png "对比这两个设计稿的差异"管道与脚本化
# 管道输入：将 diff 传给 Codex 分析
git diff | codex exec "总结这些改动的风险点"
# 纯文本输出（适合脚本解析）
codex -z "列出所有 TODO" > todos.txt
# 结合其他命令的实用场景
cat error.log | codex exec "定位根因并给出修复方案"
find . -name "*.test.ts" | codex exec "检查这些测试文件是否有重复逻辑"会话管理实战
# 查看所有历史会话
codex resume
# 直接恢复最近会话
codex resume --last
# 在会话中压缩上下文（长对话 Token 不足时使用）
> /compact
# 导出会话供审计
> /export
# 导出到 ~/.codex/exports/session-2024-01-15.md3. 场景深入：高效 TUI 交互模式
场景：长会话的上下文管理
实战示例：
# 第 1 轮：分析项目
> 分析 src/ 目录的架构问题
# ... 10 轮对话后 ...
# Token 即将耗尽
> /status
# 显示：Context: 92% used
# 压缩上下文
> /compact
# Codex 总结前面的讨论，释放 Token 空间
# 继续深入
> 基于上面的分析，给出具体重构方案
场景：分叉会话对比方案
# 主会话：方案 A
> 用策略模式重构这个模块
# 发现不确定，分叉尝试方案 B
> /fork
# 新会话：方案 B
> 用函数组合替代策略模式重构
# 对比两个方案后，选择更好的合并回主会话
4. 💡 核心避坑与最佳实践 (Takeaways)
- 多用
@引用，少复制粘贴：引用文件比粘贴代码节省 30-50% Token，且定位更精确 /compact是省钱神器：长会话导致上下文膨胀时，压缩一次可恢复大量 Token 预算/plan先看方案再执行：对复杂任务先/plan，确认思路正确后再切到可写模式执行- Esc Esc 快速编辑上一条：说错了不用重新打字，按两次 Esc 直接修改上一条消息
- 善用管道模式：
git diff | codex exec是审查和生成 Changelog 的高效组合 - 定期
/export归档：重要会话导出为 Markdown，便于后续审计和知识沉淀