¿Puede Claude Code usar mis códigos 2FA sin ver el secreto?
Sí. Guarde el secreto del autenticador en una bóveda y deje que el agente pida el código, nunca el secreto. `clavitor-cli totp "GitHub"` calcula los seis dígitos actuales en la máquina del agente e imprime solo esos. La bóveda guarda el secreto cifrado y nunca lo ve.
El resto de esta página explica por qué importa, cómo configurarlo y la única decisión que usted toma para cada cuenta.
Por qué el teléfono dejó de funcionar
El inicio de sesión con doble factor se diseñó en torno a una persona con un teléfono. El sitio pide un código, usted abre su aplicación de autenticación y escribe seis dígitos.
Luego, quien inicia sesión pasó a ser un script. Claude Code despliega, abre un panel, consulta una consola que está detrás de 2FA. En el paso cuatro se detiene y espera a que usted encuentre su teléfono.
Así que la gente hace lo rápido. Pegan el secreto, la cadena larga que hay detrás del código QR, en un archivo de configuración o en un prompt, y dejan que el agente genere códigos por su cuenta.
Esa cadena no es un código. Es lo que genera todos los códigos, durante toda la vida de la cuenta. Quien la tenga posee su segundo factor hasta que usted lo restablezca. En manos de un agente puede acabar en un registro, en una transcripción o en una respuesta a una inyección de prompt que pide "su configuración, para depurar".
El patrón: pedir el código, no el secreto
Un código dura treinta segundos. Un secreto dura hasta que usted lo cambie. Así que el agente debe recibir el primero y nunca el segundo.
Con Clavitor eso es un solo comando:
$ code=$(clavitor-cli totp "GitHub")
Lo que ocurre:
- La CLI obtiene la entrada de GitHub desde la bóveda, cifrada.
- Descifra el campo de contraseña de un solo uso con la clave del propio agente, en la máquina del agente.
- Calcula el código actual y lo imprime en una sola línea, nada más.
Capture el código dentro del comando que lo necesita, como arriba. No ejecute totp por sí solo: entonces el código queda en la salida del agente, que es su transcripción.
Acepta un secreto simple (seis dígitos, treinta segundos) o un enlace otpauth:// completo, y respeta la configuración del propio enlace: de 6 a 8 dígitos, SHA-1, SHA-256 o SHA-512.
Configurarlo para Claude Code
- En su bóveda, abra Clientes y luego + Nuevo cliente. Nómbrelo "Claude Code" y elija las entradas que podrá usar.
- En la máquina donde se ejecuta Claude Code, pegue el blob de inscripción, escriba la clave de inscripción cuando se le pida e instale la skill:
$ clavitor-cli init '<blob>' Enrollment key: $ clavitor-cli skill install
La skill enseña a Claude Code a usar la bóveda: una entrada cada vez, por nombre, y los valores capturados donde se usan en lugar de imprimirse.
La única decisión: ¿qué códigos puede leer un agente?
Un secreto de autenticador nuevo en Clavitor es solo suyo. Se guarda bajo Cifrado de identidad, que solo abre su clave de hardware. Pida a un agente usarlo y recibirá una negativa (CV-2048) que nombra el campo.
Ese es el valor por defecto correcto. Su banco, su correo, la consola de administración de su empresa: ningún agente necesita esos códigos.
Para las cuentas donde un agente debe superar el inicio de sesión por sí solo, abra la entrada en su página de bóveda y haga clic en la pequeña insignia L3 junto al campo. Confirme, y ese único campo pasa a Cifrado de credenciales. La insignia muestra L2, y clavitor-cli totp funciona para él. Su página de bóveda desbloqueada ya tiene la clave, así que no hay que tocar nada más. ¿Cambió de opinión? Haga clic en L2, confirme, y solo su clave vuelve a abrirlo.
Así que es por cuenta, y usted decide cada vez.
Lo que esto no resuelve
Un código sigue siendo un código válido durante treinta segundos.
- Un agente al que hayan convencido de algo puede seguir iniciando sesión con el acceso que usted le dio. Simplemente no puede llevarse el secreto.
- Una vez que un agente puede generar sus propios códigos, ese 2FA ya no demuestra que hubo una persona. Aceptable para una cuenta de despliegue. Piénselo dos veces donde "un humano aprobó esto" es lo esencial.
- Alguien con acceso de administrador a la máquina del agente puede usar todo lo que el agente pueda usar.
Por eso importa el acceso que lo rodea:
- Alcance. El agente solo llega a las entradas que usted asignó a su cliente.
- Límites de lectura. Cada código es una lectura de la entrada, que cuenta para los límites del cliente.
- Un registro. Cada solicitud de código es una lectura de la entrada, y queda registrada en su registro de auditoría.
En resumen
No le dé a un agente su secreto de autenticador. Dele una forma de pedir el código actual, para las cuentas que usted elija, y conserve una línea en el registro cada vez que lo haga.
Vea cómo funciona el acceso de agentes o lea la documentación de totp.