Claude Code 能在不看到密钥的情况下使用我的 2FA 验证码吗?
可以。把身份验证器密钥保存在保管库中,让代理去请求验证码,而不是密钥。`clavitor-cli totp "GitHub"` 会在代理的机器上算出当前的六位数字并只打印这些数字。保管库以加密方式保存密钥,永远不会看到它。
本页其余部分将说明这为什么重要、如何设置,以及您需要为每个账户做出的唯一一个选择。
为什么手机方案不再适用
双因素登录最初是围绕一个拿着手机的人设计的。网站要求输入验证码,您打开身份验证器应用,输入六位数字。
后来登录的主体变成了脚本。Claude Code 部署服务、打开仪表盘、检查一个位于 2FA 之后的控制台。到第四步它停下来,等您去找手机。
于是人们选择了省事的做法:把密钥——QR 码背后那串长字符串——粘贴到配置文件或提示词里,让代理自己生成验证码。
那串字符串不是验证码。它是生成每一个验证码的东西,在账户存续期间一直有效。谁持有它,谁就拥有您的第二因素,直到您重置为止。在代理手中,它可能落入日志、会话记录,或是对一条要求“提供您的配置以便调试”的提示注入的回复里。
模式:请求验证码,而不是密钥
一个验证码只存活三十秒。一个密钥存活到您更改它为止。所以代理应该拿到前者,永远拿不到后者。
使用 Clavitor 时,这只需一条命令:
$ code=$(clavitor-cli totp "GitHub")
发生的事情:
- CLI 从保管库中取出 GitHub 条目,处于加密状态。
- 它在代理的机器上,用代理自己的密钥解密一次性密码字段。
- 它算出当前验证码并打印在一行中,仅此而已。
在需要验证码的命令内部捕获它,如上所示。不要单独运行 totp:那样验证码会落入代理的输出中,也就是它的会话记录。
它可以读取纯密钥(六位数字、三十秒)或完整的 otpauth:// 链接,并遵循该链接自身的设置:6 到 8 位数字,SHA-1、SHA-256 或 SHA-512。
为 Claude Code 进行设置
- 在您的保管库中,打开 Clients,然后点击 + New client。将其命名为 "Claude Code",并选择它可以使用的条目。
- 在运行 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,确认,之后就只有您的密钥能再次打开它。
所以这是按账户划分的,每次都由您决定。
这不能解决的问题
一个验证码在三十秒内仍然是一个有效的验证码。
- 一个被诱骗的代理仍然可以用您授予它的权限登录。它只是无法把密钥带走。
- 一旦代理可以自己生成验证码,该 2FA 就不再能证明有人在场。对部署账户来说没问题。在“有人类批准了此事”是关键的场景中,请三思。
- 对代理机器拥有管理员权限的人,可以使用代理能使用的一切。
这就是为什么周围的访问控制很重要:
- 范围。 代理只能访问您为其客户端指定的条目。
- 读取限制。 每个验证码是对条目的一次读取,计入客户端的限额。
- 记录。 每次验证码请求都是对条目的一次读取,并记录在您的审计日志中。
简而言之
不要把您的身份验证器密钥交给代理。给它一种请求当前验证码的方式,限定在您选择的账户上,并在它每次这样做时在日志中留下一条记录。