豆包 Seed 2.1 Turbo 如何通过 Claude Code 接入?
在 Claude Code 中配置本站 API Key、根地址 https://api.icodeeasy.cc 和模型 doubao-seed-2.1-turbo,即可使用 Doubao Seed 2.1 Turbo。本页介绍 macOS、Linux、Windows 的设置、验证和排错。
先分清模型、客户端与账号
Doubao Seed 2.1 Turbo 是文本模型;Claude Code 是 Anthropic 的编程客户端。这里把客户端的模型选择指向豆包,不代表请求由 Claude 模型处理。Seed 文本模型与 Seedream 图片生成和 Seedance 视频生成不是同一种服务。
本页使用 I Code Easy API Key,不使用火山引擎 / 方舟官方 Key、官方套餐或豆包消费端 App 登录。不同服务的密钥和地址不能混用。
开始前准备
- 按 Claude Code 指南安装客户端;系统与终端准备见环境准备。
- 注册账号,在 API Keys复制本站 Key;只保存到自己的本地配置。
- 查看当前价格与用量说明及模型能力目录,确认公开支持范围。
推荐直接填写 doubao-seed-2.1-turbo。旧名 doubao-seed-2.0-pro 会透明升级到 Seed 2.1 Turbo,不再表示独立的旧模型选择。三个 ANTHROPIC_DEFAULT_*_MODEL 变量用于将 Haiku、Sonnet、Opus 别名也指向同一模型。
Linux / MacOS 配置
在准备运行 Claude Code 的终端中粘贴以下配置,把占位文本替换成本站 Key。它先对当前终端会话生效:
export ANTHROPIC_AUTH_TOKEN="你的 I Code Easy API Key"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export ANTHROPIC_MODEL="doubao-seed-2.1-turbo"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="doubao-seed-2.1-turbo"
export ANTHROPIC_DEFAULT_SONNET_MODEL="doubao-seed-2.1-turbo"
export ANTHROPIC_DEFAULT_OPUS_MODEL="doubao-seed-2.1-turbo"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
需要持久化时,把同一组 export 写入所用 shell 的启动文件:zsh 用 ~/.zshrc,bash 用 ~/.bashrc。只执行与你的 shell 对应的一行:
source ~/.zshrc
source ~/.bashrc
也可以重新打开终端。已经运行的 Claude Code 不会自动读取新的环境变量,退出后从这个终端重新启动。
Windows 配置
只配置当前 PowerShell 会话时运行:
$env:ANTHROPIC_AUTH_TOKEN = "你的 I Code Easy API Key"
$env:ANTHROPIC_BASE_URL = "https://api.icodeeasy.cc"
$env:ANTHROPIC_MODEL = "doubao-seed-2.1-turbo"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "doubao-seed-2.1-turbo"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "doubao-seed-2.1-turbo"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "doubao-seed-2.1-turbo"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"
需要用户级持久化时,在已经设置好上述变量的同一个窗口运行以下代码,把这七个值保存到用户环境:
$names = @(
"ANTHROPIC_AUTH_TOKEN",
"ANTHROPIC_BASE_URL",
"ANTHROPIC_MODEL",
"ANTHROPIC_DEFAULT_HAIKU_MODEL",
"ANTHROPIC_DEFAULT_SONNET_MODEL",
"ANTHROPIC_DEFAULT_OPUS_MODEL",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC"
)
foreach ($name in $names) {
$value = [Environment]::GetEnvironmentVariable($name, "Process")
[Environment]::SetEnvironmentVariable($name, $value, "User")
}
用户级变量供以后启动的进程读取。保存后重新打开 PowerShell;若使用 VS Code 或其他集成终端,也重启其宿主应用,再启动 Claude Code。
先做本地验证,再发真实请求
先确认客户端已安装;下面命令仅输出版本,不会发起模型请求:
claude --version
检查 Key 是否存在,只输出布尔值,不打印 Key 原文:
macOS / Linux:
test -n "$ANTHROPIC_AUTH_TOKEN" && echo true || echo false
PowerShell:
[bool]$env:ANTHROPIC_AUTH_TOKEN
从刚配置的终端运行 claude,在客户端中输入 /status,检查当前模型和连接配置。状态页是本地配置线索;界面仍出现 Claude Code、Haiku、Sonnet 或 Opus 名称,不足以证明实际使用了 Claude 模型。
然后由你在 Claude Code 中发送一句简短提示,例如“只回复 OK”。这会产生真实请求,按当前规则计费。到请求日志核对本次请求是否成功、记录的模型和费用;不要仅凭模型在回答中自称的名称判断。
常见问题与排错
| 现象 | 优先检查 |
|---|---|
| 401 / 鉴权失败 | 确认使用本站 Key、没有多余空格,Key 未轮换失效,且地址与 Key 属于同一服务。不要把 Key 发给他人检查。 |
| 403 / 无权限 | 检查账号状态与当前模型访问范围;保留错误文字和发生时间联系支持,不附 Key。 |
| 429 / 请求受限 | 查看完整错误文字和控制台状态,降低并发、稍后重试;不要把所有 429 都认作余额不足。 |
| 仍显示 Claude 名称 | 检查 ANTHROPIC_MODEL 与三个默认变量;客户端名称、模型别名与实际请求模型是不同信息,以请求日志交叉确认。 |
| 配置未生效 | 退出旧客户端,从新终端重启;检查启动文件、用户环境和客户端配置中的重复值,避免在另一个 shell 中修改。 |
| 超时 / 网络错误 | 检查本地代理和网络;试用下文 JP/SG 地址,再查看连接排查。 |
主域名连接慢时,只替换 ANTHROPIC_BASE_URL,其他变量不变;备用地址同样不加 /v1:
https://jp.icodeeasy.cc
https://sg.icodeeasy.cc
切换后重启 Claude Code,再按上面的流程验证。排错时可提供错误码、发生时间和脱敏日志,不提供 Key 原文。
相关指南与官方参考
相关指南
Claude Code 安装、API 配置与 Windows 排错
安装 Claude Code,配置自定义 API 地址与密钥,验证 Windows、macOS、Linux 环境变量,排查 401、403、429 和连接问题,并了解 Claude Desktop、Kimi 与 GLM 的配置入口。
Kimi Code 配置指南:API Key、K3.1 Pro 与 Claude Code
在 Kimi Code CLI 或 Claude Code 中配置 Kimi K3.1 Pro,区分持久与临时设置、Windows 会话和 Base URL,并排查 401、模型切换及旧名问题。
在哪里查看人民币价格、余额与用量明细?
通过公开价格页和控制台查看实时人民币价格、余额、请求日志、Token 用量、账单明细及当前支付方式的最新说明。