Doubao 大規模モデル 2.1（Seed 2.1 Pro）が正式にリリースされました。フロントエンドのコーディング能力は Arena Frontend ランキングで第8位、Opus 4.6 と同ランクです。さらに重要なのは、Volcano Engine Ark が Anthropic プロトコル互換のエンドポイントを提供していることです。つまり、日常使いの Claude Code や Cursor といったコーディングエージェントを、Doubao 駆動へシームレスに切り替えられます。本チュートリアルでは、3つの環境変数で切り替えを完了し、実際のオープンソースプロジェクトのバグ修正を通じて、主力として使えるかを検証します。

Arena Code Frontend の人間によるブラインド投票ランキングにおける Seed 2.1 Pro の位置。Opus 4.6 と同一ランクにいます。

始める前の準備

切り替えの前に以下を用意してください。

• Volcano Engine Ark のアカウント（登録先：Volcano Engine コンソール）
• インストール済みの Claude Code（ターミナル CUI エージェント）
• ターミナル環境（macOS / Linux、Windows は WSL 推奨）
• 想定設定時間：5分。以降はトークン量に応じた課金

3ステップで接続完了

ステップ1：モデルを有効化して API Key を取得

Volcano Engine Ark コンソールにログインし、モデル doubao-seed-2-1-pro-preview を見つけて有効化します。「API Key 管理」で ARK API Key を1つ作成し、コピーして保存してください。

💡 ヒント：有効化したらチャージを忘れずに。Doubao 2.1 の総合的な利用コストは Claude Opus 4.6 比で80%近く下がっており、予算に敏感な開発者も安心して使えます。

ステップ2：3つの環境変数を設定

Claude Code の起動前に3つの変数を注入するだけです（~/.claude/settings.json の env フィールドに書くこともできます）。

export ANTHROPIC_BASE_URL=https://ark.cn-beijing.volces.com/api/compatible
export ANTHROPIC_AUTH_TOKEN=あなたの_ARK_API_Key
export ANTHROPIC_MODEL=doubao-seed-2-1-pro-preview

~/.zshrc にエイリアスを書いて、Doubao 駆動と元の claude を隔離し、互いに干渉しないようにするのがおすすめです。

alias doubao='ANTHROPIC_BASE_URL=https://ark.cn-beijing.volces.com/api/compatible \
ANTHROPIC_AUTH_TOKEN=あなたのKEY \
ANTHROPIC_MODEL=doubao-seed-2-1-pro-preview \
claude'

保存したら source ~/.zshrc。以後、ターミナルで doubao と打てば Doubao 駆動の Claude Code、claude と打てば従来のモデルが起動します。

ステップ3：接続成功を確認

ターミナルで実行します。

claude

起動したら /status と打ち、表示される Model フィールドが doubao-seed-2-1-pro-preview になっていることを確認します。

/status コマンドで Claude Code が実際に呼び出しているモデルを直接確認でき、設定ミスを防げます。

💡 ヒント：変数の設定、エイリアスの記述、エンドポイントの変更という一連の作業は、Claude Code や任意のエージェントに丸投げして、数分でセットアップしてもらうこともできます。本当に自分の手でやる必要があるのは、モデルの有効化、Key の取得、チャージだけです。

実測シナリオ：実際のオープンソースプロジェクトのバグを修正させる

テスト対象：FanBox

テスト対象は FanBox というオープンソースプロジェクトです——「Coding Agent のコックピット」。左側でローカルファイルを閲覧・プレビューし、右側の組み込み本物ターミナルで Claude Code や Codex を走らせ、エージェントがファイルを変更するたびに対応するカードが光ります。

FanBox は実際のユーザーがいて、今も日々成長している製品です。自前のコードは28ファイル・15609行、単体の app.js だけで4572行。新モデルの実戦能力を検証するには十分な複雑さです。

GitHub 上の FanBox の open issue を直接取得させ、実際のユーザーからフィードバックされた問題を2つ選びました。

• #27：ターミナルでコピー＆ペーストが効かない。ネイティブターミナルと挙動が不一致
• #28：プロジェクトに新しく追加した skills が読み込めない

どちらのバグも一目で見抜けるものではありません。1つ目はプロジェクト作者本人も見当がつかず、2つ目は skills の読み込み・リフレッシュの一連のロジックを読み解く必要があります。

いきなりコードを変更しなかった

Seed 2.1 Pro はタスクを受け取ると、まず plan mode（Claude Code の「先に探索し、先に考え抜いて、それから着手する」モード）に入り、自らタスクを2つの並行ラインに分解しました。Explore サブエージェントを2つ同時に投入——1つはターミナル実装コードを徹底的に読み込み（45回のツール呼び出し、12万トークン）、もう1つは skills の読み込み機構を調査（35回、約4万トークン）し、どちらも関連コードを読み込んでから戻ってきました。

plan mode + 並行サブエージェントは Claude Code が用意した足場であり、それを使いこなせるかはモデル能力の表れです。

変更は実に筋がいい

#27 の修正では、奇策に頼らずプロジェクト本来の書き方に沿って直しました。xterm 公式のクリップボードプラグインをインストールし、ターミナルにキー処理を追加——Cmd+C で選択範囲をコピー、Cmd+V でシステムクリップボードを読み出して bracketed paste で安全にターミナルへ挿入、ついでに Cmd+プラス/マイナス による文字サイズ調整も補いました。変更は app.js など5ファイル、80行あまりに及びます。

一番の実感は、リポジトリ本来の作法を守って変更したことです。プロジェクトのあちこちで __noXterm という「読み込み失敗したらフォールバックする」タイプのスイッチが使われていますが、修正の際にはそれに倣って __noClipboard の保険を追加し、元のコードのスタイルにぴたりと馴染ませました。長期保守されるプロジェクトでは、この点は「動くかどうか」よりも重要です。

auto mode で Seed 2.1 Pro は40分以上ぶっ通しで走り、途中で人の手を借りませんでした——長時間にわたり複雑なタスクを安定させ続けられること自体が、能力の硬い指標です。

検証結果

修正後、2つの issue はどちらも1つの commit として製品に取り込まれました。作者がアプリの中で実際に操作してみたところ、

• ターミナルで Cmd+V のペーストが効くようになり、新規プロジェクトに追加した skill も表示された
• #27 ではついでに右クリックメニューと選択即コピー（iTerm2 に揃える）も補完された
• #28 の根本原因はキャッシュロジックに隠れていた——skills の読み込みは「直近12個のアクティブプロジェクト」しかスキャンせず、新規プロジェクトの skill は対象外のため読み込まれなかった。強制リフレッシュのインターフェースを追加してキャッシュを回避したとのこと。この種の罠を自力で掘り当てられるのは確かに容易ではありません

よくある質問

• 設定後 /status に表示されるのが Doubao モデルではない：3つの環境変数がすべて正しく注入されているか確認してください。特に ANTHROPIC_BASE_URL の末尾に余分な / を付けないよう注意。
• 「接続タイムアウト」や「認証失敗」のエラーが出る：ARK API Key が doubao-seed-2-1-pro-preview モデルの権限を有効化していること、アカウントに残高があることを確認してください。
• Turbo 版でコストを抑えたい：ANTHROPIC_MODEL を doubao-seed-2-1-turbo-preview に変えるだけです。価格は半減し、単純なタスクに向いています。
• 元のモデルと併存できるか：できます。エイリアスで隔離すればよく、doubao は Doubao、claude は元のモデルで走り、互いに影響しません。