了解 Codex 桌面 App
最后核对日期
2026-05-30。客户端界面、设置入口和功能名称会随版本变化，请以你当前安装的 Codex 桌面 App 为准。
安装完成后，不要急着让 Codex 改真实项目。先把界面分区看懂，你后面遇到权限、日志、插件、任务状态、设置入口时才不会乱点。Codex 桌面 App 不是只有一个输入框，它把“聊天、项目、工具、权限、环境和任务记录”放在同一个工作台里。
这篇解决什么问题
本章按入门教程的原有顺序，先认识 Chat、Project、输入框、工作目录、权限提示、设置入口和常见设置项。理解这些之后，再开始第一个任务会稳很多。
左侧一般会看到对话、项目、插件、自动化等入口。不同版本名称可能不完全一致，但核心逻辑差不多：普通问答放在 Chat，需要读写本地文件的任务放在 Project。
Project 对应本地工作目录，同一个项目下的对话可以共享文件上下文。你在项目里下达的修改任务，通常会直接落到这个目录里的真实文件上。
输入框附近通常会有添加上下文、模型选择、权限设置和工作目录等入口。新手每次发送任务前，至少看一眼当前目录和权限模式。
适合谁
- 刚装好 Codex 桌面 App，还不知道每个区域干什么的人。
- 想区分“普通聊天”和“项目任务”的新手。
- 准备使用插件、MCP、权限管理和自动化的人。
- 想知道设置面板里哪些选项该动、哪些选项先别动的人。
前置条件
- 已完成 Codex 桌面 App 安装和登录。
- 准备一个测试目录。
- 能接受界面截图和你当前版本略有差异。
操作步骤
- 打开 Codex 桌面 App，先看左侧入口。
- 区分 Chat 和 Project：Chat 适合一次性问答，Project 适合操作本地文件。
- 在 Project 里选择一个测试工作目录。
- 查看输入框附近的模型、权限、上下文和目录入口。
- 发起只读任务，观察任务状态、日志和权限弹窗。
- 打开设置面板，确认外观、权限、MCP、Git、浏览器等入口位置。
Chat 和 Project 怎么选
| 入口 | 适合做什么 | 不适合做什么 |
|---|---|---|
| Chat | 一次性问答、概念解释、提示词润色、临时分析 | 长期维护一个本地项目、连续修改同一批文件 |
| Project | 读写本地目录、生成代码或文档、连续迭代、多个对话共享同一工作目录 | 没有明确目录边界的闲聊 |
如果你不确定选哪个，凡是涉及“读取这个文件夹”“帮我改这个页面”“帮我跑测试”“整理这个项目”的，都优先放到 Project。这样后续新建对话时，仍然可以围绕同一个工作目录继续推进。
输入框附近重点看什么
新手不需要一次把所有按钮都研究透，但下面四个入口建议先认识：
- 上下文：上传截图、文件或说明，让 Codex 看到更多背景。
- 模型：不同模型速度、成本和能力不同，遇到复杂任务再考虑切换。
- 权限：控制 Codex 能否自动改文件、运行命令、联网或请求更高权限。
- 工作目录：决定 Codex 到底在操作哪个文件夹。
发送任务前看一眼工作目录，是最便宜的安全习惯。很多“怎么把别的项目改坏了”的问题，都不是模型问题，而是目录选错了。
设置面板怎么理解
设置面板不需要像考试一样一次填完。建议按下面这张表理解：
| 设置项 | 你应该怎么想 |
|---|---|
| 常规 | 默认工作模式、回答风格、基础权限，新手先用保守配置 |
| 外观 | 只影响显示，不影响能力 |
| 配置 | 模型、推理、沙盒、审批、网络等高级项，不懂先别乱改 |
| 个性化 | 放个人协作偏好，不放项目规则 |
| MCP 服务器 | 连接外部工具，先从只读、低风险工具开始 |
| Git | 真实项目的安全网，任务前后都看 diff 和状态 |
| 环境 | 记录项目启动、安装、测试所需步骤 |
| 浏览器 | 适合网页预览和前端验收，线上页面要控制操作边界 |
| 电脑操控 | 风险更高，首次只用于观察、截图和低风险点击 |
| 使用情况 | 遇到限流、额度、并发问题时优先检查 |
新手先检查四件事
- 当前是在 Chat 还是 Project。
- Project 绑定的是不是正确工作目录。
- 当前权限是不是只满足这次任务，而不是长期最大权限。
- 任务失败时能不能找到日志、终端输出或阶段总结。
截图不是推荐配置
教程截图只说明入口位置，不代表所有开关都应该照着打开。尤其是完全访问、浏览器控制、电脑操控、MCP、钩子和自动化，第一次使用都应该按任务逐步开启。
什么时候需要改设置
| 你遇到的情况 | 优先检查 |
|---|---|
| Codex 回答太技术或太简略 | 常规、个性化 |
| 每次都询问同一个安全命令 | 权限、配置、项目规则 |
| 需要连接 Figma、Notion、飞书、数据库 | MCP 或插件 |
| 希望任务结束后自动跑测试 | 环境、钩子、自动化 |
| 想并行处理多个分支任务 | Git、工作树、项目对话 |
| 需要检查网页 UI | 浏览器 |
| 需要操作桌面软件 | 电脑操控 |
| 找不到历史任务 | 已归档对话或任务列表 |
| 无法启动新任务或响应变慢 | 使用情况、套餐和网络 |
常见坑
- 在 Chat 里做本地项目任务，结果每次都要重新给上下文。
- 没确认工作目录，就让 Codex 开始改文件。
- 看到权限提示不读内容，直接允许。
- 找不到日志和任务状态，任务失败后不知道从哪里排查。
- 以为设置越多越专业，第一次使用就把 MCP、浏览器、电脑操控全部打开。
- 把个人偏好、项目规则和密钥都混在同一个配置里，后面很难维护。
Redman 实测建议
把 Codex 桌面 App 当成“项目工作台”会更好理解：左边选项目，中间看任务，底部发指令，权限弹窗决定它能做多远。新手先用最小权限熟悉一遍，再逐步打开插件和自动化。