OpenAI Codex：它是什麼、如何安裝，以及 2026 年的地區存取條件

搜尋結果中的「Codex」一詞其實代表三種不同事物，第一次搜尋的人通常不明白自己找到的是什麼。過去曾有一個 Codex 模型，但它已於 2023 年停用；如今這個名稱指的是一套代理程式，此外還有十幾種同名產品也混在其中。

本文只介紹其中一種 Codex：OpenAI 的程式設計代理程式。它能做什麼、在哪裡執行、費用多少、如何在五分鐘內安裝，以及 OpenAI 對各國的說明。內容都以官方文件為依據，文末附有每項數據的連結。

關於工具設定的補充資料，請參閱 Ailoot 文件。

OpenAI Codex 是什麼？#

把它和一般聊天相比。在聊天中，你複製一段程式碼、貼上、取得回答，再把內容複製回去。代理程式的運作方式不同：你用日常語言描述工作，它就會開啟專案資料夾中相關的檔案、進行修改、執行檢查，並顯示結果。

OpenAI 在其程式碼儲存庫中用一句話描述它：

本機執行是指程式會下載到你的裝置，能存取檔案並在資料夾中執行命令。只有送往模型的請求會傳到雲端。

開放原始碼程式碼在 GitHub 上以 Apache-2.0 授權公開。截至 2026 年 8 月 1 日，該儲存庫有 103,000 顆星標，最新版本 0.146.0 於 7 月 29 日發布。幾乎每天都有更新，因此你使用的版本很可能已經不同。

2026 年的 Codex 與已停用的舊 Codex 有何不同？#

人們常常把它們搞混，因為兩者都是 OpenAI 的官方產品。它們的推出日期可以區分彼此。

第一種是一組模型：code-davinci-001、code-davinci-002、code-cushman-001、code-cushman-002。它們只做一件事：為你補全程式碼，並為第一代 GitHub Copilot 提供支援。在 OpenAI 的已停用模型清單中，這四個模型列在同一行：2023 年 3 月 20 日公告，3 月 23 日停用，建議替代模型為 gpt-4o。

第二種是安裝在你電腦上的程式。@openai/codex 套件於 2025 年 4 月 16 日出現在 npm 登錄檔中。程式內使用的模型會隨時間換成較新的模型，但程式本身維持不變。

2025 年 4 月以前關於 Codex 的說明，描述的都是已停用的產品。如果你找到把 Codex 稱為模型，並建議透過 code-davinci-002 呼叫它的資料，就把它關掉吧。

Codex 在哪裡運作：終端機、編輯器、瀏覽器，還是應用程式？#

你不必只能選一種。登入方式相同，帳戶也相同。差別只在於你在哪裡工作比較方便。

Xcode 和 JetBrains 的擴充功能運作方式與其他編輯器不同：

雲端的運作方式與其他四種不同。工作會送到 OpenAI 容器，並從 GitHub 複製出一份儲存庫。代理程式不需要使用你的電腦就能工作；之後你可以檢視結果，決定是否將變更帶回自己的副本。設定分三個步驟：連接 GitHub、建立包含所需相依套件的環境，以及指派工作。

如果你使用 API 金鑰登入，終端機、編輯器和應用程式都能使用。使用金鑰時無法使用雲端，也無法使用與雲端相關的功能，例如自動程式碼審查和從 Slack 啟動工作。若要使用這些功能，必須以 ChatGPT 帳戶登入。

Codex 內部使用哪個模型？#

OpenAI 用一句話概括：

模型旁邊還有另一個控制項：推理強度，共有四個設定：Low（在應用程式和編輯器中稱為 Light）、Medium、High 和 Extra High。OpenAI 建議使用能達到所需結果的最低等級，遇到需要規劃的工作時再提高等級。

除此之外還有兩種更高階的模式。Max 會讓模型花更多時間處理工作。Ultra 會把工作拆成多個部分，並平行交由子代理程式處理。文件直接指出，多數工作都不需要這兩種模式。

另外還有獨立的 gpt-5.3-codex-spark，這是供快速迭代使用的研究版本，僅 Pro 方案可用。

選擇模型和推理強度本身就是脈絡工程：你決定代理程式要思考多少，以及要為工作提供哪些資訊。這套方法有三大支柱：AI 分身（將你的方法論放進代理程式）、Second Brain（專案知識的組織架構），以及脈絡工程。缺少這些要素，AI 代理程式就會開始編造內容。

Codex 費用多少？各方案包含什麼？#

我在 2026 年 8 月 1 日依據官方價格頁面核對了價格。

Business 按月付款時，每席費用是 $25，而不是 $20。

接著談使用上限。OpenAI 沒有提供一個固定數字：

OpenAI 公布的不是單一數字，而是在自己的電腦上工作時，五小時內可傳送訊息數的範圍。Plus 和 Business 的數值相同：

100 美元的 Pro 方案中，所有數值都乘以五；200 美元的 Pro 方案則乘以二十。除了五小時時段之外，OpenAI 也提到每週上限，但沒有公布具體數字。

同一模型的使用範圍可能相差十倍，原因很簡單。一則訊息可能用掉每日額度的 1%，也可能用掉 10%，因為真正重要的是完成的工作量，請求次數影響不大。我在Claude Pro 和 Max 使用上限中，以 Claude 為例詳細說明了 token 在實際使用中的消耗方式；其運作機制完全相同。

用完額度後有三種選擇：不更換方案而購買額外點數、切換到較輕量的模型，或使用 API 金鑰開始工作階段，並依使用量支付 token 費用。

Codex 有哪些地區限制？#

OpenAI 公開了官方支援國家與地區清單。白俄羅斯不在清單中。哈薩克、亞美尼亞、喬治亞、土耳其、塞爾維亞和烏克蘭都在清單中。

同一頁面的文字如下：

安裝並執行程式是一回事，存取模型則是另一回事。登入時會進行國家檢查：無論透過 ChatGPT 登入，還是使用 API 金鑰登入，都會連結到 OpenAI 帳戶。

GitHub 上的回報顯示，因國家問題遭到拒絕時會是什麼情況。2026 年 1 月，一位來自委內瑞拉的開發者表示，他在 PowerShell 中使用 Codex 0.88.0，每次嘗試都遇到相同問題：

{
  "error": {
    "code": "unsupported_country_region_territory",
    "message": "Country, region, or territory not supported",
    "type": "request_forbidden"
  }
}

unsupported_country_region_territory 代碼和 403 狀態表示遭到與國家相關的拒絕。如果看到這個錯誤，表示安裝過程沒有出問題，Node 也與此無關。

還有一道文件完全沒提到、但實際上更常遇到的障礙：電話號碼驗證。「電話號碼驗證無法使用」這則回報有 206 則留言；另一則關於舊號碼已無法使用、也不能更換的回報，自 2026 年 6 月起一直開放，已有 71 則留言。反覆出現的情況都一樣：同一個帳戶可以在瀏覽器中使用 ChatGPT，但 Codex 要求電話驗證，而且沒有辦法繞過。OpenAI 沒有公布接受哪些國家的電話號碼，因此無法事先確認自己的號碼能否使用。

本文不介紹繞過方式，本文的主題是工具的運作方式。

Anthropic 也公布支援國家清單，運作方式相同。把一種工具說成「允許使用」，另一種說成「遭到封鎖」的資料，只會誤導讀者；從正式規定來看，兩者處於相同狀態。兩份清單都會變動，請查看最新版本。

如何安裝 Codex：逐步說明#

以下是技術步驟，適用於已擁有有效 OpenAI 帳戶的人。

1. 安裝程式

   選擇適合你系統的安裝方式。之後更新至最新版時，也請使用相同方式。

2. 開啟專案資料夾

   代理程式會在你啟動它的資料夾中工作。執行第一個命令前，先切換到該資料夾。

3. 登入帳戶

   第一次執行 codex 時，程式會提示你登入。瀏覽器會開啟，登入完成後，控制權會回到終端機。

4. 交辦第一個工作

   用日常語言描述你的需求。先從不會造成影響的工作開始，例如請它說明專案內容。

macOS 和 Linux 的安裝命令：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows 使用 PowerShell 執行相同的安裝程式：

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

如果已經安裝 Node，也可以透過 npm 安裝：

npm install -g @openai/codex

macOS 也可以使用 Homebrew。請務必加上 --cask，否則會安裝錯誤的項目：

brew install --cask codex

在 Linux 和 WSL2 上，沙箱以 bubblewrap 為基礎，因此需要事先安裝：

sudo apt install bubblewrap

Fedora 和相關系統請使用 sudo dnf install bubblewrap。此外，WSL 第 1 版支援至版本 0.114；從 0.115 起，沙箱改用 bubblewrap，WSL1 因此無法運作。不過在 Windows 上，即使不使用 WSL，也能透過內建沙箱正常運作。

初次啟動時該做什麼？#

首先切換到專案資料夾並輸入 codex，就會開啟工作階段。接著不用任何特殊語法，以日常語言描述工作即可。

剛開始幾分鐘可試試這五個命令：

1. /status - 查看模型、核准政策，以及代理程式視為工作區的資料夾。
2. /permissions - 查看目前的存取模式，以及如何切換模式。
3. /model - 更換模型和推理強度。
4. /init - 建立描述專案的 AGENTS.md 檔案；下一節會詳談。
5. /review - 單獨檢查變更，不會編輯檔案。

除了直接執行 codex，還有三個實用的終端機命令：

codex resume                    # return to the previous conversation in this folder
codex exec "fix the tests"      # one-off run without a dialogue, for scripts
codex --image screenshot.png    # attach an image to the task

在終端機和擴充功能的文件頁面中，OpenAI 都重複提出相同建議：在工作前後建立提交。代理程式會自行編輯檔案，因此從第一天開始就應確保能用一個命令還原變更。

如何透過 AGENTS.md 向 Codex 說明你的專案？#

套用順序有嚴格規定，文件在該章節第一行就說明了：

首先，Codex 會讀取全域檔案 ~/.codex/AGENTS.md，你可以在其中寫下適用於所有專案的習慣。接著它會讀取專案中的檔案：從儲存庫根目錄一路往下，到目前資料夾為止，每個資料夾各讀取一個檔案。這些規則會由上而下合併，較近的檔案會覆蓋較遠的檔案。因此，services/payments 中的規則會優先於根目錄的一般規則。

簡單的檔案範例如下：

# AGENTS.md

## How to work with this project

- Run tests with `npm test`; don't run them one file at a time.
- Install packages with pnpm.
- Ask me before adding a new production dependency.
- Do not touch the `legacy/` folder at all.

合併後的檔案總大小上限為 32 KB。超過後，後續檔案就不會再加入，而且不會發出通知。AGENTS.md 過大也會在每次執行時消耗額度，因為整份檔案都會放進脈絡中。

如果你熟悉 CLAUDE.md，這套機制應該很熟悉：只是名稱不同，用的是同一種方法。專案規則檔案可作為 Second Brain 的基礎：代理程式能在你說明之前，先了解你的工作。我在同一個專案中搭配使用 AGENTS.md 和 CLAUDE.md一文中介紹了如何使用這兩個檔案。

Codex 會自行做什麼？哪些操作需要核准？#

這兩項設定常被混淆，因此 OpenAI 用一句話說明兩者的差異：

切換為自動審核後，工作資料夾的範圍仍然不變。自動化只是省去點擊，並不會改變代理程式的權限。

應用程式和編輯器有三種存取模式。Ask for approval 永遠可用，也是建議的起始選項。Approve for me 和 Full access 則必須先在設定中啟用。

終端機有自己的機制：程式會檢查資料夾，並建議一組合適的權限。

本機模式預設會關閉網路存取。代理程式會執行它自行想出的命令，因此預設不會允許它連上網際網路。

即使在工作資料夾內，所有模式下代理程式也只能讀取某些位置：.git、.agents 和 .codex。使用 /status 查看代理程式目前視為工作區的資料夾。

此外還有完整存取模式，也就是 --dangerously-bypass-approvals-and-sandbox 旗標。文件將其標示為高風險，並註明「不建議使用」。旗標名稱已經說明一切，我沒有其他補充。

Codex 或 Claude Code：該選哪一個？#

工具之間的差異，比你從網路上的爭論中得出的印象還小。兩者都會讀取你的專案並自行編輯檔案，而且在超出資料夾範圍時都會先詢問。

剛開始時，先看看你目前已經付費使用哪些服務最容易。如果你訂閱了 ChatGPT，Codex 已經包含在內，無須另外付費。我在另一篇文章Codex 與 Claude Code 比較中做了詳細的實測比較；如果你想把工作設定從一種工具移到另一種工具，可以參考遷移指南。

初次啟動時最常出現哪些問題？#

這份清單根據專案儲存庫中的回報整理而成，並非猜測；每一項都來自實際遇到問題的人。

1. 安裝了錯誤的套件。 執行不帶前綴的 npm install -g codex 會安裝一個自 2011 年起存在的靜態網站產生器。正確套件是 @openai/codex。
2. 沒有安裝 bubblewrap。 在 Linux 和 WSL2 上若缺少它，沙箱就無法啟動。Codex 會改用內建的替代方案，並在啟動時發出警告。只需一個命令即可安裝。
3. 因國家限制而遭拒。 登入時會出現 unsupported_country_region_territory 代碼和 403 狀態。這與安裝無關。
4. 需要電話驗證。 不是每個人都會遇到，而且文件沒有提到這個問題。沒有官方方法可以更換無法使用的電話號碼；相關回報自 2026 年 6 月起一直開放。
5. 使用額度比預期更快用完。 「Token 消耗速度非常快」是整個儲存庫中討論最多的回報，有 627 則留言。切換到較輕量的模型並降低推理強度可能有幫助。

介面語言不會影響代理程式的工作；工作語言不必與介面語言相同。

接下來該怎麼做#

開始使用代理程式的第一個小時，總是在做同一件事：了解它能自主做到什麼程度。只有在自己的專案中試用，才能知道答案；文件中的範例無法告訴你這些。

我建議依照以下順序開始：

1. 安裝程式，並登入有效的 OpenAI 帳戶。
2. 開啟實際專案資料夾並執行 codex。
3. 查看 /status 與 /permissions，檢查型任務明確選擇唯讀，確認生效模式後才詢問專案結構。
4. 建立一次提交，再交辦第一個編輯工作。
5. 撰寫一份三行的 AGENTS.md，比較新增前後代理程式的回應。

AI 分身 + Second Brain + 脈絡工程 — 關於工具使用的更多資料，請參閱 Ailoot 文件。