Skip to main content
OpenCode はカスタムモデルプロバイダをサポートするターミナルベースのコーディングエージェントです。設定ファイル opencode.json に @ai-sdk/openai-compatible パッケージを使用して Tokios をプロバイダとして追加し、options.baseURL を https://api.tokios.com/v1 に設定し、models に Tokios のデプロイメント名をリストします。これにより、OpenCode はすべてのエージェントリクエストをプライベートなコネクタトンネル経由でローカルモデルにルーティングします。

​
前提条件

​
OpenCode の設定

設定ファイル opencode.json に Tokios プロバイダブロックを追加します。正確な設定ファイルの場所（プロジェクトローカルの opencode.json またはグローバル設定パス）や正確なキー名（options、npm、models）は OpenCode のリリースによって異なる可能性があるため、インストールされているバージョンのプロバイダスキーマで確認してください。
opencode.json
設定内の gemma-tunnel を 公開デプロイメント名 に置き換えてください。Models タブで登録した名前を使用します。バックエンド（Ollama、llama.cpp、vLLM、LM Studio）が使用するローカルモデル ID ではありません。自分のキーに sk-tok-YOUR_KEY を置き換え、共有またはバージョン管理された設定ファイルにコミットしないようにしてください。
options.baseURL には /v1 を含める必要があります。OpenCode の OpenAI 互換プロバイダはこの URL に対して相対的にリクエストを送信するため、/v1 が含まれていないベース URL では Tokios API サーフェスに到達できません。

​
ツール対応モデルの選択

OpenCode のエージェントは、ファイルの読み取り、コマンドの実行、コードの編集を行うためにツール呼び出しに依存しています。すべてのローカルモデルがツール呼び出しを確実に処理できるわけではありません。OpenCode のエージェントを実際の編集に依存する前に、強力なツール呼び出しサポートを持つモデルをバックエンドとするデプロイメントを選択してください。候補の比較方法については ローカルモデルの選択 を参照してください。

​
トラブルシューティング

OpenCode が送信した API キーが欠落している、形式が正しくない、または取り消されています。options.apiKey に余分な空白なしで完全な sk-tok-… キーが含まれていることを確認し、Keys タブでそのステータスを確認してください。
設定の models 下のモデルキーが登録済みのデプロイメントと一致しません。Models タブ上の公開名と完全に一致することを確認してください。Ollama、llama.cpp、vLLM、LM Studio のローカルモデル ID ではありません。
そのデプロイメントのコネクタがオフラインであるか、並列処理の上限に達しています。Connectors タブを確認してください — コネクタは Online と表示されている必要があり、実行中のマシンは起動しており到達可能である必要があります。

​
次のステップ

互換性のあるクライアント

他の OpenAI および Anthropic 互換クライアントのベース URL とキーの設定を確認します。

ローカルモデルの選択

エージェントワークフローにデプロイメントをコミットする前に、バックエンドとモデルを比較します。