description: Авторизация в Koda CLI через Koda Auth: вход по device flow, хранение токенов, смена аккаунта и переменные окружения. icon: material/key-variant tags: [CLI, авторизация, Koda Auth, токены]
Авторизация¶
Koda CLI требует рабочую учётную запись, прежде чем сможет вызывать модель. Если учётной записи нет, вы сможете создать её в процессе.
Доступны два варианта:
- Войти через Koda — авторизация через Koda Auth по протоколу device flow (рекомендуется).
- Продолжить без входа — запуск без авторизации; доступ к моделям Koda в этом режиме недоступен.
При первом интерактивном запуске CLI показывает диалог с выбором одного из этих вариантов.
Вход через Koda Auth¶
Koda Auth использует device flow: CLI генерирует одноразовый код устройства и ждёт, пока вы подтвердите вход в браузере.
- Запустите
koda - В диалоге выберите Войти через Koda.
- Koda предоставит ссылку в формате
https://kodacode.ru/account?... - Koda попытается открыть браузер автоматически и в течение 2-х минут будет ожидать ответа от сервера авторизации. Если браузер не открылся или отсутствует (например, при доступе к серверу по SSH), скопируйте ссылку из терминала и откройте её вручную.
- Koda привяжется автоматически сразу после авторизации (если учётной записи нет, она будет создана).
Headless и удалённые окружения¶
В SSH-сессиях, CI-окружениях и терминалах без браузера можно запретить автоматическое открытие браузера:
CLI всё равно напечатает ссылку подтверждения. Откройте её на машине с браузером, завершите вход и вернитесь в терминал — CLI продолжит ожидать подтверждение до истечения таймаута.
Продолжение без входа¶
Если выбрать Продолжить без входа, CLI запустится без авторизации. В этом режиме нельзя вызывать модели Koda, но доступны локальные функции: навигация по проекту, чтение файлов, shell-команды и другие операции, не требующие API.
Перейти к авторизации позже можно командой /auth.