Skip to content

Codex 桌面端使用教程:从首次登录到完成第一个任务(2026) ​

更新日期:2026年11月17日

第一次打开 Codex 桌面端,最容易卡住的地方往往不是安装,而是不知道应该选择哪种工作方式:临时对话要不要建项目?Chat 和 Work 怎么分?插件、文件夹和权限分别解决什么问题?

这篇 Codex 桌面端使用教程按一次真实任务的顺序讲解这些概念。你会从官方入口登录,选定一个可回退的 Git 项目,让 Codex 先调查、再修改、最后运行验证;同时了解模型、配置和自动化功能的边界。产品名称、按钮位置和账号资格会随版本变化,页面显示与本文不一致时,以 Codex 官方文档和当前客户端为准。

一、Codex 桌面端、Chat、Work 与 CLI 怎么区分? ​

“桌面端”是运行载体,Chat、Work 等是应用里的工作入口,CLI 则是终端入口。不同版本可能会合并或改名,因此应按任务需要理解它们,而不是死记某个按钮的位置。

入口或概念主要工作单位适合的任务结果通常是什么
Chat 或普通对话当前会话、上传的文件问答、写作、单文件分析、需求澄清解释、草稿、分析结果
Work 或项目任务项目目录、任务和多轮上下文多文件修改、运行命令、持续跟进可审查的文件改动、测试结果
Codex CLI当前终端目录和 Git 工作区脚本、自动化、CI、熟悉命令行的开发命令输出、提交前 diff
IDE 扩展编辑器中的文件、选区和工作区边读代码边提问、局部修改编辑器中的补丁或解释

一个实用判断标准是:如果验收标准包含“仓库里的文件发生正确变化,并且命令验证通过”,优先选择 Work 或 CLI;如果最终只需要一份说明、摘要或方案,普通对话通常更轻量。需要进一步比较 ChatGPT Work 与 Codex,可阅读功能、权限与选型指南。

二、第一次使用 Codex 桌面端:安装、登录与选项目 ​

1. 从官方入口安装 ​

请从 ChatGPT 官方下载页或 Codex App 官方文档进入下载。现有安装包可能以 ChatGPT 桌面应用的名称提供,安装后再在应用内选择 Codex。不要把搜索结果中的“绿色版”“破解版”或第三方重新打包程序当作官方客户端。

如果你还没有安装桌面应用,可先看Codex 桌面端下载安装指南。本文只展开安装后的使用流程,不重复不同系统的安装包细节。

2. 登录并确认账号能力 ​

启动应用后按当前页面提示登录。桌面端是否能使用某个模型、项目功能、连接器或自动化能力,取决于产品版本、账号套餐、工作区策略和所在地区;不要把某篇旧教程中的“必需 Plus”或“完全免费”当成长期规则。使用 API Key 时,还要区分 API 平台用量与 ChatGPT 订阅,它们可能分别计费。

3. 选择一个可回退的练习项目 ​

第一次不要直接打开生产目录。建议准备一个有 Git 的小项目,并先执行:

bash
git status --short

确保你知道哪些改动原本就存在。项目最好有 README、明确的启动命令和至少一条测试或构建命令;如果没有,也可以先让 Codex 只读调查,不要立即要求它“全面优化”。

4. 先看权限和工作目录 ​

打开项目后,确认 Codex 当前使用的目录、是否允许写入工作区、运行命令时是否需要逐次审批。桌面端常见的权限选项可能叫只读、工作区写入、按需批准或完全访问,具体名称以当前版本为准。权限越大,能触碰的文件和命令越多,但并不代表任务结果更可靠;第一次练习保持最小权限即可。

三、四个核心概念:对话、项目、附件与插件 ​

对话和项目不是一回事 ​

只需总结一份 PDF、改写一段文案或分析一个表格时,直接在对话中附加文件即可。需要连续几天处理多份资料、修改多个文件或保留项目规则时,再创建项目。项目的价值是集中保存工作上下文,并让后续任务更容易回到同一个目录和约束中。

文件夹与单个文件的选择 ​

需求推荐方式原因
临时问一个文件的问题附加单个文件范围小,容易检查输入
修改同一仓库中的多个文件打开项目文件夹Codex 能理解目录、依赖和测试关系
长期维护一组规则项目 + AGENTS.md把约束写成可重复读取的上下文
连接外部数据或服务按需启用连接器/插件明确数据流向和权限边界

不要为了“让 Codex 看得更多”把整个磁盘、包含密钥的目录或不相关的大型仓库都加入上下文。输入越宽,隐私暴露和误改范围越难控制。

插件是能力扩展,不是质量开关 ​

插件或连接器可以提供浏览器、文档、表格、演示文稿、GitHub 等额外工具,但安装数量不会自动提高回答质量。先确认任务需要什么,再启用一个最小工具集合;首次使用外部连接器时,阅读它能读取、写入和上传哪些数据。涉及客户资料、内部代码、令牌或生产系统时,先遵守组织政策和服务条款。

四、用 Codex 桌面端完成第一个可验证任务 ​

下面以“阅读一个小型前端项目,修复一个明确的文案或界面问题”为例。这个流程也适用于后端、脚本和文档项目。

第一步:只调查,不修改 ​

先发送一条范围清晰的提示词:

text
先不要修改文件。

请阅读 README、项目配置和与首页相关的源文件,回答:
1. 项目使用什么技术栈,如何启动、测试和构建;
2. 首页入口和目标文案分别在哪些文件;
3. 当前 Git 工作区是否已有未提交改动;
4. 完成本次任务的最小改动范围是什么;
5. 你还缺少哪些信息。
只引用实际读到的文件和命令,不要猜测。

检查它的回答是否真的引用了仓库内容。若启动命令、入口文件或现有改动判断错误,先纠正上下文,再进入下一步。

第二步:写清目标、边界和验收 ​

把开放式请求改成可检查的任务。例如:

text
目标:把首页按钮“立即开始”改为“开始试用”。
范围:只修改首页组件、对应测试和必要的翻译文件。
约束:不升级依赖,不改接口,不重新格式化无关文件。
验收:按钮显示新文案;现有点击行为不变;运行相关测试和项目构建。
流程:先说明计划和将修改的文件,确认后再编辑。

目标、范围、约束和验收越具体,越容易判断 Codex 是否越界。对于可能影响数据、权限、依赖或公开 API 的改动,应把“先停下来说明”写进提示词。

第三步:分小步修改并检查 diff ​

让 Codex 先完成最小修改,再查看变更摘要和差异:

bash
git diff --stat
git diff --check
git diff

重点看四件事:是否改了约定之外的文件,是否出现大段无关格式化,是否把测试或配置删掉,是否把用户输入直接拼进危险命令。发现范围扩大时,先要求它停止并解释原因,不要用新的指令覆盖问题。

第四步:让验证结果成为交付证据 ​

完成修改后,要求 Codex 按项目已有命令验证,不要只接受“应该可以”:

text
请运行与本次改动直接相关的测试,并运行项目要求的 lint、类型检查或构建命令。
逐条报告实际执行的命令、退出结果和未解决的失败。
不要为了让命令通过而删除测试、隐藏错误或扩大修改范围。

如果项目没有自动化测试,至少运行构建或类型检查,并手动打开受影响页面。对 UI 任务还应检查窄屏布局、加载和错误状态;对脚本任务则要用一份安全的样例输入验证输出。

五、模型、思考等级与权限怎么选? ​

模型名称和“快速、平衡、深度”等思考等级会随版本变化,选择时应看任务难度,而不是长期绑定某个型号。

任务特征选择思路交付前必须补的检查
改几处文字、解释文件、整理小型资料快速或默认级别检查是否理解了真实文件
跨文件实现功能、补测试、修常见 Bug默认或更深级别运行相关测试和构建
复杂重构、难定位回归、长链路调查更深级别,必要时分阶段人工审查设计、diff 和失败分支
生产、凭据、数据迁移或外部写入任何级别都要收紧权限逐项确认目标、回滚和审批

模型更强不等于可以跳过验收。高难任务可以先用较强模型规划,再让较快模型执行机械步骤,但每一步都要保留文件范围和验证命令。

六、全局配置、项目配置与 AGENTS.md ​

当你发现“设置改了却没有生效”,通常先查层级和工作目录,而不是反复重装。常见的稳定概念如下:

类型常见位置作用
用户级配置~/.codex/config.toml跨项目的默认设置
项目级配置受信任项目中的 .codex/config.toml只覆盖当前项目的设置
项目规则AGENTS.md说明目录结构、命令、约束和验收方式
会话设置当前任务的模型、权限和工具选择只影响当前会话或任务

项目级设置可能需要项目被信任后才会加载,具体优先级以当前版本文档为准。可以先阅读站内的命令、配置与安全参考手册和AGENTS.md 编写指南,再用实际状态确认:

bash
pwd
git status --short
codex --version
codex doctor

不要把密码、API Key、Cookie、客户数据或内部地址写进 AGENTS.md、日志和提示词。规则文件应描述可公开复用的工程约定,而不是保存秘密。

七、站点、定时任务和自动化功能怎么用? ​

部分版本会提供站点构建、定时任务或自动化入口,名称与开放范围可能变化。它们适合重复、边界明确且结果容易检查的工作,例如生成日报、整理固定目录或运行周期性检查。

建议采用“手动跑通一次,再自动化”的顺序:

  1. 用普通任务确认输入、输出和失败处理;
  2. 限定自动化可读取和可写入的目录;
  3. 明确失败时是否停止、重试或通知;
  4. 涉及外部发布、发送消息、删除数据或生产系统时,保留人工审批。

自动化不是免审查的后台员工。先验证一次结果,再设置周期运行,并定期检查额度、权限和任务仍然存在。

八、常见问题 ​

Codex 桌面端一定需要 API Key 吗? ​

不一定。桌面端可能提供 ChatGPT 账号登录,也可能支持 API 认证;可用方式由当前应用、账号和工作区策略决定。API Key 走 API 平台计费,不能简单等同于 ChatGPT 订阅权益。请以官方认证文档为准。

为什么 Codex 看不到我的文件? ​

先确认当前打开的项目目录和文件是否在允许范围内,再检查权限模式、项目信任状态和文件是否被忽略。不要一上来启用完全访问;先用一个明确的相对路径让它读取并回显文件名。

为什么修改全局设置后项目没有变化? ​

依次检查当前工作目录、项目级配置是否覆盖了用户级配置、配置格式是否正确,以及应用是否需要重新启动。codex doctor、codex --help和当前会话状态通常比旧截图更可靠。

Codex 改了太多文件怎么办? ​

先停止后续任务,保存当前 diff,要求它列出每个文件的修改原因。确认哪些改动属于本次范围后,再手动回退无关部分或恢复 Git 基线;不要让它用一次“大整理”掩盖越界改动。

在中国大陆使用时要注意什么? ​

可用性、登录和网络条件可能因账号、地区、组织策略和时间而变化。不要使用虚假身份、共享账号、绕过安全控制或来源不明的代理和插件;请遵守所在地法律法规、OpenAI 服务条款及组织安全政策。本文不提供绕过平台限制的操作步骤。

结语:把 Codex 当成可审查的协作者 ​

这篇 Codex 桌面端使用教程的核心不是记住 Chat、Work、项目或插件的按钮,而是建立一条稳定闭环:先选对工作范围,再让 Codex 调查;明确目标、约束和验收后再修改;最后用 diff、测试和构建结果确认交付。小任务用对话,大任务用项目,外部工具按需启用,权限始终跟着任务边界走。

你可以先在一个允许回退的小型 Git 项目中完成一次只读调查,再尝试文案修改或补测试。需要安装细节时,参阅Codex 桌面端下载安装指南;需要终端工作流时,参阅Codex CLI 安装、登录与常用命令。

参考与核验:OpenAI Codex GitHub 仓库。