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

本指南目標：在 Linux 桌面（Ubuntu／Debian 為例）安裝 OpenAI Codex CLI，並接上自己的 MYAI168 API，使用 gpt-5.6-sol。

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

端點與模型

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

重要安全須知

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

先確認：node --version 與 npm --version 有沒有版本號。沒有就裝（Ubuntu／Debian）：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

或用 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts

echo $SHELL

• 結尾是 /bash → 用 ~/.bashrc
• 結尾是 /zsh → 用 ~/.zshrc

下面凡是提到「shell 設定檔」，就換成你的那個。

官方首選：standalone 安裝器（不需 Node.js，可跳過「0.5」的 Node 安裝；官方文件 https://developers.openai.com/codex/cli/）：

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

替代方式：npm（需已安裝 Node.js）。不要用 sudo（會有權限問題）；若遇 npm 權限錯誤，把 npm 全域目錄指到自己家目錄後再裝：

npm install -g @openai/codex

確認：

codex --version

cc-switch 是跨平台 GUI，Linux 桌面操作介面與其他平台相同。（前提：已安裝 cc-switch —— 安裝方式見開發者中心的「cc-switch Linux」分頁。）

1. 開 cc-switch，點「Codex」分頁。
2. 點「+」新增，選 Custom Configuration。
3. 填：Provider Name = MYAI168；API Key = 你的金鑰；API Request URL = https://www.myai168.com/futaba/api/openai/v1
4. Advanced Options：Needs Local Routing 先「關閉」（直連失敗再開）。
5. Save → 在卡片上 Enable。

設環境變數（Codex 透過 env_key 讀取；寫進 shell 設定檔，zsh 換成 ~/.zshrc）：

echo 'export MYAI168_API_KEY="你的金鑰"' >> ~/.bashrc
source ~/.bashrc

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

cat ~/.codex/config.toml

若 cc-switch 沒寫成功（config.toml 不存在），用 heredoc 手動寫（整塊貼上、Enter）：

mkdir -p ~/.codex
cat > ~/.codex/config.toml << 'EOF'
model = "gpt-5.6-sol"
model_provider = "myai168"

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

並確認金鑰環境變數已設（同方式 A 的 export 那行）。

進一個測試資料夾再開（不要在家目錄）：

mkdir -p ~/cc-test
cd ~/cc-test
codex

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

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

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

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

• codex 指令找不到 → 執行 source ~/.bashrc（或 source ~/.zshrc）或重開終端機；或 npm bin 不在 PATH，用 npm prefix -g 找目錄加進 PATH。（Windows 為開新 PowerShell。）
• no_pricing_info／模型不存在 → 該模型在此端點未登錄，確認用 gpt-5.6-sol。
• 回 404／responses not found（直連失敗） → MYAI168 端點對此模型可能只支援 Chat Completions。回 cc-switch 打開「Needs Local Routing」，Save、Enable，使用時保持開著。
• 401／unauthorized → echo "[$MYAI168_API_KEY]" 確認有值；必要時 provider 區塊加 requires_openai_auth = false。（Windows 為確認 [Environment]::GetEnvironmentVariable("MYAI168_API_KEY","User") 有值，並開新視窗。）
• 狀態列顯示 default／像官方模型 → config 沒套用。最常見：env_key 填成金鑰字串而非變數名。
• 切換模型 → 對話中 /model；或改 config.toml 的 model。臨時單次：codex -c model='"模型名稱"'

更新 Codex（standalone 安裝器版＝重跑官方安裝指令即更新；npm 版用 install @latest，不要用 npm update -g）：

curl -fsSL https://chatgpt.com/codex/install.sh | sh
# npm 版：npm install -g @openai/codex@latest

設定檔位置

~/.codex/config.toml

官方文件

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