0.7.2
Поиск по документации… ⌘K
02 · Руководство пользователя

02. Установка managed-сборки

Актуальная пользовательская сборка — managed. Она использует корпоративный вход через AstraHub и не требует файла license.key. Ниже используется версия 0.7.2.

В версии 0.7.2 опубликованы:

  • astracode-linux-x86_64-gnu-0.7.2.tar.gz — Linux x86_64;
  • astracode-macos-0.7.2.zip — macOS Apple Silicon;
  • astracode-windows-x86_64-0.7.2.zip — Windows x86_64.

Имена архивов сохранены без суффикса -managed для совместимости с процессом публикации. Сам бинарник должен показывать версию astracode-cli 0.7.2-managed.

Linux x86_64

Распакуйте архив и перейдите в созданную директорию:

bash
tar -xzf astracode-linux-x86_64-gnu-0.7.2.tar.gz
cd astracode-linux-x86_64-gnu-0.7.2

Проверьте версию:

bash
./bin/astracode --version

Запустите Астра ИИ [КОД] для нужного проекта:

bash
./bin/astracode -C /path/to/project

Если на минимальной Linux-системе отсутствует D-Bus Secret Service, установите runtime-библиотеку:

bash
sudo apt install libdbus-1-3

macOS Apple Silicon

Распакуйте архив в постоянную директорию:

bash
mkdir -p "$HOME/astracode-0.7.2"
unzip astracode-macos-0.7.2.zip -d "$HOME/astracode-0.7.2"
cd "$HOME/astracode-0.7.2"

Снимите quarantine-атрибут с полученного корпоративного бинарника и проверьте версию:

bash
xattr -dr com.apple.quarantine ./astracode
./astracode --version

Запустите Астра ИИ [КОД]:

bash
./astracode -C /path/to/project

Если macOS запросит доступ к Keychain, разрешите его для Астра ИИ [КОД] в соответствии с политикой вашей организации.

Windows x86_64

В PowerShell распакуйте архив:

powershell
Expand-Archive `
  -Path .\astracode-windows-x86_64-0.7.2.zip `
  -DestinationPath .
cd .\astracode-windows-x86_64-0.7.2

Проверьте версию и запустите Астра ИИ [КОД]:

powershell
.\astracode.exe --version
.\astracode.exe -C C:\path\to\project

Если запуск блокирует корпоративная политика Windows или SmartScreen, обратитесь к администратору и передайте ему имя архива и версию. Не отключайте системную защиту целиком.

Первый вход через AstraHub

При первом запуске TUI предложит открыть авторизацию в браузере. Нажмите Enter, войдите через корпоративную учётную запись и вернитесь в терминал. После завершения настройки появится сообщение:

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

Управлять сессией можно и из терминала:

bash
astracode login
astracode login status
astracode logout

Без активной AstraHub-сессии работа с моделями недоступна. Подробнее — Доступ через AstraHub.

Повторный запуск

После перезапуска терминала снова перейдите в директорию установки или используйте абсолютный путь.

Linux:

bash
/path/to/astracode-linux-x86_64-gnu-0.7.2/bin/astracode -C /path/to/project

macOS:

bash
"$HOME/astracode-0.7.2/astracode" -C /path/to/project

Windows PowerShell:

powershell
C:\path\to\astracode-windows-x86_64-0.7.2\astracode.exe -C C:\path\to\project

Опционально: добавить Астра ИИ [КОД] в PATH

Linux

Находясь в корне распакованной сборки:

bash
mkdir -p "$HOME/.local/bin"
ln -sfn "$(pwd)/bin/astracode" "$HOME/.local/bin/astracode"

macOS

Находясь в директории с бинарником:

bash
mkdir -p "$HOME/.local/bin"
ln -sfn "$(pwd)/astracode" "$HOME/.local/bin/astracode"

Если ~/.local/bin ещё не входит в PATH, добавьте в ~/.zshrc:

bash
export PATH="$HOME/.local/bin:$PATH"

Windows

Добавьте директорию с astracode.exe в пользовательскую переменную Path через системные настройки Windows, затем откройте новый PowerShell.

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

bash
astracode --version

Обновление

Для установки из архива обновляйтесь повторной распаковкой новой версии в отдельную директорию. После проверки переключите созданный вами симлинк или запись в Path на новый бинарник.

Команда /update или astracode update рассчитана на установку через управляемый install-скрипт со служебным release metadata. При ручной распаковке архива она может сообщить, что способ установки определить не удалось; в этом случае обновитесь вручную.

Конфигурация, сессии и память находятся в ~/.astracode/, поэтому при замене бинарника сохраняются.

Если что-то не работает

См. 15-troubleshooting.md. Частые случаи:

  • astracode: command not found — используйте полный путь или добавьте директорию в PATH;
  • macOS сообщает operation not permitted — проверьте quarantine-атрибут и корпоративную политику;
  • требуется вход в AstraHub — выполните astracode login;
  • сессия входа недействительна — выполните astracode logout, затем astracode login.
ESC