Установка и вход в CLI
Как установить istok-code-cli, войти через браузер или device flow и проверить, что доступ к рабочему контуру действительно работает.
- CLI ещё не установлен или вход вызывает вопросы
- Нужно зайти на машине без удобного браузера
- После установки хочется быстро понять, что контур и доступ работают правильно
- Рабочая установка CLI на локальной машине или сервере
- Понимание разницы между обычным логином и device flow
- Готовый минимальный маршрут до первого запроса и проверки usage
Что нужно до установки
Quickstart в кабинете опирается на простой набор требований: Node.js 20 или новее, рабочий npm и обычный пользовательский доступ к кабинету Istok. Поддерживаются macOS, Linux и Windows через WSL.
Если вы работаете на удалённой машине или в среде, где неудобно открывать браузер локально, это не блокер. Для таких случаев в продукте есть device flow логин.
Базовая установка
Если вам важен максимально короткий путь, достаточно трёх команд из quickstart: установка, логин и первый запрос. Всё остальное уже можно делать после того, как доступ подтверждён и CLI отвечает.
Установите CLI
Выполните npm install -g istok-code-cli и дождитесь завершения установки.
Запустите логин
Для обычной рабочей машины начните с команды istok-code login.
Проверьте первый вызов
После входа отправьте короткий реальный запрос и затем выполните istok-code usage.
Обычный вход через браузер
Команда istok-code login использует стандартную веб-сессию кабинета. Если вы уже вошли в браузере, подтверждение занимает минимум действий. Если нет, система сначала предложит обычный логин в кабинет, а затем вернёт вас к авторизации CLI.
Этот путь удобен для основной рабочей машины. Он хорош тем, что не заставляет вручную переносить коды и не требует отдельной настройки приложения-аутентификатора.
Когда нужен device flow
Команда istok-code login --device нужна для headless и неудобных сценариев: удалённый Linux, WSL, временная консоль на сервере или любая среда, где браузер есть отдельно от терминала.
В этом режиме CLI выдаёт код подтверждения. Вы открываете страницу подтверждения в браузере, вводите код, подтверждаете доступ и после этого CLI завершает вход сам. Это тот же продуктовый контур авторизации, просто разделённый на терминал и браузер.
Чем проверить, что всё действительно работает
Лучший первый тест это не абстрактная команда, а короткий рабочий вопрос по реальному коду. Например, попросите объяснить функцию или модуль, который вы и так хорошо знаете. Так вы сразу проверяете качество результата, а не только факт успешного логина.
Сразу после первого запроса выполните istok-code usage. Это даёт быстрый контроль над тем, что токен, доступ и счётчики usage синхронизированы корректно.