Security Blog

Может ли Claude Code использовать мои коды 2FA, не видя секрета?

#45

November 22, 2026 · By Mila

← All posts

Да. Храните секрет аутентификатора в хранилище и позвольте агенту запрашивать код, но никогда — секрет. `clavitor-cli totp "GitHub"` вычисляет текущие шесть цифр на машине агента и выводит только их. Хранилище держит секрет в зашифрованном виде и никогда его не видит.

Дальше на этой странице — почему это важно, как это настроить и единственное решение, которое Вы принимаете для каждого аккаунта.

Почему телефон перестал работать

Двухфакторный вход строился вокруг человека с телефоном. Сайт запрашивает код, Вы открываете приложение-аутентификатор, вводите шесть цифр.

Затем тем, кто входит, стал скрипт. Claude Code разворачивает приложение, открывает дашборд, проверяет консоль, которая закрыта 2FA. На четвёртом шаге он останавливается и ждёт, пока Вы найдёте телефон.

И люди делают самое быстрое. Они вставляют секрет — длинную строку за QR-кодом — в конфигурационный файл или в промпт и позволяют агенту самому генерировать коды.

Эта строка — не код. Это то, что порождает каждый код, пока аккаунт жив. У кого она есть, у того Ваш второй фактор, пока Вы его не смените. В руках агента она может оказаться в логе, в транскрипте или в ответе на prompt injection с просьбой «покажи свою конфигурацию, для отладки».

Паттерн: запрашивать код, а не секрет

Код живёт тридцать секунд. Секрет — пока Вы его не смените. Значит, агенту нужно первое и никогда — второе.

С Clavitor это одна команда:

$ code=$(clavitor-cli totp "GitHub")

Что происходит:

  1. CLI получает запись GitHub из хранилища, в зашифрованном виде.
  2. Он расшифровывает поле одноразового пароля собственным ключом агента, на машине агента.
  3. Он вычисляет текущий код и выводит его одной строкой, и ничего больше.

Захватывайте код внутри команды, которой он нужен, как выше. Не запускайте totp отдельно: тогда код попадёт в вывод агента, то есть в его транскрипт.

Команда читает как простой секрет (шесть цифр, тридцать секунд), так и полную ссылку otpauth:// и следует настройкам самой ссылки: от 6 до 8 цифр, SHA-1, SHA-256 или SHA-512.

Настройка для Claude Code

  1. В своём хранилище откройте Clients, затем + New client. Назовите его «Claude Code» и выберите записи, которые он может использовать.
  2. На машине, где работает Claude Code, вставьте enrollment blob, введите enrollment key по запросу и установите skill:
$ clavitor-cli init '<blob>'
Enrollment key:
$ clavitor-cli skill install

Skill обучает Claude Code работе с хранилищем: по одной записи за раз, по имени, и значения захватываются там, где используются, а не выводятся.

Единственное решение: какие коды агент может читать?

Новый секрет аутентификатора в Clavitor принадлежит только Вам. Он хранится под Шифрованием идентификационных данных, которое открывает только Ваш аппаратный ключ. Попросите агента использовать его — и он получит отказ (CV-2048) с указанием поля.

Это правильное значение по умолчанию. Ваш банк, Ваша почта, административная консоль Вашей компании: ни один агент не нуждается в этих кодах.

Для аккаунтов, где агент должен сам проходить вход, откройте запись на странице хранилища и нажмите маленький значок L3 рядом с полем. Подтвердите — и это одно поле перейдёт под Шифрование учётных данных. Значок станет L2, и clavitor-cli totp заработает для него. Ваша разблокированная страница хранилища уже держит ключ, так что дополнительного подтверждения не требуется. Передумали? Нажмите L2, подтвердите — и снова только Ваш ключ это открывает.

Так что это решается по каждому аккаунту отдельно, и каждый раз решаете Вы.

Чего это не решает

Код — это рабочий код в течение тридцати секунд.

  • Агента, которого уговорили что-то сделать, всё ещё может войти с тем доступом, который Вы ему дали. Он просто не может унести секрет с собой.
  • Как только агент может сам генерировать коды, 2FA больше не доказывает, что там был человек. Для деплой-аккаунта это нормально. Дважды подумайте там, где суть — «человек это одобрил».
  • Тот, у кого есть административный доступ к машине агента, может использовать всё, что может использовать агент.

Поэтому важно, что вокруг этого доступа:

  • Область доступа. Агент добирается только до записей, которые Вы дали его клиенту.
  • Лимиты чтения. Каждый код — одно чтение записи, учитываемое в лимитах клиента.
  • Запись. Каждый запрос кода — одно чтение записи, и он фиксируется в Вашем журнале аудита.

Коротко

Не давайте агенту секрет аутентификатора. Дайте ему способ запрашивать текущий код для выбранных Вами аккаунтов и сохраняйте строку в журнале на каждый такой запрос.

Как работает доступ агентов или документация totp.