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

# 내 기기에서 실행

> 클라우드 에이전트가 내 컴퓨터에서 세션을 실행하도록 합니다. 컴퓨터에 권한을 부여하고, 기기를 선택하여 세션을 시작하고, 민감한 위치에 대한 접근을 확인하고, 실행 기록을 보고, 연결 끊김과 기기 제거를 처리하는 방법을 설명합니다.

**내 기기에서 실행**은 클라우드 에이전트가 내 컴퓨터 중 한 대를 원격으로 제어하는 방식입니다. 에이전트는 해당 컴퓨터에서 로컬 환경과 파일을 사용하여 파일을 읽고 쓰고 명령을 실행하며, 로컬에서 실행하는 것과 같은 결과를 냅니다. 앱에서는 이 옵션을 **Run on your device**라고 부릅니다.

## 내 기기 또는 클라우드 서버 선택

각 세션은 시작할 때 실행 방식을 정합니다. 이후에는 변경할 수 없습니다.

| | 내 기기 | 클라우드 서버 |
| - | - | - |
| 작업이 이루어지는 곳 | 선택한 컴퓨터 | 내 [클라우드 서버](https://docs.aihubmix.com/ko/cloud/environments/cloud-host.md) |
| 사용하는 환경과 파일 | 해당 컴퓨터의 환경과 프로젝트 폴더 | 클라우드 서버의 프로젝트 사본과 프로젝트 환경 |
| 사용 가능한 프로젝트 | 해당 컴퓨터의 로컬 프로젝트, 또는 프로젝트에 속하지 않은 세션 | 클라우드 프로젝트, 또는 프로젝트에 속하지 않은 세션 |
| 지원하는 에이전트 | 현재는 Claude Code만 지원 | 전체 |
| 요구 사항 | 컴퓨터가 온라인 상태이고 **Allow execution**이 켜져 있음 | Plus 구독 |
| 컴퓨터가 꺼지거나 오프라인이 될 때 | 현재 작업이 일시 중지되고, 다시 연결되면 계속됨 | 영향 없음 |

노트북을 닫은 뒤에도 계속 실행되어야 하는 작업은 클라우드 서버를 선택하세요.

## 컴퓨터에서 세션을 실행하도록 허용

**1. 컴퓨터에서 데스크톱 앱에 로그인**

데스크톱 앱을 설치하고 같은 계정으로 로그인합니다. [다운로드 및 로그인](https://docs.aihubmix.com/ko/cloud/getting-started/install-and-sign-in.md)을 참고하세요. 로그인하면 컴퓨터가 워크스페이스에 자동으로 추가됩니다. 웹 앱에서는 기기가 추가되지 않습니다.

**2. 머신 세부 정보 열기**

**Settings › Workspace › Machines**로 이동하여 컴퓨터를 클릭합니다. 목록에는 각 머신의 운영 체제, 클라이언트 버전, 온라인 상태가 표시됩니다.

**3. Allow execution 켜기**

**Allow execution**을 켜고(컴퓨터의 경우 기본값은 꺼짐), 확인 대화 상자에서 어떤 제한이 완화되는지 검토합니다. 켜면 이후 이 컴퓨터에서 실행되는 모든 세션에 계속 적용됩니다.

**4. 필요에 따라 권한 부여 조정**

접근 범위, 민감한 위치, 권한 상한을 설정합니다. 저장하면 변경 사항이 새 세션에 바로 적용됩니다.

![머신 목록](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/machines.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=7e1df978d48ba5be7f5a7a9edeb30f68)

Settings › Workspace › Machines

머신 세부 정보에서 다음을 조정할 수 있습니다.

* **Access scope**: 프로젝트 폴더만, 선택한 폴더, 또는 컴퓨터 전체(기본값).
* **Sensitive locations**: SSH, 키체인, 시스템 구성 등입니다. 매번 묻기(기본값), 접근 차단, 접근 허용 중에서 선택합니다.
* **Permission limit**: 세션 권한은 이 상한을 넘을 수 없습니다. 제한 없음(기본값), Approve for me, Ask for approval 중에서 선택합니다.
* **Allowed secrets**: 이 컴퓨터에서 사용할 수 있는 워크스페이스 시크릿입니다. 기본값은 전체입니다.
* **Environment variable overrides**: 이 컴퓨터에서 실행할 때 재정의할 환경 변수입니다. 평문 시크릿은 여기에 넣지 마세요.

권한 부여를 완화하면 확인을 요청합니다. 강화할 때는 확인을 요청하지 않습니다. **Allow execution**을 끄면 이 컴퓨터를 사용하는 세션이 일시 중지됩니다. 명령은 이 컴퓨터에서 내 계정의 권한으로 실행됩니다.

> [!NOTE]
>
> 실행 권한 부여는 해당 컴퓨터의 데스크톱 앱에서만 변경할 수 있습니다. 다른 기기와 웹 앱에서는 보기만 할 수 있습니다.

## 기기를 선택하여 세션 시작

**1. 실행 환경 메뉴 열기**

새 세션 입력창 위에서 프로젝트 옆의 실행 환경 버튼을 클릭합니다.

**2. 기기 선택**

**Run on your device** 아래에서 컴퓨터를 선택합니다. 각 기기 아래에 접근 범위와 권한 상한이 표시됩니다.

**3. 작업 보내기**

작업을 작성하고 보냅니다. 세션이 시작되면 이 컴퓨터에서 계속 실행됩니다.

* 로컬 프로젝트는 기본적으로 프로젝트가 있는 컴퓨터를 사용합니다. 그 외에는 기본적으로 클라우드 서버를 사용합니다.
* 기기가 오프라인이거나, Allow execution이 꺼져 있거나, 프로젝트가 해당 기기에 없거나, 현재 에이전트가 Claude Code가 아니면 기기를 선택할 수 없습니다. 메뉴에 이유가 표시됩니다.
* 기기를 선택하면 해당 기기의 권한 상한보다 높은 권한은 선택할 수 없습니다.
* 다른 컴퓨터나 클라우드 서버로 바꾸려면 새 세션을 시작하세요.

세션이 어떤 컴퓨터에서 처음 실행될 때 Allow execution이 아직 켜져 있지 않거나 해당 컴퓨터에 프로젝트와 일치하는 폴더가 없으면, 그 컴퓨터의 클라이언트에 안내가 표시됩니다. **Open Machines & access**를 클릭하여 Allow execution을 켜거나, **Allow**를 클릭하고 프로젝트 폴더를 선택합니다(폴더는 클라우드에 동기화되지 않습니다). 프로젝트에 속하지 않은 세션은 자체 임시 폴더를 사용합니다.

## 민감한 위치에 대한 접근 확인

민감한 위치가 매번 묻기로 설정되어 있으면, 에이전트가 SSH 구성 같은 위치에 접근하기 전에 실행 중인 기기의 클라이언트에 이유와 경로가 표시됩니다.

* **Allow once**: 머신 권한 부여를 변경하지 않고 이번 한 번만 허용합니다.
* **Deny**: 허용하지 않습니다. 일정 시간 응답하지 않으면 거부한 것으로 처리됩니다.
* **Respond later**: 안내를 잠시 숨기며, 사이드바에서 세션에 확인이 필요하다는 표시가 붙습니다.

## 실행 기록 보기

실행 환경 메뉴 아래쪽의 **Execution log**를 클릭하면 이 세션의 동작을 볼 수 있습니다. 머신 세부 정보에서 **View execution log**를 클릭하면 이 컴퓨터에서 실행된 모든 세션의 동작을 볼 수 있습니다. 기록의 각 줄에는 에이전트가 한 일, 대상, 결과가 표시됩니다.

실행 중인 기기의 클라이언트에서는 프로세스를 중지하거나, 연결을 끊거나, 즉시 다시 연결할 수도 있습니다. 다른 곳에서는 보기만 할 수 있습니다.

## 컴퓨터 연결이 끊기면

컴퓨터가 꺼지거나, 절전 모드로 전환되거나, 오프라인이 되거나, 클라이언트를 종료하면 현재 작업이 일시 중지됩니다. 연결이 돌아오면 멈춘 지점부터 자동으로 계속되며, 완료된 동작은 반복되지 않습니다. **Reconnect**를 클릭할 수도 있습니다. 다른 기기와 웹 앱에서는 세션에 기기 오프라인 표시가 붙습니다.

기기가 오프라인이 되어도 세션은 클라우드 서버로 자동으로 옮겨지지 않습니다. 연결 문제는 [FAQ 및 문제 해결](https://docs.aihubmix.com/ko/cloud/reference/troubleshooting.md)을 참고하세요.

## 기기 제거

머신 세부 정보 아래쪽의 **Remove device**를 클릭하고 확인합니다.

> [!WARNING]
>
> 제거하면 기기의 연결이 즉시 끊기고, 해당 기기를 사용하던 세션이 중단됩니다. 나중에 이 컴퓨터를 다시 사용하려면 해당 컴퓨터에서 다시 로그인하세요.

클라우드 서버는 제거할 수 없습니다. 현재 사용 중인 컴퓨터는 여기에서 제거할 수 없으며, 제거하려면 계정에서 로그아웃하세요.


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