---
title: "02 - 安裝與登入"
type: note
specialty: Programming
tags: [codex-cli從0開始使用教學, 02-安裝, wsl, chatgpt-login]
created: 2026-08-04
updated: "2026"
modified: 2026-08-04
---

# 02 - 安裝與登入

← [[01-什麼是Codex-CLI]] | [[00-Index]] | 下一篇 → [[03-互動模式基本操作]]

---

## 安裝

### npm（最常用）

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

### Homebrew

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

### 安裝腳本 / 直接下載

官方也提供 curl（mac / Linux）與 PowerShell（Windows）安裝腳本，或直接從 [GitHub Releases](https://github.com/openai/codex/releases) 下載對應平台架構的 binary。

### 驗證

```bash
codex --version
```

---

## ⚠️ Windows：官方建議用 WSL2

> **CLI 在 macOS 和 Linux 上是完整支援的；Windows 支援仍是 experimental，官方建議在 WSL2 workspace 裡跑 Codex 以獲得可靠體驗。**

這跟 [[Programming/Herdr/Herdr從0開始使用教學/02-安裝與環境選擇|Herdr]] 和 [[Programming/Claude-Code/Claude-Code-CLI從0開始使用教學/02-安裝與登入|Claude Code]] 的建議一致——**三個工具都指向同一個結論：在 WSL2 裡工作**。

一次設定，三個工具都受益：

```bash
# WSL2 Ubuntu 裡
curl -fsSL https://claude.ai/install.sh | bash   # Claude Code
npm install -g @openai/codex                      # Codex CLI
curl -fsSL https://herdr.dev/install.sh | sh      # Herdr
sudo apt install -y jq                            # 編排腳本需要
```

---

## 登入

### 用 ChatGPT 帳號（你要用的）

```bash
codex
```

第一次會出現選單，選 **Sign in with ChatGPT**。支援 Plus、Pro、Business、Edu、Enterprise 訂閱。

也可以直接：

```bash
codex login
```

### 無瀏覽器環境（SSH / 遠端）

```bash
codex login --device-auth
```

走 device code 流程——它給你一組代碼，你在另一台有瀏覽器的裝置上輸入。

> 💡 **從 iPhone SSH 進 WSL 第一次設定 Codex 時就會用到這個。**

### API key

也可以用 API key（從 stdin 傳入），但那是走 API 計費，**不是你的 Plus 訂閱額度**。

---

## ⚠️ 模型異動（2026-08 重要）

> **`gpt-5.4` 和 `gpt-5.4-mini` 於 2026-08-31 從「ChatGPT 登入的 Codex」退場。**
> 用 ChatGPT 登入的話，把儲存的設定、自訂 agent、排程任務裡的
> `gpt-5.4` 換成 **`gpt-5.6-terra`**、`gpt-5.4-mini` 換成 **`gpt-5.6-luna`**。

**今天是 2026-08-04，也就是不到一個月。** 該檢查的地方：

- [ ] `~/.codex/config.toml` 的 `model = ` 那行
- [ ] 任何 `[profiles.*]` 區塊裡的 `model`
- [ ] 排程任務 / automation 設定
- [ ] **你寫過的編排腳本**——例如 [[Programming/Herdr/Herdr從0開始使用教學/08-Claude當大腦-Codex當雙手|Herdr 教學]] 裡出現的 `herdr agent start reviewer --kind codex -- -m gpt-5.4` 這種寫法

> 💡 **實務建議：編排腳本裡不要寫死模型名。** 讓它用 `config.toml` 的預設，或把模型名抽成一個變數。模型會換，腳本不該跟著壞。

### 思考力度

Codex 也有 reasoning effort 的概念（`model_reasoning_effort`），一般是 `minimal` / `low` / `medium` / `high` / `xhigh`，**實際可用等級依模型而定**。

另外有兩個特殊模式：
- **Max**：給選定模型更多時間思考**單一任務**，適合最難的問題、深度重於速度時
- **Ultra**：**用 subagent 平行處理複雜任務的不同部分**，適合工作可以切成有意義的區塊時

---

## 額度概念

ChatGPT Plus 的 Codex 用量是**每 5 小時一個滾動視窗**，而且**本機訊息和 cloud task 共用同一份額度**，另外可能有週上限。不同模型的額度區間不同。

> 💡 **這正是「Claude 當大腦、Codex 當雙手」有意義的原因**：兩份訂閱各有各的窗口，分開用等於總產能加倍。但也要注意——**Codex 的額度不是無限的**，一次開 5 個 pane 全速跑會很快吃完 5 小時的量。實務上 2–3 個平行 worker 比較穩。

---

## 建議的初始設定

### 1. 建立 `~/.codex/config.toml`

```toml
# 預設用哪個模型（⚠️ 2026-08-31 後不要再寫 gpt-5.4）
model = "gpt-5.6-terra"
model_reasoning_effort = "medium"

# 日常安全預設
approval_policy = "on-request"
sandbox_mode = "workspace-write"

# 常用 profile：一鍵切換安全等級
[profiles.paranoid]
approval_policy = "untrusted"
sandbox_mode = "read-only"

[profiles.batch]
approval_policy = "never"
sandbox_mode = "workspace-write"
```

用法：`codex --profile paranoid`（純分析）、`codex --profile batch`（量產）。

詳見 [[05-AGENTS-md與config-toml]]。

### 2. 建立全域 `~/.codex/AGENTS.md`

```markdown
# 全域指示

- 回答用繁體中文，技術名詞保留英文
- 修改前先說明你要做什麼，做完列出改了哪些檔案
- **不要 git commit、不要 git push**，除非我明確要求
- 不確定的事情直接說不確定，不要猜
```

**最後兩條對你特別重要**——你的兩個 repo 都規定 commit 由 orchestrator 統一做。

### 3. 在兩個 repo 建 `AGENTS.md`

⚠️ 你的 `Obsidian-med-note` **已經有 `AGENTS.md`** 了。確認它的內容是不是也適合給 Codex 讀（它會讀，Claude Code 不會——除非 `CLAUDE.md` 用 `@AGENTS.md` 匯入）。

`Taiwan_IM_board` 目前只有 `CLAUDE.md`。要讓 Codex 也遵守那些規則，需要建一份 `AGENTS.md`（可以只放 Codex 需要的子集）。

---

## 更新

```bash
npm update -g @openai/codex          # npm 安裝
brew upgrade --cask codex            # Homebrew 安裝
```

---

## 🔗 相關筆記

- [[01-什麼是Codex-CLI]] — 上一步
- [[03-互動模式基本操作]] — 下一步
- [[05-AGENTS-md與config-toml]] — 設定檔完整說明
- [[Programming/Herdr/Herdr從0開始使用教學/02-安裝與環境選擇|Herdr 02]] — 同一個 WSL2 環境
- [[Programming/Claude-Code/Claude-Code-CLI從0開始使用教學/02-安裝與登入|Claude Code CLI 02]] — 另一支的安裝

---

*最後更新：2026-08-04*