AI Agents
在 SeedRouter 上執行程式開發代理
讓 Claude Code 使用 SeedRouter 的 Claude 模型、讓 Codex CLI 使用 GPT-6,費用從你的 SeedRouter 餘額中扣除。
程式開發代理可以使用 SeedRouter 作為模型供應商。它們透過你的 SeedRouter API 金鑰傳送請求,每個請求依 token 用量從你的 SeedRouter 餘額中扣款,無需訂閱。
| 代理 | 使用的端點 | 模型 |
|---|---|---|
| Claude Code | Anthropic Messages,https://api.seedrouter.ai/v1/messages | Claude |
| Codex CLI | OpenAI Responses,https://api.seedrouter.ai/v1/responses | GPT-6 |
如果要讓代理呼叫 SeedRouter 的影像與影片模型,請使用 MCP 伺服器,或參閱透過 AI 代理使用 SeedRouter。
Claude Code
在用於啟動 Claude Code 的終端機中執行:
export ANTHROPIC_BASE_URL=https://api.seedrouter.ai
export ANTHROPIC_API_KEY=YOUR_API_KEY
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5
claude --model claude-opus-5-5- 基礎 URL 不包含路徑。 Claude Code 會自行加入
/v1/messages。 - 三個
ANTHROPIC_DEFAULT_*_MODEL變數將 Claude Code 的opus、sonnet與haiku別名指向 SeedRouter 模型 ID,這些別名也用於背景工作。你也可以直接傳入 ID,例如claude --model claude-fable-5-1。 - 使用該金鑰會取代你的 Claude 訂閱方案。 在互動工作階段中,Claude Code 會要求你核准使用該金鑰一次;此後的請求將從你的 SeedRouter 餘額中扣款。取消設定這些變數即可恢復使用訂閱方案。
若要讓每次啟動都保留這些設定,請將相同的變數放入 env 區塊中,該區塊位於 ~/.claude/settings.json。這樣該檔案就會包含一把可消耗你餘額的金鑰,因此請妥善保密。
| 模型 ID | 用途 |
|---|---|
claude-opus-5-5 | 日常程式開發 |
claude-fable-5-1 | 長時間重構與複雜除錯 |
claude-fable-5 | 依賴強制工具呼叫的設定情境 |
claude-sonnet-5-5 | sonnet 別名 |
claude-haiku-5-5 | haiku 別名與背景工作 |
各模型頁面列有每百萬 token 的即時費率,例如 Claude Opus 5.5。Claude Code 指南記錄了完整設定、提示詞快取行為與測試結果。
Codex CLI
將 SeedRouter 加入使用者層級的 ~/.codex/config.toml 中,並保留其他設定:
model = "gpt-6-sol"
model_provider = "seedrouter"
[model_providers.seedrouter]
name = "SeedRouter"
base_url = "https://api.seedrouter.ai/v1"
env_key = "SEEDROUTER_API_KEY"
wire_api = "responses"然後匯出金鑰並啟動 Codex:
export SEEDROUTER_API_KEY=YOUR_API_KEY
codex- 使用使用者層級的設定檔。 Codex 會忽略
model_provider與model_providers在專案層級.codex/config.toml中的設定。 - 選擇模型時,可透過
model設定,或使用codex -m gpt-6-astra為單次工作階段指定模型。GPT-6 Astra 適合最困難的任務,GPT-6 Sol 適合日常程式開發,GPT-6 Luna 適合需要快速、低成本完成的步驟。 - 經過測試的模型是 GPT-6。 Codex 傳送 Responses 請求;其他文字模型需要支援 Responses 格式,其 API 參考會列明這一點,但尚未在 Codex 中經過測試。
GPT-6 Codex 指南記錄了上下文視窗、推理強度設定與測試結果。
檢查連線
curl https://api.seedrouter.ai/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-haiku-5-5",
"max_tokens": 32,
"messages": [{"role": "user", "content": "Reply OK."}]
}'金鑰有效時,會回傳一則包含簡短回覆的訊息。對於 Codex,請在完成上述設定後執行 codex exec "Reply OK."。
費用與限制
- 請求依每次回應對應的 token 用量計費。程式開發工作階段每次請求都會傳送較長的提示詞前綴,包括指令、工具定義與專案檔案。模型支援提示詞快取時,後續請求會以較低費率從快取讀取該前綴。
- 每個請求都會出現在你的用量記錄中。請在帳單頁面儲值額度。
- HTTP
429表示同時傳送的請求過多。請減少並行工作階段或子代理的數量;如果有Retry-After,請依其指定的時間等待。
疑難排解
| 現象 | 解決方法 |
|---|---|
401 | 檢查金鑰。對於 Claude Code,只設定 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN 其中之一,不要同時設定。 |
每次請求都回傳 404 | Claude Code 需要設定 ANTHROPIC_BASE_URL=https://api.seedrouter.ai;Codex 需要設定 base_url = "https://api.seedrouter.ai/v1"。 |
| 模型無法使用 | 使用上面列出的模型 ID:Claude Code 使用 Claude 模型,Codex 使用 GPT-6。 |
| 餘額不足 | 在帳單頁面儲值額度。 |
429 | 減少並行工作階段或子代理的數量;如果有 Retry-After,請依其指定的時間等待。 |
