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

Цель этого документа — за 10 минут вы получите первый рабочий результат с AstraCode.

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

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

bash

# Linux x86_64
curl -k -L -o /tmp/astracode.tar.gz \
  "https://gitlab.prosto.aib.pro/api/v4/projects/286/packages/generic/astracode-linux-x86_64-gnu/0.4.11/astracode-linux-x86_64-gnu-0.4.11.tar.gz"
tar xzf /tmp/astracode.tar.gz -C /tmp/
sudo mv /tmp/astracode /usr/local/bin/
astracode --version

Должны увидеть astracode 0.4.11.

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

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

bash

cd ~/myproject
astracode

Откроется TUI. Первый запуск создаст ~/.astracode/ и попросит выбрать модель.

3. Настроить модель (1 минута)

В появившемся popup'е выберите провайдера: - OpenAI (api.openai.com) — нужен API-ключ от OpenAI. - Anthropic (api.anthropic.com) — нужен ключ от Anthropic. - Local AstraCode или Custom — если у вас on-prem endpoint.

Введите API-ключ. Он сохранится зашифрованно в ~/.astracode/secrets/local.age — больше его вводить не нужно.

Можно пропустить и настроить позже через /model.

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

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

text

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

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

При запуске первой shell-команды (ls, tree) появится approval-диалог:

text

Would you like to run the following command?

  ls -la

› 1. Yes, proceed (y)
  2. Yes, and don't ask again for commands that start with `ls` (p)
  3. No, and tell AstraCode what to do differently (esc)

Выберите пункт стрелками или клавишей: y — разрешить однократно; p — больше не спрашивать для команд с таким префиксом (например, для всех ls); esc — отказать. Клавиши настраиваются в /keymap.

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

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

text

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

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

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

text

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

AstraCode попросит подтверждения на изменение файла (по умолчанию approval_policy = on-request).

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

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

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

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

text

/resume

Откроется picker всех ваших сессий — выберите нужную.

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

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

text

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

Цель сохранится в БД. Даже после /new или перезапуска AstraCode сможет вернуться к ней через /resume. См. 07-goals.md.

Если хотите review перед коммитом

text

/review

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

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

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

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

text

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

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

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

Команда	Что делает
`/help`	Справка по всем командам (`/help <команда>` — детали)
`/new`	Начать новую сессию
`/clear`	Начать новый чат и очистить экран
`/resume`	Открыть picker сохранённых сессий
`/diff`	Показать `git diff`
`/review`	Code review текущих изменений
`/model`	Сменить модель или провайдера
`/status`	Текущая модель, токены, sandbox
`Esc`	Прервать ответ
`Ctrl-C`	Выйти из TUI
`Tab`	Авто-дополнение в composer
`@<file>`	Упомянуть файл в промпте
`!<cmd>`	Выполнить shell-команду вручную
`$<skill>`	Активировать скилл вручную

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

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

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

text

/locale ru

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

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

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

AstraCode не запоминает между сессиями всё подряд. Чтобы он помнил факты о вас или проекте — включите Память. Иначе при /new контекст с нуля.
API-ключи — деньги. Каждый запрос к OpenAI/Anthropic стоит токены. Long context = больше токены. /status показывает расход. /compact сжимает историю.
Sandbox блокирует часть команд. Это не баг, а защита. Если что-то нужное не работает — /approvals сменить уровень разрешений. В Windows-сборке также есть /sandbox-add-read-dir для добавления конкретного пути (на Linux/macOS этой команды нет). См. 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 — что значат approval-диалоги.

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