Claude Code 連線不穩？OpenAI Codex CLI 完整替代方案【Windows 完全指南・2026 年版】

前言：為什麼寫這篇

最近不少台灣開發者都碰到同一個問題：Claude Code 確實強，但連線品質不太穩定。

常見狀況大概是這些：

• 登入慢，有時候直接連不上
• 終端機裡突然 timeout
• 公司網路、VPN 環境下特別容易卡
• Session 莫名斷掉，要重新登入
• 光是搞穩定連線就花掉不少時間

如果你只是想要一個能穩定落地的 AI 程式開發工具，其實不用死磕 Claude Code。

Codex CLI 是目前很靠譜的替代方案。

它一樣是終端機裡的 coding agent，能讀專案、改程式碼、跑指令、修 bug、寫測試。再搭配 Crazyrouter 這類統一 API 閘道，還能把模型接入、成本和網路體驗一起解決掉。

這篇文章直接從實戰角度講清楚 4 件事：

1. 為什麼最近很多人開始把 Claude Code 的備選換成 Codex CLI
2. Windows 上怎麼從零裝起來
3. 怎麼把 Git、Python、pnpm、Bun、VS Code、Cursor 這些配套環境補齊
4. 怎麼接入 Crazyrouter，更穩定地用 GPT、Claude、DeepSeek、Gemini 等模型

目標讀者：在 Windows 上開發的工程師，之前沒裝過 Codex CLI。

一、為什麼說 Codex CLI 是 Claude Code 的現實替代

1. 都是終端機裡的 AI coding agent

Codex CLI 和 Claude Code 的核心用法很像：

• 在終端機啟動
• 讀取專案結構
• 按你的描述去改程式碼
• 執行 shell 指令和測試
• 給出 patch、diff、修正建議

開發者真正需要的是：

• 幫我定位問題
• 幫我改檔案
• 幫我補測試
• 幫我跑常見開發指令

這個範圍內，Codex CLI 完全夠用。

2. Windows 支援更明確

Claude Code 系的工具很多時候偏 Unix-first。Windows 使用者常常卡在環境、權限、PATH、proxy 這些邊緣問題上。

Codex CLI 官方已經把 Windows 路線講得很清楚：

• 原生 Windows CLI
• WSL2 路線
• Windows 沙箱模式
• config.toml 統一設定

3. 更適合搭配統一 API 閘道

很多人卡 Claude Code，不只是產品本身的問題：

• 帳號管理麻煩
• 網路環境不穩定
• 綁死單一模型
• 計費不夠彈性

Codex CLI 可以透過 openai_base_url 指向第三方相容介面，把模型來源、價格和網路體驗一起最佳化。

4. 對台灣開發者更現實

大家在意的不是「理論上誰更強」，而是：

• 今天能不能穩定用
• 公司網路裡能不能跑
• Windows 電腦能不能裝
• 要不要反覆折騰 proxy
• 出問題時能不能定位

從這個角度，Codex CLI + Crazyrouter 是一條更現實的路。

二、Codex CLI 是什麼

Codex CLI 是 OpenAI 開發的開源終端 AI 程式開發 agent，用 Rust 重寫，速度快、體積小。

它能做的事：

• 讀取專案結構
• 修改、產生程式碼
• 重構既有邏輯
• 執行 shell 指令
• 跑測試、分析錯誤
• 在工作目錄裡持續迭代

和瀏覽器聊天最大的差別：它直接在你的專案上下文裡工作，不是把程式碼複製貼上去問它。

三、Windows 上的 3 種安裝方式

四、安裝前先把基礎環境補齊

Windows 最容易翻車的不是 Codex 本身，而是環境沒打好。

1. 安裝 Windows Terminal

winget install Microsoft.WindowsTerminal

2. 安裝 Git

winget install Git.Git

# 驗證
git --version

# 基礎設定
git config --global user.name "Your Name"
git config --global user.email "your@email.com"
git config --global init.defaultBranch main
git config --global core.autocrlf true

3. 安裝 Node.js 22+

Codex CLI 需要 Node.js 22 以上。

winget install OpenJS.NodeJS.LTS

# 驗證
node --version   # v22.x.x
npm --version    # 10.x.x

五、推薦方案：WSL2 安裝 Codex CLI

1. 安裝 WSL2

管理員 PowerShell：

wsl --install

重新開機後，Ubuntu 會啟動並要求設定使用者名稱和密碼。

2. 在 WSL 裡裝 Node.js

wsl

# 安裝 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

# 重開 shell 或 source
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# 安裝 Node 22
nvm install 22

# 驗證
node --version
npm --version

3. 安裝 Codex CLI

npm i -g @openai/codex
codex --version

4. 工作目錄一定放在 Linux 檔案系統

不要把專案放在 /mnt/c/... 下面跑 Codex。

mkdir -p ~/code && cd ~/code
git clone https://github.com/your/repo.git
cd repo
codex

原因：

• /mnt/c 跨檔案系統 I/O 比較慢
• 權限和 symlink 容易出怪問題

六、Windows 原生安裝

node --version
npm i -g @openai/codex
codex --version

如果找不到 codex 指令，通常是 npm 全域路徑沒進 PATH：

npm config get prefix
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";" + (npm config get prefix), "User")

重開終端機再試。

七、二進位檔安裝

1. 到 GitHub Releases 下載 Windows 版
2. 改名為 codex.exe
3. 放到 PATH 裡的目錄

mkdir "$env:USERPROFILE\bin"
Move-Item "$env:USERPROFILE\Downloads\codex-windows-x64.exe" "$env:USERPROFILE\bin\codex.exe"
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\bin", "User")

八、認證方式

ChatGPT 帳號登入

codex
# 第一次啟動會開瀏覽器引導登入

API Key

PowerShell：

# 暫時
$env:OPENAI_API_KEY = "sk-your-api-key"

# 永久
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-your-api-key", "User")

WSL/Bash：

export OPENAI_API_KEY="sk-your-api-key"

# 永久
echo 'export OPENAI_API_KEY="sk-your-api-key"' >> ~/.bashrc
source ~/.bashrc

九、【重點】接入 Crazyrouter

這是這篇文章最關鍵的部分。

只用 OpenAI 官方 API 的話，你還是會遇到：

• 單一來源綁定
• 模型選擇不夠彈性
• 網路路徑不一定最佳
• 計費不夠友善

接上 Crazyrouter 後：

• OpenAI 相容介面，穩定連線
• GPT / Claude / DeepSeek / Gemini 等 600+ 模型統一入口
• 同模型便宜 20~40%
• 一個帳戶管理所有 AI 開支

1. 取得 API Key

到 crazyrouter.com 註冊，在控制台建立 API Key。

2. 修改 Codex 設定檔

設定檔位置：

• Windows：%USERPROFILE%\.codex\config.toml
• WSL：~/.codex/config.toml

openai_base_url = "https://crazyrouter.com/v1"
model = "gpt-4o"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[windows]
sandbox = "elevated"

環境變數：

PowerShell（永久）：

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "your-crazyrouter-key", "User")

WSL（永久）：

echo 'export OPENAI_API_KEY="your-crazyrouter-key"' >> ~/.bashrc
source ~/.bashrc

3. 臨時方式

PowerShell：

$env:OPENAI_BASE_URL = "https://crazyrouter.com/v1"
$env:OPENAI_API_KEY = "your-crazyrouter-key"
codex

WSL：

OPENAI_BASE_URL="https://crazyrouter.com/v1" OPENAI_API_KEY="your-crazyrouter-key" codex

十、設定檔詳解

實用設定範例：

openai_base_url = "https://crazyrouter.com/v1"
model = "gpt-4o"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
model_reasoning_effort = "medium"
web_search = "cached"
cli_auth_credentials_store = "keyring"

[windows]
sandbox = "elevated"
sandbox_private_desktop = true

各欄位說明

設定優先順序

1. CLI 參數（最高）
2. Profile 值
3. 專案 .codex/config.toml
4. 使用者 ~/.codex/config.toml
5. 系統 /etc/codex/config.toml
6. 內建預設值（最低）

十一、沙箱與審批模式

沙箱模式

審批策略

# 推薦的日常組合
codex --sandbox workspace-write --ask-for-approval on-request

# 全自動（小心使用）
codex --full-auto

十二、配套環境安裝

Python

PowerShell：

winget install Python.Python.3.12
python --version

WSL：

sudo apt update && sudo apt install -y python3 python3-pip python3-venv

pnpm

npm i -g pnpm
pnpm --version

Bun

PowerShell：

powershell -c "irm bun.sh/install.ps1 | iex"

WSL：

curl -fsSL https://bun.sh/install | bash

為什麼配套環境很重要

因為 Codex 不只是回答問題，它會真的執行指令：

• pnpm install
• pytest
• bun test
• npm run lint

環境沒裝好，Codex 再聰明也跑不動你的專案。

十三、IDE 整合

VS Code

最簡單：在整合終端機裡跑 codex。

WSL 開發：

cd ~/code/your-project
code .

VS Code 會自動以 WSL 模式開啟。

Cursor

Cursor 本身是 AI IDE，但你一樣可以在它的終端機裡跑 Codex CLI。兩者獨立計費。

JetBrains

Alt+F12 開終端面板，直接跑 codex。

WSL 整合：Settings → Tools → Terminal → Shell path 改成 wsl.exe --distribution Ubuntu。

十四、常見問題排查

codex: command not found

npm 全域路徑沒進 PATH。

npm config get prefix
# 把顯示的路徑加到 PATH

Node.js 版本太舊

# WSL
nvm install 22 && nvm use 22

# Windows
winget upgrade OpenJS.NodeJS.LTS

WSL2 沒啟用

# 管理員 PowerShell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# 重新開機後
wsl --set-default-version 2

/mnt/c/ 下很慢

把專案移到 Linux 檔案系統：

cp -r /mnt/c/Users/you/Projects/my-app ~/code/my-app

Crazyrouter 接入後 "model not found"

確認：

• openai_base_url 是 https://crazyrouter.com/v1
• API Key 正確且有餘額
• 模型名稱拼寫正確

Git 沒初始化

Codex 靠 .git 辨識專案根目錄。

git init

十五、不同任務推薦模型

用 Profiles 快速切換：

openai_base_url = "https://crazyrouter.com/v1"
model = "gpt-4o"

[profiles.cheap]
model = "gpt-4o-mini"

[profiles.smart]
model = "claude-sonnet-4-20250514"
model_reasoning_effort = "high"

[profiles.tw]
model = "deepseek-chat"

codex --profile cheap    # 省錢模式
codex --profile smart    # 複雜任務
codex --profile tw       # 中文專案

十六、最短可執行版本

Windows 原生

winget install Microsoft.WindowsTerminal
winget install Git.Git
winget install OpenJS.NodeJS.LTS
npm i -g @openai/codex
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "your-crazyrouter-key", "User")

建立 %USERPROFILE%\.codex\config.toml：

openai_base_url = "https://crazyrouter.com/v1"
model = "gpt-4o"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[windows]
sandbox = "elevated"

重開終端機：

codex

WSL2

wsl --install

進 WSL 後：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
# 重開 shell
nvm install 22
npm i -g @openai/codex
echo 'export OPENAI_API_KEY="your-crazyrouter-key"' >> ~/.bashrc
mkdir -p ~/.codex
cat > ~/.codex/config.toml << 'EOF'
openai_base_url = "https://crazyrouter.com/v1"
model = "gpt-4o"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
EOF
source ~/.bashrc
codex

結語

如果你最近被 Claude Code 的連線不穩定搞得很煩，不用繼續把時間浪費在不確定性上。

Codex CLI + Crazyrouter 這套組合：

• 真的裝得起來
• 真的穩定能用
• 可以彈性切換多個模型
• 成本更低

與其追「理論上最強的工具」，不如選「今天就能穩定用的工具」。對開發者來說，這才是真正有價值的事。

註冊 Crazyrouter 取得 API Key：crazyrouter.com

Codex CLI 官方文件：developers.openai.com/codex/cli

如果這篇有幫到你，請按個讚 👍