> ## Documentation Index
> Fetch the complete documentation index at: https://factory-docs-cli-sandbox-mcp-whole-process.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# モデルの使い分け

> 仕様モード計画には、最大限の柔軟性と最適化のために、デフォルトモデルとは異なるAIモデルを使用してください。

## モデルの使い分けとは？

モデルを使い分けると、仕様モードの計画では特定の AI モデルを使用し、通常のコーディングセッションでは別のデフォルトモデルを使用できます。これにより、計画フェーズと実装フェーズを個別に最適化する柔軟性が得られます。

例えば、包括的な仕様計画にはより強力なモデルを使用し、日常的な実装作業にはより高速なモデルを使用することができます。

***

## なぜモデルを使い分けるのか？

異なるモデルは異なるタスクに秀でています。仕様モードのモデルとデフォルトモデルを分離することで、以下が可能になります：

<CardGroup cols={2}>
  <Card title="計画の最適化" icon="brain">
    エッジケースやアーキテクチャの決定を考慮する、より徹底的で分析的なモデルを仕様計画に使用します。
  </Card>

  <Card title="速度とコストのバランス" icon="gauge">
    通常のコーディングにはより高速で経済的なモデルを使用し、重要な計画フェーズには強力なモデルを確保します。
  </Card>

  <Card title="タスクの複雑さとの適合" icon="layer-group">
    複雑な機能は計画段階で高度な推論の恩恵を受け、シンプルなタスクには標準モデルが使用できます。
  </Card>

  <Card title="柔軟なワークフロー" icon="shuffle">
    異なるモデルの組み合わせを切り替えて、特定のユースケースに最適なものを見つけます。
  </Card>
</CardGroup>

***

## モデルの使い分けを設定する方法

### 設定へのアクセス

1. `droid` を実行して CLI を起動
2. `/model` を入力してモデルセレクターを開く
3. **「Configure Spec Mode Model（仕様モードモデルを設定）」**（リストの最初のオプション）に移動
4. **Enter** を押して設定を開始

### 設定オプション

設定画面を開くと、3つのオプションが表示されます：

* **Yes, configure spec mode model（仕様モードモデルを設定）** - 仕様モード用に異なるモデルを選択
* **No, keep using \[current configuration/main model]（現在の設定/メインモデルを使い続ける）** - 変更せずに終了
* **Clear spec mode model (use main model)（仕様モードモデルをクリアし、メインモデルを使用）** - 仕様モードモデルを削除し、すべてにデフォルトモデルを使用 *（既に仕様モードモデルが設定されている場合のみ表示）*

### モデルの選択

1. \*\*「Yes, configure spec mode model（仕様モードモデルを設定）」\*\*を選択
2. 利用可能なモデルのリストを参照
3. 仕様モード用に好みのモデルを選択
4. モデルが推論をサポートしている場合、推論レベルを選択
5. 設定は自動的に保存されます

<Note>
  現在のデフォルトモデルに基づいて、互換性のあるモデルのみがセレクターで利用可能になります。以下の[モデル互換性](#model-compatibility)を参照してください。
</Note>

***

<a id="model-compatibility" />

## モデル互換性

異なる AI プロバイダーが推論トレースとコンテキストを処理する方法が異なるため、すべてのモデルの組み合わせが連携するわけではありません。以下が互換性のルールです：

### 互換性ルール

<AccordionGroup>
  <Accordion title="OpenAI モデル">
    **OpenAI モデルは他の OpenAI モデルとのみペアリング可能**

    * メインモデル: GPT-5 → 仕様モデル: GPT-5-Codex ✅
    * メインモデル: GPT-5 → 仕様モデル: Sonnet 4.5 ❌

    OpenAI の内部推論フォーマットは暗号化されており、他のモデルプロバイダーと互換性がありません。
  </Accordion>

  <Accordion title="推論有効な Anthropic モデル">
    **推論が有効な Anthropic モデルは他の Anthropic モデルとのみペアリング可能**

    * メインモデル: Sonnet 4.5（推論オン）→ 仕様モデル: Sonnet 4.5 ✅
    * メインモデル: Sonnet 4.5（推論オン）→ 仕様モデル: GPT-5 ❌

    拡張思考が有効な場合、推論トレースは同じプロバイダー内に留まる必要があります。
  </Accordion>

  <Accordion title="推論無効な Anthropic モデル">
    **推論がオフの Anthropic モデルは非 OpenAI モデルとペアリング可能**

    * メインモデル: Sonnet 4.5（推論オフ）→ 仕様モデル: 任意の非 OpenAI モデル ✅
    * メインモデル: Sonnet 4.5（推論オフ）→ 仕様モデル: DeepSeek ✅

    推論が無効な場合、プロバイダー間での互換性が可能です。
  </Accordion>
</AccordionGroup>

<Info>
  **なぜこれらの制限があるのか？** モデルプロバイダーは推論トレースを異なる方法で暗号化します。推論が有効な場合、仕様モデルはメインモデルからの推論チェーンを読み取り継続できる必要があり、これには一致するプロバイダーが必要です。
</Info>

***

## 推論レベル設定

推論をサポートする Anthropic モデル（Sonnet 4.5 など）を選択した場合、推論レベルを選択するよう求められます：

* **Off** - 拡張思考なし、より高速な応答
* **Low** - 簡潔な検討、速度と深度のバランス
* **Medium** - 複雑な決定に対する適度な思考時間
* **High** - 重要なアーキテクチャ選択に対する深い分析

仕様モードモデルの推論レベルはデフォルトモデルの推論設定とは独立しており、各フェーズを完全にコントロールできます。

<Tip>
  仕様計画では、**Medium** または **High** の推論レベルがより良い結果を生むことが多いです。計画段階での徹底的な分析が実装中の問題を防ぐためです。
</Tip>

***

## 一般的な設定

異なるシナリオに対する効果的なモデルの組み合わせをいくつか紹介します：

### Anthropic モデル

**最適用途：** ほとんどの開発ワークフロー、柔軟な推論制御

* **デフォルトモデル:** Haiku 4.5 または Sonnet 4.5（サポートされている場合は任意の推論を選択）
* **仕様モードモデル:** Opus 4.7（推論: high）または Sonnet 4.5（推論: high）
* **利点：** 深い計画分析による高速実装。Opus 4.7 は最も徹底的な計画のために **Max** 推論を提供します。

### OpenAI モデル

**最適用途：** OpenAI モデルを専用使用するチーム、コスト重視のプロジェクト

* **デフォルトモデル:** GPT-5-Codex
* **仕様モードモデル:** GPT-5（high 推論）
* **利点：** 一貫した推論フォーマット、仕様用の特化したコーディングモデル

***

## 動作原理

設定が完了すると、仕様モードに入るたびに Droid が自動的に仕様モードモデルを使用します：

1. **Shift+Tab** で **仕様モードを有効化**
2. **機能説明を提供**
3. **Droid が仕様モードモデルを使用**して分析、計画、仕様生成を実行
4. **生成された仕様をレビューして承認**
5. **実装ではデフォルトモデルを使用**して実際のコードを記述

<Note>
  デフォルトモデルは通常のコーディングセッションと実装作業に常に使用されます。仕様モードモデルは、仕様モードの計画フェーズでのみアクティブになります。
</Note>

***

## 設定の確認

現在使用しているモデルを確認するには：

1. CLIで`/model`を入力
2. 現在のデフォルトモデルがハイライト表示される
3. 仕様モードモデルが設定されている場合、セレクターの上部に表示される

***

## モデル使い分け設定のクリア

すべてに単一のモデルを使用する設定に戻したい場合：

1. CLIで`/model`を入力
2. \*\*「Configure Spec Mode Model（仕様モードモデルを設定）」\*\*に移動
3. **Enter**を押す
4. \*\*「Clear spec mode model (use main model)（仕様モードモデルをクリアし、メインモデルを使用）」\*\*を選択
5. **Enter**を押して確認

デフォルトモデルが通常のコーディングと仕様モードの両方で使用されるようになります。

***

## ベストプラクティス

<AccordionGroup>
  <Accordion title="同じモデルから開始">
    仕様モードを初めて使用する場合は、両方のモードでデフォルトモデルを使用することから始めてください。慣れてきたら、異なる仕様モードモデルを試して、計画品質が向上するかどうかを確認してください。
  </Accordion>

  <Accordion title="プロジェクトの複雑さを考慮">
    シンプルなプロジェクトでは個別のモデルは不要かもしれません。複雑な依存関係を持つ複雑なシステムでは、より強力な仕様モードモデルを使用することで、実装中の高コストなミスを防ぐことができます。
  </Accordion>

  <Accordion title="推論をタスクの重要度に合わせる">
    アーキテクチャの決定には高い推論努力を使用し、定型的な機能追加には低い努力を使用してください。デフォルトと仕様モードの推論を独立して調整してください。
  </Accordion>

  <Accordion title="互換性ルールを尊重">
    非互換なモデル組み合わせを強制しようとしないでください。制限は十分な技術的理由があって存在しており、違反はCLIによって防がれます。
  </Accordion>

  <Accordion title="使用量を監視">
    より強力なモデルと高い推論努力はコストを増加させます。プレミアム設定を選択的に使用することで、品質ニーズと予算制約のバランスを取ってください。
  </Accordion>
</AccordionGroup>

***

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

<AccordionGroup>
  <Accordion title="希望のモデルを選択できない">
    **原因:** そのモデルが現在のデフォルトモデルと互換性がありません。

    **解決策:** 上記の[モデル互換性](#model-compatibility)ルールを確認してください。最初にデフォルトモデルを変更するか、推論設定を調整して互換性を有効にする必要がある場合があります。
  </Accordion>

  <Accordion title="仕様モードモデルが自動的にクリアされた">
    **原因:** 設定されている仕様モードモデルと互換性のないモデルにデフォルトモデルを変更しました。

    **解決策:** これは期待される動作です。新しいデフォルトモデルと互換性のある新しい仕様モードモデルを設定するか、両方のモードでデフォルトモデルを使用し続けてください。
  </Accordion>

  <Accordion title="推論努力セレクターが表示されない">
    **原因:** 選択されたモデルが推論をサポートしていないか、Anthropic以外のモデル組み合わせを使用しています。

    **解決策:** これは正常です。すべてのモデルが推論設定をサポートしているわけではありません。モデルはデフォルトの動作を使用します。
  </Accordion>
</AccordionGroup>

***

## 関連リソース

<CardGroup cols={2}>
  <Card title="仕様モード" icon="file-contract" href="/jp/cli/user-guides/specification-mode">
    機能の計画と実装のための仕様モードの使用方法を学ぶ。
  </Card>

  <Card title="設定" icon="gear" href="/jp/cli/configuration/settings">
    Droidの動作とワークフローとの統合の他の側面を設定する。
  </Card>

  <Card title="モデルの選択" icon="brain" href="/jp/cli/user-guides/choosing-your-model">
    利用可能なモデルの違いと適切なモデルの選択方法を理解する。
  </Card>

  <Card title="BYOK" icon="key" href="/jp/cli/byok/overview">
    独自のAPIキーを持参してFactoryでカスタムモデルを使用する。
  </Card>
</CardGroup>

***