桌面版：Windows、macOS、Linux

返回 Codex 教学总目录

读完能做到什么

桌面应用程式负责让你管理任务、档案与成果。模型负责理解需求；任务则保存这一次工作的对话与环境。开始之前先分清楚这三件事，才不会把「换模型」误认成「换到另一个资料夹」。需要比较入口可先看Codex 入门。

开始之前

准备能使用 Codex 的 ChatGPT 帐号及网路，依帐号与用量确认登入的工作区。方案、额度与模型选单可能依帐号不同，本篇不硬写固定价格或指定某个模型。若已有桌面版，先使用应用程式提供的更新方式，再核对下方入口。

下载Small Steps 练习包，解压缩并复制 expected 为自己的 codex-practice。这个资料夹有五个程式档案，使用虚构资料、没有登入或后端。本篇只改标题与样式，先不要把正式专案选进来。预览需要 Python 3；资料测试需要 Node.js。

先保留原始副本

解压缩后先在档案管理员把 expected 复制成两份并排的资料夹：codex-practice 用来修改，codex-practice-before 用来比对。两者都应直接包含五个原始程式档；备份放在工作资料夹外，不要放进它的子目录。Windows 用档案总管，macOS 用 Finder，Linux 用档案管理员完成相同操作。

尚未建立 Git 储存库时，应用程式的 Git 差异功能可能无法使用。你仍可用文字编辑器开启两份同名档案逐项比对；不必先学会提交或还原整个储存库。需要正式版本管理再接Git 教学。

第一步：依作业系统安装

Windows：从 ChatGPT 官方下载页选 Windows，依官方安装程式完成安装，再从开始功能表开启 ChatGPT。若你熟悉 PowerShell，也可使用官方 Windows 文件列出的命令。安装完成后重新开启应用程式；看不到新捷径时先检查安装是否结束，不要重复下载多份。

winget install --id 9PLM9XGG6VKS -s msstore

macOS：同样从官方下载页选 macOS，开启下载的安装档，依画面将应用程式安装到指定位置，再从「应用程式」开启 ChatGPT。若系统显示不相容，回下载页核对目前系统需求；不要用停用系统保护来处理版本不支援。安装后关闭安装视窗，再确认启动的是已安装的程式。

Linux：桌面版目前是预览版，官方列出 Ubuntu 24.04／26.04 LTS、Debian 13、Fedora 43／44，以及保持完整更新的 Arch Linux，均支援 x64 与 ARM64。先在终端机确认系统与处理器，再从Linux 官方安装页选择对应套件或安装脚本。其他发行版不在这次正式支援清单中，不要把套件装得进去当成全部功能受支援。

cat /etc/os-release
uname -m

Ubuntu／Debian 选 .deb，Fedora 选 .rpm；Arch 使用官方安装脚本。x86_64 代表 x64；aarch64 或 arm64 选 ARM64。在放有下载档案的资料夹开启终端机，只执行符合自己系统的方式。档案被浏览器加上编号时，先核对实际档名。

Arch 下载官方脚本后再以 sudo 执行；脚本会设定 OpenAI 签署的套件库并进行完整系统更新，执行前先阅读内容与确认提示。

curl --proto '=https' --tlsv1.2 -fL -o install-arch.sh https://persistent.oaistatic.com/codex-app-prod/linux/install-arch.sh
sudo bash install-arch.sh

Linux 安装后从应用程式选单开启 ChatGPT，或在终端机执行 chatgpt。后续更新使用发行版套件管理器。预览版尚未支援 Computer Use，原生 Wayland 仍有实验性限制；这不妨碍你先练习档案修改与手动浏览器验收，也不要用 macOS 截图代表 Linux 实际画面。

第二步：登入并选择练习位置

三种系统都先在应用程式完成登入，确认帐号与工作区，选择 Codex，再以开启资料夹或建立专案的入口选 codex-practice。应直接看到 index.html 等档案，而不是压缩包或上一层资料夹。若画面要求选本机或其他工作环境，这一篇选自己的练习副本所在位置。

建立 New chat 后先做唯读确认。把下列文字贴在 Codex 任务输入框，不是 PowerShell 或 Terminal。这一步能提早发现选错专案、档案没解压缩，以及任务开在另一台主机等问题。

Before editing, report the current working folder and list the exercise files.
Read index.html and explain how the page loads its JavaScript.
Do not change files. Tell me if the expected five files are missing.

预期指出实际资料夹，并找到 app.js 及 core.mjs 的关系。与你的档案总管比对路径，不要只看到「我已了解专案」就跳过。若应用程式开了工作树副本，请先核对副本位置；详见Worktree。本例不需要 Git 仓库也能开始。

第三步：交付一个可验收的小修改

Update this Small Steps practice website.
Change the main heading to "Small steps, clear progress."
Use a dark blue heading color with readable contrast on the existing background.
Keep the form labels, task data format, storage key and behavior unchanged.
Do not add dependencies or external services.
Show the changed files, explain the diff and report checks actually performed.

等待任务提供成果后，从档案或变更检视开启 index.html、style.css。检查标题字串与颜色设定是否对应需求，是否意外修改储存格式或删除标签。档案差异中的新增与删除只是比较结果，不表示网站已发布。第一次不用同时要求登入、云端部署与资料库；先完成一个可以自己验收的小范围。

先核对差异，再看画面

若多改了档案，先要求说明每处差异，核对后只撤回本题以外的修改。不要用整个资料夹覆盖来掩盖原因。也不要用「只有两个档案变动」代替接下来的功能验收。

第四步：在浏览器确认结果

在练习资料夹开终端机，Windows 使用下列命令。服务会持续占用这个终端机，这是正常状态；另开浏览器，不要因为没有回到提示符号就再次启动。

py -m http.server 4173 --bind 127.0.0.1

python3 -m http.server 4173 --bind 127.0.0.1

开启 http://127.0.0.1:4173。若这个来源已有想保留的虚构任务，先另行记录；展开 About this exercise，选 Reset practice data，再切到 All tasks 并确认清单为空。这只清除练习资料，不会还原程式档。接著新增 Read 与 Build，完成 Read；Active tasks 应只剩 Build，Completed tasks 应只剩 Read。重新整理后资料应保留。输入只有空白的任务不得新增；这是与正常流程一起检查的边界案例。

用浏览器开发工具的响应式模式检查 390 与 1280 像素，或缩小视窗检查窄版；文字、按钮与表单不应左右溢出。按 Tab 时要看得到焦点。再于另一个同目录终端机执行 node --test core.test.mjs，参考版应为 3 个测试通过。若 Codex 没有浏览器工具，就由你执行画面验收，并保留「未由代理实测」的纪录。

常见问题、停止与还原

应用程式中没有 Codex：先核对是否已更新、登入正确帐号与工作区，再查帐号可用功能。不要反复重装来处理额度或工作区管理限制。CLI 是另一个入口，安装桌面版不代表终端机一定能找到 codex 命令。

开到错误资料夹：比较任务回报的绝对路径与五个档案。如果是解压缩前的 ZIP、空目录或另一个专案，停止修改，重新选择。已发生的修改要在原位置核对，不要假设切换专案会搬移档案。

网页空白或 JavaScript 没执行：确认网址是 http://127.0.0.1:4173，而不是双击档案的 file URL。再检查伺服器终端机与浏览器 Console。若连接埠已占用，停止自己先前启动的服务或选另一个连接埠；不同连接埠的浏览器储存空间不同。

停止预览使用 Ctrl+C。还原时参照差异，只恢复标题与本次样式；保留其他既有修改。练习网站的 Reset practice data 只用来清除本例专用资料，与还原程式不同。任务完成、测试通过和网站正式上线是三个不同状态。

小练习与查证纪录

把需求改成「手机上表单按钮维持整行，桌面维持与输入框并排」，要求 Codex 先说明目前样式，再做必要修改。以两个宽度及原有资料操作完成验收；如果既有样式已符合，就接受无须修改的结果，避免为了产生差异而改程式。

安装与功能依桌面官方文件、Windows 文件及 Linux 文件于 2026-09-20 查证。教材网站已在 Windows／Edge 153 的 360、390、1280px 视窗验证；这些是网页成果截图，不是桌面产品介面、实体手机或 macOS／Linux 安装实测。接著可读AGENTS.md、Plan 模式与Git 差异。

返回 Codex 教学总目录

阅读完整文字说明

Install to Folder to Review

• AI 工具
• 教程
• Codex