給第一次碰終端機的人。全程約 15 分鐘，只需要複製貼上五行指令。不需要 VS Code，不需要懂 Node.js，不需要架環境。
先講結論。你要做的只有三件事：打開 Mac 內建的「終端機」；貼上一行安裝指令按 Enter；輸入 codex，用 ChatGPT 帳號登入，然後開始用中文跟它講話。
沒有的東西不用擔心：不需要先裝 VS Code、不需要先裝 Node.js、不需要先申請 API 金鑰。
terminal會跳出一個視窗，最後一行長得像這樣：
你的電腦名稱 ~ %
那個 % 就是「請下指令」的意思。游標會停在它後面，你打的字都出現在那裡，打完按 Enter 才會執行。
這個視窗裡沒有「存檔」的概念，打錯字直接按刪除鍵改掉就好；還沒按 Enter 之前都不算數。
把下面這一整行複製起來（右邊有複製鈕），貼到終端機裡，按 Enter：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
跑完之後你會看到一堆 ==> 開頭的訊息，那是正常的進度報告。
~/.local/bin/codexcodex 就找得到它設定資料則放在 ~/.codex/ 這個資料夾裡。
裝完必做：關掉終端機，重新打開。設定檔的修改要重開終端機才會生效。按 Command + Q 完全結束，再重新打開一次。
codex --version
有出現版本號（例如 0.145.0）就是成功了。
| 情況 | 指令 |
|---|---|
| 已經有 Homebrew | brew install --cask codex |
| 已經有 Node.js | npm install -g @openai/codex |
最常見的安裝失敗原因：打成 npm install -g codex（少了 @openai/），會裝到完全無關的別的套件。認明 @openai/codex。
Codex 會直接動「你所在資料夾」裡的檔案，所以第一次玩，先開一個乾淨的資料夾，不要在重要專案裡練習。依序貼上這兩行，一行一行按 Enter：
mkdir ~/codex-practice
cd ~/codex-practice
| 指令 | 原文 | 白話 |
|---|---|---|
pwd | print working directory | 我現在人在哪個資料夾？ |
ls | list | 這個資料夾裡有什麼？ |
cd 資料夾名 | change directory | 進去某個資料夾 |
補充：cd .. 是「退回上一層」，~ 代表你的家目錄。會這三個就夠用了。
codex
登入一次就好，之後開啟不用再登入。
畫面下方有個輸入框，直接用中文打字，按 Enter 送出。試試看：
請在這個資料夾建立一個 hello.html，內容是一個寫著「你好，世界」的網頁，字要大一點。
Codex 會先跟你說它打算怎麼做，動手改檔案前會問你要不要同意。看到問你就是好事，代表安全鎖在運作。
做完之後，另開一個終端機視窗輸入 open ~/codex-practice/hello.html，就能用瀏覽器打開看成果。
這是新手最該懂的一件事。在 Codex 畫面裡輸入 /permissions，可以選三種模式：
| 模式 | 它能做什麼 | 適合誰 |
|---|---|---|
| Read-only 唯讀 | 只能看檔案，不能改 | 第一次用、只想問問題 |
| Auto 自動 | 可以改檔案、執行指令，但重要動作會先問你 | 一般日常使用，建議從這裡開始 |
| Full access 完全存取 | 全部自己來，不問你 | 你很清楚它在做什麼的時候 |
新手建議：從 Auto 開始，被問到就一項一項看清楚再同意。不要一開始就開 Full access。
在 Codex 畫面裡，以 / 開頭的是「對 Codex 本身下的指令」，不是對 AI 說話：
| 指令 | 用途 |
|---|---|
/init | 產生一份 AGENTS.md，記錄這個專案的規矩給 AI 看 |
/status | 看目前用哪個模型、哪個資料夾、什麼權限 |
/permissions | 改上面說的安全鎖 |
/model | 換模型、調整思考深度 |
/review | 請它檢查你改過的東西有沒有問題 |
另外，在畫面裡按 ? 會列出所有快捷鍵。
codex resume，可以叫回最近的對話紀錄，不用從頭講一遍codex exec "把 README 的錯字修好"執行 /init 之後，資料夾裡會多一個 AGENTS.md 檔案。它是純文字檔，可以直接用文字編輯器打開改。裡面寫的是「這個專案的規矩」，例如：
config/ 這個資料夾Codex 每次開工都會先讀它。這跟你正在學的「skill」是同一種概念 — 都是把「你希望 AI 怎麼做事」寫成檔案，讓它每次都照辦，不用你每次重講。差別只在名字和放的位置不同。
強烈建議在有版本控制的資料夾裡用 Codex。萬一它改壞了，一行指令就能還原；沒有版本控制的話，改壞了就真的回不去了。
最低限度的保命做法，在資料夾裡先做這兩步：
git init
git add -A && git commit -m "before codex"
之後想反悔，就用 git checkout . 回到剛剛那個狀態。
更新：跟安裝同一行指令，再跑一次就是更新。
curl -fsSL https://chatgpt.com/codex/install.sh | sh
用 Homebrew 裝的人用 brew upgrade --cask codex；用 npm 裝的人用 npm update -g @openai/codex。
移除：把 ~/.local/bin/codex 和 ~/.codex/ 這兩個位置移到垃圾桶即可。
| 畫面上出現 | 意思 | 怎麼辦 |
|---|---|---|
zsh: command not found: codex | 終端機找不到程式 | 你沒重開終端機。完全關掉再開一次，或執行 source ~/.zshrc |
| 貼上指令後沒反應 | 可能忘了按 Enter | 按一下 Enter |
| 瀏覽器沒跳出登入頁 | 被擋住了 | 把終端機裡顯示的那串網址複製起來，自己貼到瀏覽器打開 |
| 提示已達用量上限 | 免費／Plus 額度用完 | 等額度重置（以 5 小時為一個區間），或升級方案 |
| 它改壞了我的檔案 | 沒有先做版本控制 | 見第十一節，事前 git commit 是唯一的後悔藥 |
| 打錯字卡住了 | — | 按 Control + C 兩次，重新開始 |