使用 ApiFlux 設定 Claude Code
安裝 Claude Code，透過 Anthropic 相容介面連線 ApiFlux，並驗證模型請求。
本指南介紹如何將 Claude Code 連線到 ApiFlux。設定完成後，Claude Code 可以透過 ApiFlux 的 Anthropic-compatible 介面傳送請求，並在 ApiFlux 控制台檢視紀錄和用量。
適用場景
適合希望在 Claude Code 中使用 ApiFlux 統一管理模型存取、用量和紀錄的使用者。
如果使用者還沒有安裝終端機，可以先閱讀：
[!NOTE] Claude Code 可以用官方安裝指令碼安裝，不一定需要 Node.js。但如果使用者同時要使用 Codex CLI 或 OpenCode，建議先安裝 Node.js LTS。
準備工作
開始前，請準備：
- 一個 ApiFlux API Key
- 一個 ApiFlux 支援 Claude / Anthropic-compatible 協議的模型 ID
ApiFlux 官網入口：
https://apiflux.ai/ApiFlux OpenAI-compatible Base URL：
https://apiflux.ai/v1Claude Code 使用閘道器時通常透過 ANTHROPIC_BASE_URL 設定介面地址。建議先使用：
https://apiflux.ai如果出現路徑相關錯誤，再嘗試：
https://apiflux.ai/v11. 安裝 Claude Code
Windows
開啟 PowerShell，執行：
irm https://claude.ai/install.ps1 | iex也可以使用 WinGet：
winget install Anthropic.ClaudeCode如果使用 WSL，請在 WSL 終端機中按 macOS / Linux 命令安裝。
macOS / Linux
開啟終端機，執行：
curl -fsSL https://claude.ai/install.sh | bashmacOS 使用者也可以使用 Homebrew：
brew install --cask claude-code安裝完成後，關閉終端機並重新開啟。
2. 確認 Claude Code 已安裝
在終端機中執行：
claude --version如果能看到版本號，說明 Claude Code 已安裝成功。
也可以執行診斷命令：
claude doctor如果提示 command not found 或「不是內部或外部命令」，請重新開啟終端機；如果仍然失敗，請重新執行安裝命令。
3. 準備 ApiFlux API Key
進入 ApiFlux 控制台，開啟 API Keys 頁面，複製要用於 Claude Code 的 API Key。
如果尚未建立 API Key，請先參考：
4. 設定 Claude Code 環境變數
[!NOTE]
ANTHROPIC_API_KEY中填寫的是 ApiFlux API Key，不是 Anthropic 官網 Key。
Windows PowerShell
目前視窗暫時生效：
$env:ANTHROPIC_BASE_URL="https://apiflux.ai"
$env:ANTHROPIC_API_KEY="YOUR_APIFLUX_API_KEY"
$env:DISABLE_INTERLEAVED_THINKING="1"
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"檢查 Key 是否生效：
echo $env:ANTHROPIC_API_KEY如果希望長期生效，可以執行：
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://apiflux.ai","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY","YOUR_APIFLUX_API_KEY","User")
[Environment]::SetEnvironmentVariable("DISABLE_INTERLEAVED_THINKING","1","User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS","1","User")設定長期環境變數後，請關閉 PowerShell，再重新開啟。
macOS / Linux
目前視窗暫時生效：
export ANTHROPIC_BASE_URL="https://apiflux.ai"
export ANTHROPIC_API_KEY="YOUR_APIFLUX_API_KEY"
export DISABLE_INTERLEAVED_THINKING=1
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1檢查 Key 是否生效：
echo $ANTHROPIC_API_KEYmacOS 預設通常是 zsh，長期生效可以寫入 ~/.zshrc：
echo 'export ANTHROPIC_BASE_URL="https://apiflux.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="YOUR_APIFLUX_API_KEY"' >> ~/.zshrc
echo 'export DISABLE_INTERLEAVED_THINKING=1' >> ~/.zshrc
echo 'export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1' >> ~/.zshrc
source ~/.zshrcLinux 常見是 bash，長期生效可以寫入 ~/.bashrc：
echo 'export ANTHROPIC_BASE_URL="https://apiflux.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="YOUR_APIFLUX_API_KEY"' >> ~/.bashrc
echo 'export DISABLE_INTERLEAVED_THINKING=1' >> ~/.bashrc
echo 'export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1' >> ~/.bashrc
source ~/.bashrc5. 選擇模型
Claude Code 的模型 ID 應以 ApiFlux Models 頁面為準。
如果目前 Claude Code 版本支援透過啟動引數指定模型，可以使用：
claude --model "YOUR_MODEL_ID"示例：
claude --model "claude-sonnet-4-6"[!NOTE]
claude-sonnet-4-6僅作為示例。實際可用模型請以 ApiFluxModels頁面為準。
6. 發起測試請求
啟動 Claude Code：
claude --model "YOUR_MODEL_ID"在 Claude Code 中輸入一個簡單請求：
請用三句話介紹 ApiFlux，並說明它適合什麼使用者。如果 Claude Code 正常回覆，請回到 ApiFlux 控制台，開啟 Logs 檢視請求紀錄。
相容性說明
部分 Claude Code 版本會預設傳送 beta header。第三方閘道器或部分 Claude 路由可能不接受這些 beta header，從而返回：
invalid beta flag如果出現該錯誤，請確保啟動前已經設定：
DISABLE_INTERLEAVED_THINKING=1
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1如果 https://apiflux.ai 報路徑錯誤，可以改用：
ANTHROPIC_BASE_URL="https://apiflux.ai/v1"常見問題
401 Unauthorized
通常由以下原因導致：
- API Key 填寫錯誤
- API Key 已刪除或失效
- 目前終端機沒有載入環境變數
- Key 中包含多餘空格
Windows PowerShell 可執行：
echo $env:ANTHROPIC_API_KEYmacOS / Linux 可執行：
echo $ANTHROPIC_API_KEY如果沒有輸出，請重新設定環境變數。
404 或 Not Found
通常是 Base URL 路徑不匹配。
可先嘗試：
https://apiflux.ai如果仍然失敗，再嘗試：
https://apiflux.ai/v1模型不可用
請回到 ApiFlux Models 頁面，確認所選模型支援 Claude / Anthropic-compatible 協議。