> ## 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-cli：Agent 与 Lab

> 将浏览器连接到本机（Agent），或使用隔离的 Ubuntu 练习环境（Lab）。

**xkat-cli** 是 xkat 的命令行包。一个 `xkat` 命令提供 **两种工具**，请勿混淆。

| 工具        | 命令                            | 用途                     |
| :-------- | :---------------------------- | :--------------------- |
| **Agent** | `xkat up` · `status` · `down` | 将浏览器工作区连接到 **本机**      |
| **Lab**   | `xkat lab …`                  | 课程用隔离 **Ubuntu 24.04** |

<CardGroup cols={2}>
  <Card title="下载页" icon="download" href="https://xkat.space/zh/download">
    在 [xkat.space/download](https://xkat.space/zh/download) 获取桌面版与 CLI
  </Card>

  <Card title="在 npm 查看" icon="npm" href="https://www.npmjs.com/package/xkat-cli">
    npm 上的 xkat-cli
  </Card>
</CardGroup>

***

## 安装

```bash theme={null}
npx xkat-cli@latest
npm install -g xkat-cli
```

需要 **Node.js 18+**。参见[本地环境](/zh/learn/workspace/local-setup)。**桌面应用**的 **Tools** 菜单也可运行相同命令。

***

## 1) Agent

用 **Agent** 将 [Dynamic Workspace](/zh/learn/workspace/overview) 连到本机。

### 功能

<CardGroup cols={2}>
  <Card title="本地 Shell" icon="terminal">
    Web 终端 ↔ 本机 shell
  </Card>

  <Card title="文件同步" icon="arrows-rotate">
    工作目录与 Web 同步
  </Card>

  <Card title="仅 localhost" icon="shield-check">
    <code>127.0.0.1:10022</code>
  </Card>

  <Card title="后台运行" icon="bolt">
    <code>xkat up</code>
  </Card>
</CardGroup>

### 命令

```bash theme={null}
xkat up
xkat status
xkat down
```

```bash theme={null}
npx xkat-cli@latest up
```

### 安全

* 仅本机端口
* 仅官方域名可连接
* `~/.xkat/agent.log`

***

## 2) Lab

面向 Linux、网络与 Agent 课程的 **Ubuntu 24.04**。无需自行配置虚拟机。

### 命令

```bash theme={null}
xkat lab install
xkat lab up
xkat lab shell
xkat lab stop
xkat lab delete
xkat lab status
xkat lab doctor
xkat lab reset
```

### 典型流程

1. `xkat lab install`
2. `xkat lab up`
3. `xkat lab shell`
4. `xkat lab stop` / `xkat lab delete`

### Agent vs Lab

| 检查    | 命令                |
| :---- | :---------------- |
| Agent | `xkat status`     |
| Lab   | `xkat lab status` |

***

## 桌面应用

从[下载页](https://xkat.space/zh/download)安装。安装包路径为 `…/desktop/v{version}/…`。标题栏 **Tools** 可运行 Agent/Lab。登录：系统浏览器 → `xkat://` → `https://xkat.space/api/auth/desktop/complete`。

***

## 与云端工作区的关系

|      | Cloud                                        | Agent      | Lab                  |
| :--- | :------------------------------------------- | :--------- | :------------------- |
| 设置   | [zero-setup](/zh/learn/workspace/zero-setup) | `xkat up`  | `xkat lab install`   |
| 运行位置 | xkat cloud                                   | host OS    | Ubuntu VM            |
| 适合   | quick start                                  | host tools | Linux / net / agents |

***

## 更多

* [下载](https://xkat.space/zh/download)
* [本地环境](/zh/learn/workspace/local-setup)
* [npm: xkat-cli](https://www.npmjs.com/package/xkat-cli)