> ## 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/cn/cloud/models/model-sources.md)。

## 适用范围

| 形态 | 支持情况 | 说明 |
| - | - | - |
| 桌面客户端 | 支持 | 本页按桌面客户端描述。 |
| 网页版 | 支持 | 与桌面客户端一致；Windows 上的网页版没有「选择智力」快捷键。 |
| 手机网页 | 支持 | 同一个浮层，宽度随屏幕收窄。 |

## 入口

* **模型按钮**（输入框右下角）：显示 Harness、模型厂商图标和模型名。模型名后的小字表示来源：自带订阅写「订阅」，自己添加的 API Key 写「BYOK」，Plus 包含的模型不写。
* **强度按钮**（模型按钮旁）：显示当前档位，例如「中」「高 · Ultracode」。模型不支持调节强度时不显示。
* **上下文用量圈**（会话中，模型按钮左侧），见 [上下文用量圈](#context-usage)。
* 快捷键见 [键盘操作](#keyboard)。
* 订阅额度用完或账号断开时，弹窗里的「换模型继续」也会打开模型选择器，见 [订阅额度用完](https://docs.aihubmix.com/cn/cloud/models/model-sources.md#subscription-limit-reached)。

## 模型选择器

模型选择器上半部分是 **Harness** 列表（当前选中的带对勾），下半部分是 **模型**，分「订阅」「BYOK」两个页签。Plus 包含的模型和你自己的 API Key 都在 BYOK 页签。

| 情况 | 你会看到 / 怎么做 |
| - | - |
| 打开选择器 | 停在当前模型所在的页签；切换页签只换列表，点了模型才生效。 |
| 列表顶部「默认模型」 | 选中这个页签的默认模型（通常是推荐模型）。 |
| 订阅页签 | 每个订阅账号一组，组标题是账号名称，右侧小字是套餐。 |
| BYOK 页签 | 第一组是 Plus 模型（带 AIHubMix 图标），见 [Plus 模型](https://docs.aihubmix.com/cn/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/cn/cloud/sessions/composer.md)。

## Harness 与模型来源的搭配

模型选择器只让你选当前 Harness 能用的模型，其他组置灰并写原因。

* **Plus 模型**：可用模型因 Harness 而异。
* **自带订阅**：每种订阅对应特定 Agent，例如 Claude 订阅仅限 Claude Code，ChatGPT 订阅用于 Codex CLI，见 [支持的订阅](https://docs.aihubmix.com/cn/cloud/models/model-sources.md#supported-subscriptions)。
* **自带 Key**：Claude Code 需要「Anthropic 兼容」接口，Codex CLI 需要「OpenAI 兼容」接口，见 [接口格式与 Harness](https://docs.aihubmix.com/cn/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/cn/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/cn/cloud/plus/without-plus.md)。

## 注意与限制

* 要换 Harness 只能新建会话。
* 压缩会丢失较早的细节；不想压缩时点「取消」，或选上下文上限更大的模型。
* 新会话里点不兼容组的模型会自动换 Harness，请留意提示。
* 模型清单、档位和推荐档可能调整，以产品内显示为准。

## 相关

* [模型来源：Plus 模型、自带订阅与 BYOK](https://docs.aihubmix.com/cn/cloud/models/model-sources.md)
* [模型常见问题](https://docs.aihubmix.com/cn/cloud/models/model-faq.md)
* [输入框](https://docs.aihubmix.com/cn/cloud/sessions/composer.md)
* [未开通 Plus 时](https://docs.aihubmix.com/cn/cloud/plus/without-plus.md)
* [术语表](https://docs.aihubmix.com/cn/cloud/concepts/glossary.md)


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