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

> OpenAI 的 Codex：代理程式應用程式、安裝方式、介面、模型、方案、權限與地區存取條件。

Source: https://ailoot.ai/blog/zh-hant-tw/openai-codex-install/
Canonical: https://ailoot.ai/blog/zh-hant-tw/openai-codex-install/
Language: zh-Hant-TW
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-080
Revision: sha256-7a3504dc6d8ad7d074266899d1a2b64d09bd125a45ad7f1dea4f9fdac8c597ae


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

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

關於工具設定的補充資料，請參閱 [Ailoot 文件](https://ailoot.ai/docs/)。

<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Ailoot Guides">

[Ailoot 指南](https://ailoot.ai/docs/)

</div>

<div class="aside" data-semantic="callout" role="note" aria-label="Attention">

注意

本文僅供參考。我不是律師，也不提供法律建議。

</div>

## OpenAI Codex 是什麼？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

Codex 是 OpenAI 的程式設計代理程式。它依生效權限與核准政策讀取專案、編輯檔案及執行指令；部分獲准動作不會另行詢問。它可在終端機、編輯器、ChatGPT 應用程式、瀏覽器及雲端中運作。所有 ChatGPT 方案都包含 Codex，免費方案也不例外。

</div>

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

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

<figure>
<blockquote>
<p>Codex CLI 是一款在你的電腦上本機執行的 OpenAI 程式設計代理程式。</p>
</blockquote>
<figcaption>— OpenAI，https://github.com/openai/codex</figcaption>
</figure>

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

它們是名稱相同的兩種不同產品。舊 Codex 是一系列 `code-davinci` 和 `code-cushman` 模型，在 GitHub Copilot 中執行，並於 2023 年 3 月 23 日停用。新 Codex 於 2025 年 4 月推出，從模型變成代理程式。兩者唯一相同之處就是名稱。

</div>

人們常常把它們搞混，因為兩者都是 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 登錄檔中。程式內使用的模型會隨時間換成較新的模型，但程式本身維持不變。

| 功能 | 2023 年以前的版本 | 目前版本 |
|----|----|----|
| 它是什麼 | 一組 API 模型 | 在你電腦上執行的代理程式 |
| 使用方式 | 在編輯器中補全程式碼 | 描述工作，由代理程式執行 |
| 執行位置 | GitHub Copilot 和 API 中 | 終端機、編輯器、應用程式、瀏覽器、雲端 |
| 狀態 | 2023 年 3 月 23 日停用 | 幾乎每天更新 |

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

Codex 可在五種地方使用，而不同介面背後是同一個代理程式。CLI 在終端機中執行，擴充功能整合至編輯器，macOS 和 Windows 版 ChatGPT 應用程式提供獨立模式，瀏覽器版 ChatGPT 可回答簡單問題，而 Codex 雲端則在隔離的 OpenAI 容器中執行工作。

</div>

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

| 使用位置 | 執行位置 | 適用情境 |
|----|----|----|
| CLI | 你電腦上的終端機 | 編輯專案、執行命令、處理指令碼 |
| 編輯器擴充功能 | VS Code、Cursor、Windsurf、Xcode、JetBrains | 在開啟的檔案旁編輯，直接查看變更 |
| ChatGPT 應用程式 | macOS 和 Windows | 長時間工作、處理終端機以外的檔案 |
| 瀏覽器版 ChatGPT | 任何電腦，無須安裝 | 手邊沒有終端機時，快速詢問程式設計問題 |
| 雲端 | OpenAI 容器，在 chatgpt.com/codex 登入 | 平行執行工作，從 GitHub、Linear、Slack 啟動工作 |

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

<figure>
<blockquote>
<p>選擇你的編輯器。VS Code 和相容的編輯器使用 Codex 擴充功能；Xcode 和 JetBrains 則有各自的整合功能。</p>
</blockquote>
<figcaption>— Codex 文件，https://learn.chatgpt.com/docs/codex/ide</figcaption>
</figure>

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

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

## Codex 內部使用哪個模型？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

GPT-5.6 系列有三個模型：Sol 適合複雜工作，Terra 適合日常工作，Luna 適合快速、重複的工作。使用 `/model` 切換模型，也可以同時調整推理強度。GPT-5.4 和 GPT-5.4 mini 將於 2026 年 8 月 31 日退出 Codex，分別由 Terra 和 Luna 取代。

</div>

OpenAI 用一句話概括：

<figure>
<blockquote>
<p>Codex 提供三個 GPT-5.6 模型：Sol 適合深入探索和細節處理，Terra 是日常工作的主力，Luna 適合簡單、重複的工作。如果不確定該選哪個，就從 Sol 開始。</p>
</blockquote>
<figcaption>— Codex 文件，https://learn.chatgpt.com/docs/models</figcaption>
</figure>

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

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

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

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

<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Ailoot Guides">

[Ailoot 指南](https://ailoot.ai/docs/)

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

Codex 包含在所有 ChatGPT 方案中，免費方案也不例外。Free 費用為 0 美元，Go 為 8 美元，Plus 為 20 美元，Pro 起價 100 美元，Business 年繳每席 20 美元。Codex 沒有獨立訂閱方案：你支付 ChatGPT 費用，就能使用 Codex。你也可以用 API 金鑰登入，依使用量支付 token 費用。

</div>

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

| 方案 | 月費 | 包含內容 |
|----|----|----|
| Free | \$0 | 適用於短時間工作的 Codex |
| Go | \$8 | 適用於輕量工作的 Codex |
| Plus | \$20 | 可在終端機、編輯器、網頁和 iOS 上使用 Codex，並可使用 GPT-5.6 系列 |
| Pro | \$100 起 | 使用上限為 Plus 的 5 倍；\$200 方案的上限為 20 倍 |
| Business | 年繳每席 \$20 | 至少 2 個席位、共用工作區、單一登入 |
| Enterprise 和 Edu | 洽詢 | 優先處理、稽核記錄、資料保留控制項 |
| API 金鑰 | 按 token 計費 | 終端機、編輯器和 SDK，不含雲端功能 |

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

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

<figure>
<blockquote>
<p>你能傳送的訊息數取決於所選模型、工作的規模和複雜程度，以及你是在本機還是雲端執行工作。</p>
</blockquote>
<figcaption>— Codex 文件，https://learn.chatgpt.com/docs/pricing</figcaption>
</figure>

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

| 模型 | 每 5 小時的訊息數 |
|---------------|----------------------|
| GPT-5.6 Sol | 10-100 |
| GPT-5.6 Terra | 25-200 |
| GPT-5.6 Luna | 250-2 000 |
| GPT-5.5 | 15-80 |
| GPT-5.4 | 20-100 |
| GPT-5.4 mini | 60-350 |

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

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

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

## Codex 有哪些地區限制？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

程式可以在任何地方下載和執行，但沒有 OpenAI 帳戶就無法使用，而限制是套用在帳戶本身。登入時會檢查國家，並回傳 403 代碼。沒有官方的繞過方法，我也不會介紹任何方法。

</div>

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

同一頁面的文字如下：

<figure>
<blockquote>
<p>在下列國家和地區以外存取我們的服務，或提供他人存取我們服務的方式，可能導致帳戶暫停或終止。</p>
</blockquote>
<figcaption>— OpenAI，https://developers.openai.com/api/docs/supported-countries</figcaption>
</figure>

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

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

```json
{
  "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：逐步說明

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

安裝只需五分鐘。macOS 和 Linux 使用一行命令執行官方安裝程式；Windows 則使用 PowerShell。也可以使用 npm 和 Homebrew。接著，在專案資料夾中執行 `codex`，透過瀏覽器登入，就能交辦第一個工作。Linux 和 WSL2 使用者要先安裝 bubblewrap。

</div>

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

1.  ### 安裝程式

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

2.  ### 開啟專案資料夾

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

3.  ### 登入帳戶

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

4.  ### 交辦第一個工作

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

macOS 和 Linux 的安裝命令：

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

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

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

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

```bash
npm install -g @openai/codex
```

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

```bash
brew install --cask codex
```

<div class="aside" data-semantic="callout" role="note" aria-label="Attention">

注意

透過 npm 安裝前，請先確認套件名稱。我查過登錄檔：自 2011 年 10 月 1 日起，已有別人的套件以沒有前綴的 `codex` 名稱上架。它是靜態網站產生器，最新版本為 0.2.3。它會毫無提示地完成安裝，但無法運作。正確名稱是 `@openai/codex`：at 符號、公司名稱，再加上斜線。

</div>

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

```bash
sudo apt install bubblewrap
```

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

## 初次啟動時該做什麼？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

簡短的斜線命令可在工作階段中使用。先執行 `/status`，查看模型、核准政策和工作資料夾。接著試試 `/permissions`，查看代理程式獲准執行哪些操作。`/model` 可切換模型，`/init` 會建立描述專案的檔案，`/review` 則會在不編輯檔案的情況下檢查變更。

</div>

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

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

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

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

```bash
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 說明你的專案？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

AGENTS.md 是放在專案根目錄的文字檔，你可以用自己的話寫下規則：如何執行測試、要使用哪個套件管理工具、哪些內容不可碰。代理程式會在開始工作前讀取它。你的家目錄中可以放一個全域檔案，專案中也可以放專案層級檔案；兩者的規則會一併生效。總大小上限為 32 KB。

</div>

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

<figure>
<blockquote>
<p>Codex 會在開始任何工作之前讀取 AGENTS.md 檔案。</p>
</blockquote>
<figcaption>— Codex 文件，https://learn.chatgpt.com/docs/agent-configuration/agents-md</figcaption>
</figure>

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

簡單的檔案範例如下：

```markdown
# 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](https://ailoot.ai/blog/zh-hant-tw/agents-md-claude-md-one-instruction-file/)一文中介紹了如何使用這兩個檔案。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

有兩項彼此獨立的設定。沙箱決定代理程式可以在哪裡寫入，以及能否存取網路。核准政策則決定何時停止並詢問你。預設情況下，在 git 資料夾中，代理程式會自行編輯工作資料夾內的檔案；只有要離開該資料夾或存取網路時才需要核准。

</div>

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

<figure>
<blockquote>
<p>變更由誰審核請求，不會擴大沙箱範圍。</p>
</blockquote>
<figcaption>— Codex 文件，https://learn.chatgpt.com/docs/permission-modes</figcaption>
</figure>

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

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

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

| 情境 | 程式建議的設定 | 意義 |
|----|----|----|
| 受 git 控制的資料夾 | `Auto` | 自行編輯工作資料夾中的檔案；離開該資料夾或存取網路時需要核准 |
| 不受 git 控制的資料夾 | `read-only` | 讀取並回應，但不會進行任何變更 |
| Codex 雲端 | OpenAI 容器 | 設定期間安裝相依套件；之後便可在沒有網路存取的情況下工作 |

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

兩種工具的架構相同：終端機中的代理程式、編輯器擴充功能、應用程式和雲端。兩者的差異在於模型、入門價格，以及專案規則檔案名稱等細節。Codex 的最低入門價格是 0 美元；Claude Code 則是 17 美元。

</div>

| 功能 | Codex | Claude Code |
|----|----|----|
| 供應商 | OpenAI | Anthropic |
| 模型 | GPT-5.6：Sol、Terra、Luna | Opus、Sonnet、Haiku |
| 專案規則檔案 | `AGENTS.md` | `CLAUDE.md` |
| 登入方式 | ChatGPT 帳戶或 API 金鑰 | Claude 訂閱或 Console 帳單 |
| 最低入門價格 | Free 為 \$0，Go 為 \$8 | Pro 年繳為 \$17 |
| 使用位置 | 終端機、編輯器、應用程式、網頁、雲端 | 終端機、編輯器、應用程式、網頁 |
| 沙箱 | 預設關閉網路，寫入工作資料夾 | 可設定權限模式 |
| 支援國家清單 | OpenAI 公布 | Anthropic 公布 |

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

剛開始時，先看看你目前已經付費使用哪些服務最容易。如果你訂閱了 ChatGPT，Codex 已經包含在內，無須另外付費。我在另一篇文章[Codex 與 Claude Code 比較](https://ailoot.ai/blog/zh-hant-tw/codex-vs-claude-code-choice/)中做了詳細的實測比較；如果你想把工作設定從一種工具移到另一種工具，可以參考[遷移指南](https://ailoot.ai/blog/zh-hant-tw/migrate-claude-code-to-codex/)。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

常見問題有五種：安裝了錯誤的 npm 套件、Linux 上沒有安裝 bubblewrap、登入時因國家限制而遭拒、需要電話號碼驗證，或是使用額度意外用盡。

</div>

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

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 則留言。切換到較輕量的模型並降低推理強度可能有幫助。

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

## 接下來該怎麼做

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

重點摘要

安裝並開啟專案後，先查看 `/status` 與 `/permissions`，再交辦工作。首項任務只應描述檔案時，請選擇並驗證唯讀存取。Auto 可不逐次詢問便編輯工作資料夾；不能因提示看似無害或沒有 Git，就推論受唯讀保護。接著加入三條規則的 AGENTS.md，比較回應。

</div>

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

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

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

<div class="section" role="doc-bibliography" aria-label="Sources">

### 來源

- [Codex CLI：安裝與初次啟動](https://learn.chatgpt.com/docs/codex/cli) - OpenAI 官方文件
- [Codex 編輯器擴充功能](https://learn.chatgpt.com/docs/codex/ide) - 支援的編輯器清單
- [Codex 雲端](https://learn.chatgpt.com/docs/cloud) - 在隔離環境中執行工作
- [Codex 模型](https://learn.chatgpt.com/docs/models) - GPT-5.6 Sol、Terra、Luna，以及舊模型的停用日期
- [Codex 方案與使用上限](https://learn.chatgpt.com/docs/pricing) - 方案價格及每五小時可傳送的訊息數
- [登入方式](https://learn.chatgpt.com/docs/auth) - ChatGPT 帳戶和 API 金鑰
- [沙箱與核准](https://learn.chatgpt.com/docs/sandboxing) - 存取模式及 Linux 上的 bubblewrap
- [代理程式權限與安全性](https://learn.chatgpt.com/docs/agent-approvals-security) - 受保護路徑、危險旗標、預設建議
- [權限模式](https://learn.chatgpt.com/docs/permission-modes) - Ask for approval、Approve for me、Full access
- [AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md) - 代理程式讀取專案規則的方式
- [支援的國家與地區](https://developers.openai.com/api/docs/supported-countries) - OpenAI 官方清單
- [已停用的 OpenAI 模型](https://developers.openai.com/api/docs/deprecations) - 舊 Codex 的停用日期
- [openai/codex 儲存庫](https://github.com/openai/codex) - 開放原始碼、使用者回報和版本發布
- [npm 登錄檔中的 @openai/codex 套件](https://registry.npmjs.org/@openai/codex) - 版本和發布日期
- [GitHub 上的 Codex 版本發布](https://github.com/openai/codex/releases) - 版本號碼和發布日期


</div>

**AI 分身 + Second Brain + 脈絡工程** — 關於工具使用的更多資料，請參閱 [Ailoot 文件](https://ailoot.ai/docs/)。



<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Ailoot Guides">

[Ailoot 指南](https://ailoot.ai/docs/)

</div>

<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Go to Ailoot">

[前往 Ailoot](https://ailoot.ai/)

</div>

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

### Codex 每次修改檔案前都會詢問嗎？

不一定。本文 Auto 流程中，工作目錄內獲准的編輯可不經逐次核准。首項任務前查看 /status 與 /permissions；只想獲得說明時，請明確選擇唯讀。

### 安裝成功卻因地區錯誤無法登入，為什麼？

CLI 安裝與模型存取是不同步驟。403 加上 unsupported_country_region_territory 涉及帳戶存取，不是 Node 或安裝器；請依 OpenAI 支援國家資訊確認帳戶地區。


## Ailoot · 公司及其專案組合

Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。