モデルガイド初心者向け更新日

Claude Code で Doubao Seed 2.1 Turbo を使うには

Claude Code に I Code Easy API Key、ルート URL 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 のコーディングクライアントです。この設定では Doubao を選択し、Claude モデルによる処理を意味しません。Seed のテキストモデルは Seedream 画像生成や Seedance 動画生成とは別のサービスです。

ここでは I Code Easy API Key を使います。Volcengine / Ark 公式の Key や契約、Doubao の一般向けアプリのログインは使いません。異なるサービスのキーと URL を混在させないでください。

設定前の準備

  1. Claude Code ガイドでクライアントをインストールし、OS とターミナルは環境準備を確認してください。
  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 を当サービスの 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 行をシェルの起動ファイルに追加します。zsh は ~/.zshrc、bash は ~/.bashrc です。使用中のシェルに対応する行だけを実行してください。

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"

ユーザー環境として永続化する場合は、上記を設定した同じウィンドウで次のコードを実行します。7 つの値をユーザー環境に保存します。

$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 か、余分な空白がないか、ローテーションで無効になっていないか、URL と Key のサービスが一致するかを確認します。Key は他人に送らないでください。
403 / アクセス拒否アカウント状態と現在のモデル利用範囲を確認してください。Key を含めず、エラー文と発生時刻をサポートに伝えます。
429 / リクエスト制限エラー全文と管理画面の状態を確認し、同時実行数を減らして後で再試行します。429 が常に残高不足を意味するわけではありません。
Claude の名前が表示されるANTHROPIC_MODEL と 3 つの既定変数を確認します。クライアント名、モデルの別名、実際のモデルは異なる情報なので、リクエストログとも照合します。
設定が反映されない古いクライアントを終了し、新しいターミナルから起動します。起動ファイル、ユーザー環境、クライアント設定の重複値と、変更したシェルが実際の使用シェルかを確認します。
タイムアウト / 通信エラーローカルプロキシとネットワークを確認します。下記の JP/SG URL を試し、接続トラブル対処を参照してください。

メインドメインへの接続が遅い場合は ANTHROPIC_BASE_URL だけを変更し、ほかの変数は維持します。代替 URL にも /v1 は付けません。

https://jp.icodeeasy.cc
https://sg.icodeeasy.cc

変更後に Claude Code を再起動して確認手順を繰り返します。問い合わせにはエラーコード、時刻、機密情報を除いたログを使い、Key 自体は送らないでください。

関連ガイドと公式資料