> ## 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.

# 키보드 단축키와 명령 메뉴

> AIHubMix Cloud의 모든 키보드 단축키(macOS / Windows / 웹 앱), ⌘/ 단축키 참조 패널, ⇧⌘P 명령 메뉴를 설명합니다.

AIHubMix Cloud에는 하나의 단축키 세트가 있으며, 사용자 지정할 수 없습니다. 언제든지 `⌘/` (Windows: `Ctrl+/`)를 누르면 모든 단축키를 볼 수 있습니다. 단축키가 없는 기능 대부분은 명령 메뉴 `⇧⌘P` (Windows: `Ctrl+Shift+P`)에서 검색해 실행할 수 있습니다.

## 단축키 적용 범위

| 형태 | 지원 여부 | 참고 |
| - | - | - |
| 데스크톱 앱 | 지원 | macOS는 `⌘` 조합을 사용하고, Windows는 이를 `Ctrl` 조합으로 변환합니다 |
| 웹 앱 | 지원 | 브라우저가 예약한 조합은 사용할 수 없으며, 일부는 대체 키가 있습니다 |
| 모바일 웹 | 해당 없음 | |

## 키 표기

| macOS | Windows |
| - | - |
| `⌘` Command | `Ctrl` |
| `⌥` Option | `Alt` |
| `⌃` Control | `Ctrl` |
| `⇧` Shift | `Shift` |
| `⌃⌘` 조합 | `Ctrl+Alt` |
| `⏎` Return | `Enter` |

인터페이스에 표시되는 키는 사용 중인 시스템에 맞게 자동으로 변환됩니다.

## 전체 단축키 표

"웹 앱" 열에는 앱과 다른 경우만 표시합니다. 표시되지 않은 항목은 앱과 같이 동작합니다.

### 일반

| 작업 | macOS | Windows | 웹 앱 |
| - | - | - | - |
| 명령 메뉴 | `⇧⌘P` | `Ctrl+Shift+P` | |
| 키보드 단축키(참조 패널) | `⌘/` | `Ctrl+/` | |
| 설정 열기 | `⌘,` | `Ctrl+,` | |
| 사이드바 전환 | `⌘\`、`⌘B` | `Ctrl+\`、`Ctrl+B` | |
| 뒤로 가기 | `⌘[` | `Ctrl+[` | 브라우저의 뒤로를 사용하세요 |
| 앞으로 가기 | `⌘]` | `Ctrl+]` | 브라우저의 앞으로를 사용하세요 |
| 알림(**Settings › Notifications** 열기) | `⌥⌘U` | `Ctrl+Alt+U` | |
| 표시 모드 순환(라이트 / 다크 / 시스템) | `⇧⌘L` | `Ctrl+Shift+L` | |

### 채팅

| 작업 | macOS | Windows | 웹 앱 |
| - | - | - | - |
| 새 채팅 | `⌘N`、`⇧⌘O` | `Ctrl+N`、`Ctrl+Shift+O` | `⇧⌘O` / `Ctrl+Shift+O` 만 |
| 프로젝트 밖에서 새 채팅 | `⌥⌘O` | `Ctrl+Alt+O` | |
| 채팅 검색 | `⌘K` | `Ctrl+K` | |
| 이전 채팅(분할 보기에서는 이전 창) | `⇧⌘[`、`⌃⇧Tab` | `Ctrl+Shift+[`、`Ctrl+Shift+Tab` | macOS: `⌥↑`, Windows: `Ctrl+Shift+[` 또는 `Alt+Up` |
| 다음 채팅(분할 보기에서는 다음 창) | `⇧⌘]`、`⌃Tab` | `Ctrl+Shift+]`、`Ctrl+Tab` | macOS: `⌥↓`, Windows: `Ctrl+Shift+]` 또는 `Alt+Down` |
| 채팅 1–9로 이동 | `⌘1`–`⌘9` | `Ctrl+1`–`Ctrl+9` | macOS: `⌃1`–`⌃9`, Windows 웹 앱에서는 사용할 수 없음 |
| 입력이 필요한 다음 채팅 | `⌥⌘A` | `Ctrl+Alt+A` | |
| 모든 읽지 않음 지우기 | `⇧Esc` | `Shift+Esc` | |
| 채팅 이름 변경 | `⌥⌘R` | `Ctrl+Alt+R` | |
| 채팅 고정 또는 고정 해제 | `⌥⌘P` | `Ctrl+Alt+P` | |
| 읽지 않음 또는 읽음으로 표시 | `⇧⌘U` | `Ctrl+Shift+U` | |
| 채팅 보관 | `⇧⌘A` | `Ctrl+Shift+A` | |
| 채팅 링크 복사 | `⌥⌘L` | `Ctrl+Alt+L` | |
| 작업 디렉터리 복사 | `⇧⌘C` | `Ctrl+Shift+C` | |
| Markdown으로 복사 | `⌥⇧⌘C` | `Ctrl+Alt+Shift+C` | |
| 사이드 채팅 열기 또는 숨기기 | `⌥⌘S` | `Ctrl+Alt+S` | |
| 현재 채팅 닫기(분할 보기에서는 현재 창) | `⌘W` | `Ctrl+W` | 사용할 수 없습니다. 명령 메뉴를 사용하세요 |
| 채팅 내 검색 | `⌘F` | `Ctrl+F` | |

### 입력창

| 작업 | macOS | Windows | 웹 앱 |
| - | - | - | - |
| 보내기 | `⏎` | `Enter` | |
| 줄 바꿈 | `⇧⏎` | `Shift+Enter` | |
| 실행 중 다른 방식으로 보내기(대기열 ↔ 끼어들기) | `⌘⏎` | `Ctrl+Enter` | |
| 마지막 메시지 편집(입력창이 비어 있을 때) | `↑` | `Up` | |
| 파일 또는 이미지 추가 | `⌘U` | `Ctrl+U` | Windows 웹 앱에서는 사용할 수 없음 |
| 음성 입력(곧 제공 예정) | `⌃⇧V` | `Ctrl+Shift+V` | |
| 모델 선택기 열기 | `⌃⇧M` | `Ctrl+Shift+M` | |
| 강도 메뉴 열기(추론 강도) | `⌃⇧I` | `Ctrl+Shift+I` | Windows 웹 앱에서는 사용할 수 없음 |
| 권한 메뉴 열기 | `⌃⇧S` | `Ctrl+Shift+S` | |
| 프로젝트 선택기 열기 | `⌥⇧⌘O` | `Ctrl+Alt+Shift+O` | |
| 새 채팅 페이지에서 프로젝트 1–9 선택 | `⌥⌘1`–`⌥⌘9` | `Ctrl+Alt+1`–`Ctrl+Alt+9` | |
| 새 프로젝트 | `⌘O` | `Ctrl+O` | |
| 열린 메뉴에서 1–9번째 항목 선택 | `1`–`9` | `1`–`9` | |

### 실행과 승인

| 작업 | macOS | Windows | 동작 조건 |
| - | - | - | - |
| 실행 중인 작업 중지 | `Esc` | `Esc` | 세션이 실행 중일 때 |
| 요청 승인 | `⏎`、`1` | `Enter`、`1` | 승인을 기다리는 요청이 있고 포커스가 메시지 입력창에 없을 때 |
| 승인하고 다시 묻지 않기(**Allow for this task**) | `2` | `2` | 위와 같음 |
| 요청 거부 | `Esc`、`3` | `Esc`、`3` | 위와 같음 |

승인 단축키의 전체 규칙은 [입력 필요](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)를 참고하세요.

### 워크스페이스와 패널

| 작업 | macOS | Windows | 동작 조건 |
| - | - | - | - |
| 파일 | `⇧⌘E` | `Ctrl+Shift+E` | 세션이 프로젝트에 속할 때 |
| 변경 사항 | `⌃⇧G` | `Ctrl+Shift+G` | 세션이 프로젝트에 속할 때 |
| 웹 미리보기 | `⇧⌘B` | `Ctrl+Shift+B` | 세션이 열려 있을 때(프로젝트 밖의 세션은 아직 미리보기를 지원하지 않음) |
| 클라우드 서버 | `` ⌃` `` | `` Ctrl+` `` | 세션이 열려 있을 때 |
| 클라우드 서버 전체 보기 | `⇧⌘F` | `Ctrl+Shift+F` | 세션이 열려 있을 때 |
| 오른쪽 패널(펼치기 / 접기) | `⌥⌘\` | `Ctrl+Alt+\` | 세션 페이지 |

패널 단축키를 다시 누르면 패널이 접힙니다. 분할 보기에서는 사용할 수 없습니다. [오른쪽 패널](https://docs.aihubmix.com/ko/cloud/interface/right-drawer.md)을 참고하세요.

### 분할 보기

| 작업 | macOS | Windows |
| - | - | - |
| 레이아웃 순환(단일 → 2 → 4 → 6개 창) | `⇧⌘\` | `Ctrl+Shift+\` |
| 현재 창을 분할 보기에서 빼기 | `⌃⌘W` | `Ctrl+Alt+W` |

### 마우스

| 작업 | macOS | Windows |
| - | - | - |
| 사이드바의 채팅을 분할 보기에 추가 | `⌥` 클릭 | `Alt` 클릭 |
| 사이드바의 채팅을 새 탭에서 열기(웹 앱만) | `⌘` 클릭 | `Ctrl` 클릭 |
| 미리보기 링크를 브라우저에서 열기 | `⌘` 클릭 | `Ctrl` 클릭 |

### 메뉴, 대화상자, 기타 키

| 위치 | 키 | 효과 |
| - | - | - |
| 메뉴 | `↑` / `↓`, `⏎` | 이동, 선택 |
| 메뉴 | `→` / `←` | 하위 메뉴 열기 / 닫기 |
| 메뉴, 대화상자 | `Esc` | 닫기(하위 메뉴가 열려 있으면 하위 메뉴를 먼저 닫음) |
| 오른쪽 패널 탭 바 | `Delete` / `Backspace` | 탭 닫기 |
| 전체 화면의 패널 | `Esc` | 전체 화면 종료 |
| 웹 미리보기 주석 | `Esc` | 먼저 댓글 상자를 닫고, 다음에 주석 모드를 종료합니다 |
| 사이드바에서 드래그, 분할 보기로 드래그 | `Esc` | 드래그 취소 |

## 단축키가 동작하는 조건

* **입력란에 포커스가 있을 때**: `Esc`, `⏎`, `↑`, 숫자 키 같은 단일 키는 동작하지 않습니다. 예외: 메인 메시지 입력창에서는 `Esc` 로 세션을 중지할 수 있고, `⇧Esc` 로 모든 읽지 않음을 지울 수 있으며, 입력창이 비어 있으면 `↑` 로 마지막 메시지를 편집합니다.
* **같은 키가 상황에 따라 다르게 동작**: `Esc` 는 실행 중인 세션을 중지하고, 승인을 기다리는 요청을 거부합니다. 대화상자나 메뉴가 열려 있으면 `Esc` 는 먼저 그것을 닫습니다.
* **`⌘⏎` (대기열 ↔ 끼어들기)**: 세션이 실행 중이고 메시지 입력창에 내용이 있을 때만 동작합니다. 현재 에이전트가 끼어들기를 지원하지 않으면 메시지가 대기열에 들어갑니다.
* **이전 / 다음 채팅, 채팅 1–9**: 세션의 최근 활동을 기준으로 합니다. 분할 보기에서는 창을 전환합니다.
* **파괴적인 작업에는 단축키가 없음**: 영구 삭제는 메뉴와 명령 메뉴에만 있으며, 이 경우에도 확인이 필요합니다.

## 웹 앱의 대체 키

브라우저가 예약한 조합(`⌘N`, `⌘W`, `⌘1`–`⌘9`, `⌘[` 등)은 웹 앱에서 사용할 수 없습니다. 대체 키가 있는 경우 웹 앱에는 대체 키가 바로 표시됩니다(위 표의 "웹 앱" 열 참고). 대체 키가 없는 경우 명령 메뉴 `⇧⌘P` 에서 실행하세요.

## ⌘/ 단축키 참조 패널

`⌘/` (Windows: `Ctrl+/`)를 누르면 **Keyboard shortcuts** 패널이 열리며, 모든 단축키가 그룹별로 나열됩니다. 표시되는 키는 사용 중인 시스템과 웹 앱에 맞게 자동으로 바뀝니다. 하단의 **View in Settings** 를 클릭하면 **Settings › Keyboard shortcuts** (같은 내용)로 이동합니다. `Esc` 를 누르거나 `⌘/` 를 다시 누르면 닫힙니다. 패널에는 검색 기능이 없습니다. 기능을 검색하려면 명령 메뉴를 사용하세요.

## ⇧⌘P 명령 메뉴

`⇧⌘P` (Windows: `Ctrl+Shift+P`)를 누르면 명령 메뉴가 열립니다. 입력해 검색하고, `↑` / `↓` 로 선택하고, `⏎` 로 실행하고, `Esc` 로 닫습니다. 명령 메뉴에는 지금 실행할 수 있는 명령만 표시되며, 단축키가 있는 명령은 오른쪽에 키가 표시됩니다.

명령 메뉴에는 다음이 포함됩니다.

1. **단축키 표에 있는 작업 중 현재 사용할 수 있는 작업**.
2. **명령 메뉴에만 있는 기능**:

| 그룹 | 명령 |
| - | - |
| 일반 | **Check for updates** (데스크톱 앱만) |
| 채팅 | **Go to parent chat**, **Fork chat in same worktree**, **New chat in this worktree**, **Open chat in new window or tab**, **Delete chat permanently** |
| 입력창 | **Choose where to run (this computer / cloud server)** |
| 실행과 승인 | **Copy the last response**, **Fork from the last response**, **Expand or collapse the run log**, **Take control of the cloud server**, **New scheduled task** |
| 분할 보기 | **Split view: 2 panes**, **Split view: 4 panes**, **Split view: 6 panes**, **Exit split view** |

3. **설정 페이지**: **Settings · Account**, **Settings · Appearance**, **Settings · Model sources (subscriptions / BYOK)** 등.
4. **페이지 이동**: **Go to · Projects**, **Go to · Scheduled tasks**, **Go to · Cloud server**, **Go to · Activity**.
5. **언어와 화면 스타일**: **Switch language to English**, **Display mode · …**, **Theme · …**.

## FAQ

### 웹 앱에서 `⌘N` 을 눌렀더니 새 브라우저 창이 열렸습니다.

브라우저가 `⌘N` 을 예약하고 있습니다. 웹 앱에서는 `⇧⌘O` (Windows: `Ctrl+Shift+O`)를 사용해 새 채팅을 시작하세요.

### 단축키를 사용자 지정할 수 있나요?

현재는 지원하지 않습니다.

### `Esc` 로 세션이 중지되지 않은 이유는 무엇인가요?

대화상자나 메뉴가 열려 있으면 `Esc` 는 먼저 그것을 닫습니다. 검색 상자 같은 다른 입력 영역에 포커스가 있을 때도 `Esc` 로 세션이 중지되지 않습니다. 메인 메시지 입력창이나 대화 영역에 포커스를 둔 상태에서 `Esc` 를 눌러 세션을 중지하세요.

### `1` 키로 요청이 승인되지 않은 이유는 무엇인가요?

승인 단축키는 승인을 기다리는 요청이 있고 포커스가 메시지 입력창이나 다른 버튼에 없을 때만 동작합니다. 먼저 대화의 빈 영역을 클릭한 뒤 키를 누르세요.

## 관련 문서

* [인터페이스 개요](https://docs.aihubmix.com/ko/cloud/interface/overview.md)
* [오른쪽 패널](https://docs.aihubmix.com/ko/cloud/interface/right-drawer.md)
* [분할 보기](https://docs.aihubmix.com/ko/cloud/interface/split-view.md)
* [입력 필요](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)
* [계정 메뉴와 공통 오버레이](https://docs.aihubmix.com/ko/cloud/interface/command-and-menus.md)


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