モデル設定
概要
モデル設定ページは、LLM プロバイダーとモデルパラメーターを管理するために使用します。APP 側では複数のプロバイダーを同時に設定でき、システムは選択されたモデルに応じて API フォーマットと能力検出を自動的に切り替えます。
プロバイダーのサポート
| プロバイダー | API フォーマット | 説明 |
|---|---|---|
| Anthropic | anthropic | Claude シリーズモデル |
| OpenAI | openai | GPT / o シリーズモデル |
| DeepSeek | openai | DeepSeek-chat / reasoner |
| Qwen（通義千問） | openai | Qwen-plus / Qwen-max |
| Gemini | openai | Google Gemini シリーズ |
| カスタム | openai / anthropic | OpenAI または Anthropic フォーマットに対応したサードパーティサービス |
設定項目
| パラメーター | 説明 |
|---|---|
| プロバイダー選択 | ドロップダウンリストから LLM プロバイダーを選択 |
| API Key | プロバイダーの API キー（暗号化して保存） |
| Base URL | API エンドポイントアドレス（カスタムプロバイダーでは必須） |
| apiFormat | API プロトコルフォーマット：anthropic または openai |
| モデル選択 | プロバイダーの利用可能なモデルリストから選択 |
| tokensRespLimit | 1 ターンあたりの最大出力トークン数 |
モデル能力フラグ
システムは resolveCapabilities によってモデルの能力を自動検出し、マルチモーダル入力の処理に影響します：
| 能力 | 説明 | 影響 |
|---|---|---|
| vision | 画像理解 | 画像入力を受け付けるかどうか |
| document | ドキュメント理解 | PDF などのドキュメント入力を受け付けるかどうか |
| audio | 音声理解 | 音声入力を受け付けるかどうか |
| tool_use | ツール呼び出し | function calling をサポートするかどうか |
コンテキストウィンドウ
各モデルのデフォルトのコンテキストウィンドウサイズ：
| モデル | コンテキストウィンドウ |
|---|---|
| Claude Sonnet 4 / Opus 4 / Claude 4 | 200,000 tokens |
| GPT-4o / GPT-4o-mini / GPT-4-turbo | 128,000 tokens |
| GPT-4.1 | 1,000,000 tokens |
| o3 / o4-mini | 200,000 tokens |
| DeepSeek-chat / DeepSeek-reasoner | 64,000 tokens |
| Qwen-plus / Qwen-max | 128,000 tokens |
完全なモデルリストについては サポートされているモデル一覧 を参照してください。
操作ガイド
モデルの設定方法
- APP を開く → 左側の設定メニュー → モデル
- プロバイダーリストから使用したい LLM プロバイダー（例：Anthropic）を選択
- そのプロバイダーが提供する API Key を入力
- （オプション）サードパーティの互換サービスを使用する場合、Base URL をサービスプロバイダーが提供するエンドポイントアドレスに変更
- モデルのドロップダウンリストから具体的なモデル（例：Claude Sonnet 4）を選択
- 保存をクリック
注意：API Key は暗号化された形式でローカルに保存され、クラウドにアップロードされることはありません。API Key を他人に共有したり、コードリポジトリにコミットしたりしないでください。
モデルの切り替え方法
複数のプロバイダーを設定した後は、いつでも現在使用しているモデルを切り替えることができます。切り替え後、次回の対話から新しいモデルが使用されます。既存の対話の履歴には影響しません。
モデル選定の推奨
シーンによって適したモデルは異なります。以下は推奨の組み合わせです：
| 利用シーン | 推奨モデル | 理由 |
|---|---|---|
| 日常対話と軽量タスク | GPT-4o-mini / Qwen-plus | 応答が速く、コストが低い |
| 複雑な推論と長文ドキュメント分析 | Claude Opus 4 / Claude Sonnet 4 | 推論能力が高く、200K の長いコンテキスト、document 入力をサポート |
| コード開発とデバッグ | DeepSeek-chat / Claude Sonnet 4 | コード理解能力が優れている |
| 超長コンテキスト（コードベース全体） | GPT-4.1 | 1M token のコンテキストウィンドウ |
| 画像理解が必要 | Claude Sonnet 4 / GPT-4o | vision 能力をサポート |
| コスト重視 | Qwen-plus / DeepSeek-chat | 価格が最も低い |
| 深い推論が必要（数学 / 論理） | o3 / DeepSeek-reasoner | 推論チェーンモデル。ただし DeepSeek-reasoner はツール呼び出しをサポートしない |
ヒント：どれを選べばよいか分からない場合は、Claude Sonnet 4 から始めることをおすすめします —— 推論、コード、ツール呼び出し、マルチモーダルのいずれの面でもバランスの取れたパフォーマンスを発揮します。
コンテキストウィンドウがユーザーに与える実際の影響
コンテキストウィンドウは、Agent が 1 回の対話で「記憶」できる内容の量を決定します：
| ウィンドウサイズ | おおよその目安 | 適用シーン |
|---|---|---|
| 64K tokens | 純テキスト約 100 ページ または 中規模のコードファイル約 5 個 | 短い対話、単一ファイル操作 |
| 128K tokens | 純テキスト約 200 ページ または コードファイル約 10 個 | 中程度の複雑さのプロジェクト、複数ファイル操作 |
| 200K tokens | 純テキスト約 300 ページ または コードファイル約 15 個 | 複雑なプロジェクト、長い対話、PDF ドキュメント分析 |
| 1M tokens | 純テキスト約 1500 ページ または コードファイル約 70 個 | 超大規模コードベース分析、書籍レベルのドキュメント |
対話内容がウィンドウの上限に近づくと、システムは自動的にコンテキスト圧縮をトリガーし、最も重要な情報をインテリジェントに保持します。
tokensRespLimit の影響
tokensRespLimit は、Agent が各ターンで返信する最大トークン数を制御します：
| 設定値 | 影響 |
|---|---|
| 小さすぎる（例：500） | Agent の返信が途中で切れる可能性があり、複雑な分析や長いコード生成が不完全になる |
| 適度（例：4096、推奨デフォルト） | 返信の完全性と応答速度のバランスが取れる |
| 大きすぎる（例：32000） | Agent は非常に長い返信を返せるが、待ち時間と費用が増加する |
推奨：デフォルト値のままで問題ありません。返信が途中で切れる状況に頻繁に遭遇する場合は、適度に増やすことができます。
よくある質問
API Key が無効
- Key が正しくコピーされているか確認（前後のスペースに注意）
- Key に対応するプロバイダーが正しく選択されているか確認
- Key が期限切れまたは失効していないか確認
リクエストタイムアウト
- ネットワーク接続を確認
- カスタム Base URL を使用している場合、アドレスに到達可能か確認
- 一部のモデルは高負荷時に応答が遅くなることがあるため、しばらくしてから再試行
モデルの返信品質が良くない
- より強力なモデルへの切り替えを試す（例：GPT-4o-mini から Claude Sonnet 4 へ）
- tokensRespLimit の設定が小さすぎないか確認
- プロンプトを最適化し、より明確な指示を提供する
関連ドキュメント
- サポートされているモデル一覧 — 完全なモデル能力マトリクス
- コンテキスト 5 層圧縮 — コンテキストウィンドウ管理戦略