Security Blog

Claude Code가 비밀 값을 보지 않고도 2FA 코드를 사용할 수 있나요?

#45

November 22, 2026 · By Mila

← All posts

가능합니다. 인증기 비밀 값은 볼트에 보관하고, 에이전트는 코드만 요청하게 하세요. 비밀 값은 절대 요청하지 않습니다. `clavitor-cli totp "GitHub"`는 에이전트 머신에서 현재 6자리 숫자를 계산해 그것만 출력합니다. 볼트는 비밀 값을 암호화된 상태로 저장하며 그 값을 직접 보지 않습니다.

이 페이지의 나머지 부분은 왜 이것이 중요한지, 어떻게 설정하는지, 그리고 계정마다 내려야 하는 하나의 선택에 관한 이야기입니다.

전화기가 더 이상 통하지 않는 이유

2단계 로그인은 전화기를 가진 사람을 기준으로 설계되었습니다. 사이트가 코드를 요구하면, 인증기 앱을 열고, 6자리를 입력합니다.

그런데 로그인하는 주체가 스크립트가 되었습니다. Claude Code가 배포하고, 대시보드를 열고, 2FA 뒤에 있는 콘솔을 확인합니다. 네 번째 단계에서 멈춰 서서 여러분이 전화기를 찾기를 기다립니다.

그래서 사람들은 편한 방법을 택합니다. QR 코드 뒤에 있는 긴 문자열, 즉 비밀 값을 설정 파일이나 프롬프트에 붙여넣고 에이전트가 스스로 코드를 만들게 합니다.

그 문자열은 코드가 아닙니다. 계정이 살아있는 한 모든 코드를 만들어내는 원천입니다. 이 값을 가진 사람은 여러분이 초기화하기 전까지 2단계 인증 수단을 쥐고 있는 셈입니다. 에이전트 손에 들어가면 로그, 대화 기록, 아니면 "디버깅을 위해 설정을 보여줘"라고 요구하는 프롬프트 인젝션에 대한 응답 어딘가에 끝날 수 있습니다.

패턴: 비밀 값이 아니라 코드를 요청하기

코드는 30초면 만료됩니다. 비밀 값은 바꾸기 전까지 계속 유효합니다. 따라서 에이전트는 전자만 받고 후자는 절대 받지 않아야 합니다.

Clavitor에서는 명령 하나면 됩니다:

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

일어나는 일:

  1. CLI가 볼트에서 GitHub 항목을 암호화된 상태로 가져옵니다.
  2. 에이전트 머신에서, 에이전트 자신의 키로 일회용 비밀번호 필드를 복호화합니다.
  3. 현재 코드를 계산해 한 줄로 출력하고, 그 외에는 아무것도 출력하지 않습니다.

코드가 필요한 명령 안에서 코드를 캡처하세요. 위처럼 하면 됩니다. 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에게 볼트 사용법을 알려줍니다. 한 번에 한 항목, 이름으로 조회하고, 값을 출력하는 대신 사용되는 지점에서 캡처합니다.

하나의 선택: 에이전트가 어떤 코드를 읽을 수 있나?

Clavitor에 새로 저장된 인증기 비밀 값은 여러분만의 것입니다. Identity Encryption(신원 암호화) 아래 저장되며, 오직 여러분의 하드웨어 키만 열 수 있습니다. 에이전트가 사용을 요청하면 해당 필드를 명시한 거부(CV-2048)를 받게 됩니다.

이것이 올바른 기본값입니다. 은행, 이메일, 회사 관리 콘솔: 그런 코드가 필요한 에이전트는 없습니다.

에이전트가 스스로 로그인을 통과해야 하는 계정이라면, 볼트 페이지에서 해당 항목을 열고 필드 옆의 작은 L3 배지를 클릭하세요. 확인하면 그 필드 하나만 Credential Encryption(자격 증명 암호화)으로 이동합니다. 배지는 L2로 표시되고, clavitor-cli totp가 그 필드에서 작동합니다. 잠금 해제된 볼트 페이지가 이미 키를 갖고 있으므로 추가로 키를 쓸 필요가 없습니다. 마음이 바뀌었나요? L2를 클릭하고 확인하면 다시 여러분의 키만 열 수 있습니다.

즉, 계정 단위이고, 매번 여러분이 결정합니다.

이것으로 해결되지 않는 것

코드는 30초 동안 유효한 코드입니다.

  • 무언가에 속은 에이전트는 여러분이 부여한 접근 권한으로 여전히 로그인할 수 있습니다. 다만 비밀 값을 가지고 도망갈 수는 없습니다.
  • 에이전트가 스스로 코드를 만들 수 있게 되면, 그 2FA는 더 이상 사람이 있었다는 증거가 아닙니다. 배포 계정이라면 괜찮습니다. "사람이 승인했다"가 핵심인 곳이라면 다시 생각하세요.
  • 에이전트 머신에 관리자 권한을 가진 사람은 에이전트가 쓸 수 있는 것은 무엇이든 쓸 수 있습니다.

그래서 그 주변의 접근 통제가 중요합니다:

  • 범위. 에이전트는 클라이언트에 부여한 항목에만 접근할 수 있습니다.
  • 읽기 한도. 코드 한 번은 항목 한 번 읽기이며, 클라이언트의 한도에 포함됩니다.
  • 기록. 모든 코드 요청은 항목 한 번 읽기이며, 감사 로그에 기록됩니다.

요약

에이전트에게 인증기 비밀 값을 주지 마세요. 대신, 선택한 계정에 한해 현재 코드를 요청할 방법을 주고, 요청할 때마다 로그에 한 줄이 남게 하세요.

에이전트 접근이 작동하는 방식 보기 또는 totp 문서 읽기.