跳到主要内容
Agent 实践室CODEX STUDY CLUB

THE CODEX FIELD GUIDE / 学习路线

从第一次使用,
到独立完成任务。

边学边做,把每一步变成可以检查的结果。
从头阅读,或从你现在需要的那一章开始。

浏览完整目录
一本可以随时查阅的实践手册
14篇中文教程
4 个学习阶段

不用一次读完。选一个小任务,打开教程,对照实际结果继续往前。

01

阶段 1 · 5 篇

先把工作环境准备好

认识使用入口,确认账号与配置,找到自己的项目。

  1. 01

    Codex 是什么:按任务选择使用入口

    区分桌面应用中的 Codex、CLI、IDE 和云端任务,从熟悉的工作环境完成第一次可验证练习。

  2. 02

    Codex 桌面安装与首次验证

    从当前官方桌面入口安装并登录,选择 Codex 和项目文件夹,用一个只读任务核验是否能正常工作。

  3. 03

    Codex 账号、套餐与可用范围

    先核对现有账号能使用的 Codex 入口、模型和额度,再决定是否需要付费或采用 API Key。

  4. 04

    连接第三方 API:先分清登录与供应商配置

    区分 ChatGPT 登录、OpenAI API Key 与自定义供应商,按官方字段准备最小配置,并逐项验证兼容性。

  5. 05

    认识 Codex 桌面:项目、任务与运行位置

    确认 Codex 入口、本地项目和任务运行位置,学会检查文件、执行记录与改动结果,不依赖旧版按钮截图。

02

阶段 2 · 4 篇

亲手完成一个任务

从一张学习卡片开始,练习描述需求、跟进任务和检查结果。

  1. 06

    第一个 Codex 任务:做一张可验收的学习卡片

    用空目录里的一个 HTML 文件练习任务描述、结果预览、逐项验收和小步迭代,明确文件生成与发布的区别。

  2. 07

    任务设计:写清结果、范围和验收证据

    把模糊需求变成可执行任务,按需要补充上下文、边界与验收方式,并用本仓库文档修改练习任务描述。

  3. 08

    任务执行:跟进、审查与验证结果

    区分执行中纠偏与排队跟进,用 diff、实际命令和页面证据判断任务状态,避免把记录失败当作验收通过。

  4. 09

    用手机跟进 Codex:配对主机与验收任务

    从桌面端配对手机,在 Remote 中跟进 Codex 工作,区分连接成功、任务完成和部署可用。

03

阶段 3 · 3 篇

把实践带进命令行

安装 CLI,在仓库里做一次小改动,再学习常用命令与任务恢复。

  1. 10

    安装 Codex CLI:排查脚本 404、找不到命令与登录失败

    用不执行安装脚本的请求检查、命令路径和版本定位失败阶段,再分别验收安装、登录与只读任务。

  2. 11

    CLI 第一个任务:只读了解、小步修改、逐项验收

    以 README 的一处修改练习 Codex CLI,检查文件差异和项目验证,只提交确认过的本次文件。

  3. 12

    CLI 选项与命令:选对目录、只读检查与恢复任务

    先核对版本与帮助,再用只读任务练习交互、exec 和精确恢复会话,分清当前轮纠偏与下一轮排队,并验收输出证据。

04

阶段 4 · 2 篇

找到适合你的工作方式

按项目需要,继续了解编辑器里的协作与云端任务。

  1. 13

    在 VS Code 中使用 Codex:安装、上下文与消息排队

    从官方入口安装扩展,用文件依据完成只读任务;分清发送、排队、当前轮纠偏与未送达,附可下载的消息故障记录表。

  2. 14

    使用 Codex Cloud:环境保存后,怎样确认任务能跑

    Codex Cloud 环境已保存却不能运行?分清 Save、Publish、新任务与 PR,附只读就绪检查提示词和失败分流方法。

PUT IT INTO PRACTICE / 继续动手

带着一个真实问题,去看看别人怎么做。

案例库按任务整理实践过程、可复用方法和验收依据。

探索实战案例