Ключи и подключи

Как устроен ключ

Префикс sk- - тот же, что у OpenAI, чтобы работали библиотеки и инструменты, которые проверяют формат ключа.

Ключ показывается в открытом виде ровно один раз - в момент создания. Сохраните его сразу в менеджер паролей или в переменную окружения. Если ключ потерялся, его не восстанавливают, а отзывают и выпускают новый.

Ключ передаётся заголовком:

Authorization: Bearer sk-...

Ограничения ключа

Ограничения задаются при создании и позволяют выдать подрядчику, скрипту или чужой машине доступ, за который не страшно. Жёсткий лимит расхода - потолок суммы, которую ключ может списать с общего баланса: когда он выбран, ключ перестаёт обслуживать запросы, а остальной баланс аккаунта остаётся нетронутым. Кроме него есть белый список моделей, срок действия и список разрешённых IP.

Ограничения проверяются до того, как запрос уйдёт к поставщику: отклонённый запрос не расходует баланс. Что именно не сошлось, написано в теле ответа - Ошибки и поведение.

Лимит расхода считается от общего баланса аккаунта, а не пополняется отдельно: это потолок для ключа, а не кошелёк.

Отзыв

Отзыв в личном кабинете действует сразу - проверка ключа кэшируется ненадолго, и отзыв сбрасывает кэш явно. Отозванный ключ не включается обратно: вместо него выпускается новый.

Списания, совершённые с ключом до отзыва, не компенсируются - все запросы с ключом считаются вашими (п. 3.2 и 3.3 оферты).

Разумная практика - отдельный ключ на проект, подрядчика или машину. Тогда отзыв одного ключа не останавливает всё остальное, а расход видно по каждому отдельно.

Где ключ оказывается на диске

Установщик кладёт ключ в открытом виде только в rc-файл вашей оболочки и в ~/.claude/settings.json - остальные конфиги ссылаются на переменную окружения AKYKO_KEY и самого ключа не содержат. Что куда пишется, перечислено на странице Интеграции.

В репозиторий ключ класть не нужно ни в каком виде: все поддерживаемые инструменты умеют читать его из переменной окружения.