01. Быстрый старт — AstraCode — Руководство пользователя

Цель этого документа — за 10 минут вы получите первый рабочий результат с Астра ИИ [КОД].

1. Установить (1 минута)

См. подробно 02-installation.md. Самый быстрый путь:

После установки проверьте версию:

bash

astracode --version

Должны увидеть astracode-cli 0.7.2-managed.

2. Запустить (10 секунд)

Перейдите в директорию проекта:

bash

cd ~/myproject
astracode

Откроется TUI. Первый запуск создаст ~/.astracode/ и предложит войти через AstraHub. В сборке без -managed вместо входа появится экран «Настройте первого провайдера», см. 06. Модели и провайдеры.

3. Войти через AstraHub (1 минута)

На экране входа нажмите Enter. Астра ИИ [КОД] откроет корпоративную страницу авторизации в браузере. После успешного входа вернитесь в терминал и дождитесь сообщения:

text

✓ Вход и настройка AstraHub завершены

Проверить состояние входа можно в терминале:

bash

astracode login status

Доступные модели выдаёт организация через AstraHub. Выбрать модель после входа можно командой /model. Подробнее — Доступ через AstraHub и Модели и провайдеры.

4. Первая задача (3 минуты)

В нижней части экрана — поле ввода. Напишите задачу:

text

Привет! Покажи структуру этого проекта в виде дерева, глубина 2 уровня.

Нажмите Enter. Астра ИИ [КОД]: 1. Прочитает содержимое директории. 2. Покажет дерево в чате. 3. Объяснит, что увидел.

Безопасная read-only команда вроде ls обычно выполняется автоматически внутри песочницы. Если действию потребуются дополнительные права, Астра ИИ [КОД] покажет диалог подтверждения, например:

text

Tool wants to run: git push origin feature/my-change
[y] allow once   [a] allow always   [d] deny

Нажмите y — разрешить однократно. a — разрешать аналогичные действия до конца сессии. d — отказать. Не подтверждайте действие, если не понимаете, зачем ему нужны дополнительные права.

5. Реальная задача (5 минут)

Теперь что-то полезное. Например:

text

Найди файл с тестами для модуля auth и запусти их. Если упадут — покажи мне, почему.

Астра ИИ [КОД]: 1. Найдёт тестовый файл (grep/find). 2. Запустит тесты (cargo test, pytest, что у вас). 3. Если упадут — покажет stacktrace + объяснение. 4. Может предложить fix.

Если предложил fix:

text

Примени этот fix.

Астра ИИ [КОД] покажет выполненную правку в блоке вызова инструмента. В стандартном режиме изменения внутри текущей рабочей области выполняются без отдельного подтверждения; подтверждение появится, только если действию нужны права за пределами текущей политики.

6. Что делать дальше

Если задача растянулась

Если разговор стал длинным или вы перешли к новой задаче — /new (новая сессия, та же модель).

Если хотите продолжить эту задачу позже — закройте TUI (/exit или Ctrl-D). При следующем запуске:

text

/sessions

Откроется список сессий текущего проекта — выберите нужную. Ctrl+A переключает на сессии всех проектов и обратно. (/resume — алиас той же команды.)

Если задача большая

Поставьте цель:

text

/goal Реализовать OAuth-вход через Google

Цель сохранится в БД. Даже после /new или перезапуска Астра ИИ [КОД] сможет вернуться к ней через /sessions. См. 07-goals.md.

Если хотите ревью перед коммитом

text

/review

Откроется меню — выберите «Uncommitted changes». Агент-ревьюер пройдётся по изменениям и напишет отчёт с findings.

Если что-то пошло не так

Ctrl-C — прервать текущий ответ модели.

Если ответ не соответствует запросу — попросите переделать:

text

Не то. Я хотел, чтобы ты использовал библиотеку X, а не Y.

Модель учтёт корректировку и переделает.

7. Самые важные команды

Команда	Что делает
`/help`	Справка по всем командам (`/help <команда>` — детали)
`/new`	Начать новую сессию
`/clear`	То же + очистить экран
`/sessions`	Открыть список сохранённых сессий (`/resume` — алиас)
`/diff`	Показать `git diff`
`/review`	Ревью кода текущих изменений
`/undo`	Сразу отменить последнее сохранённое изменение файла
`/collapse` / `/expand`	Свернуть или раскрыть завершённые блоки вызова инструментов
`/model`	Выбрать модель (в managed-сборке — из пула AstraHub)
`/status`	Текущая модель, токены, песочница
`Ctrl-C`	Прервать ответ
`/exit` или `Ctrl-D`	Выйти из TUI
`Tab`	Поставить сообщение в очередь
`@<file>`	Упомянуть файл в промпте
`!<cmd>`	Выполнить shell-команду вручную
`$<skill>`	Активировать скилл вручную

Полная шпаргалка — 04-commands-cheatsheet.md.

8. На русском?

Если вам комфортнее на русском:

text

/locale ru

(Доступно только до первого сообщения в сессии. Если уже что-то отправляли — /new, потом /locale ru.)

Эта настройка сохранится в config.toml. См. 14-customization.md.

9. Подводные камни первых дней

Астра ИИ [КОД] не запоминает между сессиями всё подряд. Чтобы сведения о вас или проекте сохранялись — включите Память. Иначе при /new контекст начинается с нуля.
Длинный контекст расходует больше токенов. /status показывает расход текущей сессии, а /compact сжимает историю. Доступность моделей и лимиты задаёт организация.
Песочница блокирует часть команд. Это не баг, а защита. Если что-то нужное не работает — /approvals сменить уровень разрешений или /sandbox-add-read-dir добавить конкретный путь (команда доступна только на Windows). См. 13-safety.md.
MCP-серверы (Linear, GitHub, Slack и т.п.) добавляются через config.toml, не из UI. См. 11-mcp.md.

10. Что почитать дальше

03-tui-basics.md — где что на экране, какие хоткеи.
05-working-with-project.md — как эффективно работать в репозитории.
13-safety.md — что значат диалоги подтверждения.

Удачи! Если что-то не работает — 15-troubleshooting.md.