Codex 学习专区/01|入门与进阶/Codex 最系统手把手教程,从入门到精通(附完整 PDF)

Codex 最系统手把手教程,从入门到精通(附完整 PDF)

最后更新 2026-09-02·约 37 分钟读完
🔦

公众号:爱 AI 的大刘

发文时间:2026 年 6 月 9 日 15:45

无论你是还没安装、没有账号,还是想接入国产模型,这篇都可能是全网最详尽的 Codex 实战教程。

图片为Codex最系统手把手教程宣传图,以深色背景搭配紫色和蓝色元素,展示了从入门到精通的8个步骤。步骤包括安装/下载、登录/ API Key、国内模型切换、项

Codex 堪称 2026 年最值得投入学习的 Agent 工具之一,其生态在 OpenAI 的持续打磨下日臻完善。

本文将手把手带你从零上手,逐步进阶到精通。即便你尚未安装、不熟悉操作、想接入国内 API,甚至连 ChatGPT 账号都没有,也完全不用担心——我们一步一步来。

好,正式开始。

一、 安装 Codex

第一步,先把软件装上。

官方下载入口只有一个:打开 https://chatgpt.com/codex

Mac 和 Windows 版本均已提供,进入页面后点击醒目的「下载应用」按钮即可。

图片展示的是Codex官网页面。页面上方有ChatGPT标志及导航栏,包括简介、功能、学习、Codex、商业应用、定价、下载等选项。中间部分以紫色背景突出显示C

本文以 Mac 为例演示,安装过程与常规软件无异:下载安装包后拖入应用程序文件夹即可。

Windows 端同样简单。除了官网下载,还可以通过终端一行命令完成安装,更加便捷:

winget install Codex -s msstore

winget 是 Windows 官方包管理器,相当于系统自带的命令行应用商店,输入命令后自动完成下载安装,无需手动点击。

安装完成后打开软件,进入下一步。

二、 登录、认界面、设成中文

首次打开软件,系统会提示登录。

直接使用 ChatGPT / OpenAI 账号登录即可,点击「使用 ChatGPT 继续」并完成授权。

图片展示了Codex的登录界面。上方有“欢迎使用 Codex”字样及蓝色勾选图标,说明所有ChatGPT套餐均包含Codex。下方有“使用ChatGPT继续”黑

这里补充说明一点:Codex 的使用权限与你的 ChatGPT 会员档位绑定。免费用户可以下载和使用基础功能,但无法使用 Codex 专用高级模型;轻度使用场景下,20 美元档位已足够满足需求;重度用户则可选择更高档位。建议根据自身实际情况选择,不必一开始就购买最贵的方案。

(没有账号、或想接入国产模型的解决方案,将在下一节专门讲解,稍安勿躁。)

登录成功后即可看到主界面。下面先带你认识界面的四大核心区域,熟悉后操作起来就心中有数了。

这张图片展示了Codex界面的初始页面,左侧栏包含「新对话」「搜索」「插件」「自动化」等功能入口,以及「项目」分类下的相关项目列表,最底部还有「设置」选项。界面

界面中央的主区域是对话窗口,与其他 AI 对话工具类似,用于日常交互。

左侧导航栏用于管理所有内容,分为两层:上层是「对话」,下层是「项目」。

图片展示了Codex界面的左侧导航栏及主区域。左侧导航栏分为“项目”和“对话”两层,“项目”下有多个项目选项,如Index-Trustee等;“对话”下有搜索、

「对话」适用于零散的临时任务,例如查资料、做规划、解释概念等,无需绑定到具体文件夹。

「项目」才是 Codex 真正发挥实力的核心区域。

其工作逻辑是:一个项目对应电脑本地的一个文件夹。将文件夹交给 Codex 后,它就在该目录内执行操作,生成的文件也保存在其中。

这就是所谓的工作空间。

这张图展示了Codex的项目相关界面,左侧侧边栏以紫色框线标注了多个项目文件夹,其中包含Indie-Trustmrr、Indie-PPT等选项,紫色箭头明确指向

一个项目下可以开启多个对话(Thread,即独立的任务线),它们共享同一文件夹中的文件,但聊天记录相互独立、互不干扰。

这里特别提醒:前期做好分类规划非常重要。

不要图省事把所有内容都堆在一个对话里——记录一长,上下文就会混乱,AI 也容易出错。前期没分好类,后期整理起来会非常痛苦。

工作空间管理的核心原则是:同一大方向的内容放在同一个项目中,每件具体任务开启一条新对话。这是我认为最高效的使用方式。

熟悉界面后,我们顺手把它设置成中文。

点击左下角 Settings,进入 General 设置页,找到 Language 选项,选择中文。

图片展示了Codex界面中设置入口的位置。界面左侧是导航栏,其中“Settings”选项被红色框突出显示。点击“Settings”后,会进入General设置页 图片展示了Codex软件的General设置页界面。左侧为设置菜单,选中“General”。右侧是设置内容,Language选项被蓝色框突出显示,当前语言为“E

选择后系统会自动下载中文语言包,重启 Codex 后界面即变为中文。

三、 没 ChatGPT 账号 / 想接国产 API,怎么办

本节专门为没有账号、不想折腾网络环境、或希望使用国产模型的读者准备。

我知道不少人卡在这一步——工具本身很好,但一听说需要 ChatGPT 账号和特殊网络环境就望而却步。其实没那么复杂,下面提供两条可行路径,任选其一即可。

后续操作在 Mac 和 Windows 上基本一致,遇到差异处我会单独说明。

路径一:使用 API Key 登录

还记得登录页的「使用其他方式登录」吗?其中就包含 API Key 登录选项。

如果你已有 OpenAI 平台的 API Key,这是最直接的方式。

但说实话,OpenAI API Key 对国内用户来说门槛也不低——需要绑定海外信用卡并充值。因此更多人会选择下面这条路径:直接接入国产模型。

路径二:使用 CC-Switch 为 Codex 接入国产模型

这是我最推荐普通用户选择的路径。无需 ChatGPT 账号,接入 DeepSeek 或智谱 GLM 等国产模型后,即可正常使用 Codex。

我们需要用到一个工具——CC-Switch,它的核心功能可以概括为一句话:在不同模型之间一键切换。

前往其 GitHub Releases 页面下载安装包即可,仓库地址为 farion1231/cc-switch。

图片展示了CC Switch工具的界面,其核心功能是统一管理AI编程工具工作流。界面左侧有“免费下载”和“查看文档”按钮,支持macOS 13+、Windows

Windows 用户下载 .msi 安装包,双击按向导完成安装;Mac 用户下载对应版本,拖入应用程序文件夹即可。

安装完成后打开软件,顶部有多个 Tab,包括 Claude、Codex、Gemini 等。它并非仅支持 Codex,不过本文我们只使用 Codex 这一栏。

图片展示了CC Switch软件界面。上方有多个图标,如AI、GPT、Gemini等。下方有“Claude Official”和“default”两个模型配置,

在 Codex 栏中,点击右上角的加号,新增一个模型配置。

随后会弹出供应商选择列表,涵盖国内外众多模型。这里我们选择 DeepSeek(若使用智谱则选择 Zhipu GLM,操作完全相同)。

这张图片展示的是Codex工具里的添加新供应商界面,界面提供了多种AI模型供应商选项,分为预设供应商和自定义配置类别。其中,DeepSeek选项被蓝色高亮标注,

接下来是填写配置信息。这一步是全文中我最想详细讲解的环节。

为什么?因为我自己第一次用 CC-Switch 给 Codex 接 DeepSeek 时,就在这里踩过坑——模型名填错了一个字母,导致持续报错,我还以为是 API Key 或网络问题,反复排查了十几分钟才发现原因。

因此,下面我将需要填写的两个字段逐一说明,照着操作即可避免同样的问题。

第一项,API Key。前往 DeepSeek 开放平台获取,注册登录后在 API Keys 页面新建一个密钥,复制后粘贴到此处。使用其他厂商的模型则前往对应平台获取。

第二项,模型名称。这正是我当初出错的地方——请严格按照 DeepSeek 平台文档中的标准名称填写,一个字母都不能错。填写完成后,其余配置项通常会自动填充,无需手动修改。

图片展示的是Codex添加新供应商界面中模型映射部分。界面中列出了“DeepSeek V4 Flash”和“DeepSeek V4 Pro”两个模型,对应的实际

两项填写完成后,点击右下角的「添加」。

添加成功后,系统会自动切换到刚配置的模型,主界面中该模型会处于高亮状态。

此时回到 Codex,会发现它已自动登录并可以正常使用,左下角会显示登录状态。

图片展示了Codex登录状态界面。上方显示“已通过API密钥登录”,并有用户头像图标。下方有“设置”和“退出登录”选项,其中“退出登录”选项左侧有向左箭头图标。

实际使用下来,CC-Switch 最大的优势就是切换模型便捷——今天想用 DeepSeek,明天想换 GLM,点两下即可完成切换,无需每次修改大量配置。对于不想折腾的用户来说,确实非常省心。

补充推荐:Codex++——无账号也能使用 Skills

GitHub 上还有一个项目叫 Codex++(CodexPlusPlus),它可以解锁 Skills 等高级功能,即便没有 ChatGPT 账号也能运行。

Skills 的概念将在后续章节详细介绍。这里先有个印象:如果你走的是接入国产模型的路径,又想体验 Skills 功能,可以关注一下 Codex++。具体安装步骤在其仓库 README 中有详细说明,本文不再展开。

图片展示了GitHub上Codex++项目的页面。上方标题为“Codex++”,下方有“中文”“English”选项。中间是Codex++的图标,下方文字介绍其

至此,账号和模型接入部分就完成了。无论你是直接使用 ChatGPT 账号,还是接入了国产模型,都可以继续往下学习。

四、核心玩法

本章我们逐一讲解日常使用中最核心的功能。

先回顾一下项目和对话的逻辑(前面提到过,这里落实到具体操作)。

要正式开始工作,在左侧「项目」栏点击加号,新建一个空白项目,或直接选择电脑上已有的文件夹。

该图片呈现了Codex核心玩法里的项目操作界面,对应文档中新建项目的步骤。界面左侧的“项目”栏里显示了Indie-Trustmrr、PPT Agent、Indi

进入项目后,对话框会发生变化,底部多出一些功能选项,我们逐一介绍。

4.1 对话框左下角:三档权限控制

  • 默认权限:最保守,它干啥都得先问你一句、等你点同意。
  • 自动审查:适合日常,平时让它自己跑,碰到有风险的操作(比如删一堆文件、动敏感目录)才停下来拦你一下。
  • 完全访问:全放开,它自己跑,不再每步征求你。
图片展示了Codex工具里“AI的工作权限”设置界面,呈现了三种权限选项的具体内容,对应文档中提及的权限模式。其中选中的“请求批准”选项标注为已启用,该模式的说

我个人日常使用的是完全访问模式。

并非不担心风险,而是因为每次弹出确认提示时,我往往也无法快速判断操作是否合理,不如让 AI 自主执行、我专注监控最终结果。

但需要坦诚地说:如果你是刚上手、心里没底,建议先使用「自动审查」模式——它会在真正危险的操作前拦截,比一开始就完全放开更稳妥。权限档位随时可以调整,无需纠结。

4.2 对话框右下角:模型切换与推理档位

模型选择方面,接入了哪个模型就使用哪个;使用官方账号的话,直接选择当前最新的 GPT-5.x 系列即可。

旁边是推理档位,从低到超高(Low 到 Extra High)。可以理解为 AI 的「思考深度」——档位越高,回答前的思考时间越长,通常更稳妥全面,但也更慢、更消耗额度。

我的建议是:日常使用「高」档位即可,不必一开始就拉满。真正遇到复杂任务时,再开启「超高」。说实话,超高档位我平时很少使用——并非它不好,而是大部分需求确实用不上,拉满纯属浪费。

图片展示了在Indie - Trustmrr中构建内容时的模型切换和推理深度设置界面。左侧为输入区域,下方有“请求批准”“本地模式”“main”等选项。右侧是模

旁边还有速度设置,分为标准和快速两档。快速档响应更快但消耗更多额度,标准档与快速档的实际体验差距不大。

除非额度非常充足,否则推荐使用标准档。

4.3 文件修改方式:直接修改、隔离副本、云端

新建对话时,除了权限档位,还可以选择 AI 在「哪里」执行修改。这一点新手特别需要了解,因为它直接决定了「会不会动到我的原始文件」。

  • 直接改(Local):就在你这个项目文件夹里改,改完就是改完了,最直接。
  • 隔离副本(Worktree):它另开一份副本去改,碰都不碰你的原文件,你看着满意了再合并回来。怕它改乱的,走这个最稳。
  • 云端(Cloud):把活儿丢到云端后台跑,你电脑该干嘛干嘛,跑完回来收结果。

我的建议是:刚上手又担心出问题时,使用隔离副本模式;等熟悉操作、信得过 AI 后,日常使用直接修改也可以。

4.4 如何向 AI 传递文件、图片,以及语音输入

仅靠打字描述,AI 有时无法准确理解你指的是哪个文件。以下几种更高效的方式都应该掌握。

先说如何让 AI 准确定位文件。在对话框中输入 @,会弹出文件选择菜单,搜索文件名后直接将文件插入消息,AI 就能明确知道你指的是哪个文件,比口头描述靠谱得多。

提醒一下:@ 只能选择具体文件,无法选择整个文件夹。

再说图片。手里有报错截图、设计图、表格图片时,无需费力描述,直接拖入对话框或复制粘贴即可,AI 能够识别图片内容。

不想打字的用户还可以使用语音输入。按住 Ctrl+M 开始说话,系统会将语音转为文字,转换后还可以编辑再发送。对于打字较慢的用户,这个功能非常实用。

4.5 减少 AI 跑偏:需求提报的正确方式

很多人觉得 AI 不好用,其实是需求没有说清楚。官方提供过一个非常实用的提需求框架,照着做效果立竿见影。一条完整的需求应尽量包含以下三要素:

  • 给材料:把它要看的文件、文档、报错截图给它,别让它猜。
  • 立规矩:比如「用中文」「别动数据库」「照我现有的风格来」。
  • 定验收:把「做成什么样才算成」说清楚,比如「能正常打开、不报错」「这三项都对得上」。

简言之就是:给材料、立规矩、定验收。这三项补全后,AI 跑偏的概率会大幅降低。

遇到复杂任务时,记得顺手将推理档位调到「高」。

4.6 计划模式(Plan Mode):先规划、后执行

点击对话框左侧的加号,可以开启「计划模式」。

其工作方式是:你提出需求后,AI 不会立即动手,而是先梳理方案和步骤,待你确认无误后再开始执行。开启后,对话框旁会出现一个小图标,提示当前处于计划模式。

图片展示了Codex的界面,左侧有多个功能选项,其中“计划模式”开关被红色框突出显示。右侧显示“我们应该在Indie - Trustmrr中构建什么?”的问题,

凡是稍微复杂的任务,我都建议先走一遍计划模式。AI 会先提出几个问题供你选择回答,然后给出完整方案,你确认后它才正式开工。这一步看似多此一举,实际上能帮你减少大量返工。

图片展示了Codex在计划模式下与用户的对话界面。用户提出想做一个产品,AI先梳理方案和步骤,待确认无误后开始执行。对话框旁有“计划模式”图标提示。AI提出几个 图片展示了Codex目标模式下构建出的完整计划。上方列出功能、内容、质量、商业、风险等测试要求,如功能测试需完成注册/邀请码等任务,内容测试需在15分钟内完成7

4.7 目标模式(Goal):委派长任务,让 AI 自主推进

这是近期推出的新功能,非常受欢迎。

与计划模式并排的还有「目标模式」。计划模式是「先理清方案再动手」,目标模式则是另一种思路:你设定一个相对长期的目标,AI 会一轮一轮自主推进,无需你发一条、等一条、再催一条。中途可以随时暂停、继续,或直接撤销该目标。

适合那种「一时半会儿做不完、又不需要时刻盯着」的任务。设定后你就可以去忙别的,AI 会自行逐步推进。

4.8 修改完成后如何逐条验收(Review 审阅面板)

这个功能我必须专门讲一下,因为它解决了新手最大的顾虑:AI 改了我的文件,不满意怎么办?能撤销吗?

AI 完成任务后,桌面端会出现一个 Review(审阅)面板,将本次所有修改逐一列出。你可以这样处理:

  • 一处处过,这处改得好就留下,那处不对就单独撤掉,不用整篇推翻。
  • 觉得整个方向都不对,一键全撤,回到它动手之前的样子。
  • 哪行还想再调,把鼠标挪到那行点个加号,直接写一句「这儿改成怎样」,它就照你这条意见接着改。

有了这个功能,就不用担心「改坏了收不回来」。这也是我建议新手尽早熟悉的功能——它是你从「不敢让 AI 碰我的文件」到「放心交给它」的关键一步。

4.9 内置预览浏览器与批注功能

如果你让 AI 制作的是网页等可视化内容,完成后它会提示你用 Codex 自带的浏览器打开预览效果。

打开后,右上角有几个按钮,包括截图和批注。批注是我使用频率最高的功能之一,非常实用。

开启批注后,可以直接在页面上圈选任意元素,输入修改意见。比如想换个 logo,直接在页面上选中它,输入「换成官方 logo」即可,无需再截图、再用文字描述半天。

近期还新增了一个功能:选中字体、字号、颜色等属性后,可以直接在面板中调整,修改后实时预览效果。

批注完成后点击发送,AI 就会按照你的意见进行修改。

这张图片是Codex的可视化界面,对应文档中介绍的Skills与插件功能的相关内容。界面内显示“正在思考”的状态提示,输入框内标注有“要求后续变更”的内容;底部

4.10 Skills 与插件:可视化界面,Codex 对新手最友好的特性之一

Skills 可以理解为给 Agent 使用的「技能包」,插件则是将一组技能和工具打包成的更成熟的安装包。

Codex 最贴心的一点是,这些功能都做成了可视化界面——不像有些工具,装了什么、装在哪、有什么用,自己都搞不清楚。

从左侧导航栏的「插件」进入,顶部可以切换「插件」和「技能」两个 Tab。

图片展示了Codex的插件界面。左侧导航栏中“插件”选项被选中,显示了如Index-Trustmer、PPT Agent等插件。右侧是插件页面,顶部有“插件”和

系统已内置大量常用插件。

图片展示了Codex的界面,上方标题为“让 Codex 按你的方式工作”。下方有搜索框,可输入指令。界面中部有“在对话中试用”按钮。下方分为“Featured”

同时还有大量内置技能,可直接使用。

图片展示了Codex的技能设置界面。上方有“插件”和“技能”选项卡,当前选中“技能”。界面中显示“让 Codex 按你的方式工作”,并有搜索框。推荐技能有PDF

要使用某个 Skill,在对话框中输入 / 或 $,即会弹出技能列表供选择。

这张图片展示了Codex工具的技能选择及输入界面,上方列表呈现了多个技能选项,包括用于生成或编辑图片的Image Gen、将视觉目标转化为响应式前端的Image

想要安装第三方开发的 Skill 更简单——直接将该 Skill 的链接发给 Codex,让它帮你完成安装即可。

4.11 个性化设置:全局 AGENTS.md 与项目 AGENTS.md

进入设置中的「个性化」,里面有个「自定义指令」选项,这实际上就是全局的 AGENTS.md。

图片展示了Codex的个性化设置界面,其中“自定义指令”选项被突出显示,对应全局的AGENTS.md。界面左侧为设置菜单,选中“个性化”选项。右侧个性化设置页面

AGENTS.md 可以理解为给 Codex 制定的行为规范。全局这份是通用规则,例如「默认使用中文」「先讲结论、少做铺垫」「删除文件等危险操作必须先征求我的同意」等。设定后,无论开启多少个新对话,AI 都会遵守这些规则。

项目级的 AGENTS.md 则是针对具体项目的特殊约定。这个无需自己编写——直接打开对应项目,跟 Codex 说「帮我写一份这个项目的 AGENTS.md」,把你的关注点跟它聊清楚,让它自动生成即可。

4.12 记忆功能

同样在个性化设置中,有记忆相关的开关,建议开启。开启后,AI 会在对话结束或闲置一段时间后,自动将之前的对话总结为记忆并保存,后续遇到相关话题时会自动调用。

这张图片展示的是Codex的记忆(实验性)设置界面,该界面用于设置Codex收集、保留和整合记忆的相关规则。界面中「启用记忆」的右侧开关呈蓝色开启状态,而「Ch

4.13 如何查看剩余额度

使用过程中可能需要了解剩余额度。有两种方式:一是点击左下角设置,里面有「剩余额度」选项;二是更快捷的方式——直接在对话框输入 /,调出「状态」(status)。

图片展示了Codex AI的个人账户界面。在“个人资料”下,有“设置”选项。在“剩余用量”部分,显示了5小时内剩余91%(19:19)、1周内剩余58%(6月1

它会显示 5 小时内剩余额度、本周剩余额度以及刷新时间,非常直观。

核心玩法部分就介绍到这里。熟练掌握这些功能后,日常需求基本都能高效完成。

五、 往「精通」摸一摸

以下是 Codex 较为进阶、也更强大的功能。先说明一点:本章介绍的功能目前基本为 Mac 专属,Windows 暂不支持。Windows 用户可以先了解,等待官方后续更新。

5.1 Computer Use:让 AI 直接操控你的电脑

这是 Codex 最强大的能力之一。它能通过「看屏幕 + 操作鼠标键盘」的方式,真正地操控你的电脑——比如帮你去某个网站搜索、下载、安装软件。全球范围内能做到这种可视化电脑操控的产品屈指可数,Codex 在这方面做得相当出色。

要使用此功能,先去设置中打开「电脑操控」开关。

这张图片展示的是Codex软件的设置界面,左侧菜单栏被高亮选中的选项为“电脑操控”,该功能即文档提及的Computer Use。右侧界面明确标注了“电脑操控”模

使用时,在对话框中用 @ 点名 Computer Use,告诉它你要做什么即可。它操作时,屏幕上方会出现提示条,让你知道它正在接管。

遇到输入密码、登录账号等涉及安全的步骤时,它会自动暂停并让你手动操作,这一点做得相当稳妥。

5.2 定时任务自动化:让 AI 按计划自动执行

你可以为 AI 设定定时任务,让它在固定时间自动执行某项工作。例如设置每天早上九点自动巡检,它到点会自行运行,完成后将结果发送给你,实现完全托管。

这张图片展示的是Mac端Codex的自动化功能界面,左侧导航栏中“自动化”选项处于选中状态。界面中央标注有“创建首个自动化”的提示,下方提供了每日简报、每周回顾

再次强调:以上进阶功能目前均为 Mac 专属,Windows 暂不支持。Windows 用户不必白费力气寻找,先把前面四章的功能用熟,等待官方后续更新即可。

六、 写在最后

至此,从安装、登录、设置中文,到无账号接入国产模型,再到核心玩法与进阶能力,本文已将 Codex 的完整使用路径串联起来。

其实你会发现,Codex 并没有那么高深莫测——难点就那么几处,绕过去之后,剩下的自己上手试一试,很快就能熟练。

接下来,就交给你自己去探索了。希望这篇教程对你有所帮助,玩得开心。

AI,确实让人上瘾!

既然看到这里了,如果觉得内容不错,欢迎点赞、在看、转发三连支持;如果想第一时间收到推送,也可以给我个星标⭐。

感谢阅读。