KEXU
Codex 中文教程

第一次用 Codex:
完成一个看得见的小任务

从入口、登录到任务描述,带你做一个本地商品介绍页,再检查它是不是真的能用。

KEXU 编辑整理 · 发布 2026-08-16 · 更新 2026-09-06
刚开始使用时,先选定一个工作目录和一个小目标。本文采用“制作本地商品介绍页”的练习,帮助你学会描述要求、检查文件和继续修改。练习文案由 KEXU 编写,产品事实附有官方来源。

先选一个入口

官方快速开始页面列出了桌面、网页,以及面向开发者的 Codex CLI 和 IDE 扩展入口。你可以根据平时的工作方式选择:习惯图形界面就从桌面开始,习惯终端或编辑器则使用对应的 Codex 工具。下载与安装请从官方页面进入,按自己的系统选择版本。查看官方快速开始

本篇练习使用能够操作本地文件的入口。建议单独建立一个练习文件夹,例如 codex-practice,把它选作工作目录。这样你能清楚看到本次新增了哪些文件。

ChatGPT 登录和 API Key 有什么区别?

官方认证文档区分了两种方式:ChatGPT 账号登录使用对应订阅访问权限;API Key 登录按 OpenAI Platform 的 API 使用计费。支持 API Key 的本地入口也可能缺少部分依赖 ChatGPT 云服务的功能。不能把第三方店铺余额理解为 OpenAI 官方 API 余额。具体账号能用什么,以实际账号和官方说明为准。查看官方认证说明

如果你已经安装 CLI,可以用下面的命令查看当前认证方式。它只用于查看状态,不会购买额度:

codex login status

遇到额度问题时,先记下使用入口、登录方式和错误提示,再查对应账户的用量。发给客服的截图应遮住密钥和登录凭据。

练习:做一个商品介绍页

练习目标是得到一个能在浏览器里打开的 HTML 文件。以下商品是虚构示例,不连接商城,也没有付款功能。你可以直接使用下面这段任务描述:

在当前练习文件夹里制作一个中文商品介绍页,保存为 product-demo.html。

商品名:示例 AI 学习工具包。
正文分为:适合谁、包含什么、使用前准备。
适合谁:第一次尝试 AI 工具的新手。
包含什么:一份练习清单和三段示例任务描述。
使用前准备:一台电脑和一个专用练习文件夹。

采用浅色背景,手机上文字也要清楚。页面不标价,不添加购买按钮,不使用外部图片。
完成后提供文件路径和打开方式,并检查窄屏下是否有横向滚动。

这份练习把内容、文件名和检查标准都交代清楚了。你不必先决定用哪一个网页框架;一个小页面通常可以先从单个 HTML 文件开始。

官方提示词指南建议说明目标、有关背景、输出要求和必要边界;不需要机械地填满一个固定模板。本文示例是为新手练习单独编写的。查看官方任务描述指南

收到结果后,怎么继续?

打开它提供的文件,先看标题和三段正文是否齐全,再缩窄浏览器窗口。检查长句有没有被截断、是否需要左右拖动,以及字号是否适合阅读。不要仅凭对话中的“完成”两个字判断结果。

假设页面能打开,但你觉得段落太挤,可以接着说:

这个页面的正文有点挤。把段落之间的距离增加,正文行距调大一点。保持商品名称和三段内容不变,完成后让我查看修改后的文件。

如果打开的是旧页面,先确认文件路径,再刷新浏览器。若仍看不到变化,把“打开的是哪个文件、做了什么、看到什么”写清楚。例如:

我打开的是练习文件夹里的 product-demo.html。刷新以后,手机宽度下正文仍然超出右侧。请检查导致横向滚动的元素,修复后重新验证。

这些检查是本练习的验收方法。之后做真实任务时,把标准换成实际需要的结果:表格能筛选、链接能打开,或一个具体错误不再出现。

本次练习的完成标准
检查项应看到的结果
文件工作目录中有 product-demo.html,且浏览器可打开。
内容标题和三段指定内容齐全,没有编造商品权益。
窄屏正文完整显示,没有横向滚动。
修改刷新后能看到段间距变化,原文仍保持一致。

新手常见疑问

要先买店里的商品才能学吗?

不需要。教程免费阅读;使用工具需要什么账号和权限,应先查看对应官方说明,再根据实际需求决定。

官方教程那么多,应该从哪里读?

做第一次练习时看快速开始;登录有疑问时查认证说明;任务结果偏离预期时查提示词指南。先完成一个小任务,再根据遇到的问题补充知识。

页面在本地打开,别人就能访问了吗?

本练习只生成本地文件。你电脑里的文件路径不是公共网址;需要对外展示时,还要另行选择托管方式并验证访问。

为什么本文不固定写某套餐有多少额度?

教程重点是学习操作。套餐权益与用量应查看官方当前说明和自己的账户页面,避免把旧教程里的数字当作当前承诺。

对应官方文档

以上内容于 2026-09-06 核对。本文为 KEXU 独立编写的中文入门练习,并非官方全文翻译或官方授权教程。产品界面发生变化时,请以对应官方页面为准。

继续学习

准备选择数字服务时,可先阅读购买检查清单,核对交付方式、适用条件与售后范围。

查看购买检查清单