---
description: "Codex 桌面 App 基本组成说明，介绍项目工作区、对话、设置入口、任务状态和常见界面区域，方便快速定位功能。"
---

::: tip 最后核对
官方资料最后核对日期：2026-06-13。本章参考 [Codex App docs](https://developers.openai.com/codex/app)、[Settings](https://developers.openai.com/codex/app/settings)、[Agent approvals and security](https://developers.openai.com/codex/agent-approvals-security) 等官方资料。界面说明以当前 Codex 桌面 App 实际版本为准，不同系统、地区、客户端版本和账号套餐下显示可能略有差异。
:::

# 了解 Codex 基本组成


## 认识对话和项目

打开 Codex，左侧栏就两个入口：**Chat（对话）** 和 **Project（项目）**。

![Codex 桌面 App 主界面](https://cdn.canghecode.com/codexguide/docs/images/codex-app-main-chat-home.png)

**Chat 对话**

和 ChatGPT 网页版差不多，随手问问题。各对话互不相干，也不共享文件夹。

**Project 项目**

需要动本地文件时用它——写代码、改文档、做 PPT 都可以。项目里的所有对话共用同一个文件夹，方便一起管理。

![Project 工作区界面](https://cdn.canghecode.com/codexguide/docs/images/codex-app-project-workspace-selection.png)

在项目里下达指令后，Codex 的修改会直接应用到你本地文件夹中的文件。

## 对话框功能说明

Codex 的对话框和 ChatGPT 网页版类似，支持：

1. **添加上下文**：可以附加文件、截图或其他参考内容
2. **切换模型**：在不同模型之间切换

并额外支持：

3. **控制权限**：设定 Codex 在当前任务中的操作权限
4. **选择工作目录**：指定 Codex 在哪个本地文件夹下执行任务

![对话框功能区](https://cdn.canghecode.com/codexguide/docs/images/codex-app-composer-controls.png)


## 插件与技能

包括 OpenAI 官方定制或推荐的插件与技能。

![Codex 插件与技能](https://cdn.canghecode.com/codexguide/docs/images/codex-plugin-marketplace-watermarked-small.png)

Skills 默认包含 Skills Creator、Skills Installer、OpenAI Docs 等技能，用来创建、安装技能，或获取 OpenAI 官方最新文档。在对话框中使用 `$` 即可调用 Skills：

![Codex Skills 调用](https://cdn.canghecode.com/codexguide/docs/images/codex-skills-command-watermarked-small.png)

插件是 OpenAI 定义的外部工具入口，也可能包含 Skills、MCP、脚本等能力。常见插件包括 Computer Use、Browser Use、PPT、Docs、Excel、Slack、GitHub 等。不同插件可能有额外配置。

![Codex 插件配置](https://cdn.canghecode.com/codexguide/docs/images/codex-plugin-config-watermarked-small.png)

## 自动化

Codex 支持自动化执行任务，包括使用 MCP 服务器、钩子和插件等。

![Codex 自动化总览](https://cdn.canghecode.com/codexguide/docs/images/codex-automation-overview-watermarked-small.png)

自动化会执行你指定的命令，你可以指定工作树、项目地址和定时的间隔。在下图中输入你的指令，并且配置即可。

![Codex 创建自动化](https://cdn.canghecode.com/codexguide/docs/images/codex-automation-create-watermarked-small.png)

::: tip 注意
自动化任务以默认沙盒设置运行。若工具调用需修改工作空间外文件、访问网络或操作电脑应用，该操作将执行失败。可通过规则选择性允许特定命令在沙盒外运行。
:::


## 设置面板

点击左下角头像或设置图标可以打开设置面板。

![设置入口](https://cdn.canghecode.com/codexguide/docs/images/codex-app-profile-menu-settings-billing.png)

![设置面板详情](https://cdn.canghecode.com/codexguide/docs/images/codex-app-settings-panel-detail.png)

左侧是设置菜单。里面包含丰富的配置选项，详情如下：


::: warning 先用默认配置
截图里的开关只是示例。尤其是「完全访问权限」、浏览器控制、电脑操控、钩子和 MCP 服务器，先按任务逐步开启。配置选项可参考如下。
:::


## 设置说明
大部分情况下都是保持默认配置即可。配置很多时候都是按需开启。

### 个人

<div class="setting-card-grid">
  <section class="setting-card">
    <div class="setting-card-body">
      <strong>常规</strong>
      <ul>
        <li><strong>工作模式</strong>：编程模式保留更多技术细节；日常工作模式更适合问答、整理和写作。</li>
        <li>
          <strong>权限</strong>：提供三个权限选项。
          <ul>
            <li><strong>默认权限</strong>：在沙盒环境中运行，安全但部分操作可能受限，例如访问工作目录外的文件、修改本机环境变量。</li>
            <li><strong>自动审核</strong>：也称“替我审批”，部分越权命令可以在模型审核认定安全后自动使用，无须用户授权。</li>
            <li><strong>完全访问权限</strong>：只在明确需要时临时开启，例如启用 computer use。</li>
          </ul>
        </li>
        <li><strong>常规</strong>：可配置：文件打开位置、集成终端 Shell、Codex UI 的语言、底部面板、速度（指模型生成的速度）、代码审查、建议提示、从其他AI应用中导入工作内容，打开源许可证。<br>
          通常而言，模型生成速度默认标准即可。仅在Pro 5x及以上的套餐才会推荐启用快速模式（消耗更多配额）。
        </li>
        <li><strong>编辑器</strong>：可配置：上下文窗口使用情况、跟进行为、需按 ^ + 回车键发送长文本提示。</li>
        <li><strong>弹出窗口</strong>：可配置：弹出窗口快捷键、默认使用无项目聊天。</li>
        <li><strong>听写</strong>：可配置：按住听写快捷键、切换听写快捷键、保持听写栏可见、听写词典、最近的听写记录。</li>
        <li><strong>通知</strong>：可配置：轮次完成通知、权限通知、问题通知。。</li>
      </ul>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：通常而言，推荐开启自动审核、标准速度、始终轮次完成通知</div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <strong>个人资料</strong>
      <p>查看账号资料、Token 活动</p>
      <ul>
        <li><strong>资料</strong>：头像、名称、用户名。</li>
        <li><strong>用量</strong>：活动、token、任务记录等个人统计。</li>
      </ul>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：保持默认即可</div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <strong>外观</strong>
      <p>调整 UI 和配色方案。可配置：主题导入、主题复制、强调色、背景、前景、UI 字体、代码字体、半透明侧边栏、对比度、指针光标、动态效果、字号、差异标记、宠物外观。</p>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：按照自己的喜好即可。</div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <strong>配置</strong>
      <p>管理 agent 的执行边界和config.toml的配置</p>
      <ul>
        <li><strong>自定义 config.toml 设置</strong>：Codex 的核心配置文件。详情见：<a href="../advanced/09-config-toml.html">config.toml 参考</a></li>
        <li><strong>工作空间依赖项</strong>：可配置 Codex 安装随附的Node.js和Python、进行诊断和重置并安装工作空间。</li>
      </ul>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：批准策略用按请求；沙盒用只读或工作区写入；联网按任务开启。</div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <div class="setting-card-title">个性化</div>
      <p>选择 Codex 的性格，配置自定义指令和记忆。</p>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：自定义指令写跨项目偏好。</div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <strong>键盘快捷键</strong>
      <p>查看、搜索和重设快捷键。</p>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：保持默认。后续根据需要自定义修改。</div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <strong>使用情况和计费</strong>
      <p>查看额度和套餐状态。</p>
    </div>
  </section>
</div>

### 集成

<div class="setting-card-grid">
  <section class="setting-card">
    <div class="setting-card-body">
      <strong>MCP 服务器</strong>
      <p>给 Codex 接入外部工具和上下文，比如文档、浏览器、设计工具或内部系统。</p>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：根据项目需要配置 MCP。更多请看<a href="../advanced/03-skills-plugins-mcp.html">技能与插件</a>。</div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <strong>浏览器</strong>
      <p>让 Codex 打开网页、点击、输入、截图和检查页面状态。需要在插件处下载。可配置：清除浏览数据、批注截图、打开网站前审批、网站权限。</p>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：通常始终包含批注截图，审批则视情况选择。</div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <strong>电脑操控</strong>
      <p>让 Codex 看屏幕、点应用、输入内容。Codex会读取本机上已经安装的APP，然后通过视觉识别和脚本发起键鼠操作。需要在插件处下载。</p>
    </div>
    <div class="setting-card-recommend"><strong>需要注意</strong>：电脑操作会接管你的电脑，一般而言AI接管过程中不建议用户操作。</div>
  </section>
</div>

### 编码

<div class="setting-card-grid">
  <section class="setting-card">
    <div class="setting-card-body">
      <strong>钩子</strong>
      <p>在 Codex 的生命周期事件中运行自定义脚本。可用于日志、提示检查、记忆整理、验证检查和按目录调整提示。详情见：<a href="../advanced/06-hooks.html">Hooks</a>。</p>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：默认无需配置。当需要搭建工作流时再考虑。</div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <strong>连接</strong>
      <p>管理设备远程连接。可通过手机/SSH的方式远程连接Codex。</p>
    </div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <strong>Git</strong>
      <p>让 Codex 按你的偏好处理 Git。可配置：分支前缀、PR 合并方法、侧边栏 PR 图标、强制推送、草稿 PR、旧工作树自动清理、保留数量、提交信息和 PR 标题/描述生成指令。</p>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：保持默认即可。视实际开发需要而修改。</div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <strong>环境</strong>
      <p>指定一个项目目录，告诉 Codex 这个项目该怎么构建和运行。可配置：设置脚本，清理脚本，自定义操作。例如安装依赖、构建项目、启动开发服务器和运行测试。</p>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：当你需要频繁地使用命令来打开一个项目时，考虑配置。</div>
  </section>

  <section class="setting-card">
    <div class="setting-card-body">
      <strong>工作树</strong>
      <p>让 Codex 为不同任务准备独立的工作区。适合同时修不同问题、比较不同方案，或把长任务放到一边继续做别的事。使用前先确认当前改动已经保存或提交。</p>
    </div>
    <div class="setting-card-recommend"><strong>推荐配置选项</strong>：熟悉 Git 分支后再用。任务结束后清理不用的工作树。</div>
  </section>
</div>

### 已归档

<div class="setting-card-grid">
  <section class="setting-card">
    <div class="setting-card-body">
      <strong>已归档对话</strong>
      <p>收起不再活跃的对话。可恢复。</p>
    </div>
  </section>
</div>


::: tip 注意
设置页里的名称会随着客户端迭代变化。遇到和教程截图不一致时，先看 OpenAI 官方的 [Codex App docs](https://developers.openai.com/codex/app)，再回到本教程查中文场景解释。
:::

## 下一步

下一步：[用 Codex 完成第一个任务](./06-first-task.md)。