メインコンテンツまでスキップ

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

評価スイート を参照してください。