---
title: "Руководство по установке для AI Agent"
description: "Руководство по установке и настройке NocoBase CLI, ориентированное на AI Agent. Содержит полные шаги по проверке окружения, установке, инициализации и валидации."
keywords: "NocoBase CLI,AI Agent,установка,Claude Code,Codex,Cursor,Skills"
sidebar: false
---

# Руководство по установке для AI Agent

Эта страница — руководство по установке и инициализации NocoBase CLI, ориентированное на AI Agent (например, Claude Code, Codex, Cursor, Copilot и т. д.).

Если Вы человек, обратитесь к разделу [Быстрый старт](./quick-start.md).

## Шаг 1. Проверьте предварительные требования

Убедитесь, что у пользователя установлены следующие зависимости:

- **Node.js >= 22** (проверьте командой `node -v`)
- **Yarn 1.x** (проверьте командой `yarn -v`). Если не установлен — установите через `npm install -g yarn`
- **Git** (проверьте командой `git --version`). Если не установлен — установите с [официального сайта Git](https://git-scm.com/)
- **Docker** (если пользователь хочет установить NocoBase через Docker). Проверьте командой `docker -v`. Если не установлен и пользователю нужен Docker — направьте его на [официальный сайт Docker](https://www.docker.com/get-started/) для установки, иначе пропустите.

Если предварительные требования не выполнены, сообщите пользователю, что необходимо сначала установить недостающие зависимости, и предоставьте ссылки и краткие инструкции по установке. После того как все требования выполнены, переходите к следующему шагу — установке CLI.

## Шаг 2. Установите CLI

Если в окружении пользователя уже установлен NocoBase CLI (проверьте командой `nb --version`), переходите к следующему шагу. Если нет — выполните следующую команду для установки:

```bash
npm install -g @nocobase/cli
```

Запустите `nb --version`, чтобы убедиться в успешной установке.

## Шаг 3. Запустите команду инициализации

**⚠️ Важно: Вы обязаны выполнить именно эту команду без изменений, замен или удаления параметра `--ui`. Не пытайтесь "ускорить" процесс, переходя в "неинтерактивный режим" или собирая параметры самостоятельно — `--ui` это единственно правильный способ инициализации.**

```bash
nb init --ui
```

Эта команда запустит визуальный мастер в браузере. Пользователь должен выполнить всю настройку именно в браузере (включая способ установки, базу данных, учётную запись администратора и т. д.). Ваша задача как AI Agent:

1. **Запустить только `nb init --ui`**, без каких-либо дополнительных параметров
2. **Сообщить пользователю**, что в браузере автоматически откроется локальная страница настройки, которую необходимо заполнить
3. **Если браузер не открывается автоматически** (например, из-за ограничений песочницы) — передайте пользователю URL из вывода команды, чтобы он скопировал его в браузер вручную
4. **Дождитесь подтверждения** от пользователя, что настройка завершена, прежде чем переходить к следующему шагу. По умолчанию у этой команды таймаут 30 минут — в течение этого времени не запускайте команду повторно.

## Шаг 4. Проверьте результат

```bash
nb env list
```

Убедитесь, что в выводе присутствует настроенное окружение и его статус выполнения. Затем напомните пользователю, что он может открыть URL запущенного экземпляра NocoBase и войти с заданными логином и паролем.

## Шаг 5. Завершение

Сообщите пользователю, что установка завершена. Конфигурация CLI хранится в глобальном каталоге (по умолчанию `~/.nocobase/`), и AI Agent может обращаться к ней из любого каталога — переход в специальный рабочий каталог не требуется.
