Перейти к содержанию

Авторизация

Koda CLI требует рабочую учётную запись, прежде чем сможет вызывать модель. Если учётной записи нет, вы сможете создать её в процессе.

Доступны два варианта:

  • Войти через Koda — авторизация через Koda Auth по протоколу device flow (рекомендуется).
  • Продолжить без входа — запуск без авторизации; доступ к моделям Koda в этом режиме недоступен.

При первом интерактивном запуске CLI показывает диалог с выбором одного из этих вариантов.

Вход через Koda Auth

Koda Auth использует device flow: CLI генерирует одноразовый код устройства и ждёт, пока вы подтвердите вход в браузере.

  1. Запустите koda
  2. В диалоге выберите Войти через Koda.
  3. Koda предоставит ссылку в формате https://kodacode.ru/account?...
  4. Koda попытается открыть браузер автоматически и в течение 2-х минут будет ожидать ответа от сервера авторизации. Если браузер не открылся или отсутствует (например, при доступе к серверу по SSH), скопируйте ссылку из терминала и откройте её вручную.
  5. Koda привяжется автоматически сразу после авторизации (если учётной записи нет, она будет создана).

Headless и удалённые окружения

В SSH-сессиях, CI-окружениях и терминалах без браузера можно запретить автоматическое открытие браузера:

NO_BROWSER=1 koda

CLI всё равно напечатает ссылку подтверждения. Откройте её на машине с браузером, завершите вход и вернитесь в терминал — CLI продолжит ожидать подтверждение до истечения таймаута.

Для неинтерактивного режима аутентификацию можно настроить заранее через переменные окружения KODA_AUTH_ACCESS_TOKEN, KODA_AUTH_REFRESH_TOKEN или KODA_API_KEY — подробнее на странице headless-режим.

Продолжение без входа

Если выбрать Продолжить без входа, CLI запустится без авторизации. В этом режиме нельзя вызывать модели Koda, но доступны локальные функции: навигация по проекту, чтение файлов, shell-команды и другие операции, не требующие API.

Перейти к авторизации позже можно командой /auth.

Где хранятся токены

Koda CLI хранит данные входа в:

~/.config/koda/credentials.json

Файл создаётся с правами 0600, если операционная система поддерживает такой режим. Не коммитьте этот файл и не копируйте его в проект.

Если система не позволяет создать или обновить файл в этой директории, могут возникнуть проблемы с доступом: CLI не сможет сохранить токены, будет повторно запрашивать вход или не сможет использовать модель в следующих сессиях. Проверьте права на ~/.config/koda и возможность записи для текущего пользователя.

Смена аккаунта и сброс входа

Чтобы заново открыть auth-диалог в CLI:

/auth

Чтобы полностью сбросить локальный вход, закройте CLI и удалите файл:

rm ~/.config/koda/credentials.json

После следующего запуска koda снова предложит войти через Koda Auth.