模型指南入门读者更新于

豆包 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 登录。不同服务的密钥和地址不能混用。

开始前准备

  1. 按 Claude Code 指南安装客户端;系统与终端准备见环境准备。
  2. 注册账号,在 API Keys复制本站 Key;只保存到自己的本地配置。
  3. 查看当前价格与用量说明及模型能力目录,确认公开支持范围。

推荐直接填写 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 原文。

相关指南与官方参考