# 安装与快速上手

> 用 npm 安装 nsq（或用 npx 试用），然后用五条命令启动智能体并打开仪表盘。

Source: https://docs.neurosquad.ai/zh/cli/install

## 环境要求

- **Node.js 22.13 或更新版本**（[nodejs.org](https://nodejs.org)）。
- **Windows**（x64、arm64）、**macOS**（Apple 芯片、Intel）或 **Linux**（x64、arm64）。原生组件均已预编译——无需编译器。
- 至少一个你已经在用并已登录的智能体 CLI：Claude Code、Codex CLI 或 OpenCode。nsq 负责启动它们，但不负责安装。
- `PATH` 中有 `curl`（Claude Code 和 Codex 通过它上报状态）。Windows 10 及更新版本、macOS 和大多数 Linux 发行版都自带。

## 安装

```sh
npm install -g neurosquad      # 然后运行：nsq
npx neurosquad                 # 或者不安装直接试用
```

命令名是 `nsq`。用 `nsq doctor` 检查安装：它会列出找到的智能体 CLI、守护进程、`curl`、终端以及 OpenRouter 密钥。

> 包管理器和一行安装脚本会在 npm 发布之后上线：Homebrew（`brew install glmn-ai/neurosquad/neurosquad-cli`）、Scoop（`scoop bucket add neurosquad https://github.com/glmn-ai/scoop-neurosquad`，然后 `scoop install neurosquad-cli`），以及使用你自己 npm 的安装脚本。在它们上线之前，请使用 npm。

## 快速上手

**1. 让一个智能体开始一项任务**

```sh
nsq run claude "fix the flaky checkout test" --worktree
```

`--worktree` 给这个智能体一个独立的分支和检出目录，这样多个智能体可以在同一个仓库里工作而互不干扰。

**2. 再启动一个**

```sh
nsq run codex --name reviewer
```

**3. 或者任意命令**

```sh
nsq run -- npm run dev
```

**4. 打开仪表盘**

```sh
nsq
```

一个实时终端网格。当某个智能体需要你时，它的格子会亮起并显示问题；按 `y`、`a` 或 `n` 回答，按 `Enter` 全屏打开，按 `q` 退出——智能体会继续运行。

**5. 在任何地方查看它们**

```sh
nsq ls
```

在任意终端里查看每个智能体的状态、待回答的问题和花费。

智能体在当前文件夹中启动。下一步：[仪表盘与按键](https://docs.neurosquad.ai/zh/cli/dashboard)。