> ## 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에서 **세션**을 시작하는 곳입니다. 프로젝트와 실행 환경을 선택하고, 입력창에 하려는 작업을 적어 보냅니다. 세션이 생성되고 에이전트가 작업을 시작합니다. 이미 시작한 세션에서 요구 사항을 추가하려면 [입력창](https://docs.aihubmix.com/ko/cloud/sessions/composer.md)을 참고하세요.

## 적용 범위

| 형태 | 지원 | 비고 |
| - | - | - |
| 데스크톱 앱 | 지원 | |
| 웹 앱 | 지원 | **Run on your device** 도 선택할 수 있습니다. 기기의 실행 권한은 해당 기기의 앱에서만 변경할 수 있습니다 |
| 모바일 웹 | 지원 | |

## 진입 방법

* 사이드바의 **New chat** 버튼 또는 `⌘N`.
* `⌥⌘O`: **No project** 가 선택된 상태로 새 채팅 페이지를 엽니다.
* 사이드바에서 프로젝트 행에 마우스를 올리면 나타나는 **＋** 또는 프로젝트 페이지의 **New task in this project**: 해당 프로젝트가 미리 선택된 상태로 새 채팅 페이지를 엽니다.

Windows에서는 `⌘` 를 `Ctrl` 로, `⌥` 를 `Alt` 로 바꿔 사용합니다(아래도 동일합니다).

## 새 채팅 페이지 구성

| 영역 | 비고 |
| - | - |
| 인사말 | **What’s on your mind?** 같은 짧은 문장입니다. 안내용일 뿐입니다 |
| 태그 표시줄 | 프로젝트 버튼과 실행 환경 버튼입니다. 첫 메시지를 보내기 전에만 표시됩니다 |
| 입력창 | 왼쪽 아래에 권한, 오른쪽 아래에 모델과 추론 강도, 전송이 있습니다. [입력창](https://docs.aihubmix.com/ko/cloud/sessions/composer.md)을 참고하세요 |
| 안내 문구 | Plus가 있지만 클라우드 서버가 현재 실행 중이 아닐 때 **No cloud server is running yet… we’ll guide you through setup when you create a project or send a message.** 가 표시됩니다 |

세션은 프로젝트의 현재 작업 디렉터리에서 시작됩니다. 새 채팅 페이지에는 브랜치 선택이 없습니다.

## 사용 단계

1. **New chat** 을 클릭합니다. 프로젝트는 기본적으로 **No project** 입니다.
2. (선택 사항) 프로젝트를 선택합니다.
3. (선택 사항) 실행 환경을 선택합니다: **Cloud server** 또는 **Run on your device** 아래의 기기.
4. (선택 사항) 권한, 모델, 추론 강도를 조정합니다.
5. 하려는 작업을 적은 다음(첨부 파일만 보낼 수도 있습니다) `Enter` 를 눌러 보냅니다(줄바꿈은 `Shift+Enter`).
6. 세션이 사이드바에 나타납니다. 세션이 생성되면 세션 페이지로 자동 이동하고 에이전트가 작업을 시작합니다.

처음으로 **Full access** 로 보내거나 처음으로 클라우드 서버에서 보낼 때는 먼저 확인 창이 나타날 수 있습니다. 아래 "전송 전 확인"을 참고하세요.

## 프로젝트 선택

프로젝트 버튼(`⌥⇧⌘O`)을 클릭하면 메뉴가 열립니다. 프로젝트를 검색하거나, 프로젝트를 선택하거나, **New project** 또는 **No project** 를 선택할 수 있습니다. 새 채팅 페이지에서는 `⌥⌘1`–`⌥⌘9` 로 1–9번 프로젝트를 바로 선택할 수도 있습니다.

* 각 프로젝트 아래에는 GitHub 저장소 이름이나 **Local · folder name** 같은 소스 텍스트가 한 줄 표시됩니다. 설정이 완료되지 않은 프로젝트에는 **Setting up · not ready yet** 이 표시됩니다.
* 다른 컴퓨터의 로컬 프로젝트도 선택할 수 있으며, 세션은 해당 기기에서 실행됩니다. 해당 기기가 오프라인이면 **Device offline** 으로 표시됩니다.
* 새 채팅 페이지는 마지막으로 선택한 프로젝트를 기억하지 않습니다. **New chat** 을 클릭할 때마다 **No project** 로 돌아갑니다.

### 프로젝트 없음

**No project** 세션은 프로젝트에 연결되지 않습니다. 임시 작업 디렉터리에서 실행되며, 질의응답, 스크립트 작성, 자료 정리 같은 작업에 적합합니다. 사이드바의 **Chats** 그룹에 표시되며 나중에 프로젝트로 옮길 수 있습니다. [메시지 및 세션 작업](https://docs.aihubmix.com/ko/cloud/sessions/messages.md)을 참고하세요.

## 실행 환경 선택

**실행 환경**은 에이전트가 어느 머신에서 파일을 읽고 쓰며 명령을 실행할지를 결정합니다. 에이전트 자체는 항상 클라우드에서 실행됩니다.

| 실행 방식 | 인터페이스 표시 | 의미 |
| - | - | - |
| **Cloud server** | **Cloud server** | 전부 내 클라우드 서버에서 실행되며 내 컴퓨터는 관여하지 않습니다 |
| **On your device** | **Run on your device** 아래의 기기 | 클라우드의 에이전트가 해당 컴퓨터를 원격으로 제어하고, 그 컴퓨터의 환경과 파일로 실행합니다 |

* 기본값은 **Cloud server** 입니다. 로컬 프로젝트는 프로젝트가 있는 기기에서 실행되는 것이 기본입니다.
* 선택할 수 없는 기기는 회색으로 비활성화되며 이유(**Device offline**, **Execution disabled** 등)가 표시됩니다.
* 실행 기기는 세션을 만들 때 정해지며 이후에 바꿀 수 없습니다. 다른 기기를 사용하려면 새 세션을 만드세요.

기본값 규칙, 기기를 선택할 수 없는 이유, 기기 권한 부여, 실행 로그는 [실행 환경](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)을 참고하세요.

## 권한 선택

**권한**은 에이전트가 작업 전에 나에게 물어볼지를 결정합니다. 입력창 왼쪽 아래의 권한 버튼(`Ctrl+Shift+S`)을 클릭합니다.

| 옵션 | 설명 |
| - | - |
| **Ask for approval** | 환경 밖에서 편집하거나 인터넷을 사용하기 전에 항상 묻습니다 |
| **Approve for me** | 안전하지 않을 수 있다고 감지된 작업만 묻습니다 |
| **Full access** | 클라우드 환경 안에서 인터넷과 파일에 제한 없이 접근합니다 |

* 새 세션의 기본값은 **Full access** 입니다. 새 세션은 매번 기본값에서 시작하며 마지막 선택을 기억하지 않습니다.
* 기기에서 실행할 때는 권한이 기기의 권한 상한을 넘을 수 없으며, 상한을 넘는 수준은 회색으로 비활성화됩니다. 상한은 해당 기기의 앱에 있는 **Machines & access** 에서 변경합니다.
* 이미 시작한 세션에서도 언제든 권한을 변경할 수 있습니다. 복구 작업과 보관된 세션은 변경할 수 없습니다.
* 승인 요청을 처리하는 방법은 [입력 필요](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)를 참고하세요.

### 전체 액세스 켜기 확인

기기에서 실행하면서 **Full access** 로 전환하면 **Turn on full access?** 가 나타납니다. 에이전트가 동의를 구하지 않고 명령을 실행하고, 인터넷에 접근하고, 모든 파일을 만들고 수정할 수 있게 된다고 설명하며, 민감한 데이터의 손실 또는 유출, 프롬프트 인젝션 등의 위험을 안내합니다(에이전트가 이 프로젝트의 모든 시크릿을 읽을 수 있다는 점 포함). **Confirm** 을 클릭해야만 전환됩니다. **Cancel** 을 클릭하거나 `Esc` 를 누르면 원래 권한이 유지됩니다.

## 모델과 추론 강도 선택

입력창 오른쪽 아래에 모델 버튼과 추론 강도 버튼이 있습니다. 새 세션은 계정의 기본 선택 또는 마지막으로 세션을 만들 때의 선택을 사용합니다. 자세한 내용은 [Harness 및 모델](https://docs.aihubmix.com/ko/cloud/models/harness-and-models.md)을 참고하세요.

## 전송 전 확인

아래 대화 상자는 처음에만 나타납니다. 어느 대화 상자에서든 **Cancel** 을 클릭하면 메시지가 전송되지 않으며, 텍스트와 첨부 파일은 입력창에 그대로 남습니다.

### 기본 전체 액세스(전체 액세스로 처음 보낼 때)

**Full access by default** 대화 상자는 에이전트가 명령 실행, 의존성 설치, 클라우드 환경의 파일 수정, 인터넷과 연결된 서비스 접근, 이 프로젝트의 모든 시크릿 읽기를 할 수 있다고 설명합니다. 또한 입력창 왼쪽 아래에서 언제든 **Ask for approval** 또는 **Approve for me** 로 전환할 수 있다고 안내합니다. **Got it, start the task** 를 클릭하면 전송되며, 이 대화 상자는 다시 나타나지 않습니다.

### 클라우드 서버 관리자 권한(클라우드 서버에서 처음 보낼 때)

클라우드 서버 관리자 권한이 켜져 있으면, 클라우드 서버에서 처음 세션을 시작할 때 **Turn on admin access on cloud server** 가 나타나며 다음을 안내합니다.

* 에이전트가 클라우드 서버에서 관리자 권한을 가지며, 클라우드 서버에 저장된 자격 증명을 읽을 수 있습니다.
* 승인과 브랜치 제한은 권장 사항일 뿐이며 더 이상 강제되지 않습니다.
* 끄더라도 이미 적용된 변경은 되돌려지지 않습니다. 시스템 파일을 실수로 수정하면 클라우드 서버를 다시 빌드해야 할 수 있습니다.

**Got it, start the task** 를 클릭하면 전송되고 다시 묻지 않습니다. 관리자 권한을 켜거나 끄려면 [클라우드 서버 관리자 권한](https://docs.aihubmix.com/ko/cloud/cloud-host/admin-permission.md)을 참고하세요.

## 규칙과 상태

| 상황 | 표시되는 내용 | 할 수 있는 작업 |
| - | - | - |
| Plus 요금제 없음 | 고정 응답 + 업그레이드 카드 | **Upgrade** 를 클릭해 구독합니다. 구독하면 메시지가 자동으로 전송됩니다. [Plus 없이 보내기](https://docs.aihubmix.com/ko/cloud/plus/without-plus.md)를 참고하세요 |
| 구독했지만 클라우드 서버가 아직 준비되지 않음 | 클라우드 서버 설정 / 복원 안내 | 준비되면 전송이 자동으로 재개됩니다 |
| 세션 생성 실패 | 메시지가 **Not sent: reason** 으로 표시됩니다 | **Retry** 를 클릭합니다 |
| 세션은 생성되었지만 첨부 파일 업로드 실패 | 첨부 파일은 **The chat was created, but attachments failed to upload…** 메시지와 함께 입력창에 남습니다 | 첨부 파일에서 다시 시도를 클릭한 다음 전송합니다 |
| 선택한 기기에서 실행을 허용하지 않았거나, 해당 기기에 프로젝트와 연결된 폴더가 아직 없음 | 해당 기기의 데스크톱 앱에 대화 상자가 나타납니다 | 안내에 따라 켜거나 폴더를 선택합니다. [실행 환경](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)을 참고하세요 |

그 밖의 오류는 [오류 및 복구](https://docs.aihubmix.com/ko/cloud/sessions/errors-and-recovery.md)를 참고하세요.

## 자주 묻는 질문

### 새 채팅 페이지를 열면 왜 항상 No project인가요?

새 채팅 페이지는 마지막으로 선택한 프로젝트를 기억하지 않습니다. 사이드바 프로젝트 행의 **＋** 또는 프로젝트 페이지의 **New task in this project** 를 사용하세요. 그러면 프로젝트가 자동으로 미리 선택됩니다.

### 클라우드 서버에서 실행하는 것과 내 기기에서 실행하는 것은 어떻게 다른가요?

두 경우 모두 에이전트는 클라우드에서 실행됩니다. **Cloud server** 를 사용하면 명령과 파일이 클라우드 서버에 있으며, 컴퓨터를 꺼도 세션이 계속됩니다. 기기를 사용하면 그 기기가 온라인 상태이고 실행이 허용되어 있어야 합니다.

### 내 컴퓨터를 선택했는데 Full access가 왜 회색으로 비활성화되어 있나요?

해당 기기에 더 낮은 권한 상한이 설정되어 있습니다. 해당 기기의 앱에서 상한을 올리세요.

### 세션을 시작한 후 다른 기기로 바꿀 수 있나요?

아니요. 다른 기기를 사용하려면 새 세션을 만드세요.

## 관련 문서

* [입력창](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/errors-and-recovery.md)
* [실행 환경](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)
* [Harness 및 모델](https://docs.aihubmix.com/ko/cloud/models/harness-and-models.md)
* [Plus 없이 보내기](https://docs.aihubmix.com/ko/cloud/plus/without-plus.md)
* [클라우드 서버 관리자 권한](https://docs.aihubmix.com/ko/cloud/cloud-host/admin-permission.md)


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