PWPieceWise AI搜尋 Model / MCP / Skill
圖文教學 · 已按官方文件核對 · 初心者友善

安裝 OpenAI Codex

Codex 有幾個入口:CLI、IDE、Desktop app、Codex Web。呢頁教你先裝 CLI,之後再講點樣登入同開始第一個 project。

資料來源:OpenAI Codex docs + openai/codex GitHub README

先分清四個 Codex 入口

如果你想喺自己電腦 project folder 入面叫 AI 寫 code,最直接係 Codex CLI。如果想喺 editor 入面用,就裝 IDE integration。Cloud-based agent 就去 Codex Web。

Codex surfaces

CLI:terminal 入面打 codex

IDE:VS Code / Cursor / Windsurf

Desktop:codex app

Web:chatgpt.com/codex

1

macOS / Linux 安裝 Codex CLI

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex
官方 README 指出 Mac / Linux 用以上 installer;installer 預設由 releases.openai.com 下載,失敗會 fallback GitHub Releases。
Terminal

貼上 install command

等下載完成

輸入 codex 啟動

2

Windows 安裝 Codex CLI

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex

如果 Windows policy 阻擋 script,請用系統管理員 PowerShell 或檢查公司/學校機 App Control policy。

PowerShell

用 PowerShell

貼上官方命令

完成後開新 terminal

3

其他安裝方法:npm / Homebrew

# npm
npm install -g @openai/codex

# macOS Homebrew
brew install --cask codex
Alternatives

npm 適合已有 Node.js

Homebrew 適合 macOS

binary 適合進階用戶

4

登入:建議用 ChatGPT plan

官方建議:執行 codex 後選 Sign in with ChatGPT,可用 Plus / Pro / Business / Edu / Enterprise plan。API key 也可以,但需要額外設定。

codex
Login choice

Run codex

選 Sign in with ChatGPT

Browser 完成登入

回到 terminal

5

第一個 project 測試

cd ~/my-project
codex
# 然後輸入:
請先閱讀這個 project,解釋目錄結構,暫時不要修改檔案。
第一次使用唔好即刻叫佢大改 code。先叫 Codex 讀 project、解釋、列 plan,確認後先改。
First prompt

cd 你的 project

codex

叫佢解釋 repo 結構

官方來源

OpenAI Codex Documentationopenai/codex GitHub READMECodex Web