メインコンテンツへスキップ

​
混合モデルとは？

混合モデルを使用すると、通常のコーディングセッション用のデフォルトモデルとは別に、Specification Mode専用の異なるAIモデルを使用できます。これにより、プランニング段階と実装段階を独立して最適化する柔軟性が得られます。 例えば、包括的な仕様プランニングにはより強力なモデルを使用し、日常的な実装作業にはより高速なモデルを使用することができます。

​
なぜ混合モデルを使用するのか？

異なるモデルは異なるタスクで優れた性能を発揮します。spec modeモデルをデフォルトモデルから分離することで、以下が可能になります：

Optimize for Planning

Use a more thorough, analytical model for specification planning that considers edge cases and architectural decisions.

Balance Speed & Cost

Keep a faster, more economical model for regular coding while reserving powerful models for critical planning phases.

Match Task Complexity

Complex features benefit from advanced reasoning during planning, while simpler tasks can use standard models.

Flexible Workflows

Switch between different model combinations to find what works best for your specific use cases.

​
混合モデルの設定方法

​
設定へのアクセス

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

​
設定オプション

設定ツールを開くと、3つのオプションが表示されます：
  • Yes, configure spec mode model - Specification Mode用に異なるモデルを選択
  • No, keep using [current configuration/main model] - 変更せずに終了
  • Clear spec mode model (use main model) - spec modeモデルを削除してデフォルトモデルをすべてに使用 （spec modeモデルが既に設定されている場合のみ表示）

​
モデルの選択

  1. **「Yes, configure spec mode model」**を選択します
  2. 利用可能なモデルのリストを参照します
  3. Specification Mode用の希望するモデルを選択します
  4. モデルが推論をサポートしている場合は、推論努力レベルを選択します
  5. 設定は自動的に保存されます
Only compatible models will be available in the selector based on your current default model. See Model Compatibility below.

​
モデルの互換性

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

​
互換性ルール

OpenAI models can only pair with other OpenAI models
  • Main model: GPT-5 → Spec model: GPT-5-Codex ✅
  • Main model: GPT-5 → Spec model: Sonnet 4.5 ❌
OpenAI’s internal reasoning format is encrypted and is incompatible with other model providers.
Anthropic models with reasoning enabled can only pair with other Anthropic models
  • Main model: Sonnet 4.5 (reasoning on) → Spec model: Sonnet 4.5 ✅
  • Main model: Sonnet 4.5 (reasoning on) → Spec model: GPT-5 ❌
When extended thinking is active, reasoning traces must stay within the same provider.
Anthropic models with reasoning off can pair with non-OpenAI models
  • Main model: Sonnet 4.5 (reasoning off) → Spec model: Any non-OpenAI model ✅
  • Main model: Sonnet 4.5 (reasoning off) → Spec model: DeepSeek ✅
Without reasoning enabled, cross-provider compatibility is possible.
Why these restrictions? Model providers encrypt their reasoning traces differently. When reasoning is active, the spec model must be able to read and continue the reasoning chain from the main model, which requires matching providers.

​
推論努力の設定

推論をサポートするAnthropic モデル（Sonnet 4.5など）を選択した場合、推論努力レベルを選択するよう求められます：
  • Off - 拡張思考なし、より高速な応答
  • Low - 簡潔な考慮、スピードと深度のバランス
  • Medium - 複雑な決定のための適度な思考時間
  • High - 重要なアーキテクチャ選択のための深い分析
spec modeモデルの推論努力は、デフォルトモデルの推論設定とは独立しており、各段階を完全に制御できます。
For specification planning, Medium or High reasoning effort often produces better results since thorough analysis during planning prevents issues during implementation.

​
一般的な設定

さまざまなシナリオに対する効果的なモデルの組み合わせを以下に示します：

​
Anthrop モデル

最適な用途： ほとんどの開発ワークフロー、柔軟な推論制御
  • デフォルトモデル： Haiku 4.5またはSonnet 4.5（サポートされている場合は任意の推論を選択）
  • Spec modeモデル： Opus 4.6（推論：高）またはSonnet 4.5（推論：高）
  • 利点： 深いプランニング分析による高速実装。Opus 4.6は最も徹底的なプランニングのためにMax推論を提供

​
OpenAI モデル

最適な用途： OpenAIモデルのみを使用するチーム、コストを重視するプロジェクト
  • デフォルトモデル： GPT-5-Codex
  • Spec modeモデル： GPT-5（高推論）
  • 利点： 一貫した推論形式、仕様用の専用コーディングモデル

​
動作原理

設定が完了すると、Droid はSpecification Modeに入るたびに自動的にspec modeモデルを使用します：
  1. Shift+TabでSpecification Modeを有効化
  2. 機能の説明を提供
  3. Droidがspec modeモデルを使用して分析、プランニング、仕様生成を実行
  4. 生成された仕様を確認・承認
  5. 実装ではデフォルトモデルを使用して実際のコードを記述
Your default model is always used for regular coding sessions and implementation work. The spec mode model is only active during the planning phase of Specification Mode.

​
設定の確認

現在使用中のモデルを確認するには：
  1. CLI で /model を入力
  2. 現在のデフォルトモデルがハイライト表示されます
  3. spec modeモデルが設定されている場合、セレクターの上部に表示されます

​
混合モデル設定のクリア

すべてに単一のモデルを使用する設定に戻したい場合：
  1. CLI で /model を入力
  2. **「Configure Spec Mode Model」**に移動
  3. Enterキーを押す
  4. **「Clear spec mode model (use main model)」**を選択
  5. Enterキーを押して確認
デフォルトモデルが通常のコーディングとSpecification Modeの両方で使用されるようになります。

​
ベストプラクティス

If you’re new to Specification Mode, start by using your default model for both modes. Once you’re comfortable, experiment with different spec mode models to see if it improves your planning quality.
Simple projects may not need separate models. For complex systems with intricate dependencies, using a more powerful spec mode model can prevent costly mistakes during implementation.
Use higher reasoning effort for architectural decisions and lower effort for routine feature additions. Adjust both your default and spec mode reasoning independently.
Don’t try to force incompatible model combinations. The restrictions exist for good technical reasons and violations will be prevented by the CLI.
More powerful models and higher reasoning efforts increase cost. Balance quality needs with budget constraints by using premium configurations selectively.

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

Cause: The model is incompatible with your current default model.Solution: Check the Model Compatibility rules above. You may need to change your default model first, or adjust reasoning settings to enable compatibility.
Cause: You changed your default model to one that’s incompatible with your configured spec mode model.Solution: This is expected behavior. Configure a new spec mode model that’s compatible with your new default model, or continue using the default model for both modes.
Cause: The selected model doesn’t support reasoning, or you’re using a non-Anthropic model combination.Solution: This is normal. Not all models support reasoning configuration. The model will use its default behavior.

​
関連リソース

Specification Mode

Learn how to use Specification Mode for planning and implementing features.

Settings

Configure other aspects of how Droid behaves and integrates with your workflow.

Choosing Your Model

Understand the differences between available models and how to choose the right one.

BYOK

Bring your own API keys to use custom models with Factory.