---
title: ランタイムの設定 – Agent Teams ドキュメント
description: Claude Code、Codex、または OpenCode ランタイムを設定します。認証、プロバイダーアクセス、マルチモデルモード、起動前チェックについて解説します。
lang: ja-JP
---

# ランタイムの設定

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

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

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

## 前提条件

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

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

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

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

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

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

```bash
claude login
```

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

```bash
claude --version
```

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

### Codex

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

```bash
codex login
```

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

```bash
codex --version
```

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

### OpenCode

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

```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 は起動するのにチームメイトが配信可能にならない場合は、モデルがプロンプトを無視したと判断する前にレーンの証跡を調べてください。[トラブルシューティング](/ja/guide/troubleshooting#opencode-registered-but-bootstrap-unconfirmed) を参照してください。

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

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

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

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

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

## 起動前チェックリスト

チームを起動する前に:

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

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

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

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

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

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