> ## 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/ko/cloud/models/model-sources.md)를 참고하세요.

## 지원 범위

| 플랫폼 | 지원 여부 | 참고 |
| - | - | - |
| 데스크톱 앱 | 지원 | 이 페이지는 데스크톱 앱을 기준으로 설명합니다. |
| 웹 앱 | 지원 | 데스크톱 앱과 같습니다. Windows의 웹 앱에는 **Open effort menu** 단축키가 없습니다. |
| 모바일 웹 | 지원 | 같은 팝오버가 화면에 맞게 좁게 표시됩니다. |

## 진입점

* **모델 버튼**(입력창 오른쪽 아래): Harness, 모델 공급사 아이콘, 모델 이름을 표시합니다. 모델 이름 뒤의 작은 글씨는 출처를 나타냅니다. 내 구독은 **Subscription**, 추가한 API 키는 **BYOK** 가 표시되며, Plus에 포함된 모델은 아무것도 표시되지 않습니다.
* **강도 버튼**(모델 버튼 옆): 현재 단계를 표시합니다(예: **Medium**, **High · Ultracode**). 모델이 강도 조정을 지원하지 않으면 숨겨집니다.
* **컨텍스트 사용량 링**(세션에서 모델 버튼 왼쪽). [컨텍스트 사용량 링](#context-usage)을 참고하세요.
* 단축키는 [키보드 단축키](#keyboard)를 참고하세요.
* 요금제 사용 한도에 도달했거나 계정의 연결이 끊어지면, 대화상자의 **Use another model** 로도 모델 선택기가 열립니다. [요금제 사용 한도 도달](https://docs.aihubmix.com/ko/cloud/models/model-sources.md#subscription-limit-reached)을 참고하세요.

## 모델 선택기

모델 선택기의 위쪽은 **Harness** 목록(선택한 항목에 체크 표시)이고, 아래쪽은 **Subscriptions** 와 **BYOK** 두 탭이 있는 **Model** 입니다. Plus에 포함된 모델과 내 API 키는 모두 BYOK 탭에 있습니다.

| 상황 | 표시 내용 / 할 일 |
| - | - |
| 선택기 열기 | 현재 모델의 탭으로 열립니다. 탭을 전환하면 목록만 바뀌며, 모델을 클릭해야 변경이 적용됩니다. |
| 목록 맨 위의 **Default model** | 이 탭의 기본 모델(보통 권장 모델)을 선택합니다. |
| Subscriptions 탭 | 구독 계정마다 하나의 그룹. 그룹 제목은 계정 이름이며, 오른쪽에 작은 글씨로 요금제가 표시됩니다. |
| BYOK 탭 | 첫 번째 그룹은 Plus 모델(AIHubMix 아이콘)입니다. [Plus 모델](https://docs.aihubmix.com/ko/cloud/models/model-sources.md#plus-models)을 참고하세요. 나머지는 프로바이더별로 그룹화되며, 한 프로바이더에 키가 여러 개이면 키 이름별로 나뉩니다. 그룹 제목에 마우스를 올리고 연필 아이콘을 클릭하면 해당 그룹을 편집합니다. |
| 소스 아래에 아직 내용이 없음 | 목록 영역에 **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에 따라 다릅니다. [입력창](https://docs.aihubmix.com/ko/cloud/sessions/composer.md)을 참고하세요.

## Harness와 모델 소스 조합

모델 선택기에서는 현재 Harness가 사용할 수 있는 모델만 선택할 수 있습니다. 다른 그룹은 이유와 함께 회색으로 비활성화됩니다.

* **Plus 모델**: 사용 가능한 모델은 Harness에 따라 다릅니다.
* **내 구독**: 각 구독은 특정 Agent에 대응합니다. 예를 들어 Claude 구독은 Claude Code 전용이고, ChatGPT 구독은 Codex CLI용입니다. [지원되는 구독](https://docs.aihubmix.com/ko/cloud/models/model-sources.md#supported-subscriptions)을 참고하세요.
* **내 키**: Claude Code는 **Anthropic compatible** API가, Codex CLI는 **OpenAI compatible** API가 필요합니다. [API 형식과 Harness](https://docs.aihubmix.com/ko/cloud/models/model-sources.md#api-format-harness)를 참고하세요.

## Harness와 모델 선택

1. 새 세션 페이지에서 입력창 오른쪽 아래의 모델 버튼을 클릭합니다.
2. Harness를 클릭합니다. Harness를 바꾸면 모델이 **Default model** 로 돌아갑니다.
3. **Subscriptions** 또는 **BYOK** 탭으로 전환하고 모델을 클릭합니다.
4. 필요하면 강도 버튼을 클릭해 추론 강도를 조정합니다.
5. 메시지를 입력하고 보냅니다. 세션이 이 조합으로 시작됩니다.

## 기본 선택

* 새 세션은 마지막으로 만든 세션의 선택(Harness, 모델, 소스, 직접 선택한 추론 강도)을 다시 사용합니다. 처음에는 Claude Code + **Default model** 입니다.
* 추론 강도를 직접 선택한 적이 없으면 강도 버튼에 모델의 권장 단계가 표시됩니다.
* 기억된 모델이나 소스를 더 이상 사용할 수 없으면 **Default model** 로 돌아갑니다.
* Ultracode는 새 세션에서 기본적으로 꺼져 있습니다.
* 세션에서 모델을 전환하면 해당 세션에만 영향을 주며, 새 세션의 기본값은 바뀌지 않습니다.
* 같은 프로바이더의 구독 계정이 여러 개이면 **Default** 로 표시된 계정을 사용합니다. [기본 계정](https://docs.aihubmix.com/ko/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" 조합에 따라 다르며, 제품에 표시된 대로입니다. 세션에서도 바꿀 수 있으며, 변경 사항은 다음 턴부터 적용됩니다.

### 두 가지 형태

| 현재 모델 | 형태 | 항목 이름 |
| - | - | - |
| 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 슬라이더**: 드래그하거나 클릭해 단계를 선택합니다. 아래 줄에 현재 단계의 용도가 설명됩니다. **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 단계는 바뀌지 않습니다. 켜져 있으면 강도 버튼에 **High · Ultracode** 같은 표시가 나타납니다. 세션에서는 다음 턴부터 적용됩니다.

* 켤 수 있는지는 Harness, 클라우드 서버, 모델, 소스에 따라 다릅니다. Claude Code, 준비된 클라우드 서버, **Extra high** 를 지원하는 선택된 모델이 필요합니다.
* 조건을 충족하지 않으면 토글이 회색으로 비활성화되고 이유가 표시됩니다. 새 세션에서 모델이나 소스를 바꿔 조건을 더 이상 충족하지 않으면 토글이 자동으로 꺼집니다.

### 모델 전환 후 강도 변화

| 상황 | 결과 |
| - | - |
| 선택한 단계가 새 모델에도 있음 | 그대로 유지됩니다. |
| 새 모델에 이 단계가 없음 | 새 모델의 권장 단계로 돌아갑니다. |
| 새 모델이 강도 조정을 지원하지 않음 | 강도 버튼이 숨겨집니다. |
| 세션에서 모델 전환 | 확인 대화상자에 **Effort after switching: X** 가 표시됩니다. |

## 키보드 단축키

| 작업 | macOS | Windows |
| - | - | - |
| 모델 선택기 열기 또는 닫기 | `⌃⇧M` | `Ctrl+Shift+M` |
| 강도 메뉴 열기 또는 닫기 | `⌃⇧I` | `Ctrl+Shift+I` (웹 앱에서는 브라우저가 사용하므로 사용할 수 없음) |
| **Subscriptions** 와 **BYOK** 탭 전환 | `Tab` | `Tab` |
| 메뉴에서 1–9번째 항목 선택 | `1`–`9` | `1`–`9` |
| Effort 목록에서 이동 | `↑` `↓` | `↑` `↓` |
| 강도 슬라이더 조정 | `←` `→` `↑` `↓` `Home` `End` | 같음 |
| 메뉴 닫기 | `Esc` | `Esc` |

## Plus가 없는 경우

* 모델 선택기는 평소대로 열립니다. BYOK 탭의 Plus 모델 그룹이 회색으로 비활성화되고 **Subscribe to Plus to use these models** 가 표시됩니다. **Get Plus** 를 클릭하면 Plus 구독 대화상자가 열립니다.
* 새 세션 페이지에서 보낸 메시지는 보관되고 업그레이드 카드가 표시됩니다. 구독하면 자동으로 전송됩니다. [Plus가 없을 때](https://docs.aihubmix.com/ko/cloud/plus/without-plus.md)를 참고하세요.

## 참고 사항과 제한

* Harness를 바꾸려면 새 세션을 만드세요.
* 압축하면 이전의 세부 내용이 사라집니다. 압축하지 않으려면 **Cancel** 을 클릭하거나, 컨텍스트 한도가 더 큰 모델을 선택하세요.
* 새 세션에서 호환되지 않는 그룹의 모델을 클릭하면 Harness가 자동으로 전환됩니다. 안내 메시지를 확인하세요.
* 모델 목록, 단계, 권장 단계는 바뀔 수 있습니다. 제품에 표시된 내용을 따르세요.

## 관련 문서

* [모델 소스: Plus 모델, 내 구독, BYOK](https://docs.aihubmix.com/ko/cloud/models/model-sources.md)
* [모델 FAQ](https://docs.aihubmix.com/ko/cloud/models/model-faq.md)
* [입력창](https://docs.aihubmix.com/ko/cloud/sessions/composer.md)
* [Plus가 없을 때](https://docs.aihubmix.com/ko/cloud/plus/without-plus.md)
* [용어집](https://docs.aihubmix.com/ko/cloud/concepts/glossary.md)


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