zero2codex
OpenAI Codex workflow course

Course goal: ship your personal brand site

Build a personal brand site with Codex

Keep improving one project from an empty folder to a responsive one-page site with an introduction, projects, and contact details. Every lesson adds a visible result or a check toward that finish line.

Curriculum

Personal brand site build path

01

Start With Codex

Set up Codex and build the hero section of your personal brand site.

0/4
02

Prompt Like A Builder

Map the site, plan its sections, and turn rough ideas into clear changes.

0/3
Find the Files to ChangeAsk Codex to show which files control each part of the site before you edit anything.Plan Before CodingPlan the site's theme control before editing, including risks and browser checks.
10 minReady

Plan Before Coding

Use a plan to reduce surprise before Codex edits production files.

implementation sequenceblast radiusreview checkpoints

Watch, then try

05|先規劃主題切換(CLI 版・25 秒)

真實 CLI 輸出檢視器與本機網站錄影,非 Codex 原生介面;繁中字幕、無旁白,等待區段已剪接。

zero2codex
MP4

Step-by-step

  1. 沿用前一課的 my-brand-site,或從下方練習檔取用本課 before 起點。
  2. 在專案目錄執行本片 CLI 指令;本課權限為 read-only。
  3. 核對實際輸出與結束碼,不把文字回報當成瀏覽器操作證據。
  4. 先確認三步計畫和完成條件,下一課才實作。
跟著本片操作:CLI 指令與練習檔(繁體中文)

這是本課的 CLI 替代實作路徑;下方概念課程仍保留其他介面的說明。先安裝並登入 Codex CLI,在 my-brand-site 資料夾內執行下列 macOS/Linux 指令。影片將真實 CLI JSON 事件排版成易讀畫面,下列指令使用一般 CLI 輸出;不是 Codex 原生介面,等待區段已剪接。

codex exec --ephemeral --ignore-user-config --sandbox read-only '讀 index.html 後提出三步計畫,新增深淺主題切換。要有可辨識的按鈕名稱,點两次恢復,兩種主題 CTA 都正常,手機不溢出。只規劃,不改檔;把程式檢查和瀏覽器檢查分開。限 180 字。'

下載逐課練習檔與實際結果(ZIP)

10-minute lab

Hands-on lab

Plan a small light/dark theme switch for the mapped personal brand site. This lesson ends with an approved plan, not edited code.

Before you start

  • Keep the file and feature notes from the previous lesson available for reference.
  • Open my-brand-site and start a new task named Plan theme switch.

Do it now

Good prompt

Codex, inspect index.html and propose a three-step plan for adding an accessible light/dark theme switch. Keep the project in one file, add no packages, and preserve the existing Projects button and section navigation. Include the exact behavior, likely risks, and browser checks at wide and narrow widths. Do not edit until I approve the plan.

What success looks like

  • Codex returns a short ordered plan and makes no file changes.
  • The plan identifies the exact file and the visible behavior to add.
  • Verification covers clicking the switch and checking both wide and narrow layouts.
Stuck? Try this
  • If Codex edits immediately, reply: “Stop after planning and revert any implementation changes.”
  • If the plan says only “update CSS and JS,” ask it to name the specific UI state and manual checks.

Plain-language explanation

Planning first means Codex explains the likely sequence before it edits files. The plan should name files, order of changes, tests, and risks.

You do not need a huge plan. For most beginner tasks, a three-step plan is enough to catch misunderstandings before code changes happen.

Why it matters

A short plan gives you a review checkpoint. It is much cheaper to correct a plan than to untangle a wrong implementation.

Common beginner mistake

Beginners often let Codex start editing immediately, then review a diff that is larger than expected.

Try this

Choose a change that touches more than one file. Ask Codex for a plan and reject any plan that does not name verification.

Completion checklist

  • The plan names files likely to change.
  • The plan includes a test or manual check before implementation begins.

Sources

Define Done WhenDefine visible completion checks, then implement the site's light and dark themes.
08

Finish And Deliver The Site

Polish independent tasks in parallel, then complete one final acceptance review.

0/3

Practice lab

Copyable Codex prompts

Plan before coding

Codex, inspect the relevant files first, then propose a plan. Do not edit until the plan names tests and verification steps.

Verification checklist

  • Relevant files are named before edits begin.
  • The plan includes tests and verification commands.

Verify a UI change

Codex, start the dev server, open the route in the browser, check desktop and mobile layouts, then report the exact evidence.

Verification checklist

  • Desktop and mobile states are checked in the browser.
  • The final note includes exact evidence.

Review focused risk

Codex, review the uncommitted diff. Focus on behavioral regressions, missing tests, and accessibility issues. Do not modify files.

Verification checklist

  • Findings lead with severity and file references.
  • Unchanged files are left untouched.
Every good Codex request says what to change, what to preserve, and how to prove it worked.

Reference

Codex concepts to keep nearby