ApiFluxAI | ApiFlux 常見問題

排查 ApiFlux API Key、Base URL、Codex CLI、Claude Code 與 OpenCode 的常見問題。

本文整理 ApiFlux 使用者在建立 API Key、設定 Base URL、連線 Codex CLI、Claude Code 和 OpenCode 時常見的問題。

Q1：官網地址和 API Base URL 有什麼區別？

官網入口用於登入、建立 API Key、檢視模型、檢視餘額和檢視紀錄：

https://apiflux.ai/

API Base URL 用於設定工具或 SDK：

https://apiflux.ai/v1

大多數 OpenAI-compatible 工具應填寫 https://apiflux.ai/v1。

Claude Code 使用閘道器變數時，可以先嘗試：

https://apiflux.ai

如果出現路徑相關錯誤，再嘗試：

https://apiflux.ai/v1

Q2：API Key 洩露了怎麼辦？

請立即執行以下操作：

登入 ApiFlux 控制台
進入 API Keys
刪除洩露的 API Key
建立新的 API Key
更新本地工具或應用中的設定

洩露過的 API Key 不建議繼續使用。

Q3：為什麼會報 401 或 Unauthorized？

常見原因包括：

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

OpenCode 或 Codex CLI 使用者可檢查。

Windows PowerShell：

echo $env:APIFLUX_API_KEY

macOS / Linux：

echo $APIFLUX_API_KEY

Claude Code 使用者可檢查。

Windows PowerShell：

echo $env:ANTHROPIC_API_KEY

macOS / Linux：

echo $ANTHROPIC_API_KEY

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

Q4：為什麼提示餘額不足？

通常是 ApiFlux 帳戶餘額不足，或目前 API Key 所屬帳戶沒有可用額度。

處理方式：

開啟 ApiFlux Dashboard
檢視 Current balance
如果餘額不足，點選 Recharge
充值後重新發起請求

Q5：為什麼提示模型不存在？

多數情況是模型 ID 填寫錯誤。

請開啟 ApiFlux Models 頁面，複製模型詳情中展示的 interface model ID。不要使用模型展示名稱，也不要手動猜測模型 ID。

錯誤示例：

Claude Sonnet
GPT 4o
Gemini Pro

正確做法是複製 ApiFlux Models 頁面展示的完整模型 ID。

Q6：請求成功了，但 Logs 中沒有紀錄怎麼辦？

請依次檢查：

目前登入的 ApiFlux 帳號是否正確
工具是否設定了 ApiFlux Base URL
工具是否使用了 ApiFlux API Key
請求是否可能傳送到了其他服務商
Logs 頁面是否需要重新整理
是否選錯了時間範圍

如果工具可以回覆，但 ApiFlux Logs 中完全沒有紀錄，通常說明請求沒有經過 ApiFlux。

Q7：Codex CLI、Claude Code、OpenCode 應該使用哪種介面？

Codex CLI 建議使用自訂 model provider，設定 ApiFlux Base URL：

https://apiflux.ai/v1

OpenCode 建議使用 OpenAI-compatible custom provider：

https://apiflux.ai/v1

Claude Code 建議使用 Anthropic-compatible 閘道器變數：

ANTHROPIC_BASE_URL
ANTHROPIC_API_KEY
DISABLE_INTERLEAVED_THINKING
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS

設定完成後，可透過 ApiFlux Logs 驗證請求是否成功到達 ApiFlux。

Q8：一個 API Key 可以給多個工具共用嗎？

可以，但正式使用時建議按工具或環境拆分。

例如：

codex-cli-key
claude-code-key
opencode-key
production-app-key

這樣做有三個好處：

更容易定位用量來源
更容易排查異常請求
某個 Key 洩露時隻影響對應工具或環境

Q9：如何更換模型？

先到 ApiFlux Models 頁面複製新的模型 ID。

Codex CLI 使用者修改：

model = "YOUR_NEW_MODEL_ID"

OpenCode 使用者修改：

"models": {
  "YOUR_NEW_MODEL_ID": {}
}

Claude Code 使用者如果支援啟動引數，可以使用：

claude --model "YOUR_NEW_MODEL_ID"

修改後重新啟動工具，並前往 ApiFlux Logs 確認請求紀錄。

Q10：如何安全處理截圖和螢幕錄影？

公開截圖或螢幕錄影前，請確認沒有展示以下內容：

完整 API Key
包含真實 Key 的環境變數
包含真實 Key 的設定檔
敏感 prompt
私密紀錄內容

推薦打碼方式：

sk-****abcd

最多保留前 3 到 4 位和後 3 到 4 位，不要展示完整 Key。

Q11：Base URL 後面到底要不要加 `/v1`？

大多數 OpenAI-compatible 工具和 SDK 應填寫：

https://apiflux.ai/v1

Claude Code 的 ANTHROPIC_BASE_URL 可以先填寫：

https://apiflux.ai

如果出現路徑相關錯誤，再嘗試：

https://apiflux.ai/v1

判斷標準是：工具可以正常回覆，並且 ApiFlux Logs 中出現對應請求。

Q12：如何確認請求真的經過 ApiFlux？

發起一次簡單請求，然後開啟 ApiFlux 控制台的 Logs。

如果 Logs 中出現該請求，說明工具已經經過 ApiFlux。

如果工具有回覆但 Logs 中沒有紀錄，請檢查 Base URL、API Key 和目前登入帳號。

Q13：Claude Code 報 invalid beta flag 怎麼辦？

這是 Claude Code 連線第三方閘道器時可能出現的 beta header 相容問題。

啟動 Claude Code 前，請設定：

Windows PowerShell：

$env:DISABLE_INTERLEAVED_THINKING="1"
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"

macOS / Linux：

export DISABLE_INTERLEAVED_THINKING=1
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

然後重新執行：

claude --model "YOUR_MODEL_ID"

Q14：OpenCode 報 fn3 is not a function 怎麼辦？

該錯誤通常來自 OpenCode 外掛異常，不代表 ApiFlux API Key 或 Base URL 設定錯誤。

可以開啟：

~/.config/opencode/opencode.json

將 plugin 暫時設定為空陣列：

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": []
}

確認 OpenCode 能正常啟動後，再逐個恢復外掛。

Q15：OpenCode 報 function tools 或 reasoning_effort 不支援怎麼辦？

說明目前模型不適合 OpenCode 的工具呼叫請求。

可以嘗試更適合編碼工具呼叫的模型，例如：

deepseek-v4-pro
qwen3.7-plus
glm-5.2

Q16：Windows 和 macOS / Linux 的命令為什麼不一樣？

主要區別在環境變數寫法。

Windows PowerShell 使用：

$env:APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"

macOS / Linux 使用：

export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"

如果使用者複製了不屬於自己系統的命令，通常不會損壞電腦，只是命令不會生效。請回到對應系統的小節重新複製。

Q17：提示 command not found 或「不是內部或外部命令」怎麼辦？

這通常說明工具沒有安裝成功，或安裝目錄沒有加入 PATH。

處理方式：

關閉終端機並重新開啟
執行版本檢查命令，例如 node -v、codex --version、claude --version、opencode --version
如果仍然失敗，重新執行對應工具的安裝命令
Windows 使用者如果使用 npm 安裝，請先確認 npm -v 能正常輸出版本號

Q18：npm command not found 怎麼辦？

說明本機還沒有安裝 Node.js，或安裝後終端機沒有重新開啟。

請前往 Node.js 官網安裝 LTS 版本：

https://nodejs.org/

安裝完成後，關閉終端機並重新開啟，再執行：

node -v
npm -v

Windows PowerShell 也可以執行同樣的版本檢查命令。

Q19：環境變數是暫時的還是永久的？

直接在終端機中執行的環境變數通常只對目前視窗有效。

Windows PowerShell 暫時寫法：

$env:APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"

Windows PowerShell 長期寫法：

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

macOS / Linux 暫時寫法：

export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"

macOS 長期寫法通常寫入 ~/.zshrc，Linux 長期寫法通常寫入 ~/.bashrc。

Q20：Windows 使用者一定要安裝 WSL 嗎？

不一定。

如果只是跟著指南設定工具，PowerShell 通常已經夠用。

如果使用者經常做開發、需要執行 Linux 命令，或者某些工具在 Windows 原生環境裡表現不穩定，可以考慮使用 WSL。使用 WSL 時，請在 WSL 終端機裡按照 Linux 命令操作。