> ## 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와 모델, 모델 소스, 권한, 입력 필요, 하위 에이전트, 그리고 인터페이스의 각 영역이 하는 일을 설명합니다.

이 페이지에서는 Cloud Agent를 사용하면서 반복적으로 접하게 되는 개념을 설명합니다. 가장 중요한 두 가지는 **세션**과 **클라우드 서버**입니다. 세션에서 에이전트에게 작업을 맡기면, 에이전트는 클라우드 서버나 내 컴퓨터에서 작업을 완료합니다.

## 세션

**세션**은 하나의 작업을 두고 사용자와 에이전트가 함께 진행한 전체 기록으로, 사용자의 메시지, 에이전트의 단계, 답변, 변경 사항을 포함합니다. 세션은 프로젝트에 속할 수도 있고 어떤 프로젝트에도 속하지 않을 수도 있습니다. 사이드바에서 **New chat**을 클릭하면 세션을 시작합니다. 끝난 세션은 보관할 수 있으며, 다른 방향을 시도하고 싶을 때는 메시지에서 새 세션을 포크할 수 있습니다. [세션 시작하기](https://docs.aihubmix.com/ko/cloud/sessions/start-a-session.md)와 [세션 관리](https://docs.aihubmix.com/ko/cloud/sessions/manage-sessions.md)를 참고하세요.

## 프로젝트

**프로젝트**는 세션이 속한 코드 디렉터리 또는 저장소입니다. 두 가지 종류가 있습니다.

* **클라우드 프로젝트**: 클라우드에서 새로 만들거나, GitHub에서 가져오거나, 내 컴퓨터에서 업로드합니다. 클라우드 서버에서 실행되며, 환경을 구성할 수 있습니다.
* **로컬 프로젝트**: 데스크톱 앱에서 연결한 내 컴퓨터의 폴더입니다. 세션은 해당 컴퓨터에서 실행되며, 폴더는 클라우드에 동기화되지 않습니다.

어떤 프로젝트에도 속하지 않은 세션은 임시 작업 디렉터리에서 실행됩니다. 나중에 프로젝트로 옮길 수 있습니다. [프로젝트 및 환경 구성](https://docs.aihubmix.com/ko/cloud/environments/projects.md)을 참고하세요.

## 클라우드 서버와 내 기기에서 실행

**클라우드 서버**는 Plus에 포함된 공인 IP를 가진 전용 Linux 머신입니다. 클라우드 서버에서 실행되는 세션은 내 컴퓨터를 꺼도 계속 진행됩니다. 원격 데스크톱을 열어 에이전트가 하는 일을 지켜보거나 직접 제어할 수 있습니다.

**내 기기에서 실행**(인터페이스에는 **Run on your device**로 표시)은 또 다른 실행 방식입니다. 에이전트는 클라우드에 있지만, 파일 읽기와 쓰기, 명령 실행은 사용자가 선택한 컴퓨터에서 이루어지며 로컬에서 실행하는 것과 같은 효과를 냅니다. 해당 컴퓨터는 데스크톱 앱에 로그인되어 있고 **Allow execution**이 켜져 있어야 합니다.

| | 클라우드 서버 | 내 기기에서 |
| - | - | - |
| 사용하는 환경과 파일 | 클라우드 서버의 프로젝트 사본과 프로젝트 환경 | 해당 컴퓨터의 환경과 프로젝트 폴더 |
| 사용 가능한 프로젝트 | 클라우드 프로젝트, 프로젝트에 속하지 않은 세션 | 해당 컴퓨터의 로컬 프로젝트, 프로젝트에 속하지 않은 세션 |
| 지원하는 Harness | 전체 | 현재는 Claude Code만 지원 |
| 컴퓨터가 꺼지거나 오프라인이 될 때 | 영향 없음 | 현재 작업이 일시 중지되고, 다시 연결되면 자동으로 재개 |

실행 위치는 세션을 만들 때 선택하며, 이후에는 변경할 수 없습니다. [클라우드 서버](https://docs.aihubmix.com/ko/cloud/environments/cloud-host.md)와 [내 기기에서 실행](https://docs.aihubmix.com/ko/cloud/environments/your-device.md)을 참고하세요.

## Harness와 모델

**Harness**는 에이전트를 실행하는 프레임워크로, Claude Code나 Codex CLI 등이 있습니다. **모델**은 Harness가 호출하는 대규모 언어 모델입니다. 세션에서 첫 메시지를 보낸 뒤에는 Harness를 변경할 수 없지만, 모델은 계속 변경할 수 있습니다. **추론 강도**(인터페이스에는 **Effort**로 표시)는 모델이 얼마나 깊이 생각할지를 설정합니다. 사용 가능한 단계는 모델마다 다릅니다. [모델 선택](https://docs.aihubmix.com/ko/cloud/models/choose-a-model.md)을 참고하세요.

## 모델 소스

**모델 소스**는 누가 모델을 제공하고 사용량이 어디에 집계되는지를 결정합니다.

| | Plus 모델 | 내 구독 | BYOK |
| - | - | - | - |
| 내용 | Plus 요금제에 포함된 모델 | 내 ChatGPT, Claude 등의 구독 계정 | 직접 추가한 API 키 |
| 사용량 집계 위치 | Plus 요금제, 추가 요금 없음 | 해당 구독 계정의 할당량 | 해당 프로바이더, 그 가격으로 청구 |

BYOK에서 AIHubMix는 일반 게이트웨이 프로바이더입니다. 직접 추가한 AIHubMix API 키는 다른 키와 같은 방식으로 청구되며 Plus와는 관계가 없습니다. [모델 소스](https://docs.aihubmix.com/ko/cloud/models/model-sources.md)를 참고하세요.

## 권한

**권한**은 에이전트가 작업을 수행하기 전에 사용자에게 묻는지 여부를 결정합니다. 입력창 왼쪽 아래에서 선택합니다.

* **Ask for approval**: 환경 밖의 파일을 수정하거나 인터넷에 접근하기 전에 항상 묻습니다.
* **Approve for me**: 안전하지 않을 수 있는 작업을 감지했을 때만 묻습니다.
* **Full access**: 인터넷과 클라우드 환경의 모든 파일에 제한 없이 접근합니다. 새 세션은 기본적으로 이 단계를 사용합니다.

권한은 세션 중 언제든지 변경할 수 있습니다.

## 입력 필요

에이전트가 명령 승인, 질문에 대한 답변, 시크릿 제공, 또는 로그인처럼 에이전트가 대신할 수 없는 일을 사용자가 완료하기를 기다리며 멈추면, 세션은 **입력 필요** 상태가 됩니다. 요청은 입력창 위에 표시되며, 사이드바에서도 세션에 표시가 붙습니다. 처리하면 세션이 자동으로 계속됩니다. [에이전트와 함께 작업하기](https://docs.aihubmix.com/ko/cloud/sessions/work-with-agent.md)를 참고하세요.

## 하위 에이전트

**하위 에이전트**는 에이전트가 같은 세션 안에서 작업의 일부를 병렬로 처리하도록 보내는 보조 에이전트입니다. 모두 끝나면 결과가 메인 세션으로 합쳐집니다. 오른쪽 패널에서 각 하위 에이전트의 과정을 볼 수 있지만, 하위 에이전트에게 직접 메시지를 보낼 수는 없습니다. 하위 에이전트는 직접 포크한 세션과 다릅니다. 포크하면 별도의 일반 세션이 만들어집니다. [하위 에이전트](https://docs.aihubmix.com/ko/cloud/sessions/subagents.md)를 참고하세요.

## 인터페이스 개요

* **아이콘 바**: 창 맨 왼쪽의 아이콘 열입니다. Cloud Tasks, Scheduled, Projects, Cloud servers, Activity 사이를 전환합니다. 아래쪽의 아바타를 클릭하면 계정 메뉴가 열립니다.
* **사이드바**: 세션 목록으로, Pinned, Cloud projects, Local projects, Recents로 그룹화됩니다.
* **세션 영역**: 창 가운데의 주 영역입니다. 사용자와 에이전트 사이의 메시지, 에이전트의 단계, 결과를 표시합니다.
* **입력창**: 세션 영역 아래쪽에 있습니다. 메시지를 보내고, 첨부 파일을 추가하고, 모델, 추론 강도, 권한을 선택합니다.
* **오른쪽 패널**: 변경 사항, 파일, 웹 미리보기, 클라우드 서버의 원격 데스크톱, 사이드 채팅, 하위 에이전트가 모두 여기에서 열립니다.

> [!NOTE]
>
> 모바일 웹에는 아이콘 바가 없습니다. 같은 항목이 사이드바 아래쪽에 있습니다. 오른쪽 패널을 열면 페이지 전체를 채웁니다.


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