opencode は、ターミナルで動くオープンソースのコーディングエージェントです。組み込みのカタログにないプロバイダーは、opencode.jsonc でカスタムプロバイダーとして追加します。BroadNet Inference は OpenAI のチャット補完形式で通信するので、opencode の OpenAI 互換ランタイムパッケージを使います。このガイドは opencode の現行(V2)のドキュメントに従っています。
セットアップ
- opencode を起動するシェルでキーを export します。
export BROADNET_API_KEY='your-broadnet-key'
- 設定ファイルを作成します。 プロジェクト内に
opencode.jsoncとして置くか、どこでも使えるように~/.config/opencode/opencode.jsoncに置きます。
{
"$schema": "https://opencode.ai/config.json",
"model": "broadnet/glm-5.3",
"providers": {
"broadnet": {
"name": "BroadNet Inference",
"env": ["BROADNET_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": {
"baseURL": "https://inference.broadnet.ai/v1"
},
"models": {
"glm-5.3": {
"modelID": "broadnet/glm-5.3",
"name": "GLM 5.3",
"capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"deepseek-v4.1-flash": {
"modelID": "broadnet/deepseek-v4.1-flash",
"name": "DeepSeek V4.1 Flash",
// BroadNet's docs don't list tool calling for this model: test it first
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"qwen3.8-27b": {
"modelID": "broadnet/qwen3.8-27b",
"name": "Qwen3.8 27B",
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 262144, "output": 16000 }
}
}
}
}
}
- opencode を起動し、
/modelsでモデルを選びます。 参照の形式はbroadnet/<マップのキー>で、たとえばbroadnet/glm-5.3です。opencode はmodelIDの値を BroadNet に送ります。
設定ファイルはマージされます。opencode はまずグローバルのファイルを適用し、次にカレントディレクトリから上にたどって見つかったプロジェクトのファイルを(遠いものから順に)適用し、最後に .opencode/ の設定を適用します。そのため、プロジェクトのファイルでグローバルのプロバイダー設定を上書きできます。会社で管理されたシステム設定を使っている場合は、それが両方より優先されます。キーはファイルではなく環境変数に置けば、設定ファイルをバージョン管理に入れられます。
エイリアスを使う理由
BroadNet の ID にはもともとスラッシュが含まれています(broadnet/glm-5.3)。models のマップのキーは opencode が表示・選択に使う名前で、modelID は実際に送る値です。短いキーにしておくと参照が読みやすくなります。
capabilities と limit は自分で設定してください。カタログにないモデルについて、opencode は JSON のツール対応、テキストと画像の入力、200,000 トークンのコンテキスト、32,000 の出力トークンを仮定します。ドキュメントではこれらを検出した値ではなく、フォールバックの仮定と説明しています。上の output の 16000 は BroadNet の上限ではなく私たちの提案で、推論の余地を残すための値です。
古い V1 の設定
opencode V2 は V1 の形式も読めるので、次のような既存のブロックはそのまま動きます。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"broadnet": {
"npm": "@ai-sdk/openai-compatible",
"name": "BroadNet Inference",
"options": {
"baseURL": "https://inference.broadnet.ai/v1",
"apiKey": "{env:BROADNET_API_KEY}"
},
"models": {
"broadnet/glm-5.3": { "name": "GLM 5.3" }
}
}
}
}
ネイティブの V2 形式では、provider が providers に、npm が package に変わり(AI SDK のパッケージを使い続けるなら aisdk:@ai-sdk/openai-compatible)、options.baseURL と options.apiKey は settings の下に移ります。各フィールドの対応は opencode の V1 移行ガイドにあります。
どのモデルを選ぶか
| タスク | モデル | 備考 |
|---|---|---|
| ツールを使うエージェント型コーディング | GLM 5.3 | ツールと構造化出力の記載あり。100 万トークンのコンテキスト |
| スクリーンショット、アラビア語 | Qwen3.8 27B | ツールと画像。262K コンテキスト |
| 一日中のセッション、定額 | DeepSeek V4.1 Flash | 無制限プラン。BroadNet はツールを記載していない |
opencode はツール呼び出しに頼っています。BroadNet のドキュメントには DeepSeek V4.1 Flash のツール呼び出しの記載がないため、設定ではテストが必要な仮定として扱っています。Full Moon の 1 か月($60)を買う前に、Meteor の 1 時間($1)で実際のタスクを試してください。
トラブルシューティング
- 401。
BROADNET_API_KEYのキーが間違っている、期限切れ、または従量課金の利用枠を使い切っています。opencode を動かすプロセスでこの変数が設定されているか確認してください。 - モデルが見つからない、または拒否される。 マップのキー(
broadnet/glm-5.3)を選び、modelIDが BroadNet の ID と完全に一致しているか確認してください。参照は大文字と小文字を区別します。有料モデルにはチャージが必要です。$5 のクレジットで使えるのはbroadnet/gemma-4-26b-a4bと 2 つの Transcribe モデルだけです。 - 回答が空。
limit.outputを上げてください。回答が空になる理由。 - 429。 従量課金のキーは毎分 30 リクエスト、同時 4 リクエストまでです。リトライもカウントされます。エラーとリトライを参照してください。
- プランでサブエージェントを使う場合。 プランのセッションは 1 つにつき一度に 1 リクエストしか処理しないので、並列のサブエージェントは、それぞれに専用のセッションがない限り順番待ちになります。
