Security Blog

Claude Code はシークレットを見ずに 2FA コードを利用できますか?

#45

November 22, 2026 · By Mila

← All posts

できます。認証シークレットはボールトに保管し、エージェントにはコードを要求させ、シークレットには決して触れさせないようにします。`clavitor-cli totp "GitHub"` はエージェントのマシン上で現在の 6 桁を算出し、それだけを出力します。ボールトはシークレットを暗号化したまま保持し、平文を見ることはありません。

このページの残りの部分では、なぜこれが重要なのか、設定方法、そしてアカウントごとに必要な 1 つの選択について説明します。

なぜスマートフォンでは機能しなくなったのか

二要素認証によるサインインは、スマートフォンを持つ人を前提に設計されました。サイトがコードを要求し、認証アプリを開き、6 桁を入力する。

ところが、サインインする主体がスクリプトになりました。Claude Code がデプロイし、ダッシュボードを開き、2FA の背後にあるコンソールを確認する。そして 4 番目のステップで停止し、あなたがスマートフォンを探すのを待ちます。

そこで多くの人は手っ取り早い方法を取ります。シークレット、つまり QR コードの裏にある長い文字列を設定ファイルやプロンプトに貼り付け、エージェント自身にコードを生成させるのです。

その文字列はコードではありません。アカウントが存続する限り、すべてのコードを生み出すものです。持っている者は、リセットされるまであなたの第二要素を握ることになります。エージェントの手に渡れば、ログやトランスクリプトに残ったり、「デバッグ用にセットアップを教えて」というプロンプトインジェクションへの返答に含まれたりするおそれがあります。

パターン:コードを要求し、シークレットを渡さない

コードの有効期間は 30 秒です。シークレットは変更するまで有効です。したがって、エージェントには前者を与え、後者は決して与えないようにすべきです。

Clavitor なら 1 つのコマンドで実現できます:

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

動作の流れ:

  1. CLI は GitHub のエントリをボールトから暗号化された状態で取得します。
  2. エージェント自身の鍵で、エージェントのマシン上でワンタイムパスワードのフィールドを復号します。
  3. 現在のコードを算出し、それだけを 1 行で出力します。

上記のように、コードを必要とするコマンドの中でキャプチャしてください。totp を単体で実行しないでください。その場合、コードがエージェントの出力、つまりトランスクリプトに残ってしまいます。

平文のシークレット(6 桁、30 秒)でも完全な otpauth:// リンクでも読み取れ、そのリンク自体の設定に従います。桁数は 6〜8 桁、SHA-1、SHA-256 または SHA-512 に対応します。

Claude Code 向けの設定

  1. ボールトで Clients を開き、+ New client を選択します。「Claude Code」と名前を付け、利用を許可するエントリを選びます。
  2. Claude Code が動作するマシンで、登録用 blob を貼り付け、プロンプトで登録キーを入力し、スキルをインストールします:
$ clavitor-cli init '<blob>'
Enrollment key:
$ clavitor-cli skill install

このスキルは Claude Code にボールトの使い方を教えます。1 度に 1 つのエントリを、名前で指定し、値は出力ではなく使用箇所でキャプチャします。

唯一の選択:エージェントはどのコードを読めるようにするか

Clavitor に新しく登録された認証シークレットは、あなただけのものです。Identity Encryption(アイデンティティ暗号化)で保存され、あなたのハードウェアキーだけが開けます。エージェントが利用しようとすると、そのフィールド名を示した拒否(CV-2048)が返されます。

これが正しいデフォルトです。銀行、メール、会社の管理コンソール。そうしたコードを必要とするエージェントは存在しません。

エージェントに自力でサインインさせたいアカウントについては、ボールトページでそのエントリを開き、フィールドの横にある小さな L3 バッジをクリックします。確認すると、その 1 つのフィールドだけが Credential Encryption(資格情報暗号化)に移ります。バッジは L2 と表示され、clavitor-cli totp が機能するようになります。ロック解除済みのボールトページはすでに鍵を保持しているため、追加のタップは不要です。気が変わったら、L2 をクリックして確認すれば、再びあなたのキーだけが開けます。

つまり、アカウントごとに、毎回あなたが判断します。

これで解決しないこと

コードは 30 秒間、有効なコードであることに変わりません。

  • 悪意ある指示に乗せられたエージェントは、あなたが与えたアクセスでサインインできます。ただし、シークレットを持ち去ることはできません。
  • エージェントが自力でコードを生成できるようになると、その 2FA は人間が関与した証明にはならなくなります。デプロイ用アカウントなら問題ありません。「人間が承認した」ことが目的の場面では慎重に検討してください。
  • エージェントのマシンへの管理者アクセスを持つ者は、エージェントが利用できるものを何でも利用できます。

だからこそ、その周囲のアクセス管理が重要です:

  • スコープ。 エージェントがアクセスできるのは、そのクライアントに与えたエントリだけです。
  • 読み取り制限。 各コードは 1 回のエントリ読み取りで、クライアントの制限にカウントされます。
  • 記録。 すべてのコード要求は 1 回のエントリ読み取りであり、監査ログに記録されます。

要約

エージェントに認証シークレットを渡さないでください。選んだアカウントについて現在のコードを要求する手段を与え、そのたびにログに 1 行残るようにしましょう。

エージェントアクセスの仕組みまたはtotp ドキュメントをご覧ください。