工具整合

Claude Code

Claude Code 是 Anthropic 官方的命令列程式設計 Agent,能讀懂整個程式碼庫、編輯檔案、執行指令。透過 FlyRouter 使用時,只需把 API 位址和 Key 指向 FlyRouter,所有功能保持不變。

安裝 Claude Code

curl -fsSL https://claude.ai/install.sh | bash

安裝完成後執行 claude --version 確認,遇到問題可以執行 claude doctor 自我檢查。

設定 FlyRouter

建立 API Key

在控制台 API 金鑰 頁面為 Claude Code 單獨建立一個 Key。

寫入設定檔

編輯使用者設定檔 ~/.claude/settings.json(Windows 為 %USERPROFILE%\.claude\settings.json),沒有就新建:

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.flyrouter.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}

ANTHROPIC_BASE_URL 不要帶 /v1。

啟動並確認

在專案目錄執行 claude,然後輸入 /status,看到 Anthropic base URL 一行顯示 https://api.flyrouter.ai 即設定成功。

為什麼寫在 settings.json

寫進 settings.json 後,無論從哪個終端機、哪個 IDE 啟動都會生效,而且第一次啟動就能直接使用,不會停在登入頁。同一個變數同時在 shell 和 settings.json 裡設定時,以 settings.json 為準。不要把含 Key 的設定寫進專案裡會提交到 Git 的 .claude/settings.json。

也可以只用環境變數(只對目前終端機生效):

export ANTHROPIC_BASE_URL="https://api.flyrouter.ai"
export ANTHROPIC_AUTH_TOKEN="sk-..."
claude

選擇模型

Claude Code 裡的 opus、sonnet、haiku 三個別名分別對應上面設定的三個模型,haiku 還用於背景的輕量任務。工作階段中輸入 /model 可以切換:

  • Sonnet(claude-sonnet-5-5):日常程式設計的主力,速度和效果均衡。
  • Opus(claude-opus-5-5):複雜重構、架構設計等難題。
  • Fable(claude-fable-5-1):最強推理,單價最高,可以在 /model 裡直接輸入模型 ID 使用。

想固定預設模型,可以在 env 里加 "ANTHROPIC_MODEL": "claude-sonnet-5-5"。模型 ID 必須和 模型價格 頁面上的完全一致。

常見問題

啟動後仍然要求登入

確認 ANTHROPIC_AUTH_TOKEN 寫在 ~/.claude/settings.json 的 env 裡,而不是隻在某個終端機裡 export。如果之前用 Claude 帳號登入過,可以在工作階段裡執行 /logout 清掉舊的登入狀態。

提示 There's an issue with the selected model

模型 ID 寫錯了,或這個 Key 限制了可用模型。到 模型價格 頁面核對 ID,並檢查 Key 的模型限制。

報 400 Extra inputs are not permitted

新版 Claude Code 偶爾會發送尚未普及的實驗欄位。在 env 中加入 "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1" 即可。

請求逾時

複雜任務首字可能較慢。可以在 env 裡設定 "API_TIMEOUT_MS": "1200000"(20 分鐘)放寬逾時。

部分功能不可用

使用第三方 API 位址時,Remote Control、語音輸入和 /fast 等依賴 Anthropic 帳號的功能不可用,程式設計相關功能不受影響。

FlyRouter

一組 Key,直飛全球大型模型