Codex (OpenAI) 設定教學

安裝並設定 Codex CLI 工具，透過設定檔連線至 CodyRouter 平台。

Codex 是支援 OpenAI API 相容介面的 CLI 工具，使用設定檔的方式進行設定。本教學將帶你完成安裝與設定。

開始前請先完成 Node.js 環境安裝教學。

第一步：安裝 Codex

npm install -g @openai/codex@latest

sudo npm install -g @openai/codex@latest

以上指令會從 npm 官方儲存庫下載並安裝最新版本的 Codex 工具。

驗證安裝

codex --version

若顯示版本號，恭喜你！Codex 已經成功安裝了。

第二步：建立設定檔

Codex 使用設定檔進行連線設定，需要建立 config.toml 和 auth.json 兩個檔案。

建立設定檔

選擇你的系統，複製對應指令到終端機執行。

Windows PowerShell

# 刪除舊目錄並建立新目錄
if (Test-Path "$env:USERPROFILE\.codex") { Remove-Item -Recurse -Force "$env:USERPROFILE\.codex" }
mkdir "$env:USERPROFILE\.codex"

# 建立 config.toml
@"
model_provider = "codyrouter"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.codyrouter]
name = "codyrouter"
base_url = "https://api.codyrouter.com/"
wire_api = "responses"
requires_openai_auth = true
"@ | Out-File -FilePath "$env:USERPROFILE\.codex\config.toml" -Encoding utf8

# 建立 auth.json
@"
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}
"@ | Out-File -FilePath "$env:USERPROFILE\.codex\auth.json" -Encoding utf8

macOS / Linux

# 刪除舊目錄並建立新目錄
rm -rf ~/.codex && mkdir -p ~/.codex

# 建立 config.toml
cat > ~/.codex/config.toml << 'EOF'
model_provider = "codyrouter"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.codyrouter]
name = "codyrouter"
base_url = "https://api.codyrouter.com/"
wire_api = "responses"
requires_openai_auth = true
EOF

# 建立 auth.json
cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}
EOF

請將 YOUR_API_KEY 取代為在 主控台 頁面中複製的 API Key。

第三步：開始使用

現在你可以開始使用 Codex 了：

codex

更多使用說明請參考 OpenAI 官方文件。