Codex: Codex App 界面说明
最后更新：2026-08-31
Codex App 采用经典三栏布局，是功能最完整的使用方式。本节详细介绍每个区域的功能。
📋 前置知识：已安装 Codex App（见第 2 课）
1. 你将学到
- 三栏布局结构
- 左侧任务列表功能
- 中间对话窗口操作
- 右侧多功能区使用
2. 整体布局
Codex App 采用三栏布局：
| 区域 | 位置 | 功能 |
|---|---|---|
| 任务列表 | 左侧 | 管理多个并行任务 |
| 对话窗口 | 中间 | 与 Codex 交互的主区域 |
| 多功能区 | 右侧 | 文件浏览、终端、代码查看 |
3. 左侧：任务列表
(1) 功能说明
- 创建新任务
- 切换不同任务
- 查看任务状态（进行中 / 已完成 / 失败）
- 删除任务
(2) 任务状态
| 状态 | 图标 | 说明 |
|---|---|---|
| 运行中 | 🔄 | Codex 正在执行任务 |
| 已完成 | ✅ | 任务成功完成 |
| 等待确认 | ⏸ | 需要 Approve 操作 |
| 失败 | ❌ | 执行出错 |
| 已取消 | ⏹ | 用户手动取消 |
▶ 示例 1: Alice 管理并行任务
TEXT
📖 仅展示
Alice 同时处理三个任务：
🔄 Task 1: 重构认证模块
⏸ Task 2: 修复支付 Bug（等待确认删除文件）
✅ Task 3: 添加日志功能（已完成）
点击 Task 2 → 在对话窗口中审查操作 → 点击 Approve
4. 中间：对话窗口
(1) 输入区域
- 文本输入框：输入任务描述或追加指令
- 附件按钮：附加文件、图片作为上下文
- 发送按钮：提交任务
(2) 消息类型
| 类型 | 说明 |
|---|---|
| 用户消息 | 你输入的任务描述 |
| Codex 回复 | Codex 的操作说明和结果 |
| 文件修改 | 显示代码 diff |
| 命令执行 | 显示 shell 命令及输出 |
| 确认请求 | 需要你 Approve/Reject 的操作 |
(3) 操作按钮
| 按钮 | 说明 |
|---|---|
| Approve | 批准 Codex 的操作 |
| Reject | 拒绝操作 |
| Edit | 修改 Codex 提议的代码 |
| Retry | 让 Codex 重新尝试 |
▶ 示例 2: 审查代码修改
DIFF
--- a/src/auth/login.ts
+++ b/src/auth/login.ts
@@ -15,3 +15,8 @@
return jwt.sign(payload, secret);
+}
+
+export function verifyToken(token: string): JwtPayload {
+ return jwt.verify(token, secret) as JwtPayload;
}
[Approve] [Reject] [Edit]
5. 右侧：多功能区
(1) 文件浏览器
- 浏览项目文件树
- 查看 Codex 修改了哪些文件
- 点击文件查看内容
(2) 终端面板
- 查看 Codex 执行的命令
- 查看命令输出
- 手动输入命令
(3) 代码查看器
- 查看文件完整内容
- 查看 diff 对比
- 语法高亮
(4) 上下文面板
- 查看当前使用的上下文文件
- 手动添加/移除上下文
- 查看上下文窗口使用量
6. 顶部工具栏
| 功能 | 说明 |
|---|---|
| 模型选择 | 切换使用的 AI 模型 |
| 沙箱模式 | 切换 Suggest / Auto Edit / Full Auto |
| 项目选择 | 切换当前工作项目 |
| 设置 | 打开设置面板 |
7. 快捷键
| 快捷键 | 功能 |
|---|---|
Cmd/Ctrl+N |
新建任务 |
Cmd/Ctrl+Enter |
发送消息 |
Cmd/Ctrl+Shift+A |
全部 Approve |
Cmd/Ctrl+Shift+R |
全部 Reject |
Cmd/Ctrl+1/2/3 |
切换右侧面板 |
Cmd/Ctrl+. |
中断当前任务 |
8. 设置面板
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 沙箱模式 | Suggest / Auto Edit / Full Auto | Suggest |
| 默认模型 | AI 模型选择 | gpt-5-codex |
| 自动保存 | 自动保存 Codex 修改 | 开启 |
| 主题 | 深色/浅色 | 跟随系统 |
| 字体大小 | 代码字体大小 | 14px |
❓ 常见问题
Q 可以同时运行多个任务吗？
A 可以。Codex App 支持多任务并行，每个任务在独立的沙箱中运行，互不干扰。
Q 对话窗口可以调整大小吗？
A 可以拖动面板边界调整各区域大小，也可以折叠左侧或右侧面板。
Q Codex 修改的文件在哪里查看？
A 右侧文件浏览器会标记修改过的文件，点击可查看 diff。对话窗口也会实时显示每次修改。
Q App 和 CLI 的功能一样吗？
A 核心功能相同，App 提供更丰富的 GUI 体验（文件浏览器、多任务管理），CLI 更适合终端用户和自动化场景。
Q 如何关闭一个正在运行的任务？
A 在任务列表中右键点击任务，选择 Cancel，或使用快捷键 Cmd/Ctrl+.。
📖 小节
- 三栏布局：任务列表 + 对话窗口 + 多功能区
- 左侧管理并行任务，中间与 Codex 交互
- 右侧查看文件、终端、代码变更
- 掌握快捷键提升操作效率
- 设置面板控制沙箱模式、模型等
📝 作业
- 基础题（难度⭐）：在 Codex App 中创建并完成一个简单任务，截图各区域界面。
- 进阶题（难度⭐⭐）：同时运行两个任务，观察并行执行的效果，记录任务状态变化。
- 挑战题（难度⭐⭐⭐）：自定义 Codex App 的设置，找到最适合你的配置方案并说明理由。
