> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 컴퓨터 및 터미널

> 클라우드 머신, 로컬 기기, 공유 터미널 세션.

컴퓨터는 코드를 실행하는 머신입니다. Space는 클라우드 머신(온디맨드로 생성, Space당 하나), 클라우드 브라우저, Kazzle 앱이 설치된 자신의 기기를 가질 수 있습니다. AI는 셸 명령, 파일 작업, 터미널 세션, 브라우저 자동화에 사용합니다.

## 컴퓨터 유형

| 유형        | 기능                     | 용도                                          |
| --------- | ---------------------- | ------------------------------------------- |
| 클라우드 머신   | 셸, 터미널, 파일             | 코딩, 스크립트, 빌드, 앱 개발. 파일은 중지 및 재시작 후에도 유지됨.   |
| 클라우드 브라우저 | 브라우저                   | 스크래핑, 자동화, 로그아웃 상태 브라우징                     |
| 자신의 기기    | 데스크톱, 터미널, 브라우저(온라인 시) | Kazzle을 실행 중인 컴퓨터. 기본 제공 브라우저 및 확장 프로그램 지원. |
| 프로덕션      | 시작, 중지, 로그만 가능         | 배포된 앱. 셸, 파일, 브라우저 접근 불가.                   |

## 클라우드 머신 지속성

클라우드 머신 파일은 정상적인 중지 및 재시작 사이클에서 유지됩니다. 파일, 설치된 패키지, 도구는 그대로 유지됩니다. 클라우드 머신은 일회용 컨테이너가 아닌 지속적인 개발 환경입니다.

## 라이프사이클

1. **기존 컴퓨터 확인.** AI는 사용 가능한 컴퓨터를 미리 확인합니다.
2. **필요시 생성.** AI는 온디맨드로 클라우드 머신 또는 클라우드 브라우저를 생성합니다.
3. **오프라인 시 재시작.** 클라우드 머신은 재시작 및 중지 가능하며, 클라우드 브라우저와 자신의 기기는 다르게 시작됩니다.
4. **준비 완료.** 재시작되면 모든 도구를 사용할 수 있습니다.

## 셸 명령

AI는 빌드, 설치, git 작업, 스크립트를 위해 셸 명령을 실행합니다. 명령은 클라우드 머신의 지속적인 파일시스템에서 실행됩니다.

규칙:

* AI는 셸 데이터베이스 클라이언트보다 데이터베이스 도구를 선호합니다.
* 앱 및 리포지토리 파일 작업은 해당 workspace로 범위가 지정됩니다.
* 파괴적인 패턴은 [도구 정책](/security/tool-policies)으로 감지됩니다.

## 터미널

터미널은 사용자와 AI 간에 공유되는 지속적인 셸 세션입니다. AI는 장기 실행 프로세스(개발 서버, 빌드, 감시자)를 위해 생성합니다. 수동으로 열 수도 있습니다.

양쪽 모두 실시간으로 동일한 터미널을 봅니다:

* AI가 `npm install`을 실행합니다. 출력을 봅니다.
* 명령을 입력합니다. AI가 출력을 읽을 수 있습니다.
* AI가 개발 서버를 시작합니다. 상호작용할 수 있습니다.

AI가 앱을 시작하면 개발 서버는 터미널에서 실행됩니다. 출력을 읽어 오류를 확인할 수 있으며, AI는 빌드 실패를 감지하기 위해 모니터링합니다.

## 파일시스템

앱 및 리포지토리 파일의 경우 AI는 workspace 루트를 벗어날 수 없는 범위가 지정된 파일 작업을 사용합니다. 원본 파일시스템 접근의 경우 셸 명령을 사용합니다.