ランタイムの設定

Agent Teams は調整レイヤーです。実際のモデル処理は、サポートされているローカルランタイムとプロバイダーを通じて実行されます。

クイックスタート - 最初のランタイムを選ぶ

次のような場合	最初に使うもの
すでに Claude Code を使っている、または Anthropic のアクセスがある	Claude - 慣れた認証で、最小限のセットアップ
Codex または OpenAI ベースのワークフローを使っている	Codex - ネイティブ連携
サインアップや API キーなしで Agent Teams を試したい	OpenCode - 認証不要で同梱の無料モデルを使う
マルチモデルのルーティングや幅広いプロバイダー対応が欲しい	OpenCode - 最も柔軟で、1 つの設定で多くのバックエンドに対応
どのランタイムが合うか分からない	OpenCode - 最も多くのプロバイダーの選択肢をカバーし、後から切り替えられる

1 つのランタイムと 1 人のチームメイトから始めましょう。マルチモデルに拡張する前に、まずは 1 回の起動が動作することを確認してください。

前提条件

チームを起動する前に、次の点を確認してください。

• ランタイムバイナリがインストールされ、PATH に含まれていること。
• 認証不要で同梱の無料 OpenCode モデルから始める場合を除き、プロバイダーアカウントが使用予定のモデルへの有効なアクセス権を持っていること。
• プロジェクトのパスが存在し、読み取り可能であること。
• 認証を手動でテストする際に、アプリとターミナルが同じホーム/設定環境を使用していること。

TIP

1 人のチームメイトと 1 つのプロバイダーから始めましょう。マルチモデルレーンを追加する前に、まずは 1 回の起動が動作することを確認してください。

ターミナルでの簡単なチェック:

command -v claude
command -v codex
command -v opencode

使用予定のランタイムに対応するコマンドを実行してください。何も出力されない場合は、チームを起動する前にランタイムをインストールするか PATH を修正してください。

サポートされている経路

経路	デフォルト CLI	代表的なプロバイダー	使用する場面
Claude	claude	Anthropic	すでに Claude Code または Anthropic ベースのワークフローを使っている
Codex	codex	OpenAI	Codex ネイティブのランタイム連携が欲しい
OpenCode	opencode	OpenRouter および多数のバックエンド	マルチモデルのルーティングと幅広いプロバイダー対応が欲しい

アプリはサポートされているランタイムを検出し、可能な場合は UI からセットアップをガイドします。

Gemini は、Google ADC（gcloud auth）、Gemini CLI の OAuth、API キー認証に対応した、サポート対象のプロバイダー経路として利用できます。Gemini バックエンドが検出されたら、ランタイム設定の UI から構成してください。

プロバイダーアクセス

Agent Teams には独自の有料プランはありません。認証不要で同梱の無料 OpenCode モデルから始められます - 登録、API キー、クレジットカードは不要です。追加のモデルについては、すでにお持ちのプロバイダーアクセスを利用してください。選択する経路に応じて、サブスクリプション、ローカルランタイムの認証、または API キーを使います。

• Claude および Codex の経路は、それぞれの CLI 認証ツールに依存します。
• OpenCode は、まず認証不要で同梱の無料モデルを実行できます。その他の OpenCode モデルでは、設定ファイルにプロバイダー固有の API キーが必要になる場合があります（例: openrouter、openai、anthropic）。

認証の設定

Claude Code

ターミナルで標準の認証フローを実行します。

claude login

次に、CLI に到達できることを確認します。

claude --version

ターミナルでは動作するのにパッケージ版アプリが「ログインしていません」と報告する場合は、アプリが認識している $HOME と PATH を、ログインに使用したターミナルのものと比較してください。トラブルシューティング で説明している認証診断ログが、最良の出発点です。

Codex

OpenAI の CLI フローでインストールと認証を行います。

codex login

次に、ランタイムに到達できることを確認します。

codex --version

Codex ネイティブの起動では、利用可能な場合に Codex アカウントの状態とモデルカタログのデータを使用します。UI にモデルが表示されない場合は、チームプロンプトを編集する前にプロバイダーのステータスを更新してください。

OpenCode

認証不要で同梱の無料モデルを使うには、アプリ内で選択し、プロバイダーへのサインアップなしで起動します。その他の OpenCode バックエンドを使うには、~/.opencode/config.json（またはお使いのプラットフォームでの相当パス）を作成または編集し、使用したいプロバイダーキーを記述します。

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-..."
    }
  }
}

OpenCode が想定する正確なプロバイダー名を使用してください。カスタムのプロバイダー名を設定した場合は、モデル文字列で使用するプロバイダー ID と照らし合わせて再確認してください（例えば openrouter/moonshotai/kimi-k2.6 は openrouter ブロックを使用します）。

モデル文字列の例:

モデル文字列	存在している必要があるプロバイダーブロック
openrouter/moonshotai/kimi-k2.6	openrouter
openai/gpt-5.4	openai
anthropic/claude-sonnet-4-6	anthropic

OpenCode は起動するのにチームメイトが配信可能にならない場合は、モデルがプロンプトを無視したと判断する前にレーンの証跡を調べてください。トラブルシューティング を参照してください。

Gemini

Gemini は 3 つの認証方法をサポートしています。

• Google ADC — gcloud auth application-default login を実行して、Google Application Default Credentials 経由で認証します。
• Gemini CLI — Gemini CLI がインストールされている場合は gemini login を実行します。
• API キー — 環境に GEMINI_API_KEY を設定するか、アプリの Manage Providers UI から構成します。

アプリは利用可能な認証方法を自動検出し、バックエンドに到達できる場合はランタイム設定とチーム作成の UI に Gemini プロバイダーを表示します。

マルチモデルモード

マルチモデルモードでは、OpenCode 互換の設定を通じて、多数のプロバイダーバックエンドに処理をルーティングできます。プロバイダーの柔軟性が必要な場合や、チームメイトごとに異なるモデルレーンを使わせたい場合に利用します。

モデルレーン

各チームメイトは、それぞれ異なる providerId + model の組み合わせを使用できます。チーム編集 UI でメンバーのオプションを展開すると、グローバルなデフォルト設定を上書きできます。

控えめなマルチモデル構成:

ロール	プロバイダー	理由
Lead	Claude または Codex	最も信頼しているプロバイダーで調整を維持する
Builder	OpenCode	実装作業に幅広いモデルルーティングを使う
Reviewer	Claude、Codex、または 2 つ目の OpenCode モデル	レビューの判断を Builder のレーンから分離する

最初の起動で、慣れていない多数のプロバイダーを混在させるのは避けましょう。幅広い作業を割り当てる前に、各レーンで 1 つの小さなタスクを確認してください。

起動前チェックリスト

チームを起動する前に:

1. 選択したランタイムがインストールされている
2. ランタイムバイナリが環境の PATH に含まれている
3. 選択したバックエンドのプロバイダー認証が設定されている
4. プロバイダーが、指定する正確なモデル文字列へのアクセス権を持っている
5. プロジェクトのパスが存在し、読み取り可能である

ランタイム経路を切り替えるタイミング

現在の経路が、モデルの可用性、レート制限、プロバイダーの機能、またはチームのロールの必要性によって妨げられている場合は切り替えてください。同じプロジェクトとチームのワークフローは維持しつつ、切り替え後に 1 つの小さなタスクを検証してください。

セットアップのエラーはセットアップの問題として扱う

認証に失敗する、モデル名が拒否される、またはランタイムバイナリが見つからない場合は、まずセットアップを修正してください。ランタイム構成の問題を回避するために、チームプロンプトやプロジェクトコードを変更しないでください。

次の判断テーブルを使用してください。

症状	より適切な最初の対応
バイナリが見つからない	インストールまたは PATH を修正する
ターミナルではログインできるがアプリではできない	Electron の認証診断ログと環境を確認する
モデルが拒否される	プロバイダーランタイムで正確なモデル ID を確認する
429 が繰り返される	並列度を下げるか、モデル/プロバイダーを切り替える
OpenCode レーンが停滞する	レーンのマニフェストと opencode-sessions.json を調べる