---
title: "opencode でカスタムの OpenAI 互換プロバイダーを設定する | BroadRouter"
description: "opencode.jsonc で BroadNet Inference を opencode のカスタム OpenAI 互換プロバイダーとして追加し、モデルのエイリアス、機能、上限を設定する方法です。"
url: https://broadrouter.com/ja/guides/opencode-custom-provider/
lang: ja
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

このページは英語の原文を AI の支援を受けて翻訳したものです。 [英語の原文を読む](https://broadrouter.com/guides/opencode-custom-provider/) (2026-11-16 更新).

# opencode に BroadNet Inference をカスタムプロバイダーとして追加する

更新日 2026-11-16

opencode.jsonc の providers の下に broadnet のエントリーを追加し、package を @opencode/ai/providers/openai-compatible、settings.baseURL を https://inference.broadnet.ai/v1、env を BROADNET\_API\_KEY にします。短いモデルキーを modelID で broadnet/glm-5.3 などの BroadNet の ID に対応づけ、/models でモデルを選びます。npm @ai-sdk/openai-compatible と options.baseURL を使う古い V1 の設定もそのまま動きます。

opencode は、ターミナルで動くオープンソースのコーディングエージェントです。組み込みのカタログにないプロバイダーは、`opencode.jsonc` で**カスタムプロバイダー**として追加します。BroadNet Inference は OpenAI のチャット補完形式で通信するので、opencode の OpenAI 互換ランタイムパッケージを使います。このガイドは opencode の現行（V2）のドキュメントに従っています。

## セットアップ

1.  opencode を起動するシェルで**キーを export します**。

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **設定ファイルを作成します。** プロジェクト内に `opencode.jsonc` として置くか、どこでも使えるように `~/.config/opencode/opencode.jsonc` に置きます。

```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 }
        }
      }
    }
  }
}
```

3.  **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 の形式も読めるので、次のような既存のブロックはそのまま動きます。

```json
{
  "$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 移行ガイド](https://opencode.ai/docs/migrate-v1/)にあります。

## どのモデルを選ぶか

| タスク | モデル | 備考 |
| --- | --- | --- |
| ツールを使うエージェント型コーディング | [GLM 5.3](https://broadrouter.com/ja/models/glm-5.3/) | ツールと構造化出力の記載あり。100 万トークンのコンテキスト |
| スクリーンショット、アラビア語 | [Qwen3.8 27B](https://broadrouter.com/ja/models/qwen3.8-27b/) | ツールと画像。262K コンテキスト |
| 一日中のセッション、定額 | [DeepSeek V4.1 Flash](https://broadrouter.com/ja/models/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` を上げてください。[回答が空になる理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。
-   **429。** 従量課金のキーは毎分 30 リクエスト、同時 4 リクエストまでです。リトライもカウントされます。[エラーとリトライ](https://broadrouter.com/ja/guides/errors-and-retries/)を参照してください。
-   **プランでサブエージェントを使う場合。** [プランのセッション](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)は 1 つにつき一度に 1 リクエストしか処理しないので、並列のサブエージェントは、それぞれに専用のセッションがない限り順番待ちになります。

## このガイドの用語

[AI エージェント（AI agent）](https://broadrouter.com/ja/glossary/agent/)

AI エージェントとは、言語モデルが目標に向けて自分で手順を決めるシステムです。どのツールを呼ぶかを決め、結果を読み、最終回答を出すか上限に達するまで繰り返します。決まった箇所でモデルを呼ぶ固定のスクリプトは、ふつうワークフローと呼ばれます。

[トークン（token）](https://broadrouter.com/ja/glossary/token/)

トークンとは、言語モデルが読み書きするテキストの単位です。モデルのトークナイザーが作る単語、単語の一部、句読点、バイト列のいずれかにあたります。LLM API は利用量をトークンで数え、上限を設け、通常はトークン単位で課金します。

[AI コーディングエージェント（AI coding agent）](https://broadrouter.com/ja/glossary/coding-agent/)

AI コーディングエージェントとは、言語モデルがループの中でコードベースに取り組むソフトウェアツールです。ファイルを読み、編集し、テストなどのコマンドを実行し、出力を読んで次の手順を決めることを、タスクが終わるか上限に達するまで繰り返します。

[従量課金（pay-as-you-go）](https://broadrouter.com/ja/glossary/pay-as-you-go/)

従量課金とは、使った分だけを支払う料金体系です。トークン、リクエスト、音声の分数などの単位で計測され、サブスクリプションや最低利用額はありません。多くの LLM API はこの方式で、前払いの残高か定期的な請求書から支払います。

[OpenAI 互換 API（OpenAI-compatible API）](https://broadrouter.com/ja/glossary/openai-compatible-api/)

OpenAI 互換 API とは、POST /v1/chat/completions など OpenAI API と同じリクエスト形式とレスポンス形式を受け付ける HTTP API です。OpenAI の SDK やツールは、ベース URL、API キー、モデル名を変えるだけで利用できます。

[プリペイドクレジット（prepaid credit）](https://broadrouter.com/ja/glossary/prepaid-credit/)

プリペイドクレジットとは、使用前に API アカウントに入金しておくお金です。リクエストごとに費用が残高から差し引かれ、残高がなくなると、チャージするまで従量課金のリクエストは止まります。支出は支払った額までに抑えられます。

[モデルフォールバック（model fallback）](https://broadrouter.com/ja/glossary/model-fallback/)

モデルフォールバックとは、失敗した LLM リクエストを順序付きリストの別のモデルやプロバイダーで再試行する手法です。きっかけはエラー、レート制限、コンテキスト長エラー、ポリシーによる拒否などで、クライアントか前段のゲートウェイで実行します。

[レート制限（rate limit）](https://broadrouter.com/ja/glossary/rate-limit/)

レート制限とは、1 分あたりのリクエスト数やトークン数など、一定時間内にクライアントが API を使える量に API 側が設ける上限です。上限を超えたリクエストは、使用量が下回るまで通常 HTTP 429 Too Many Requests で拒否されます。

## よくある質問

### opencode で BroadNet のモデルが見つからないのはなぜですか？

opencode はモデルの参照を「プロバイダー/マップのキー」として解決し、ID は大文字と小文字を区別します。下の設定なら broadnet/glm-5.3 を選びます。このうち glm-5.3 がマップのキーです。modelID の値は BroadNet に送られる内容にすぎません。

### 設定で provider と npm（@ai-sdk/openai-compatible）を使っていますが、間違いですか？

いいえ。それは V1 の形式で、opencode の移行ガイドによれば引き続きサポートされています。ネイティブの V2 形式では、provider が providers に、npm が package（aisdk:@ai-sdk/openai-compatible）に、options.baseURL が settings.baseURL に変わります。

### opencode の返答が空になるのはなぜですか？

モデルが出力の上限を推論（reasoning）に使い切っています。そのモデルの limit.output を上げてください。BroadNet では推論は max\_tokens に含まれます。

## 関連ガイド

-   [Cline で BroadNet Inference を使う（OpenAI Compatible プロバイダー）](https://broadrouter.com/ja/guides/cline-openai-compatible/)
-   [エージェント向け無制限 LLM API プランのしくみ](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)
-   [推論モデルが空の回答を返す理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)
-   [Vercel AI SDK で BroadNet Inference を使う](https://broadrouter.com/ja/guides/vercel-ai-sdk-openai-compatible/)
-   [BroadNet Inference で使えるすべてのツール （英語）](https://broadrouter.com/integrations/)：SDK、コーディングエージェント、チャット UI、自動化ツールと、それぞれの正確な設定

実際のワークロードで試してください。 新規アカウントには US$5 の初回クレジットがあり、Gemma、文字起こし に使えます。DeepSeek、GLM、Qwen3.8 はチャージが必要です。

[始める](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-opencode-custom-provider&utm_content=page-cta) ·

**出典**

-   [opencode ドキュメント、Providers（カスタムプロバイダー）（2026-11-14 確認）](https://opencode.ai/docs/providers/)
-   [opencode ドキュメント、Models（エイリアス、機能、上限）（2026-11-14 確認）](https://opencode.ai/docs/models/)
-   [opencode ドキュメント、設定ファイルの場所（2026-11-14 確認）](https://opencode.ai/docs/config/)
-   [opencode ドキュメント、V1 からの移行（2026-11-14 確認）](https://opencode.ai/docs/migrate-v1/)
-   [BroadNet Inference API リファレンス （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-opencode-custom-provider&utm_content=sources)
