在 SeedRouter 上运行编程智能体

编程智能体可以使用 SeedRouter 作为模型提供商。它们通过你的 SeedRouter API 密钥发送请求，每个请求按 token 用量从你的 SeedRouter 余额中扣费，无需订阅。

如果要让智能体调用 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。这样该文件就会包含一把可消耗你余额的密钥，因此请妥善保密。

各模型页面列有每百万 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，请按其指定的时间等待。

故障排查