副業工具箱

Codex 小白入門課｜第二章

從零開始安裝 Codex：小白第一次打開終端機也能跟著做

第一章我們先講要準備什麼工具，第二章就要真的開始安裝 Codex。這一章會把你當成真正的小白：不知道終端機是什麼、不知道要打在哪裡、不知道看到什麼算成功，這些都沒關係。

你只要照著做，一步一步來。這章不是要你變成工程師，而是讓你知道怎麼把 Codex 安裝好，之後才可以叫它幫你改檔案、做網站、整理文章。

先看短影音版：1 分鐘看懂安裝流程

如果你還沒打開過終端機，可以先看這支短影音。它會用最白話的方式，把 Node.js、PowerShell、Terminal、npm 和 Codex 登入流程先串起來。

也可以直接到 YouTube 觀看

先講白話：安裝 Codex 不是像一般 App 一樣一直按下一步。它比較像先幫電腦裝一個「可以聽指令的入口」，然後你在黑色或白色的小視窗裡輸入 codex，Codex 才會開始跟你工作。

這一章要完成什麼？

  1. 知道什麼是終端機。
  2. 安裝 Node.js，讓電腦可以使用 npm。
  3. 用 npm 安裝 Codex CLI。
  4. 輸入 codex 啟動 Codex。
  5. 登入 ChatGPT 帳號。
  6. 確認看到 Codex 畫面，代表安裝成功。

先懂三個名詞，不用背

終端機是什麼？

終端機就是一個可以用文字命令控制電腦的小視窗。Windows 常見的是 PowerShell，Mac 常見的是 Terminal。你可以把它想成「跟電腦下指令的對話框」。

Node.js 是什麼？

你可以先把 Node.js 想成一個讓電腦可以安裝某些工具的底座。Codex CLI 可以透過 npm 安裝，而 npm 通常會跟 Node.js 一起來。

Codex CLI 是什麼？

CLI 的意思是命令列工具。小白不用記英文，只要知道：這是可以在終端機裡啟動 Codex 的版本。官方文件也說 Codex CLI 是在你電腦本機執行的 coding agent。

安裝前先確認你有什麼

第一步：先安裝 Node.js

如果你不知道自己有沒有 Node.js，就照這一段做。裝過也沒關係，後面會教你怎麼檢查。

Windows 和 Mac 都可以這樣開始

  1. 打開瀏覽器。
  2. 到 Node.js 官方網站：https://nodejs.org/en/download
  3. 下載適合你系統的版本。
  4. 打開下載好的安裝檔。
  5. 小白先用預設選項，一路照著安裝。
  6. 安裝完以後，先把終端機關掉再重新打開。

第二步：打開終端機

Windows 小白打開方式

  1. 按鍵盤左下角的 Windows 鍵。
  2. 輸入 PowerShell。
  3. 點開「Windows PowerShell」。
  4. 你會看到一個可以輸入文字的視窗。

Mac 小白打開方式

  1. 按 Command + 空白鍵。
  2. 輸入 Terminal 或「終端機」。
  3. 按 Enter 打開。
  4. 你會看到一個可以輸入文字的視窗。

第三步：確認 Node.js 和 npm 有沒有成功

打開終端機後，先輸入下面這一句，再按 Enter：

node -v

如果畫面出現像 v20.0.0、v22.0.0 這種版本號，代表 Node.js 有裝好。數字不一定跟這裡一樣，重點是要有出現版本號。

接著輸入：

npm -v

如果也出現一串數字，代表 npm 可以用。

如果看不懂錯誤：不要慌。把整段錯誤複製起來，問 Codex 或 ChatGPT：「我是電腦小白，這段錯誤是什麼意思？請一步一步教我修。」

第四步：安裝 Codex CLI

確認 npm 可以用以後，在終端機輸入下面這一句，然後按 Enter：

npm install -g @openai/codex

這句話的意思是：請 npm 幫你把 OpenAI 的 Codex 工具安裝到這台電腦，之後你可以直接輸入 codex 叫它出來。

安裝時畫面會跑一些英文，這很正常。小白先不要急著關掉，等它跑完，回到可以輸入下一行命令的狀態。

第五步：啟動 Codex

安裝完以後，輸入：

codex

正常情況下，你會看到 Codex 開始啟動，可能會要求你登入。官方建議可以選擇用 ChatGPT 帳號登入，這樣就能用你的 ChatGPT 方案使用 Codex。

第六步：登入 ChatGPT

  1. 看到登入提示時，選擇用 ChatGPT 登入。
  2. 瀏覽器可能會自動打開登入頁。
  3. 輸入你的 ChatGPT 帳號。
  4. 登入成功後，回到終端機。
  5. 如果 Codex 畫面可以輸入任務，代表你已經進去了。

Windows 和 Mac 哪裡不一樣？

Windows

Windows 通常用 PowerShell。小白最常卡在權限、路徑、安裝後沒有重新開終端機。如果輸入 codex 找不到，先關掉 PowerShell 再重新打開。

Mac

Mac 通常用 Terminal。有些人會用 Homebrew 安裝，官方文件也提供 brew install --cask codex 這種方式。但小白先用 npm 方式即可，因為 Windows 和 Mac 都能用同一套邏輯。

小白最常遇到的 5 個問題

1. 輸入 node -v 沒反應或找不到

通常是 Node.js 沒裝好，或安裝後終端機沒有重開。先重新開 PowerShell / Terminal，再試一次。

2. 輸入 npm -v 找不到

通常也是 Node.js 安裝問題。回到 Node.js 官網重新安裝一次。

3. npm install 跑很久

先等一下。有時候網路慢。如果真的卡很久，把畫面錯誤複製下來再問 Codex。

4. 輸入 codex 顯示找不到命令

先關掉終端機重新打開。如果還是不行，可能是安裝沒有成功，重新跑一次安裝命令。

5. 登入時不知道選哪個

小白優先選 ChatGPT 登入，不要一開始就碰 API Key。API Key 需要另外設定，對新手比較容易搞混。

安裝成功後，第一句不要亂下大任務

你剛裝好 Codex，不要馬上叫它「幫我做一個完整網站」。先用很小的任務測試。

你好，我是電腦小白。
請先不要修改任何檔案。
請告訴我你現在能幫我做哪些事情，
並用小白能懂的方式列出 5 個例子。

如果它能正常回覆，代表你已經可以開始學第三章：怎麼跟 Codex 說話。

第二章檢查表

工具推薦版位：未來可放 MacBook、Windows 筆電、螢幕、鍵盤、雲端備份、Node.js / Codex 安裝陪跑服務。

下一章預告

第三章就要進入真正使用：安裝好了以後，你第一句要怎麼跟 Codex 說？我們會用「小白老闆與 Codex 員工」的方式，教你怎麼交代任務、限制範圍、驗收成果。

參考來源