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

# 실습 및 로컬 환경 안내

> xkat 클라우드 실습 환경과 로컬 머신 연동 방법 안내.

xkat 플랫폼은 **별도의 프로그램이나 가상 머신(WSL/Docker 등)을 설치하지 않고도** 브라우저에서 클라우드 VM 및 샌드박스를 통해 즉시 실습을 진행할 수 있도록 지원합니다.

<Note>
  **Windows 사용자 참고**: 더 이상 WSL(Windows Subsystem for Linux)이나 복잡한 가상화 프로그램을 직접 설치하실 필요가 없습니다. 모든 표준 언어 실습은 클라우드 VM에서 안전하게 작동합니다.
</Note>

***

## 1. 클라우드 VM & 웹 샌드박스 (기본)

대부분의 입문 및 심화 강좌(Python, C/C++, Java, Rust, SQL, React 등)는 **웹 브라우저 접속 즉시 100% 실행**됩니다.

* **자동 연결**: 강좌에 진입하면 클라우드 격리 샌드박스가 자동으로 할당됩니다.
* **설치 제로**: 내 컴퓨터의 OS(Windows, macOS, Linux)와 상관없이 동일하고 안전한 실습 환경을 제공합니다.

***

## 2. 로컬 에이전트 연동 (선택 강좌 전용)

로컬 하드웨어(아두이노/라즈베리파이)나 내 컴퓨터의 특정 앱(Blender, Sonic Pi, 터미널 도구)과 연동하는 실습 강좌를 진행할 때만 아래 1줄 명령어로 내 컴퓨터를 연결합니다.

<Steps>
  <Step title="Node.js 18 이상 확인">
    내 컴퓨터 터미널에서 Node.js(v18 이상)가 설치되어 있는지 확인합니다.

    ```bash theme={null}
    node -v
    ```
  </Step>

  <Step title="xkat 에이전트 실행">
    터미널(Windows CMD/PowerShell, macOS Terminal, Linux Bash)에서 아래 명령어를 실행하면 플레이어와 자동 연동됩니다.

    ```bash theme={null}
    npx xkat-cli@latest up
    ```
  </Step>
</Steps>