> ## 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 クラウド VM 環境とローカルマシン連携方法のご案内。

xkat プラットフォームは、**追加のプログラムや仮想マシン（WSLやDockerなど）를 インストールすることなく**、ブラウザ上のクラウド VM およびサンドボックスで即座に演習を実行できます。

<Note>
  **Windows ユーザーへのお知らせ**: WSL（Windows Subsystem for Linux）や複雑な仮想化設定を自分でインストールする必要はなくなりました。すべての標準プログラミングレッスンはクラウド VM 上で安全に動作します。
</Note>

***

## 1. クラウド VM ＆ Web サンドボックス（基本）

ほとんどの入門・応用レッスン（Python、C/C++、Java、Rust、SQL、React など）は、**Web ブラウザにアクセスするだけで 100% 実行**されます。

* **自動接続**: レッスンに入ると、クラウド上の隔離サンドボックスが自動的に割り当てられます。
* **インストール不要**: OS（Windows、macOS、Linux）に関わらず、一貫した安全な演習環境を提供します。

***

## 2. ローカルエージェント連携（オプション演習専用）

ローカルハードウェア（Arduino/Raspberry Pi）や PC 上のアプリ（Blender、Sonic Pi、ローカル CLI ツール）と連携する専用演習の時のみ、以下の 1 行コマンドで自身の PC を接続します。

<Steps>
  <Step title="Node.js 18 以上の確認">
    お使いの端末で Node.js（v18 以上）がインストールされているか確認します。

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

  <Step title="xkat エージェントの実行">
    ターミナル（Windows CMD/PowerShell、macOS ターミナル、Linux Bash）で以下のコマンドを実行します。

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