> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Harness とモデル：モデルピッカーの完全ガイド

> Composer で Harness、モデル、推論レベルを選ぶ方法を説明します。セッション開始後は Harness が固定されモデルは引き続き変更できること、Ultra レベルと Ultracode トグルについても説明します。

**Harness** はエージェントを実行するフレームワークで、Claude Code や Codex CLI などがあります。**モデル**は Harness が呼び出す大規模言語モデルです。セッションを作成するたびに、Composer の右下にあるモデルボタンで Harness とモデルを選び、必要に応じて推論レベルを調整します。モデルの提供元と使用量の計上先については、[モデルソース](https://docs.aihubmix.com/jp/cloud/models/model-sources.md)を参照してください。

## 対応状況

| プラットフォーム | 対応 | 備考 |
| - | - | - |
| デスクトップアプリ | 対応 | このページはデスクトップアプリについて説明します。 |
| Web アプリ | 対応 | デスクトップアプリと同じです。Windows の Web アプリには **Open effort menu** のショートカットはありません。 |
| モバイル Web | 対応 | 同じポップオーバーが画面に合わせて狭く表示されます。 |

## 入口

* **モデルボタン**（Composer の右下）：Harness、モデルベンダーのアイコン、モデル名が表示されます。モデル名の後の小さな文字はソースを示します。自分のサブスクリプションの場合は **Subscription**、追加した API キーの場合は **BYOK** と表示され、Plus に含まれるモデルの場合は何も表示されません。
* **Effort ボタン**（モデルボタンの隣）：現在のレベルが表示されます。たとえば **Medium** や **High · Ultracode** です。モデルが推論レベルの調整に対応していない場合は非表示になります。
* **コンテキスト使用量リング**（セッション内、モデルボタンの左側）。[コンテキスト使用量リング](#context-usage)を参照してください。
* ショートカットについては、[キーボードショートカット](#keyboard)を参照してください。
* プランの利用上限に到達したときやアカウントが切断されたときは、ダイアログの **Use another model** からもモデルピッカーが開きます。[プランの利用上限に到達した場合](https://docs.aihubmix.com/jp/cloud/models/model-sources.md#subscription-limit-reached)を参照してください。

## モデルピッカー

モデルピッカーの上部は **Harness** の一覧（選択中のものにチェックマークが付きます）、下部は **Model** で、**Subscriptions** と **BYOK** の 2 つのタブがあります。Plus に含まれるモデルと自分の API キーは、どちらも BYOK タブにあります。

| 状況 | 表示内容 / 操作 |
| - | - |
| ピッカーを開く | 現在のモデルのタブで開きます。タブを切り替えても一覧が変わるだけで、変更はモデルをクリックしたときにのみ反映されます。 |
| 一覧の先頭の **Default model** | このタブのデフォルトモデル（通常は推奨モデル）が選択されます。 |
| Subscriptions タブ | サブスクリプションアカウントごとに 1 つのグループです。グループタイトルはアカウント名で、右側に小さな文字でプランが表示されます。 |
| BYOK タブ | 最初のグループは Plus モデル（AIHubMix のアイコン付き）です。[Plus モデル](https://docs.aihubmix.com/jp/cloud/models/model-sources.md#plus-models)を参照してください。それ以外はプロバイダーごとにグループ化され、1 つのプロバイダーに複数のキーがある場合はキー名ごとに分かれます。グループタイトルにカーソルを合わせて鉛筆アイコンをクリックすると、そのグループを編集できます。 |
| ソースにまだ内容がない | 一覧領域には **Connect subscription** または **Add API key** のボタンのみが表示されます。クリックするとその場で追加でき、完了後はここに戻ります。 |
| サブスクリプションは接続済みだが、利用できるモデルがない | 上部に **Subscription connected, but no models are available right now** と表示され、各アカウントのグループの下に理由（たとえば、現在の Harness がそのサブスクリプションに対応していないなど）が表示されます。 |
| グループが現在の Harness と互換性がない | グループが理由（たとえば **Claude Code only** や **API format not compatible with Claude Code**）とともに末尾に移動し、モデルはグレーアウトします。新しいセッションでは、クリックすると互換性のある Harness に切り替わってそのモデルが選択されます。セッション内ではクリックできません。 |
| Plus プランがない | Plus モデルのグループがグレーアウトし、**Get Plus** ボタンが表示されます。[Plus がない場合](#without-plus)を参照してください。 |
| モデルを使用できない | モデルはグレーアウトし、行末に短い理由（たとえば **No Responses API**）が表示されます。カーソルを合わせると詳しい説明が表示されます。 |
| モデルをクリックする | ポップオーバーが閉じ、モデルボタンが更新されます。推論レベルの変化については、[モデル切り替え後の推論レベルの変化](#effort-after-switch)を参照してください。 |

## 対応 Harness

Harness の一覧は製品の表示に従います。現在は Claude Code（新しいセッションのデフォルトの Harness で、Ultracode に対応する唯一の Harness）、Codex CLI（一部のモデルに Ultra レベルがあります）、OpenCode、Hermes Agent、DeepSeek、Pi があります。

実行中にメッセージを追加できるか、送信済みのメッセージを編集できるかは、Harness によって決まります。[Composer](https://docs.aihubmix.com/jp/cloud/sessions/composer.md) を参照してください。

## Harness とモデルソースの組み合わせ

モデルピッカーでは、現在の Harness で使用できるモデルのみを選択できます。その他のグループはグレーアウトして理由が表示されます。

* **Plus モデル**：利用可能なモデルは Harness によって異なります。
* **自分のサブスクリプション**：サブスクリプションごとに特定のエージェントに対応します。たとえば Claude のサブスクリプションは Claude Code 専用、ChatGPT のサブスクリプションは Codex CLI 用です。[対応しているサブスクリプション](https://docs.aihubmix.com/jp/cloud/models/model-sources.md#supported-subscriptions)を参照してください。
* **自分のキー**：Claude Code には **Anthropic compatible** の API が、Codex CLI には **OpenAI compatible** の API が必要です。[API 形式と Harness](https://docs.aihubmix.com/jp/cloud/models/model-sources.md#api-format-harness)を参照してください。

## Harness とモデルを選ぶ

1. 新しいセッションのページで、Composer の右下にあるモデルボタンをクリックします。
2. Harness をクリックします。Harness を変更すると、モデルは **Default model** に戻ります。
3. **Subscriptions** タブまたは **BYOK** タブに切り替えて、モデルをクリックします。
4. 必要に応じて、Effort ボタンをクリックして推論レベルを調整します。
5. メッセージを入力して送信します。この組み合わせでセッションが開始します。

## デフォルトの選択

* 新しいセッションでは、最後に作成したセッションでの選択（Harness、モデル、ソース、自分で選択した推論レベル）が引き継がれます。初回は Claude Code + **Default model** です。
* 推論レベルを一度も自分で選択していない場合、Effort ボタンにはモデルの推奨レベルが表示されます。
* 記憶されたモデルまたはソースが利用できなくなった場合は、**Default model** に戻ります。
* 新しいセッションでは、Ultracode はデフォルトでオフです。
* セッション内でモデルを切り替えても、そのセッションにのみ影響し、新しいセッションのデフォルトは変わりません。
* 同じプロバイダーのサブスクリプションアカウントが複数ある場合は、**Default** が付いたアカウントが使用されます。[デフォルトアカウント](https://docs.aihubmix.com/jp/cloud/models/model-sources.md#default-account)を参照してください。

## セッション開始後は Harness が固定されます

セッションで最初のメッセージを送信すると、Harness は変更できなくなります。モデル、ソース、推論レベルは引き続き変更でき、変更は次のターンから反映されます。

* モデルピッカーの Harness 領域には、現在の Harness と鍵アイコンのみが表示されます。カーソルを合わせると **This task’s harness is fixed. Start a new task to use another** と表示されます。
* セッションがプロジェクトに属している場合は、**New task with another harness ›** をクリックすると、そのプロジェクトに別の Harness で新しいセッションを作成できます。

### セッション内でモデルを切り替える

1. セッション内でモデルボタンをクリックし、別のモデルをクリックします（ソースをまたいで切り替えることもできます）。
2. 現在のコンテキストが新しいモデルに収まる場合はそのまま切り替わり、セッションに **Switched to model name** の行が残ります。収まらない場合は、先に圧縮の確認が表示されます。[圧縮して切り替える](#compact-and-switch)を参照してください。
3. それまでのセッション履歴はすべて保持され、新しいモデルがその続きから作業します。

* ターンの実行中は切り替えられません。**The task is running. Switch models after this turn ends** と表示されます。
* 切り替えに失敗した場合は理由が表示されます。別のソースやモデルを試すか、再試行できます。
* プランの利用上限への到達やアカウントの切断によりセッションが一時停止している場合、モデルまたはアカウントを切り替えると自動的に再開します。

### 圧縮して切り替える

現在のコンテキストが切り替え先のモデルに収まらない場合、ポップオーバーに **Switch to model name?** の確認が表示されます。チャットはまず要約に圧縮され、その後新しいモデルが引き継ぎます。それまでの詳細が失われる場合があります。推論レベルが変わる場合は、**Effort after switching: X** も表示されます。

* **Cancel**：モデル一覧に戻り、現在のモデルが維持されます。
* **Compact and switch**：圧縮して新しいモデルに切り替わり、セッションに **Compacted the chat and switched to model name** の行が残ります。
* セッションが長すぎて圧縮できない場合は、**This chat is too long to compact. Try starting a new session** と表示されます。

### コンテキスト使用量リング

セッション内では、モデルボタンの左側にある小さなリングに現在のコンテキスト使用量が表示されます。カーソルを合わせると、使用率とトークン数が表示されます。上限に近づくとリングの色が変わり、セッションは自動的に圧縮されます。

## 推論レベル

推論レベルは、モデルが回答する前にどれだけ考えるかを決めます。レベルが高いほど回答は綿密になりますが、時間がかかり、使用量も多くなります。各モデルにどのレベルがあり、どれが推奨されるかは「モデル + ソース + Harness」の組み合わせによって決まり、製品に表示されます。セッション内でも変更でき、変更は次のターンから反映されます。

### 2 つのスタイル

| 現在のモデル | スタイル | 入口の名前 |
| - | - | - |
| Claude モデル、またはその他のモデル + Claude Code | レベル一覧 | Effort |
| GPT モデル、またはその他のモデル + その他の Harness | スライダー | Effort |

### レベルの名前

| レベル一覧 | スライダー | 用途 |
| - | - | - |
| None | Minimal | 小さな編集、最速の応答 |
| Low | Low（GPT モデルでは **Light**） | シンプルで直接的な変更 |
| Medium | Medium | ほとんどのタスク |
| High | High | 複雑な変更 |
| Extra | Extra high | ファイルをまたぐリファクタリングや厄介なバグ |
| Max | なし | 最も難しいタスク。大量のトークンを使用し応答が遅くなる場合があるため、控えめに使用してください |
| なし | Ultra（Codex CLI のみ） | サブエージェントの並列実行。利用上限の消費が速くなります |

* **Effort のレベル一覧**：現在のモデルが対応しているレベルのみが一覧表示されます。推奨レベルには **Recommended** が付きます。レベルをクリックすると適用されます。一覧の下に [Ultracode トグル](#ultracode)があります。
* **Effort スライダー**：ドラッグまたはクリックでレベルを選びます。下の 1 行に、現在のレベルの用途が表示されます。**Reset to default** で推奨レベルにリセットされます。

### Ultra レベル

一部のモデルでは、Codex CLI で Ultra レベルがスライダーの右端に表示されます。選ぶと **Turn on Ultra reasoning?** の確認が開き、使用量が **Extra high** の約 2〜3 倍になり、タスクごとの時間が長くなることが示されます。

* **Turn on Ultra** をクリックすると適用されます。**Cancel** をクリックすると、元のレベルが維持されます。
* セッション内では **Don’t ask again this session** にチェックを入れることができます。

### Ultracode トグル

Ultracode は Claude Code のマルチエージェント並列機能で、タスクを複数のサブタスクに分割して並行して完了させます。使用量は大きく増えます。Effort のレベル一覧の下にある独立したトグルで、Effort のレベルは変わりません。オンの場合、Effort ボタンには **High · Ultracode** のように表示されます。セッション内では、次のターンから反映されます。

* オンにできるかどうかは Harness、クラウドサーバー、モデル、ソースによって決まります。Claude Code、準備ができたクラウドサーバー、**Extra high** に対応した選択済みのモデルが必要です。
* 条件を満たさない場合、トグルはグレーアウトし、理由が表示されます。新しいセッションで、モデルやソースを変更したことで条件を満たさなくなった場合、トグルは自動的にオフになります。

### モデル切り替え後の推論レベルの変化

| 状況 | 結果 |
| - | - |
| 選択したレベルが新しいモデルにもある | そのまま維持されます。 |
| 新しいモデルにこのレベルがない | 新しいモデルの推奨レベルに戻ります。 |
| 新しいモデルが推論レベルの調整に対応していない | Effort ボタンは非表示になります。 |
| セッション内でモデルを切り替える | 確認に **Effort after switching: X** が表示されます。 |

## キーボードショートカット

| 操作 | macOS | Windows |
| - | - | - |
| モデルピッカーを開く / 閉じる | `⌃⇧M` | `Ctrl+Shift+M` |
| Effort メニューを開く / 閉じる | `⌃⇧I` | `Ctrl+Shift+I`（Web アプリでは使用できません。ブラウザが使用しています） |
| **Subscriptions** タブと **BYOK** タブを切り替える | `Tab` | `Tab` |
| メニューで項目 1〜9 を選択する | `1`–`9` | `1`–`9` |
| Effort の一覧で移動する | `↑` `↓` | `↑` `↓` |
| Effort スライダーを調整する | `←` `→` `↑` `↓` `Home` `End` | 同じ |
| メニューを閉じる | `Esc` | `Esc` |

## Plus がない場合

* モデルピッカーは通常どおり開きます。BYOK タブでは、Plus モデルのグループがグレーアウトし、**Subscribe to Plus to use these models** と表示されます。**Get Plus** をクリックすると、Plus のサブスクリプションダイアログが開きます。
* 新しいセッションのページでは、送信したメッセージが保持され、アップグレードカードが表示されます。契約すると、自動的に送信されます。[Plus がない場合](https://docs.aihubmix.com/jp/cloud/plus/without-plus.md)を参照してください。

## 注意事項と制限

* Harness を変更するには、新しいセッションを作成してください。
* 圧縮すると、それまでの詳細が失われます。圧縮したくない場合は、**Cancel** をクリックするか、コンテキスト上限の大きいモデルを選んでください。
* 新しいセッションで互換性のないグループのモデルをクリックすると、Harness が自動的に切り替わります。表示される通知を確認してください。
* モデル一覧、レベル、推奨レベルは変更される場合があります。製品の表示に従ってください。

## 関連ページ

* [モデルソース：Plus モデル、自分のサブスクリプション、BYOK](https://docs.aihubmix.com/jp/cloud/models/model-sources.md)
* [モデルに関するよくある質問](https://docs.aihubmix.com/jp/cloud/models/model-faq.md)
* [Composer](https://docs.aihubmix.com/jp/cloud/sessions/composer.md)
* [Plus がない場合](https://docs.aihubmix.com/jp/cloud/plus/without-plus.md)
* [用語集](https://docs.aihubmix.com/jp/cloud/concepts/glossary.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.