ApiFluxAI | 使用 ApiFlux 設定 Codex CLI

安裝 Codex CLI，設定 ApiFlux 自訂 Provider 與 API Key，並驗證第一個請求。

本指南介紹如何將 Codex CLI 連線到 ApiFlux。設定完成後，Codex CLI 的模型請求會透過 ApiFlux 傳送，使用者可以在 ApiFlux 控制台統一檢視用量和紀錄。

適用場景

適合希望在終端機中使用 Codex CLI，並透過 ApiFlux 統一管理模型存取、餘額、紀錄和模型切換的使用者。

如果使用者還沒有安裝終端機或 Node.js，建議先閱讀：

ApiFlux 使用前準備：安裝終端機和基礎環境

準備工作

開始前，請準備：

一個 ApiFlux API Key
一個 ApiFlux 支援的模型 ID
ApiFlux Base URL：

https://apiflux.ai/v1

模型 ID 請從 ApiFlux Models 頁面複製，不建議手動猜測。

1. 安裝 Codex CLI

Windows

開啟 PowerShell，執行：

irm https://chatgpt.com/codex/install.ps1 | iex

也可以使用 npm 安裝：

npm install --global @openai/codex

如果使用 WSL，請在 WSL 終端機中按 macOS / Linux 命令安裝。

macOS / Linux

開啟終端機，執行：

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

也可以使用 npm 安裝：

npm install --global @openai/codex

安裝完成後，關閉終端機並重新開啟。

2. 確認 Codex CLI 已安裝

在終端機中執行：

codex --version

如果能看到版本號，說明 Codex CLI 已安裝成功。

如果提示 command not found 或「不是內部或外部命令」，請重新開啟終端機；如果仍然失敗，請重新執行安裝命令。

3. 開啟 Codex 設定檔

Codex CLI 的個人設定檔通常位於使用者目錄下。

macOS / Linux / WSL：

~/.codex/config.toml

可以執行：

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows PowerShell：

C:\Users\你的使用者名稱\.codex\config.toml

可以執行：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
notepad "$env:USERPROFILE\.codex\config.toml"

如果使用者習慣使用 VS Code，也可以用 VS Code 開啟設定檔。

4. 新增 ApiFlux Provider

在 config.toml 中加入以下設定：

model = "YOUR_MODEL_ID"
model_provider = "apiflux"

[model_providers.apiflux]
name = "ApiFlux"
base_url = "https://apiflux.ai/v1"
env_key = "APIFLUX_API_KEY"

將 YOUR_MODEL_ID 替換為 ApiFlux Models 頁面中顯示的模型 ID。

示例：

model = "gpt-5.4-mini"
model_provider = "apiflux"

[model_providers.apiflux]
name = "ApiFlux"
base_url = "https://apiflux.ai/v1"
env_key = "APIFLUX_API_KEY"

[!NOTE] gpt-5.4-mini 僅作為示例模型。實際可用模型請以 ApiFlux Models 頁面為準。

5. 設定 API Key 環境變數

建議透過環境變數提供 API Key，而不是把真實 Key 直接寫入 config.toml。

Windows PowerShell

目前視窗暫時生效：

$env:APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"

檢查是否生效：

echo $env:APIFLUX_API_KEY

長期生效：

[Environment]::SetEnvironmentVariable("APIFLUX_API_KEY","YOUR_APIFLUX_API_KEY","User")

設定長期環境變數後，請關閉 PowerShell，再重新開啟。

macOS / Linux

目前視窗暫時生效：

export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"

檢查是否生效：

echo $APIFLUX_API_KEY

macOS 預設通常是 zsh，長期生效可以寫入 ~/.zshrc：

echo 'export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Linux 常見是 bash，長期生效可以寫入 ~/.bashrc：

echo 'export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"' >> ~/.bashrc
source ~/.bashrc

[!WARNING] 不要在公開截圖、螢幕錄影或儲存庫中展示包含真實 API Key 的 Shell 設定檔。

6. 啟動 Codex CLI 並發出測試請求

在終端機中執行：

codex

啟動 Codex CLI 後，可以輸入一個簡單問題：

用一句話介紹 ApiFlux 是什麼

如果 Codex CLI 正常回覆，請回到 ApiFlux 控制台，開啟 Logs 確認是否出現請求紀錄。

常見問題

找不到 API Key

Windows PowerShell 檢查：

echo $env:APIFLUX_API_KEY

macOS / Linux 檢查：

echo $APIFLUX_API_KEY

如果沒有輸出，請重新設定環境變數。

401 或 Unauthorized

通常由以下原因導致：

API Key 填寫錯誤
Key 已被刪除或失效
複製 Key 時包含多餘空格
目前終端機沒有載入環境變數

處理方式：

在 ApiFlux 控制台確認 Key 是否有效
重新設定 APIFLUX_API_KEY
關閉並重新開啟終端機後再次測試

模型不存在

請檢查設定中的：

model = "YOUR_MODEL_ID"

模型 ID 必須來自 ApiFlux Models 頁面。