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

# 오류 및 복구: 전송 실패, 기기 연결 끊김, 클라우드 서버 업데이트, 절전, 사용 한도

> 세션이나 메시지에 오류가 발생했을 때 표시되는 내용, 자동으로 복구되는 경우, 다시 시도, 다시 보내기, 소스 전환이 필요한 경우를 설명합니다.

이 페이지에서는 세션 실행 중이나 메시지 전송 중에 겪을 수 있는 문제와 사용자가 해야 할 일을 정리합니다. 기본 원칙은 다음과 같습니다. **작성한 내용은 사라지지 않습니다**(전송에 실패하면 메시지가 보존되며 다시 시도할 수 있습니다). **완료된 단계와 파일은 사라지지 않습니다**(중단된 후에도 변경 사항과 환경이 유지됩니다). **자동으로 복구할 수 있는 것은 자동으로 복구됩니다**.

## 지원 범위

| 플랫폼 | 지원 | 비고 |
| - | - | - |
| 데스크톱 앱 | 지원 | 세션이 이 컴퓨터에서 실행될 때는 연결이 끊긴 후 **Reconnect** 등의 작업을 사용할 수 있습니다 |
| 웹 앱 | 지원 | |
| 모바일 웹 | 지원 | |

## 빠른 참조

| 상황 | 표시 내용 | 할 수 있는 작업 |
| - | - | - |
| 메시지가 전송되지 않음 | 메시지 아래에 **This step couldn’t finish** | **Retry** 를 클릭합니다 |
| 서버와의 연결이 끊김 | **Connection lost. Reconnecting, missed messages will catch up automatically** | 기다립니다. **Disconnected. Please refresh the page** 가 표시되면 페이지를 새로 고칩니다 |
| 실행 기기 연결이 끊김 | **The device running this task disconnected. This turn is paused and continues automatically when it reconnects.** | 기다리거나 해당 기기에서 **Reconnect** 를 클릭합니다 |
| 클라우드 서버 업데이트 중 | **Your cloud server is updating, retrying automatically** | 기다립니다 |
| 클라우드 서버 업그레이드, 종료 또는 교체로 이번 턴이 중단됨 | "…this turn stopped…" | **Resend** 를 클릭하거나 메시지를 보내 계속합니다 |
| 세션 절전 | **This chat is asleep and wakes when you send a message** | 메시지를 보냅니다 |
| 세션 대기 중 | "Queued: …" | 기다립니다. 자리가 나면 자동으로 시작됩니다 |
| 세션 일시 중지 | **Chat paused: reason. Resolve it to continue** | 이유에 따라 해결합니다 |
| 내 구독이 사용 한도에 도달함 | **Account usage limit reached** 대화 상자 | 계정이나 모델을 전환하거나 기다립니다 |
| Plus 요금제 없음 | 고정 답변 + 업그레이드 카드 | [Plus 없이 보내기](https://docs.aihubmix.com/ko/cloud/plus/without-plus.md)를 참고하세요 |

## 메시지 전송 실패

메시지가 전송되지 않으면 메시지 아래에 **This step couldn’t finish** 카드가 나타납니다: **The connection was interrupted. Your message hasn’t been sent and is kept here. Try again.** **Retry** 를 클릭합니다. 성공하면 카드가 **Recovered** 로 바뀝니다. 다시 시도해도 같은 메시지가 두 번 전송되지 않습니다.

새 채팅 페이지에서 보낸 첫 메시지가 실패하면 메시지에 **Not sent: reason** 이 표시됩니다. 같은 방법으로 **Retry** 를 클릭합니다.

## 서버와의 연결

연결이 끊기면 입력창 위에 **Connection lost. Reconnecting, missed messages will catch up automatically** 가 표시됩니다. 복구되면 연결이 끊긴 동안의 메시지가 자동으로 채워집니다. 복구할 수 없으면 **Disconnected. Please refresh the page** 가 표시되므로 페이지를 새로 고칩니다. 브라우저가 완전히 오프라인이면 **You’re offline** 이 표시됩니다.

## 실행 기기 연결이 끊긴 후 자동 계속

세션이 내 기기에서 실행되고 해당 기기의 연결이 끊기면(종료, 절전, 오프라인 등) 턴이 일시 중지되며, 모든 클라이언트에 **The device running this task disconnected. This turn is paused and continues automatically when it reconnects.** 가 표시됩니다. 기기가 다시 연결되면 턴이 중단된 지점부터 자동으로 계속되며, 완료된 작업은 다시 실행되지 않습니다. 일시 중지된 동안 직접 메시지를 보냈거나 중지를 클릭했으면 자동으로 재개되지 않습니다. 연결이 반복해서 끊기면 자동 재개가 멈출 수도 있으며, 이 경우 메시지를 보내세요.

실행 기기의 데스크톱 앱에는 연결이 끊긴 이유와 **Reconnect** 가 표시됩니다. 이유에 따라 처리합니다.

| 표시 내용 | 할 수 있는 작업 |
| - | - |
| 클라우드가 연결을 닫았거나 업데이트 중, **No network connection. Reconnecting automatically** | 기다립니다 |
| **Your sign-in expired. Sign in again to reconnect automatically** | 다시 로그인합니다 |
| **Execution machine unavailable: execution isn’t allowed on this computer** | **Machines & access** 에서 **Allow execution** 을 켭니다 |
| **No folder is linked to “project name” on this computer yet** | **Link folder** 를 클릭합니다 |
| **The local service quit unexpectedly several times. Automatic restart stopped** | **Restart** 를 클릭합니다 |
| **You disconnected this task from running on this computer** | **Reconnect** 를 클릭합니다 |

기기의 연결 상태와 실행 기록은 [실행 환경](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)을 참고하세요.

## 클라우드 서버 업데이트, 업그레이드, 종료

| 상황 | 타임라인 표시 | 할 수 있는 작업 |
| - | - | - |
| 클라우드 서버 업데이트 중 | **Your cloud server is updating, retrying automatically** | 기다립니다. 업데이트 후 자동으로 다시 시도합니다 |
| 업그레이드로 이번 턴이 중단됨 | **Your cloud server upgraded and this turn stopped. You can resend** | **Resend** 를 클릭하면 마지막 메시지를 다시 보냅니다 |
| 중지 또는 교체됨, 환경을 일시적으로 사용할 수 없음, 실행 실패 | "Your cloud server stopped or was replaced, so this turn ended…", "This turn was interrupted (the environment is temporarily unavailable…)", **Run failed. Output is kept** | 환경이 준비된 후 메시지를 보내면 Agent가 기존 진행 상황에서 계속합니다 |

## 절전, 일시 정지, 깨우기

* 한동안 활동이 없는 세션은 절전 상태가 되며 **This chat is asleep and wakes when you send a message** 가 표시됩니다. 메시지를 보내기만 하면 됩니다.
* 클라우드 서버가 재개되는 동안 타임라인에 **Wake environment project name** 이 표시되며, 보낸 메시지는 환경이 준비되면 자동으로 전송됩니다. 재개에 실패하면 구독 또는 갱신 안내가 표시됩니다.
* 세션이 일시 정지되면 상태 뒤에 이유가 표시됩니다(예: **Stopped at expiry**, **Failed to start. Send another message to retry**). 안내에 따르세요.

## 세션 대기열

한 프로젝트에서 최대 5개의 세션을 동시에 실행할 수 있습니다. 한도에 도달했거나 클라우드 서버가 재개 중이면 새 세션은 대기열에 들어가며, 자리가 나면 순서대로 자동으로 시작됩니다. 대기 중에 보낸 메시지는 시작된 후 처리됩니다.

## 세션 일시 중지

세션이 일시 중지되면 사이드바에 **Needs your input** 이 표시되고, 세션에는 **Chat paused: reason. Resolve it to continue** 가 표시됩니다.

| 이유 | 할 수 있는 작업 |
| - | - |
| **Model usage limit reached** | 아래 "요금제 사용 한도 도달"을 참고하세요 |
| 구독 계정 연결 해제됨, **Subscription inactive**, **Sub-key no longer valid** | 소스나 모델을 전환해 계속합니다(구독 계정 연결이 해제된 경우 대화 상자에서 **Use another model** 을 클릭합니다) |
| **Pending request timed out** | 메시지를 보내 계속합니다 |
| **Waiting for configuration** | 안내에 따라 구성을 완료합니다 |
| **The device running this task disconnected. It continues automatically when it reconnects** | 위의 "실행 기기 연결이 끊긴 후 자동 계속"을 참고하세요 |
| **Account suspended** | 지원팀에 문의하세요 |

## 이번 턴 중지

**Stop this turn** 을 클릭하거나 `Esc` 를 누르면:

* 타임라인에 **This turn stopped. Finished steps and files are kept.** 가 기록됩니다. 계속 메시지를 보내 이어갈 수 있습니다.
* 아직 사용자를 기다리던 요청은 폐기됩니다.
* 대기열 메시지는 원래 순서대로 전송됩니다. 다른 곳에서 이번 턴이 중지된 경우 대기열이 일시 중지됩니다. [입력창](https://docs.aihubmix.com/ko/cloud/sessions/composer.md)을 참고하세요.

실행 중에 이전 메시지를 편집하면 현재 턴이 먼저 중지됩니다. 중지가 시간 초과되면 **Stopping timed out. Try again, your edit is kept.** 가 표시됩니다. 잠시 후 **Rerun** 을 다시 클릭하세요.

## 요금제 사용 한도 도달

내 구독(예: ChatGPT 또는 Claude 계정)을 사용할 때 해당 계정이 사용 한도에 도달하면 세션이 중지되고 **Account usage limit reached** 대화 상자가 열립니다. 어떤 한도에 도달했는지와 대략적인 초기화 시점이 표시됩니다. 완료된 변경 사항과 환경은 유지됩니다. 다음을 할 수 있습니다.

* 같은 프로바이더의 다른 계정이 있을 때: 계정을 선택하고 **Continue with this account** 를 클릭합니다.
* 다른 계정이 없을 때: **Add account** 또는 **Use another model** 을 클릭합니다.
* **Later**: 대화 상자를 닫습니다. 한도가 초기화된 후 계속합니다.

사용량은 **Settings › Usage** 에서 확인할 수 있습니다. [사용량 및 결제 내역](https://docs.aihubmix.com/ko/cloud/settings/usage-and-billing.md)을 참고하세요.

## 입력창 위의 오류 카드

전송, 업로드, 미리 보기, 연결 등의 작업이 실패하면 입력창 바로 위에 설명과 주요 작업이 있는 오류가 표시됩니다. 여러 오류는 겹쳐 쌓이며, 펼치거나 **Collapse** 또는 **Dismiss all** 을 할 수 있습니다. 다시 시도에 성공하면 카드에 **Recovered** 가 표시되고 자동으로 사라집니다. **Details** 에는 원래 오류 메시지가 들어 있으며, 지원팀에 문의할 때 **Copy details** 를 사용할 수 있습니다.

| 오류 | 할 수 있는 작업 |
| - | - |
| **You’re offline**, **Request timed out**, **Too many requests**, **Service unavailable**, **Something went wrong** | **Retry** 를 클릭하거나 자동 다시 시도를 기다립니다. 계속 실패하면 세부 정보를 복사해 지원팀에 문의하세요 |
| **Your session expired** | **Sign in** 을 클릭합니다. 채팅과 초안은 유지됩니다 |
| **You don’t have access** | 워크스페이스 관리자에게 문의하세요 |
| **File too large**: **File name is over 20 MB. Compress or split it and try again.** | 파일을 압축하거나 나눕니다 |
| **Couldn’t open the preview** | 개발 서버가 계속 실행 중이고 `0.0.0.0` 에서 수신 대기하는지 확인한 다음 **Retry** 를 클릭합니다 |
| **This source isn’t available right now. Try another source or model** | 소스나 모델을 전환합니다 |

## 자주 묻는 질문

### 세션이 중단되었습니다. 이전에 변경한 파일이 남아 있나요?

예. 직접 턴을 중지했든, 클라우드 서버가 업그레이드되거나 중지되었든, 실행 기기의 연결이 끊겼든 완료된 단계와 파일은 유지됩니다. 메시지를 다시 보내면 계속됩니다.

### "Resend"와 새 메시지 보내기는 무엇이 다른가요?

**Resend** 는 마지막 메시지를 그대로 다시 보냅니다. 새 메시지를 보낼 수도 있으며, Agent는 이전 진행 상황을 바탕으로 계속합니다.

### 실행 기기의 연결이 끊긴 후 무엇을 해야 하나요?

보통은 아무것도 하지 않아도 됩니다. 기기가 다시 연결되면 세션이 자동으로 계속됩니다. 해당 기기의 앱에서 **Reconnect** 를 클릭할 수도 있습니다.

## 관련 문서

* [입력창](https://docs.aihubmix.com/ko/cloud/sessions/composer.md)
* [입력 필요](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)
* [새 세션](https://docs.aihubmix.com/ko/cloud/sessions/new-session.md)
* [실행 환경](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)
* [메시지 및 세션 작업](https://docs.aihubmix.com/ko/cloud/sessions/messages.md)
* [Plus 없이 보내기](https://docs.aihubmix.com/ko/cloud/plus/without-plus.md)


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