Codex 桌面应用上手教程

一、Codex 现在在哪里

很多老教程让你去下载一个叫 Codex 的独立安装包，这已经过时了。2026 年 7 月起，官方把 Codex 并入了新版的 ChatGPT 桌面应用：你下载的是 ChatGPT 桌面应用，进去之后在左上角切换到 Codex，就是原来的 Codex 应用。所以在官方下载页看到「下载 ChatGPT」，不要困惑，那就是正确的入口。

Codex 是什么？ 一个能进入你指定的文件夹，读文件、改文件、运行命令并检查结果的 AI 助手。和网页版聊天不同，网页版给你一段代码，你要自己建文件、复制、运行、出错再复制回去问；Codex 直接在文件夹里把这些做完，再把改动摆给你检查。它不只能写程序：整理一批 Excel 做成看板、改文档、查报错，只要是电脑上能完成的操作，都可以交给它。

桌面应用里有三种工作方式，选哪个决定了它怎么干活：

简单的问答用「聊天」就够，需要它动手处理文件时再用 Codex。聊天模式里的普通对话不占 Codex 的用量额度，用量在「设置 → 使用情况和计费」里查看。

Codex 有几个入口？ 新手选第一种：

它们共用一套账号和用量，很多配置互通。

读完这篇，你能做到：

1. 下载安装 ChatGPT 桌面应用，登录，切换到 Codex；

2. 认识界面上最重要的几个区域，会选项目、模型、权限；

3. 在一个练习文件夹里完成第一个任务，并学会检查、撤销它的改动；

4. 看懂四个权限选项，知道哪一个适合新手；

5. 遇到最常见的几个问题时知道怎么办。

需要准备：

二、下载与安装

只从官方页面下载：https://chatgpt.com/zh-Hans-CN/download/ 。官网域名一定是 openai.com 或 chatgpt.com 开头，不要从网盘、群文件或第三方下载站获取安装包。

Windows

1. 打开上面的官方下载页，选择 Windows，页面会跳到 Microsoft Store；

2. 确认应用发布者是 OpenAI，点击「获取」或「安装」；

3. 安装完成后，在开始菜单里搜索 ChatGPT 打开。

【待补图 02｜Microsoft Store 里 ChatGPT 桌面应用的安装页，框出发布者「OpenAI」和「获取」按钮】

如果你更习惯命令行，官方也给了 WinGet 的安装命令，在 PowerShell 里执行：

winget install --id 9PLM9XGG6VKS -s msstore

Windows 上默认使用「Windows 原生」方式：Codex 在 PowerShell 里执行命令，并用 Windows 自带的沙箱隔离。设置里的「智能体环境」可以改成 WSL，改完要重启应用才生效；新手保持默认。

macOS

1. 在官方下载页选择 macOS，下载 .dmg 安装包；

2. 双击打开，把应用图标拖进「应用程序」文件夹；

3. 从「应用程序」或 Spotlight 里打开。

官方页面当前提供的是 Apple 芯片（M 系列）版本。如果你的 Mac 是 Intel 芯片，请先看下载页是否仍提供对应版本。查看芯片：点左上角苹果图标 → 「关于本机」。第一次启动时系统可能弹出安全提示，确认安装包来自 OpenAI 官方页面后，按系统提示继续。

【待补图 03｜macOS 打开 dmg 后，把应用拖进「应用程序」的窗口】

Linux

官方提供了 Ubuntu、Debian、Fedora 和 Arch Linux 的安装方式，目前仍标为预览（Preview），请直接看官方的 Linux 桌面应用指南，本文不展开。

装完先更新

这类产品更新很频繁，装好之后检查一次更新（macOS 和 Windows 一般由应用内更新或应用商店更新）。老版 Codex 应用里的项目、线程和设置，并入 ChatGPT 后会保留。

三、登录

打开应用，会看到「登录 ChatGPT」页面，用你的 ChatGPT 账号登录：

1. 点击「继续登录」（或「使用其他方式登录」），浏览器会打开授权页；

2. 登录你的账号并授权；

3. 回到桌面应用，看到主界面就说明登录成功了。

登录界面里可能还有「使用 API Key」的选项。官方说明：API Key 也能用 Codex，但部分功能不可用（云端任务、一些依赖 ChatGPT 账号的功能），而且按 API 用量单独计费。新手阶段请直接用 ChatGPT 账号。

登录卡住了怎么办？ 按顺序查：

1. 默认浏览器能不能打开授权页；

2. 授权后有没有回到应用；

3. 你所在的地区是否在官方支持范围内（见第一节）；

4. 如果提示出现校验数字，确认应用里和浏览器里的数字一致再授权，防止被钓鱼；

5. 公司或学校的账号，某些入口灰着不能点，先问管理员，通常是组织策略限制，不是软件故障。

第一次启动还有两件小事：

• 设置沙箱（Windows）：首次进入时界面上可能出现「设置沙箱」的提示和一个「设置」按钮，直接点它，等它自动完成即可。沙箱是 Codex 执行命令时的一道隔离围栏，第五节讲权限时再解释；

• 界面语言：刚打开可能是英文，进入「设置 → 常规 → 语言」可以切成「中文（中国）」。

怎么看用量？ 点左下角头像，进「设置 → 使用情况和计费」。Codex、Work、工作空间智能体等共用一份额度，聊天里的普通对话不算在内；额度一般分「5 小时」和「每周」两层，进度条后面标着还剩多少、多久重置，具体规则随套餐不同，以你账号里显示的为准。

如果卡在启动时的图标画面进不去，多半是网络没有连通官方服务，先解决网络与地区问题（见第一节），再重新打开。

四、认识界面

登录之后，点窗口左上角的「ChatGPT」下拉菜单，有两项：ChatGPT（创建、学习和探索）和 Codex（构建、调试和发布）。选 Codex。

切换后的界面可以分成三块：

• 项目区（最左侧）：管理项目和聊天。「新聊天」在最上面，下面分「置顶」「项目」「最近」。项目就是你电脑上的一个文件夹，项目下的每个聊天是一次独立的对话，同一项目里可以开多个，共享这个文件夹里的文件，但各自有独立的上下文，看不到对方的完整聊天记录；

• 对话区（中间）：在这里提要求，也在输入框下方选项目、工作位置、权限、模型；

• 预览区（右侧，需要时打开）：预览 Codex 生成的文件、网页、图片，也有内置的简易浏览器和终端。

左边那一条竖着的小图标是全局导航，有首页、定时任务、资料库、图像、插件与技能等。新手天天用到的只有三处：首页输入框、项目、插件与技能，其他用到再找。

输入框：发送前要做的几个决定

输入框是整个应用的核心，底下那一排小按钮决定了它能动你多少东西、用什么模型、想得多深：

1. 左下角「＋」：给这次对话补充材料或选择工具。常用的有：

   • 文件和文件夹：把本地文件、图片交给它当参考（也可以直接拖进对话框）；

   • 计划模式：先让它提问、给方案，你确认了再动手，大改动前建议开（输入 /plan 也行）；

   • 目标：一轮说不完、需要它持续推进的长任务（输入 /goal）；

   • 绘图：画个草图帮它理解需求；

   • 往下还有已安装的插件、能把浏览器里开着的网页拉进来当上下文的选项。

   

2. 权限按钮：决定它能不能不问你就动手，第五节单独讲；

3. 右下角模型与思考强度：点模型名可以切换，名称和可选项随版本变化，新手保持默认的「推荐模型集」即可；旁边的滑杆是思考强度，越高想得越深，但越慢、越耗额度。日常改文件、做小工具，低一些的强度就够；方案没想清楚、要它帮你拆问题时再往上拉；

4. 最右两个圆按钮：麦克风是语音输入（说话变成文字，你可以先检查再发送），声波是语音聊天（实时对话）。

工作位置

选择项目按钮旁边有「此电脑」，表示 Codex 在你自己的电脑上读文件、跑命令；也可以选「云端」（OpenAI 提供的云端环境，结果留在云端任务里，需要再取回）。新手选默认的「此电脑」。

四个常用词

五、权限设置

Codex 会真的修改你电脑里的文件，所以权限是第一道护栏。点输入框下方的权限按钮，会弹出「应如何批准 ChatGPT 操作？」，官方文档（Permissions）列出四个选项：

几点要注意：

• 可选项因版本、系统和组织设置而不同。有的版本里「完全访问权限」默认不在菜单里，需要到「设置 → 常规」最上方的「权限」栏里打开才会出现；有的企业账号里某些选项被管理员禁用。「有这个选项」不等于「当前选中了它」，发消息前看一眼按钮上显示的是哪一档；

• 官方文档的提醒很明确：完全访问模式下 Codex 不限于你的项目目录，可能做出无意的破坏性操作，导致数据丢失；

• 沙箱：macOS 用系统自带的沙箱，Windows 用原生的 Windows 沙箱，或 WSL2 里的 Linux 沙箱；

• 线程列表里，任务进行中、等待批准、已完成会用不同标记显示。看到「等待批准」，说明它在等你确认某个操作，点开查看后决定是否允许。

六、第一个任务：做一个番茄钟网页

准备 1：建练习文件夹。 在桌面（或其他你找得到的地方）新建一个空文件夹，命名 codex-first-project，里面可以什么都不放。别一上来就把工作资料的文件夹交出去。

准备 2：装 Git（建议）。 应用里的「查看变更」「撤销」靠 Git 工作；没有 Git，这些功能会缺失。Windows 在 PowerShell 里执行：

winget install --id Git.Git

macOS 第一次用到 Git 时，系统可能提示安装开发者工具，按提示安装即可。

第 1 步：把文件夹交给 Codex。 切换到 Codex，点输入框上方的「选择项目」，选「新建项目」（也可以在左侧「项目」旁点「＋」）。

弹出「创建项目」窗口后：

• 想让 Codex 帮你新建一个文件夹：直接填「项目名称」；

• 想用已有文件夹：在「源文件夹」下选「在此电脑上添加文件夹」，选中 codex-first-project。

点「创建项目」。

第 2 步：信任文件夹。 会弹出「信任此文件夹吗？」。意思是：ChatGPT 可以读取、编辑和运行这个文件夹里的文件，而且即使你没发请求，文件夹里的某些设置也可能触发代码自动运行。只信任你自己建的、知道里面是什么的文件夹，别从网上下载一个来路不明的项目就点信任。确认后点「信任文件夹」。

第 3 步：确认三件事。 发送前看输入框：

• 工作位置是「此电脑」；

• 权限是「请求批准」；

• 模型和思考强度保持默认或偏低。

第 4 步：先发一条只读的问题。 把下面这段话发出去：

请告诉我这次对话的工作目录在哪里，并列出这个目录中的文件。先不要修改任何内容。

它会回答工作目录是哪个文件夹、里面有没有文件。这一步确认它在你指定的文件夹里工作，也让你看清它「探索 → 回答」的过程。

第 5 步：提出真正的任务。 需求清楚、范围小的任务可以直接说；如果你自己也说不清想要什么，点「＋」选「计划模式」，让它先提问、给计划，你确认后再执行。好的要求通常包含：要什么、给它什么材料、交付成什么样、哪些不能动、做完怎么验收。这里的任务很明确，直接复制发送：

请在当前项目文件夹里做一个番茄钟网页：25 分钟专注、5 分钟休息，有「开始」「暂停」「重置」三个按钮，界面简洁，手机上也能正常显示。
只新建一个 index.html（样式和脚本写在里面），不要安装任何依赖，不要改动其他文件。
做完后告诉我：改了哪些文件、怎么在浏览器里打开、怎么检查三个按钮是否正常。

最后一句「做完怎么验收」建议一定写。你写清楚怎么算做完，它交出成果时才会把改了哪些文件、怎么检查一并交代清楚。

第 6 步：看过程，遇到批准请求时看清再点。 Codex 开始工作，对话里会展示它读了什么、改了什么，每一行都能点开看详情。如果线程出现「等待批准」，点开能看到它想做什么，你确认合理再允许；不理解的先别批，直接问它「这条命令是做什么的」。一般一两分钟就能做完。

第 7 步：检查结果。 完成后会出现一个结果卡片：上方是它的说明（改了哪个文件、怎么打开、怎么检查），下方是「已编辑 index.html」，右边有**「撤销」和「查看变更」**两个按钮。改坏了想反悔，点「撤销」就回到改之前；点「查看变更」，右边会拉出逐行的改动对比，绿色是新增的行。

第 8 步：打开看效果。 到 codex-first-project 文件夹里双击 index.html，用浏览器打开，点「开始」看倒计时是否在走，再试「暂停」和「重置」。（你的页面样式会和图不同，功能对就行。）

第 9 步：追问修改。 不满意直接在同一个聊天里接着说，不用重开。比如：

把三个按钮改成胶囊形状，倒计时的数字再大一点。

第一次结果不完美很正常。 把你看到的现象和想要的结果说清楚，它会据此继续改。

到这里，你已经走完了 Codex 日常工作的完整循环： 建项目 → 信任文件夹 → 写要求 → 看过程 → 看变更 → 验成品 → 接着改 → 处理审批。

七、其他常用功能

1. 它在干活时，你想改要求。 直接在输入框里写新要求。如果它正在执行，输入框上方会出现「引导」按钮，点它，新消息会立即插进当前任务里，它会按最新的要求调整方向；不点的话，新消息会排到队里，等这一轮结束再处理。在「设置 → 常规」里可以选默认是「引导」还是「排队」。

2. 分支。 每条回答下面有「分支」按钮，点它会在项目里开一个新聊天，并保留到这个位置为止的对话记录。适合：比较两种方案（原聊天试一种，分支试另一种）；把工作拆开（定好大纲后，分一个聊天写文章，一个做视频脚本）；深入研究一个问题又不想打断主线。试砸了直接扔掉，原聊天不受影响。

3. 侧边聊天。 主任务还在跑，你想问个不相干的小问题：在聊天标题右边的「···」里选「新建侧边聊天」，问完不影响主任务。

4. 斜杠命令。 在输入框里打 /，会弹出命令列表。常用的：/plan（先出方案再动手）、/model（换模型）、/status（看上下文用了多少、剩余用量）、/init（在项目里生成一份 AGENTS.md）、/goal（设一个持续追求的目标）。

5. 命令行版本（可选）。 想在终端里用 Codex，官方的独立安装脚本是：

macOS / Linux：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell：

irm https://chatgpt.com/codex/install.ps1 | iex

装好后新开一个终端，执行 codex --version 检查，用 codex login 登录（浏览器回调不了时用 codex login --device-auth），进入项目文件夹后执行 codex 启动。命令行版和桌面应用共用同一份配置和登录状态。

八、常见问题

登录时找不到中国的手机号选项

找不到 Codex 独立安装包

没有撤销按钮，或提示 Git 功能不可用

它说浏览器工具无法打开本地文件

Windows 上提示脚本被禁止运行

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

修改系统策略之前，建议先阅读微软官方的说明，理解后再操作。

需要运行要求管理员权限的命令

额度消耗很快

不小心开了完全访问权限

找不到生成的文件

九、接下来学什么

建议按这个顺序，每一步都在练习文件夹里试一遍：

1. AGENTS.md：项目的说明书。对它说「请阅读当前项目并生成 AGENTS.md」，以后每次打开项目它会先读，把你的约定写进去（比如「用中文回复」「改完要说明怎么验证」）。「设置 → 个性化」里还可以写适用于所有聊天的自定义指令；

2. 一个任务一个聊天：多开聊天，互不干扰；

3. 插件与技能：插件让它连接 GitHub、邮箱、云盘等外部软件，技能是把一类任务的做法存成可重复调用的手册，输入 / 加技能名即可调用；

4. 定时任务：把你手动做过、效果满意的重复工作，交给它按时间自动执行；

5. 手机远程：在「设置 → 连接」里扫码授权后，可以用手机上的 ChatGPT 应用远程指挥这台电脑上的 Codex。