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

# 입력창: 첨부 파일, 스크린샷, 슬래시 명령, 실행 중 메시지 추가

> 입력창 사용 방법입니다. 첨부 파일 추가와 제한, 스크린샷 찍기, 슬래시 명령, 세션 실행 중 대기열 또는 끼어들기, 이번 턴 중지, 입력창 위의 오류 영역을 설명합니다.

**입력창**은 에이전트에게 작업을 맡기고 요구 사항을 추가하는 곳입니다. 새 채팅 페이지와 세션 페이지는 같은 입력창을 사용합니다. 새 채팅 페이지의 입력창 위에 있는 프로젝트와 실행 환경 선택은 [새 세션](https://docs.aihubmix.com/ko/cloud/sessions/new-session.md)을 참고하세요.

## 적용 범위

| 형태 | 지원 | 비고 |
| - | - | - |
| 데스크톱 앱 | 지원 | 이 컴퓨터에서 실행되는 세션에서는 파일이 로컬 참조로 추가됩니다 |
| 웹 앱 | 지원 | 기기에서 실행되는 세션에는 파일을 추가할 수 없고 이미지만 추가할 수 있습니다 |
| 모바일 웹 | 지원 | 브라우저가 화면 공유를 지원하지 않으면 **Take a screenshot** 이 회색으로 비활성화됩니다 |

## 입력창 구성

| 위치 | 컨트롤 | 비고 |
| - | - | - |
| 입력창 위 | 오류 영역, 입력창 위의 요청, 대기열 메시지 | 아래 내용과 [입력 필요](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)를 참고하세요 |
| 왼쪽 아래 | 파일 또는 이미지를 추가하는 **+** | `⌘U`(Windows `Ctrl+U`) |
| 왼쪽 아래 | 권한 | [새 세션](https://docs.aihubmix.com/ko/cloud/sessions/new-session.md)을 참고하세요 |
| 오른쪽 아래 | 모델, 추론 강도 | [Harness 및 모델](https://docs.aihubmix.com/ko/cloud/models/harness-and-models.md)을 참고하세요 |
| 오른쪽 아래 | 컨텍스트 사용량 링 | 세션 페이지에서만 표시됩니다. 마우스를 올리면 사용 비율이 표시됩니다. 컨텍스트가 한도에 가까워지면 자동으로 압축됩니다 |
| 오른쪽 아래 | 음성 입력 | 아직 사용할 수 없으며 **Dictation: coming soon** 이 표시됩니다 |
| 오른쪽 아래 | **Queue / Steer** 전환 | 턴이 실행 중이고 입력창에 내용이 있을 때 나타납니다. 아래를 참고하세요 |
| 오른쪽 아래 | 전송 / 이번 턴 중지 | 턴이 실행 중이고 입력창이 비어 있으면 **Stop this turn** 으로 바뀝니다 |

키 조작:

* `Enter` 로 전송하고 `Shift+Enter` 로 줄을 바꿉니다.
* 턴이 실행 중일 때 `Esc` 를 누르면 현재 작업이 중지됩니다.
* 입력창이 비어 있을 때 `↑` 를 누르면 마지막 메시지를 편집합니다(현재 에이전트가 지원하는 경우). [메시지 및 세션 작업](https://docs.aihubmix.com/ko/cloud/sessions/messages.md)을 참고하세요.

## 첨부 파일

### 첨부 파일 추가

* **+** 를 클릭하고 **Upload files or images** 또는 **Take a screenshot** 을 선택합니다.
* 파일을 입력창으로 끌어다 놓거나, 스크린샷이나 파일을 바로 붙여넣습니다.

텍스트 없이 첨부 파일만 보낼 수 있습니다. 커서가 입력창의 맨 앞에 있을 때 `Backspace` 를 두 번 누르면 마지막 첨부 파일이 삭제됩니다.

### 제한

| 항목 | 제한 | 초과 시 메시지 |
| - | - | - |
| 메시지당 첨부 파일 수 | 10개 | **“file name” not added: up to 10 attachments at a time** |
| 단일 이미지(PNG, JPEG, WebP, GIF) | 5 MB | **file name exceeds 5 MB. Choose a smaller file.** |
| 그 밖의 단일 파일(모든 형식) | 25 MB | **file name exceeds 25 MB. Choose a smaller file.** |
| 메시지당 첨부 파일 총 크기 | 100 MB | **“file name” not added: attachments can total up to 100 MB** |
| 빈 파일 | 추가할 수 없음 | **“file name” is empty** |

제한을 넘는 파일은 추가되지 않으며, 나머지는 정상적으로 추가됩니다. HEIC, HEIF, TIFF 형식의 이미지는 자동으로 JPEG로 변환됩니다.

### 이미지와 파일 추가 가능 여부

추가할 수 없으면 **+** 메뉴의 해당 항목이 회색으로 비활성화되고 이유가 표시됩니다.

| 상황 | 메시지 |
| - | - |
| 현재 에이전트가 이미지를 지원하지 않음 | **Agent name doesn’t support image attachments yet** |
| 클라우드 서버가 아직 준비되지 않았거나 업그레이드가 필요함 | **Images can be added once your cloud server is ready**, **Your cloud server needs an upgrade to send files** 등 |
| 웹 앱에서 기기에서 실행되는 세션 | 파일이 회색으로 비활성화됨: **For tasks running on your computer, add files in the desktop app**. 이미지는 정상적으로 추가됩니다 |

### 첨부 파일 상태

첨부 파일 중 하나라도 업로드 중, 변환 중이거나 업로드에 실패했으면 전송 버튼을 사용할 수 없으며 **Send when attachments are ready** 가 표시됩니다.

| 상태 | 표시되는 내용 | 할 수 있는 작업 |
| - | - | - |
| 업로드 중 | **Uploading N%** 와 진행률 표시줄 | 기다리거나, ×를 클릭해 제거합니다 |
| 업로드 실패 | **Upload incomplete** 와 이유 | 다시 시도 버튼을 클릭하거나 제거합니다 |
| 변환 중 | **Converting to JPEG** | 기다립니다 |
| 변환할 수 없음 | **This browser cannot convert this image. Use JPEG or PNG.** | 제거하고 JPEG / PNG를 대신 사용합니다 |
| 로컬 참조 | **Local reference** | 바로 전송합니다 |

### 로컬 참조(데스크톱 앱)

세션이 **이 컴퓨터**에서 실행될 때, 데스크톱 앱에서 추가한 파일은 **Local reference** 로 에이전트에 전달됩니다. 업로드되지 않으며 100 MB 총량에 포함되지 않습니다. 프로젝트 폴더 밖의 파일은 먼저 프로젝트 폴더로 복사됩니다(**Copying to an allowed folder** 표시). 파일을 참조할 수 없으면 첨부 파일에 이유가 표시됩니다. 이미지는 계속 정상적으로 업로드됩니다.

### 스크린샷 찍기

**+** 메뉴의 **Take a screenshot** 으로 캡처한 이미지는 바로 보낼 첨부 파일이 됩니다.

| 형태 | 방법 |
| - | - |
| 데스크톱 앱(macOS) | 시스템의 영역 선택을 사용합니다. Space를 눌러 창 캡처로 전환하고, `Esc` 로 취소합니다. 다른 앱의 창을 처음 캡처할 때 시스템이 화면 기록 권한을 요청합니다 |
| 데스크톱 앱(Windows) | 앱이 있는 화면을 캡처합니다 |
| 웹 앱 | 브라우저의 화면 공유 선택 창에서 화면을 선택하면 한 프레임이 캡처됩니다 |

캡처에 실패하면 **Couldn’t take the screenshot. Try again** 이 표시됩니다.

### 보낸 메시지의 첨부 파일

이미지를 클릭하면 크게 볼 수 있고, 파일을 클릭하면 다운로드됩니다. 로컬 참조 파일은 파일 이름만 표시되며 다운로드할 수 없습니다.

## 슬래시 명령

입력창 맨 앞에 `/` 를 입력하면 명령 목록이 열리고, 계속 입력하면 목록이 필터링됩니다. 명령은 현재 세션의 프로젝트, 에이전트, 실행 환경 기준으로 나열되며, **Source device · Device only**, **Cloud shared**, **Project**, **Built-in** 그룹으로 나뉩니다.

* `↑` `↓` 로 선택하고, `Enter` 또는 `Tab` 으로 삽입하고, `Esc` 로 닫습니다.
* 명령을 선택하면 입력창에 삽입만 되고 바로 전송되지 않습니다.
* 사용할 수 없는 명령은 이유와 함께 회색으로 비활성화됩니다. 가장 흔한 이유는 **Choose the source device to use this command** 입니다(명령이 특정 기기에만 설치되어 있고 세션이 그 기기에서 실행되지 않음).

플러그인과 Skills의 추가 및 관리는 [플러그인, MCP, Skills](https://docs.aihubmix.com/ko/cloud/integrations/plugins-mcp-skills.md)를 참고하세요.

## 실행 중 메시지 추가: 대기열과 끼어들기

에이전트가 작업하는 동안에도 계속 입력할 수 있습니다. 보내는 방법은 두 가지입니다(세션이 유휴 상태이면 메시지가 바로 전송됩니다).

| 방식 | 의미 |
| - | - |
| **Queue** | 입력창 위의 대기열 영역에서 기다리다가 이번 턴이 끝난 후 순서대로 전송됩니다. 각 메시지가 새 턴을 시작합니다 |
| **Steer** | 현재 턴에 즉시 삽입되며, 에이전트가 현재 턴과 함께 처리합니다 |

### 선택 방법

* 기본 방식은 **Settings › General** 에서 설정합니다. 아래 "기본 방식 설정"을 참고하세요.
* 기본값이 대기열이면 전송 버튼 옆에 **Queue | Steer** 전환이 나타나며, 이 메시지 하나만 끼어들기로 바꿀 수 있습니다.
* `⌘Enter`(Windows `Ctrl+Enter`): 이 메시지를 기본값과 반대 방식으로 보냅니다.

### 에이전트가 끼어들기를 지원하지 않을 때

현재 Claude Code와 Codex만 끼어들기를 지원합니다. 다른 에이전트에서는 **Steer** 가 회색으로 비활성화되며 모든 메시지가 대기열로 전송됩니다.

### 대기열 영역

대기열 메시지는 입력창 위에 한 줄에 하나씩 표시됩니다. 세션 타이머가 대기열에 넣은 메시지에는 **⏰ Timer** 라벨이 붙습니다. 페이지를 새로 고치거나 다른 기기에서 열어도 같은 대기열이 표시됩니다.

| 작업 | 효과 |
| - | - |
| 행 앞쪽의 핸들 드래그 | 메시지 순서를 바꿉니다 |
| **Steer** | 이 메시지를 현재 턴에 즉시 삽입합니다 |
| 삭제 | 아직 보내지 않은 이 메시지를 철회합니다 |
| **…** › **Edit message** | 그 자리에서 편집한 다음 **Save** 합니다 |
| **…** › **Open in side chat** | 텍스트를 사이드 채팅 초안으로 옮기고 대기열에서 제거합니다(첨부 파일이 있으면 사용할 수 없음) |
| **…** › **Turn off queueing** | 기본 방식을 끼어들기로 바꿉니다. 대기열 메시지는 유지됩니다 |

### 턴 중지 후

* 여기서 **Stop this turn** 을 클릭한 경우: 대기열 메시지가 원래 순서대로 계속 전송됩니다.
* 다른 곳에서 턴이 중지된 경우(예: 다른 기기에서): 대기열이 일시 중지되며, 대기열 영역에 **Queue paused** 와 **Send all** 이 표시됩니다. 하나씩 **Send** 하거나 삭제할 수도 있습니다.

## 기본 방식 설정

**Settings › General** 의 **Chat** 그룹에 있는 **Messages sent mid-turn**: **Queue**(기본값) 또는 **Steer**. 이 설정은 계정에 저장되며 데스크톱 앱과 웹 앱에서 공유됩니다.

## 이번 턴 중지

턴이 실행 중이고 입력창이 비어 있으면 전송 버튼이 **Stop this turn** 으로 바뀝니다. 클릭하거나 `Esc` 를 눌러 중지합니다. 중지 후 동작은 [오류 및 복구](https://docs.aihubmix.com/ko/cloud/sessions/errors-and-recovery.md)를 참고하세요.

## 입력창 위의 오류 영역

현재 세션과 관련된 오류(전송, 업로드, 네트워크, 미리 보기, 사용할 수 없는 소스 등)는 모두 입력창 바로 위에 표시됩니다. 각 카드에는 설명과 하나의 주요 작업(예: **Retry** 또는 **Sign in**)이 있습니다. 오류 유형별 처리 방법은 [오류 및 복구](https://docs.aihubmix.com/ko/cloud/sessions/errors-and-recovery.md)를 참고하세요.

## 자주 묻는 질문

### 첨부 파일에 Upload incomplete가 계속 표시되면 어떻게 하나요?

첨부 파일의 다시 시도 버튼을 클릭해 다시 업로드합니다. 계속 실패하면 네트워크를 확인하거나, 제거한 다음 다시 추가하세요.

### 전송 버튼이 왜 회색으로 비활성화되어 있나요?

대개 첨부 파일이 아직 업로드 또는 변환 중이거나 업로드에 실패한 경우입니다. 완료될 때까지 기다리거나, 실패한 첨부 파일을 다시 시도하거나 제거하세요.

### 중지를 클릭하면 대기열 메시지는 어떻게 되나요?

여기서 중지를 클릭하면 대기열 메시지가 순서대로 계속 전송됩니다. 다른 곳에서 턴이 중지된 경우 대기열이 일시 중지되며, **Send all** 또는 각 메시지의 **Send** 를 클릭해야 합니다.

### 기본값을 끼어들기로 하고 싶은데 왜 메시지가 대기열에 들어갔나요?

현재 에이전트가 끼어들기를 지원하지 않으면 메시지가 자동으로 대기열로 처리됩니다. Claude Code와 Codex는 끼어들기를 지원합니다.

### 슬래시 명령이 왜 회색으로 비활성화되어 있나요?

명령 아래의 이유를 확인하세요. 대부분은 명령이 특정 기기에만 설치되어 있고 현재 세션이 그 기기에서 실행되지 않는 경우입니다.

## 관련 문서

* [새 세션](https://docs.aihubmix.com/ko/cloud/sessions/new-session.md)
* [입력 필요](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)
* [오류 및 복구](https://docs.aihubmix.com/ko/cloud/sessions/errors-and-recovery.md)
* [메시지 및 세션 작업](https://docs.aihubmix.com/ko/cloud/sessions/messages.md)
* [Harness 및 모델](https://docs.aihubmix.com/ko/cloud/models/harness-and-models.md)
* [실행 환경](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)


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