工具整合
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),沒有就新建:
{
"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 帳號的功能不可用,程式設計相關功能不受影響。