モデルの役割
1つのクライアントに3つのモデルを設定し、メインループ、サブエージェント、バックグラウンド呼び出しでプロバイダーを自由に組み合わせられます。
コーディングエージェントが行う呼び出しは1種類ではありません。3種類あり、 続く各ページでは、クライアントごとの設定場所を示します。
| 役割 | そこで実行されるもの | 重要な理由 |
|---|---|---|
| メインループ | あなたが対話するモデル | 品質の大部分を左右する |
| サブエージェント | タスクから並列に展開されるワーカー | トークンの大部分を消費する |
| バックグラウンド | タイトル、要約、ファイルの説明 | 小規模だが常時発生し、余分な料金を払いやすい |
バックグラウンド呼び出しはほぼすべての操作で発生しますが、表には見えません。 その枠に最先端モデルを設定したままにすることは、エージェント型コーディングで最も費用のかかるデフォルト設定です。
3つを一度に設定する
npx @webway/connect --key $WEBWAY_API_KEY
このコマンドは利用可能なモデルのカタログを読み込み、インストール済みのクライアントを検出して、
それぞれに必要な設定を表示します。--write を追加するまで何も書き込みません。
npx @webway/connect --main <expensive> --sub <mid> --fast <cheap> --write
npx @webway/connect --models # what your key can reach
既存の設定ファイルは置き換えずにマージされます。
各クライアントでの設定場所
すべてのクライアントが3つの役割を分けているわけではありません。分けていないクライアントでは、 メインループのモデルがすべてを実行します。
| クライアント | メインループ | サブエージェント | バックグラウンド |
|---|---|---|---|
| Claude Code | ANTHROPIC_DEFAULT_OPUS_MODEL |
ANTHROPIC_DEFAULT_SONNET_MODEL、またはエージェントのフロントマター内の model: |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
| Codex CLI | model |
[profiles.*] ブロックを --profile で選択 |
同じ |
| OpenClaw | agents.defaults.model.primary |
agents 配下のエージェントごとのエントリ |
agents 配下のエージェントごとのエントリ |
| Hermes | hermes model |
— | — |
| TRAE SOLO | 選択したカスタムモデル | — | — |
| OpenAI SDK と Anthropic SDK | model 引数 |
— | — |
Claude Code が最も分かりやすい例です。3つの ANTHROPIC_DEFAULT_* 変数が
この3つの役割に正確に対応し、バックグラウンド処理には Haiku の枠が使われます。
プロバイダーを組み合わせる
3つのモデルが同じプロバイダーのものである必要はありません。すべてのモデルは どのエンドポイントからでも利用できるため、1つのプロトコルしか扱えないクライアントでも、 あるベンダーのモデルをメインループに、別のベンダーのモデルをサブエージェントに使えます。
npx @webway/connect claude-code \
--main anthropic/claude-opus-5 \
--sub openai/gpt-5.6-terra \
--fast deepseek/deepseek-v4-flash --write
Claude Code は一貫して Anthropic Messages を使用します。Anthropic に送られない2つの リクエストは Webway が変換します。そのコストについては プロトコル変換を参照してください。