> ## 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 與模型：模型選擇器完整說明

> 在輸入框裡選擇 Harness、模型和推理強度；會話開始後 Harness 固定、可以換模型，以及 Ultra 檔與 Ultracode 開關。

**Harness** 是執行 Agent 的框架，例如 Claude Code、Codex CLI；**模型**是 Harness 呼叫的大模型。每次新建會話，你在輸入框右下角的模型按鈕裡選一個 Harness 和一個模型，並按需調整推理強度。模型從哪裡來、用量記在哪裡，見 [模型來源](https://docs.aihubmix.com/zh-Hant/cloud/models/model-sources.md)。

## 適用範圍

| 形態 | 支援情況 | 說明 |
| - | - | - |
| 桌面客戶端 | 支援 | 本頁按桌面客戶端描述。 |
| 網頁版 | 支援 | 與桌面客戶端一致；Windows 上的網頁版沒有「选择智力」快捷鍵。 |
| 手機網頁 | 支援 | 同一個浮層，寬度隨螢幕收窄。 |

## 入口

* **模型按鈕**（輸入框右下角）：顯示 Harness、模型廠商圖示和模型名。模型名後的小字表示來源：自帶訂閱寫「订阅」，自己新增的 API Key 寫「BYOK」，Plus 包含的模型不寫。
* **強度按鈕**（模型按鈕旁）：顯示當前檔位，例如「中」「高 · Ultracode」。模型不支援調節強度時不顯示。
* **上下文用量圈**（會話中，模型按鈕左側），見 [上下文用量圈](#context-usage)。
* 快捷鍵見 [鍵盤操作](#keyboard)。
* 訂閱額度用完或帳號斷開時，彈窗裡的「换模型继续」也會開啟模型選擇器，見 [訂閱額度用完](https://docs.aihubmix.com/zh-Hant/cloud/models/model-sources.md#subscription-limit-reached)。

## 模型選擇器

模型選擇器上半部分是 **Harness** 列表（當前選中的帶對勾），下半部分是 **模型**，分「订阅」「BYOK」兩個頁籤。Plus 包含的模型和你自己的 API Key 都在 BYOK 頁籤。

| 情況 | 你會看到 / 怎麼做 |
| - | - |
| 開啟選擇器 | 停在當前模型所在的頁籤；切換頁籤只換列表，點了模型才生效。 |
| 列表頂部「默认模型」 | 選中這個頁籤的預設模型（通常是推薦模型）。 |
| 訂閱頁籤 | 每個訂閱帳號一組，組標題是帳號名稱，右側小字是套餐。 |
| BYOK 頁籤 | 第一組是 Plus 模型（帶 AIHubMix 圖示），見 [Plus 模型](https://docs.aihubmix.com/zh-Hant/cloud/models/model-sources.md#plus-models)；其餘按服務商歸組，同一服務商有多把 Key 時按 Key 名稱分開。懸停組標題點鉛筆圖示可編輯這組。 |
| 某個來源還沒有內容 | 列表區只有「连接订阅」或「添加 API Key」按鈕，點選就地新增，完成後回到這裡。 |
| 已連線訂閱但沒有可用模型 | 頂部寫「已连接订阅，但当前没有可用模型」，各帳號組下寫原因（例如當前 Harness 不支援該訂閱）。 |
| 某組與當前 Harness 不相容 | 該組排到最後，寫明原因（例如「仅限 Claude Code」「接口格式不兼容，Claude Code 不能用」），模型置灰。新會話裡點它會自動換成能用的 Harness 並選中該模型；會話中不能點。 |
| 沒有開通 Plus | Plus 模型組置灰，帶「开通 Plus」按鈕，見 [沒有 Plus 時](#without-plus)。 |
| 某個模型不能用 | 模型置灰，行尾寫短原因（例如「不支持 Responses」），懸停看完整說明。 |
| 點選一個模型 | 浮層關閉，模型按鈕更新；強度怎麼變見 [換模型後強度怎麼變](#effort-after-switch)。 |

## 支援的 Harness

Harness 列表以產品內顯示為準，目前有 Claude Code（新會話的預設 Harness，唯一支援 Ultracode）、Codex CLI（部分模型有 Ultra 檔）、OpenCode、Hermes Agent、DeepSeek、Pi。

執行中能否插話、能否修改已傳送的訊息因 Harness 而異，見 [輸入框](https://docs.aihubmix.com/zh-Hant/cloud/sessions/composer.md)。

## Harness 與模型來源的搭配

模型選擇器只讓你選當前 Harness 能用的模型，其他組置灰並寫原因。

* **Plus 模型**：可用模型因 Harness 而異。
* **自帶訂閱**：每種訂閱對應特定 Agent，例如 Claude 訂閱僅限 Claude Code，ChatGPT 訂閱用於 Codex CLI，見 [支援的訂閱](https://docs.aihubmix.com/zh-Hant/cloud/models/model-sources.md#supported-subscriptions)。
* **自帶 Key**：Claude Code 需要「Anthropic 兼容」介面，Codex CLI 需要「OpenAI 兼容」介面，見 [介面格式與 Harness](https://docs.aihubmix.com/zh-Hant/cloud/models/model-sources.md#api-format-harness)。

## 選擇 Harness 和模型

1. 在新會話頁點輸入框右下角的模型按鈕。
2. 點選 Harness。換 Harness 後模型回到「默认模型」。
3. 切換到「订阅」或「BYOK」頁籤，點選一個模型。
4. 需要時點強度按鈕調整推理強度。
5. 輸入內容併傳送，會話就以這個組合開始。

## 預設選擇

* 新會話預設沿用你上一次新建會話時的選擇（Harness、模型、來源和你主動選過的推理強度）；第一次使用時為 Claude Code +「默认模型」。
* 沒有主動選過強度時，強度按鈕顯示該模型的推薦檔。
* 記住的模型或來源已經不可用時，回到「默认模型」。
* Ultracode 在新會話裡預設關閉。
* 會話中換模型隻影響這個會話，不改變新會話的預設值。
* 同一家有多個訂閱帳號時，預設用標了「默认」的帳號，見 [預設帳號](https://docs.aihubmix.com/zh-Hant/cloud/models/model-sources.md#default-account)。

## 會話開始後 Harness 固定

會話發出第一條訊息後，Harness 不能更換；模型、來源和推理強度仍然可以換，從下一輪起生效。

* 模型選擇器的 Harness 區只顯示當前 Harness 和一把鎖，懸停提示「本任务的 Harness 已固定，换用请新建任务」。
* 會話屬於某個專案時，可以點「用其他 Harness 新建任务 ›」，在該專案裡用另一個 Harness 新建會話。

### 在會話中換模型

1. 在會話裡點模型按鈕，點選另一個模型（可以跨來源）。
2. 當前上下文放得下新模型時直接切換，會話裡留下一行「已切换到 模型名」；放不下時先請你確認壓縮，見 [壓縮並切換](#compact-and-switch)。
3. 之前的會話記錄全部保留，由新模型接著處理。

* 本輪還在執行時不能切換，提示「当前任务正在进行，等这一轮结束后再切换模型」。
* 切換失敗時會提示原因，可以換一個來源或模型，或重試。
* 會話因訂閱額度用完或帳號斷開而暫停時，換好模型或帳號後會自動接著執行。

### 壓縮並切換

當前上下文放不下目標模型時，浮層裡會出現「切换到 模型名？」確認：當前對話會先壓縮成摘要，再由新模型接著做，較早的細節可能不再保留；強度會變時也會寫明「切换后强度：X」。

* 「取消」：回到模型列表，當前模型不變。
* 「压缩并切换」：壓縮後換成新模型，會話裡留下一行「已压缩对话，切换到 模型名」。
* 會話太長壓縮不了時會提示「对话太长，未能压缩，建议新开会话」。

### 上下文用量圈

會話裡模型按鈕左側的小圓環表示當前上下文用量。懸停可看到已用比例和 tokens 數；接近上限時圓環變色，並會自動壓縮。

## 推理強度

推理強度決定模型回答前思考多久：檔位越高，回答越周全，但更慢、用量更大。每個模型有哪些檔位、推薦檔是哪一檔，取決於「模型 + 来源 + Harness」的組合，以產品內顯示為準。會話中也可以調整，從下一輪起生效。

### 兩種樣式

| 當前模型 | 樣式 | 入口名稱 |
| - | - | - |
| Claude 系列模型；或其他模型 + Claude Code | 檔位列表 | Effort |
| GPT 系列模型；或其他模型 + 其他 Harness | 滑塊 | 智力 |

### 檔位名稱

| 檔位列表 | 滑塊 | 適合 |
| - | - | - |
| 無 | 極低 | 小改動，響應最快 |
| 低 | 低（GPT 模型為「轻量」） | 簡單直接的修改 |
| 中 | 中 | 大多數任務 |
| 高 | 高 | 複雜的修改 |
| 超高 | 超高 | 跨檔案重構和疑難問題 |
| 極限 | 不提供 | 最難的任務；可能消耗大量 token、響應很慢，謹慎使用 |
| 不提供 | Ultra（僅 Codex CLI） | 子智慧體並行協作，用量消耗更快 |

* **Effort 檔位列表**：只列出當前模型支援的檔位，推薦檔標「推荐」，點選即生效。列表下方是 [Ultracode 開關](#ultracode)。
* **智力滑塊**：拖動或點選選擇檔位，下方說明當前檔位的用途；「恢复默认」恢復為推薦檔。

### Ultra 檔

部分模型在 Codex CLI 裡提供 Ultra 檔，位於滑塊最右側。選它時會彈出「开启 Ultra 思考？」確認，說明用量約為「超高」的 2–3 倍、單個任務耗時更長。

* 點「开启 Ultra」生效；點「取消」保持原檔位。
* 會話中可以勾選「本任务内不再提醒」。

### Ultracode 開關

Ultracode 是 Claude Code 的多代理並行功能，把任務拆成多個子任務並行完成，用量會明顯增加。它是 Effort 檔位列表下方的獨立開關，不改變 Effort 檔位；開啟後強度按鈕顯示為「高 · Ultracode」這樣的形式，會話中從下一輪起生效。

* 能否開啟取決於 Harness、雲主機、模型和來源：需要 Claude Code、雲主機已就緒、選定了支援「超高」的模型。
* 條件不滿足時開關置灰，並寫明原因；新會話裡換了模型或來源導致條件不再滿足時，開關自動關閉。

### 換模型後強度怎麼變

| 情況 | 結果 |
| - | - |
| 你選過的檔位新模型也有 | 保持不變。 |
| 新模型沒有這個檔位 | 回到新模型的推薦檔。 |
| 新模型不支援調節強度 | 強度按鈕隱藏。 |
| 會話中換模型 | 確認框裡會寫「切换后强度：X」。 |

## 鍵盤操作

| 操作 | macOS | Windows |
| - | - | - |
| 開啟或關閉模型選擇器 | `⌃⇧M` | `Ctrl+Shift+M` |
| 開啟或關閉推理強度選單 | `⌃⇧I` | `Ctrl+Shift+I`（網頁版不可用，被瀏覽器佔用） |
| 在「订阅」「BYOK」頁籤間切換 | `Tab` | `Tab` |
| 選擇選單裡的第 1–9 項 | `1`–`9` | `1`–`9` |
| 在 Effort 列表裡移動 | `↑` `↓` | `↑` `↓` |
| 調整智力滑塊 | `←` `→` `↑` `↓` `Home` `End` | 同左 |
| 關閉選單 | `Esc` | `Esc` |

## 沒有 Plus 時

* 模型選擇器照常開啟。BYOK 頁籤裡的 Plus 模型組置灰，寫「需要开通 Plus 才能使用这组模型」，點「开通 Plus」開啟 Plus 訂閱彈窗。
* 新會話頁傳送的訊息會先留著並顯示升級卡，開通後自動補發。詳見 [未開通 Plus 時](https://docs.aihubmix.com/zh-Hant/cloud/plus/without-plus.md)。

## 注意與限制

* 要換 Harness 只能新建會話。
* 壓縮會丟失較早的細節；不想壓縮時點「取消」，或選上下文上限更大的模型。
* 新會話裡點不相容組的模型會自動換 Harness，請留意提示。
* 模型清單、檔位和推薦檔可能調整，以產品內顯示為準。

## 相關

* [模型來源：Plus 模型、自帶訂閱與 BYOK](https://docs.aihubmix.com/zh-Hant/cloud/models/model-sources.md)
* [模型常見問題](https://docs.aihubmix.com/zh-Hant/cloud/models/model-faq.md)
* [輸入框](https://docs.aihubmix.com/zh-Hant/cloud/sessions/composer.md)
* [未開通 Plus 時](https://docs.aihubmix.com/zh-Hant/cloud/plus/without-plus.md)
* [術語表](https://docs.aihubmix.com/zh-Hant/cloud/concepts/glossary.md)


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