OpenAI Codex CLI 安裝與 MYAI168 設定指南 — Windows 版

本指南目標：在 Windows 安裝 OpenAI Codex CLI，並接上自己的 MYAI168 API，使用 gpt-5.6-sol。

Codex 走 OpenAI 格式，接的是 MYAI168 的「OpenAI 相容端點」搭配 gpt-5.6-sol。

端點與模型

端點   https://www.myai168.com/nccu/api/openai/v1
模型   gpt-5.6-sol

重要安全須知

• Codex 能在工作目錄裡讀寫、執行檔案。實際使用請 cd 進專案資料夾再開，不要在家目錄開啟。
• API Key 視同密碼，不要外流；外流就到 MYAI168 後台撤銷換新。
• 驗證請用「運算題」，不要用「你是誰」（模型自我認知不可靠）；並對照 MYAI168 後台呼叫紀錄確認。

先確認：在 PowerShell 跑 node --version 與 npm --version。有版本號就跳到「一、安裝 Codex」；若「command not recognized」，依下列安裝：

• 方法 A（推薦）：到 https://nodejs.org 下載 LTS 的 Windows 安裝檔（.msi），點兩下一路 Next 裝完，「關掉並重開 PowerShell」再確認 node --version。
• 方法 B（備用）：winget install OpenJS.NodeJS.LTS，裝完重開 PowerShell。

注意：若 Node 原本是其他工具（如 Hermes）附帶的，那工具移除時 Node 會一併消失。建議獨立安裝 Node 較穩定。

若被執行原則擋住先放行：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

本頁教學採 npm 安裝；官方另提供其他安裝方式，最新指引見官方文件 https://developers.openai.com/codex/cli/。

安裝（套件名務必含 @openai/ 前綴）：

npm install -g @openai/codex

開新的 PowerShell，確認：

codex --version

若出現 Missing optional dependency @openai/codex-win32-x64：

$v = npm view @openai/codex version
npm install -g "@openai/codex@$v" "@openai/codex-win32-x64@npm:@openai/codex@$v-win32-x64"

cc-switch 對 Codex 支援良好。（安裝方式見開發者中心的「cc-switch Windows」分頁。）

1. 開 cc-switch，點上方「Codex」分頁。
2. 點「+」新增，選 Custom Configuration。
3. 填：Provider Name = MYAI168；API Key = 你的金鑰；API Request URL = https://www.myai168.com/nccu/api/openai/v1
4. 展開 Advanced Options：Needs Local Routing 先「關閉」（gpt-5.6-sol 屬 GPT 系列、可走 responses，通常不需開；若直連失敗再打開，用本機代理轉換，並使用時保持 cc-switch 開著）。
5. 按 Save → 在卡片上 Enable。

設環境變數（Codex 透過 env_key 讀取）：

[Environment]::SetEnvironmentVariable("MYAI168_API_KEY", "你的金鑰", "User")

此指令無輸出即成功；驗證：

[Environment]::GetEnvironmentVariable("MYAI168_API_KEY", "User")

確認 cc-switch 有寫進 config.toml：

Get-Content $env:USERPROFILE\.codex\config.toml

建立設定資料夾並用記事本開設定檔：

mkdir $env:USERPROFILE\.codex -Force
notepad $env:USERPROFILE\.codex\config.toml

貼入（env_key 填「環境變數名稱」，不是金鑰本身）：

model = "gpt-5.6-sol"
model_provider = "myai168"

[model_providers.myai168]
name = "MYAI168"
base_url = "https://www.myai168.com/nccu/api/openai/v1"
env_key = "MYAI168_API_KEY"
wire_api = "responses"

存檔。並設環境變數（同方式 A 的 SetEnvironmentVariable）。

開新的 PowerShell（讓環境變數生效）：

mkdir $env:USERPROFILE\cc-test -Force
cd $env:USERPROFILE\cc-test
codex

驗證：進 codex 後問一個需要運算的問題：

123456 乘以 789 是多少？只回數字。

能算出 97406784、狀態列顯示 gpt-5.6-sol，即接通成功。

（不要用「你是誰」驗證——模型自我認知不可靠；以 MYAI168 後台呼叫紀錄為準。）

• codex 指令找不到 → 開新的 PowerShell 視窗；或 npm bin 不在 PATH，用 npm prefix -g 找目錄加進 PATH。（macOS 為 source ~/.zshrc／重開終端機。）
• no_pricing_info／模型不存在 → 該模型在此端點未登錄，確認用 gpt-5.6-sol。
• 回 404／responses not found（直連失敗） → MYAI168 端點對此模型可能只支援 Chat Completions。回 cc-switch 打開「Needs Local Routing」，Save、Enable，使用時保持開著。
• 401／unauthorized → 確認 [Environment]::GetEnvironmentVariable("MYAI168_API_KEY","User") 有值，並開新視窗。（macOS 為 echo "[$MYAI168_API_KEY]" 確認有值；必要時 provider 區塊加 requires_openai_auth = false。）
• 狀態列顯示 default／像官方模型 → config 沒套用。最常見：env_key 填成金鑰字串而非變數名。
• PowerShell 多行貼上變顛倒 → 改用記事本編輯，或把指令寫成一行。
• 指令碼被執行原則擋住 → Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

更新 Codex（用 install @latest，不要用 npm update -g——它受原安裝的 semver 範圍限制，可能不會更新到最新版）：

npm install -g @openai/codex@latest

更換 API Key

執行下面指令後開新的 PowerShell；或在 cc-switch 卡片更新後重新 Enable：

[Environment]::SetEnvironmentVariable("MYAI168_API_KEY", "新key", "User")

設定檔位置

%USERPROFILE%\.codex\config.toml

官方文件

• https://developers.openai.com/codex/cli
• https://developers.openai.com/codex/config-reference