Быстрый старт

## 1. Ключ API Создай ключ в консоли: [chat.waibee.com/api-keys](https://chat.waibee.com/api-keys). Затем сохрани его одним из способов. Через встроенную команду (ключ ляжет в системный keychain): ```bash frame="terminal" waibee config set-api-key ``` Либо переменной окружения: ```bash frame="terminal" export WAIBEE_API_KEY="sk_live_..." ``` ## 2. Интерактивный режим Запусти `waibee` без аргументов в каталоге проекта. Откроется TUI: пиши задачу обычным языком, агент читает файлы, предлагает правки и запускает команды. ```bash frame="terminal" cd my-project waibee ``` При первом запуске откроется короткий тур по интерфейсу. Пройти его заново можно в любой момент командой `/guide`. ## 3. Что настроить сразу Всё это команды внутри TUI. Полный список открывает `/help`, меню команд появляется по вводу `/`. | Команда | Зачем | |---|---| | `/guide` | Тур по интерфейсу. Возвращайся к нему, когда что-то забылось | | `/lang en` или `/lang ru` | Язык интерфейса. По умолчанию берётся из локали системы | | `/model` | Выбор модели, см. [Выбор модели](/code/models/) | | `/effort` | Уровень рассуждений: от `none` до `xhigh`, набор зависит от модели | | `/sandbox` | Ограничить, куда могут писать команды агента, см. [Права доступа](/code/permissions/) | | `/settings` | Настройки: поиск в вебе, песочница, приватность. `/advanced` открывает расширенные | | `/status` | Состояние сессии: модель, окно контекста, израсходованные токены | Ещё три вещи, которые пригодятся с первых минут: - **Shift+Tab** переключает режим подтверждений: спрашивать перед каждой правкой, применять правки автоматически или доверять и правкам, и командам. Текущий режим виден в нижней панели, подробности в [Правах доступа](/code/permissions/). - **`@`** прикрепляет к запросу файл или картинку, **Esc** прерывает текущий ход, **↑** возвращает предыдущее сообщение для правки. - **`/compact`** сжимает разговор, когда окно контекста заполнилось, см. [Окно контекста](/code/context-window/). Дальше по мере надобности: [`/goal`](/code/goal/) заставляет агента работать до выполнения условия, `/steer` дописывает указание не прерывая работу, `/sessions` и `/resume` возвращают к прошлым разговорам. Полный справочник: [Команды](/code/commands/). ## 4. То же самое в браузере Одна команда, и текущая работа открывается в браузере: дифф, дерево файлов, терминал. ```bash frame="terminal" waibee serve ``` Открой напечатанную ссылку. Дифф с подсветкой, комментарий к строкам, который уходит агенту, несколько сессий сразу. Отдельная кнопка открывает то же самое с телефона по QR-коду. Подробно: [Веб-интерфейс](/code/web/). ## 5. Headless-режим Разовый запуск с промптом, без интерфейса: ```bash frame="terminal" waibee run "добавь тесты к модулю auth" ``` Результат уходит в stdout, поэтому агента можно вызывать из скриптов, git-хуков, CI и других программ. Форматы вывода, коды возврата и готовые сценарии: [Headless-режим и автоматизация](/code/headless/). ## 6. IDE и терминальные клиенты Waibee Code подключается к редакторам по Agent Client Protocol (Zed, JetBrains и другие), см. [IDE (ACP)](/code/ide/). Тот же протокол работает из командной строки через acpx: сессии между вызовами и JSON-вывод для скриптов, см. [ACP в терминале](/code/acpx/).

1. Ключ API

Создай ключ в консоли: chat.waibee.com/api-keys. Затем сохрани его одним из способов.

Через встроенную команду (ключ ляжет в системный keychain):

waibee config set-api-key

Либо переменной окружения:

export WAIBEE_API_KEY="sk_live_..."

2. Интерактивный режим

Запусти waibee без аргументов в каталоге проекта. Откроется TUI: пиши задачу обычным языком, агент читает файлы, предлагает правки и запускает команды.

cd my-project
waibee

При первом запуске откроется короткий тур по интерфейсу. Пройти его заново можно в любой момент командой /guide.

3. Что настроить сразу

Всё это команды внутри TUI. Полный список открывает /help, меню команд появляется по вводу /.

Команда	Зачем
`/guide`	Тур по интерфейсу. Возвращайся к нему, когда что-то забылось
`/lang en` или `/lang ru`	Язык интерфейса. По умолчанию берётся из локали системы
`/model`	Выбор модели, см. Выбор модели
`/effort`	Уровень рассуждений: от `none` до `xhigh`, набор зависит от модели
`/sandbox`	Ограничить, куда могут писать команды агента, см. Права доступа
`/settings`	Настройки: поиск в вебе, песочница, приватность. `/advanced` открывает расширенные
`/status`	Состояние сессии: модель, окно контекста, израсходованные токены

Ещё три вещи, которые пригодятся с первых минут:

Shift+Tab переключает режим подтверждений: спрашивать перед каждой правкой, применять правки автоматически или доверять и правкам, и командам. Текущий режим виден в нижней панели, подробности в Правах доступа.
@ прикрепляет к запросу файл или картинку, Esc прерывает текущий ход, ↑ возвращает предыдущее сообщение для правки.
/compact сжимает разговор, когда окно контекста заполнилось, см. Окно контекста.

Дальше по мере надобности: /goal заставляет агента работать до выполнения условия, /steer дописывает указание не прерывая работу, /sessions и /resume возвращают к прошлым разговорам. Полный справочник: Команды.

4. То же самое в браузере

Одна команда, и текущая работа открывается в браузере: дифф, дерево файлов, терминал.

waibee serve

Открой напечатанную ссылку. Дифф с подсветкой, комментарий к строкам, который уходит агенту, несколько сессий сразу. Отдельная кнопка открывает то же самое с телефона по QR-коду. Подробно: Веб-интерфейс.

5. Headless-режим

Разовый запуск с промптом, без интерфейса:

waibee run "добавь тесты к модулю auth"

Результат уходит в stdout, поэтому агента можно вызывать из скриптов, git-хуков, CI и других программ. Форматы вывода, коды возврата и готовые сценарии: Headless-режим и автоматизация.

6. IDE и терминальные клиенты

Waibee Code подключается к редакторам по Agent Client Protocol (Zed, JetBrains и другие), см. IDE (ACP). Тот же протокол работает из командной строки через acpx: сессии между вызовами и JSON-вывод для скриптов, см. ACP в терминале.