> ## 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 平台支持您直接在浏览器中通过云端 VM 和沙箱进行实操，**无需安装额外的程序或虚拟机（如 WSL 或 Docker）**。

<Note>
  **Windows 用户提示**：您不再需要手动安装 WSL（Windows Subsystem for Linux）或复杂的虚拟化软件。所有标准编程课程均在云端 VM 中安全运行。
</Note>

***

## 1. 云端 VM 与 Web 沙箱（默认）

大多数入门及高级课程（Python、C/C++、Java、Rust、SQL、React 等）**均可在 Web 浏览器中 100% 直接运行**。

* **自动连接**：进入课程后，系统会自动分配隔离的云端沙箱。
* **零安装**：无论使用何种操作系统（Windows、macOS、Linux），均提供一致且安全的实操环境。

***

## 2. 本地 Agent 连接（仅限特定实操）

仅当课程需要与本地硬件（Arduino/树莓派）或本地应用（Blender、Sonic Pi、本地 CLI 工具）交互时，才需要运行以下单行命令连接您的计算机。

<Steps>
  <Step title="检查 Node.js 18+">
    确保您的计算机上已安装 Node.js（18 或更高版本）：

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

  <Step title="运行 xkat Agent">
    在终端（Windows CMD/PowerShell、macOS Terminal 或 Linux Bash）中运行以下命令：

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