OpenCode 連携
このページは、OpenCode(エージェント向けコーディングツール)が Yabanin の ゲートウェイ とどう連携するかを説明します。つまりゲートウェイ側の契約です。OpenCode がどのモデルへ経路付けされるか、サブスクリプションのエグゼキュータをどう委譲するか、OpenCode 駆動のセッションをどう統制するか(予算、タスクのタグ付け、ガードフック)です。
ローカル開発、立ち上げ、資格情報の扱いは、開発ガイド で扱います。このページはそのセットアップを繰り返しません。連携面そのものを文書化します。
yabanin エージェントのモデル経路
yabanin の OpenCode エージェントは、ゲートウェイの OpenAI 互換エンドポイント(POST /v1/chat/completions)と通信します。ゲートウェイはタスクの形状ごとにリクエストを経路付けするため、エージェントの「思考モデル」と「高速コーダー」は、1 つのキーの下で異なるプロバイダになり得ます。経路の決定は X-Yabanin-Decision レスポンスヘッダーに出ます(エージェント統制 — Decision ヘッダー を参照)。セッションは、あるレスポンスが なぜ そのモデルを使ったかを記録できます。
エージェント配線(make opencode-remote-wire、公開スタンド https://yabanin.ai/gw)は、OpenCode エージェントを Yabanin ゲートウェイのモデル経由で経路付けし、タスクの形状で振り分けます。
| 経路 | モデル | 用途 |
|---|---|---|
プライマリアジェント yabanin | 設定された計画モデル | セッションの主導、計画、複雑な推論。 |
サブエージェント reason | 設定された分析モデル | 深い分析、アーキテクチャ、トレードオフ、調査の統合。 |
サブエージェント code | 設定されたローカルコーダー | 明確で仕様のしっかりしたコード編集 — テンプレート、テスト、ドキュメント、指示に沿ったリファクタ。 |
サブエージェント complex-code | 設定された flash モデル(フォールバック付き) | 重いアルゴリズムのコード生成。 |
具体的なモデル名は導入設定(レジストリ/組織の経路設定)であり、ゲートウェイ契約の一部ではありません。契約が保証するのは次のとおりです。リクエストはクラスによって決定的に経路付けされ、決定は記録され、キャッシュ/コスト/ティアの会計は、どの API キークライアントともまったく同じように適用されます。
サブスクリプション委譲(tr_delegate)
難しいコーディングタスクでは、OpenCode はローカル MCP ツール tr_delegate を通じて、Codex または Cursor のサブスクリプションエグゼキュータへ委譲できます。
tr_delegate { mode: "analyze" | "implement", task: "…", provider?: "auto" | "codex" | "cursor" }analyzeは読み取り専用のレビューです。implementはワークスペースへ書き込みます。provider: autoは利用可能なエグゼキュータを選びます。codex/cursorは一方を強制します。tr_delegation_statusは、各エグゼキュータが設定済みかを報 告します(資格情報は返しません)。
委譲は デフォルトでオフ であり、YABANIN_DELEGATION_ENABLED=true で有効になります。資格情報はマシン上に留まります(Codex は ~/.codex/auth.json、Cursor は公式の agent login)。ゲートウェイはそれらを見ません。委譲はサイドカーの関心事です(services/subscription-bridge/)。ゲートウェイが扱うのは、OpenAI 互換のチャット/ツールトラフィックだけです。
上記のエージェント内経路では足りないときだけ委譲してください — 主導モデルは、通常の作業にネイティブツールを使うべきです。
OpenCode セッションの統制
OpenCode 駆動のセッションは単なるゲートウェイクライアントなので、エージェント統制の面がすべて適用されます。実務上の推奨は次のとおりです。
- 作業の論理単位ごとにタスクタグを付けます。 タスクごとに
X-Yabanin-Taskを送ります(例:stand-opencode/feature-42)。これにより、セッションの支出を CTOR / タスク利用分析 で帰属でき、YABANIN_TASK_TOKEN_BUDGETで上限を付けられます。 - 暴走セッションに上限を付けます。
YABANIN_TASK_TOKEN_BUDGET(推奨 500000)および/またはYABANIN_SESSION_TOKEN_BUDGET(推奨 200000)を設定します。80% 以 上でゲートウェイはX-Yabanin-Budget-Warningを設定します。100% では、クライアントがバックオフできる 429 を返します。 - 安い作業を安い時間帯へ経路付けします。
YABANIN_TIME_ROUTINGをYABANIN_TIME_CHEAP_WINDOW(デフォルト22:00-07:00)とともに有効にします。バッチ作業(X-Yabanin-Batch: true)は常に格下げされ、対話作業はX-Yabanin-Priority: highで対象外にできます。 - 外向きを検査します。 機微なデータを出し得るセッションでは、
YABANIN_GUARD_MODE=log(観察)で実行し、偽陽性の傾向が分かってからredact/denyへ締めます。ガードフックの偽陽性に関する注意 を参照してください。 - 系譜を検証します。 実行後、
yb lineage verify --org <org>は、リクエストごとのアテステーションチェーンが無傷であることを確認します。yb lineage export … --s3 … --lock-complianceは、WORM の証拠コピーを作ります。系譜 — ハッシュチェーン + エクスポート を参照してください。
経路変更を出荷する前の評価
OpenCode トラフィックはルーター上の実負荷なので、スタンドへ届く前に、オフラインスイートで経路とガードの変更を回帰テストしてください。
make evaluate-routing
make evaluate-guards
評価スイート を参照してください。