No fue el lanzamiento de una función, sino una decisión de diseño del contexto que el modelo usó de una forma que nadie pretendía. Para que Claude dejara de inventar nombres en campos como @author, Claude Code colocó el correo de la cuenta con sesión iniciada en el contexto del modelo. Cuando el modelo escribía después sus propios comandos curl, a veces trataba esa dirección como el contacto que algunos sitios piden a los bots y la ponía en el User-Agent, enviándola al host que estuviera consultando. El issue #107757 de GitHub (2026-11-05) y el hilo de Hacker News posterior hicieron público el comportamiento; Anthropic lo explicó el 2026-11-06 y prometió retirar la dirección del contexto en la siguiente versión.
Issue #107757 de GitHub: Bug Report: Privacy violation in User-Agent header · Hacker News: Claude Code sends your email address to websites
Clasificamos todo lo que pudimos comprobar el 2026-11-08 en cuatro cajones: declaraciones de primera mano del personal de Anthropic, entradas del CHANGELOG, el README del código fuente publicado del mod integrado, e informes de la comunidad en el issue y en Hacker News que no reprodujimos. Después respondemos a las preguntas que de verdad se hace quien usa Claude Code a diario: ¿está esto en mis transcripciones? ¿Qué bloquea el mod integrado y qué deja pasar? Y si no quiero esperar a una versión, ¿qué controles deterministas puedo activar hoy?
1. Qué ocurrió: un issue, un hilo de HN y un mecanismo que tiene sentido
El issue #107757, titulado Bug Report: Privacy violation in User-Agent header, lo abrió el 2026-11-05 el usuario taylor-edwards en macOS con Claude Code 2.1.318 y lleva las etiquetas area:security, area:tools, bug y platform:macos. Según quien lo reporta, Claude Code divulgó su correo a terceros arbitrarios en la cabecera User-Agent durante búsquedas web, sin permiso, con el resultado de decenas de correos fraudulentos al día; pide que el comportamiento se elimine del harness en lugar de convertirlo en un ajuste. Cuando lo comprobamos el 2026-11-08, el issue seguía abierto con 108 comentarios.
Issue #107757 de GitHub: Bug Report: Privacy violation in User-Agent header
El hilo de Hacker News, Claude Code sends your email address to websites, rondaba los 1.596 puntos y 526 comentarios cuando lo leímos el 7 y el 8 de noviembre. Su comentario principal aporta la pista más útil: mucha gente vio el comportamiento contra la API EDGAR de la SEC estadounidense, cuya documentación pide a los clientes programáticos que se identifiquen con el nombre de la empresa y un correo de contacto en el User-Agent. Quien comentaba demostró con curl que el User-Agent por defecto devolvía 403 y uno con dirección devolvía 200, y añadió después que la SEC acepta en realidad casi cualquier User-Agent que no sea el de curl, así que el correo no es realmente necesario. Otros señalaron que Wikipedia y la API de EVE Online también piden a los bots que se identifiquen. El participante T-R contó que su dirección personal de cuenta se envió sin ningún aviso ni advertencia y solo aparecía en peticiones curl. Otro mostró subagentes metiendo en la cabecera el nombre de la empresa, del equipo e incluso la URL del repositorio del proyecto. Todo esto son informes de la comunidad; no los reprodujimos.
Hacker News: Claude Code sends your email address to websites
Junta las dos pistas y el mecanismo queda claro: un sitio pide a los robots que incluyan un contacto, el modelo tiene por casualidad una dirección en su contexto, y obedece. Nada en Claude Code se escribió para poner el correo en un User-Agent y nadie lo plantó; es lo que ocurre cuando el contenido del contexto se encuentra con la autonomía del modelo. Por eso una frase más de instrucción no lo arregla del todo. La propia página de buenas prácticas de Anthropic lo dice: una regla que debe cumplirse siempre pertenece a un hook, una regla deny o un ajuste gestionado, no a CLAUDE.md.
Hacker News: Claude Code sends your email address to websites · Documentación de Claude Code: Best practices
2. Cronología, con el tipo de cada fuente marcado
La tabla enumera en orden lo que pudimos verificar el 2026-11-08. Primera mano significa palabras del personal de Anthropic o de quienes mantienen el repositorio; CHANGELOG significa una entrada del CHANGELOG.md del repositorio, ordenado por versión y sin fechas; comunidad significa un informe de un usuario corriente en el issue o en HN que no reprodujimos.
| Fecha / versión | Tipo de fuente | Qué dice | Estado el 11-08 |
|---|---|---|---|
| 2.1.234 (CHANGELOG, sin fecha) | CHANGELOG | Ahora se le indica a Claude que use el correo de la cuenta solo para identificarte y que no lo envíe a servicios ajenos salvo que lo pidas. Demuestra que la dirección ya estaba en el contexto y que el control era un prompt | La entrada sigue ahí; documenta que el control anterior era no determinista |
| 2026-03 (#37201) | Cita de la comunidad | Un comentarista cita un issue de marzo en el que el modelo obtuvo la dirección de git config y la envió | Enlace accesible; contenido no revisado línea a línea |
| 2026-07 (#81138) | Cita de la comunidad | Un comentarista lo llama el issue original, unos cinco meses antes de la corrección | Enlace accesible; contenido no revisado línea a línea |
| 2026-11-05 | Quien reporta | Se abre #107757: 2.1.318, macOS, dirección en el User-Agent de búsquedas web | Abierto, 108 comentarios |
| 2026-11-05 23:31 UTC | Primera mano (colaborador poteat) | El mod integrado cc-plugin-privacy en 2.1.317 y posteriores bloquea de forma determinista el comportamiento, activado por defecto, desactivable en /plugins; el código se publicó después en mods/privacy | README legible; la comunidad dice que no rechazó (sección 5) |
| 2.1.317 (CHANGELOG) | CHANGELOG | Se añade una comprobación que pregunta antes de que una llamada web o de shell envíe a la red el correo de tu cuenta | Entrada presente; dice pregunta, el README dice rechazado sin aviso |
| 2026-11-06 | Primera mano (HN, lydia_hallie, equipo de Claude Code) | El correo de la cuenta se retira del contexto del modelo en la siguiente versión, prevista a principios de la semana siguiente; hasta entonces 2.1.317+ lleva el mod integrado; aun así no evita todos los casos, como que Claude escriba un script y lo ejecute; el canal estable sigue en 2.1.311, actualiza a 2.1.317 o posterior; disculpa | Promesa pública; si se publicó, véase la última fila |
| 2026-11-06 | Comunidad | Usuarios de 2.1.317/2.1.318 (macOS, Windows) informan de que el mod aparece cargado pero el comando de prueba del propio README no se rechaza | No reproducido por nosotros; tratado como posible desajuste entre fuente y binario |
| 2.1.319 (CHANGELOG, última el 11-08) | CHANGELOG | Corregidos un escape del sandbox al crear un worktree; un comando sed que saltaba la comprobación de permisos en accept-edits y auto; y una evasión de permisos de Bash en la que un prefijo de entorno manipulado ocultaba parte del comando | No se encontró ninguna entrada que diga que el correo se retiró del contexto: la retirada está anunciada, no verificada como publicada |
Issue #107757 de GitHub: Bug Report: Privacy violation in User-Agent header · Hacker News: Claude Code sends your email address to websites · CHANGELOG.md de anthropics/claude-code · Issue #81138 de GitHub (2026-07, citado por la comunidad como el informe anterior) · Issue #37201 de GitHub (2026-03, dirección filtrada vía git config)
La última fila es la que más importa. Hasta 2.1.319 no encontramos ninguna entrada del CHANGELOG que diga que el correo de la cuenta se ha retirado del contexto. Por eso este artículo describe la corrección de raíz como anunciada y pendiente, nunca como publicada. Tras actualizar, lee tú el bloque de la versión más reciente de CHANGELOG.md, o usa el script de la sección 7 para vigilar si las sesiones nuevas siguen produciendo estas peticiones.
3. Por qué ocurrió: diseño del contexto, control por prompt y el precedente From de RFC 9110
La declaración de Anthropic en HN expone la cadena causal: había usuarios que informaban de que Claude inventaba nombres para campos como @author porque no tenía contexto sobre la cuenta; el equipo añadió el correo de la cuenta al contexto del modelo; y cuando Claude escribía por sí mismo un comando, como una llamada curl, a veces ponía la dirección en el User-Agent como contacto, porque algunos sitios se lo piden a los agentes. Otro participante de HN publicó el fragmento de contexto que vio, que en esencia le dice al modelo la dirección del usuario, le indica usarla solo para identificarlo en autoría, atribución o filtrado de su propio trabajo, y nunca enviarla a un servicio ajeno salvo petición explícita. Eso coincide con la entrada 2.1.234 del CHANGELOG: el control anterior era una frase de instrucción.
Hacker News: Claude Code sends your email address to websites · CHANGELOG.md de anthropics/claude-code
Desde el diseño de protocolos la tensión es antigua. La sección 10.1.2 de RFC 9110 define la cabecera From como el correo del humano que controla el agente de usuario que hace la petición, y establece que un agente de usuario NO DEBERÍA (SHOULD NOT) enviar From sin configuración explícita del usuario, porque podría chocar con sus intereses de privacidad o con la política de seguridad de su sitio. La misma sección dice que un agente robótico DEBERÍA (SHOULD) enviar un From válido para que se pueda contactar con quien lo opera. Es decir, que los bots se identifiquen y que la identidad del usuario no se filtre sin configuración están ambos en la especificación, y se concilian mediante una elección explícita del usuario. Claude Code entregó la dirección al modelo sin dar nunca esa elección al usuario, así que el modelo la tomó por él.
Conviene separar dos flujos de datos distintos. Las peticiones de la propia herramienta WebFetch de Claude Code, su telemetría y sus informes de error son código de primera mano: la página de uso de datos dice que en los informes de error se redactan patrones conocidos de secretos, rutas y direcciones de correo antes de salir de la máquina, y que WebFetch envía solo el nombre de host a api.anthropic.com para comprobarlo contra una lista de seguridad antes de descargar. Las peticiones de este incidente eran comandos curl redactados por el modelo y ejecutados por la herramienta Bash. Los compromisos documentados sobre lo primero no dicen nada de lo segundo. Un participante de HN observó que su User-Agent de WebFetch era Claude-User (claude-code/2.1.318 (cli); +https://support.anthropic.com/), lo que concuerda con los repetidos informes del issue de que la dirección solo aparecía en peticiones curl, pero también eso es una observación de la comunidad.
Hacker News: Claude Code sends your email address to websites · Documentación de Claude Code: Data usage
4. Qué publicó Anthropic: el README del mod integrado, cláusula por cláusula
El mantenedor poteat escribió en el issue que desde 2.1.317 el mod integrado cc-plugin-privacy bloquea de forma determinista este comportamiento, viene activado por defecto y puede desactivarse vía /plugins; el código se publicó después en mods/privacy dentro del repositorio. Su README es llamativamente contenido y merece leerse cláusula por cláusula. El mod contiene un único hook tool.check sobre llamadas Bash, PowerShell y Monitor. Una llamada se rechaza cuando su entrada contiene la dirección de la cuenta con sesión iniciada (en cualquier combinación de mayúsculas, o tras una pasada de codificación porcentual) y además nombra un User-Agent. Nombrar significa User-Agent, user_agent, --user-agent, -UserAgent, un prefijo de esos flags o UA=, o los flags de cliente curl -A, wget -U y -User de PowerShell.
Issue #107757 de GitHub: Bug Report: Privacy violation in User-Agent header · Código del mod integrado: README de mods/privacy
Dos frases definen lo que es. Primera: la prueba son dos coincidencias de palabras sobre toda la entrada, y no hay analizador sintáctico, a propósito. Así que rechazará una llamada que fije un User-Agent pero envíe la dirección a otra parte, o una que solo mencione la palabra junto a la dirección, y acepta esos falsos rechazos por simplicidad. Segunda: es una cortesía, no un límite, y cubre una sola forma. El README enumera después lo que pasa: la dirección sin User-Agent nombrado (una URL, un cuerpo de petición, curl -u, una cabecera From:); cualquier llamada WebFetch, WebSearch o de herramienta MCP; un valor calculado en tiempo de ejecución como $(git config user.email), una variable, un fichero enviado por nombre, un script que contiene la dirección, un cliente no nombrado, un cliente que fija la cabecera de otro modo, cualquier codificación más allá de una pasada porcentual y una dirección no ASCII codificada.
Hay una incoherencia entre materiales de primera mano que debe registrarse tal cual. La declaración de HN y la entrada 2.1.317 del CHANGELOG dicen que la comprobación te pregunta; el README dice que el rechazo no genera ningún aviso, esté quien esté y sea cual sea el modo de permisos, y que ni una regla allow guardada ni el clasificador del modo auto lo anulan. No podemos saber qué descripción corresponde al binario publicado; guíate por lo que haga tu propia máquina (la sección 10 muestra cómo). Para desactivarlo, según el README: /plugin disable, o "cc-plugin-privacy@builtin": false bajo enabledPlugins en ajustes de usuario, --settings o gestionados; los ajustes de un repositorio no pueden desactivarlo. Un hook de un plugin instalado situado por encima puede anular el rechazo en tool.check, y una sesión sin módulo de hooks cargado no lo ejecuta en absoluto.
CHANGELOG.md de anthropics/claude-code · Código del mod integrado: README de mods/privacy
En cuanto a la corrección de raíz, retirar la dirección del contexto, el 2026-11-08 es una promesa pública. Cuando llegue eliminará la premisa de que el modelo conoce tu correo, pero no cambiará algo que la comunidad ya ha señalado: cuando el modelo inventa un User-Agent para sí mismo también inventa tokens de producto descriptivos, arrastrando el nombre del proyecto, del cliente o de la tarea. La dirección desaparece; el nombre del proyecto puede seguir acabando en el registro de alguien.
5. Las brechas: lo que admite el README frente a lo que informa la comunidad
En la tabla, la columna izquierda procede de la propia lista del README sobre lo que pasa, la central de comentarios del issue (todos informes de la comunidad del 2026-11-06 que no reprodujimos), y la derecha indica si las defensas de las secciones 7 a 10 cubren el caso. Trata la columna central como hipótesis que verificar en tu propia máquina, no como defectos confirmados.
| Escenario | README (mods/privacy) | Informe de la comunidad (issue, no reproducido) | ¿Lo cubre la configuración de este artículo? |
|---|---|---|---|
| Dirección presente pero sin User-Agent nombrado (URL, cuerpo, curl -u, cabecera From:) | Pasa explícitamente | — | Hook: cualquier entrada con la dirección se rechaza, sin necesidad de User-Agent |
| Herramientas WebFetch / WebSearch / MCP | No se comprueban | — | El matcher del hook cubre WebFetch y WebSearch; añade mcp__.* para MCP |
| Valor en tiempo de ejecución $(git config user.email) | Pasa | Un comentarista dice que su dirección se tomó de gitconfig y se envió | El hook rechaza comandos con git config … user.email; además, pasa los commits a una identidad no-reply |
| Dirección escrita en un script con Edit y luego python3 fetch.py | Pasa (un script que contiene la dirección) | mkubenka: exactamente su segundo caso; ninguna entrada de shell comprobada contenía la dirección | El matcher del hook incluye Write y Edit, así que se detiene al escribir |
| Tokens de producto descriptivos en el User-Agent (nombres de proyecto, cliente) | Fuera de alcance (solo compara la dirección) | mkubenka: cadenas como PROJECT-site-build/1.0 sin dirección pasan | No lo cubre el hook; el sandbox limita destinos pero no reescribe cabeceras; queda una convención en CLAUDE.md y revisar transcripciones |
| Mod cargado pero sin rechazar | — | love540 (macOS, 2.1.317/2.1.318) y KardKuro (Windows 11, 2.1.318): el comando de prueba se ejecutó aunque system/init listaba cc-plugin-privacy | Hook y sandbox no dependen del mod; la sección 10 da la comprobación |
| Doble codificación / dirección no ASCII | Pasa | — | El hook añade [at] y una pasada porcentual; otras variantes quedan igual de descubiertas |
| Un hook de plugin superior anula; módulo de hooks no cargado | Lo admite el README | — | Tu hook en ajustes de usuario corre aparte; onFailure: block convierte el fallo del propio hook en bloqueo |
Issue #107757 de GitHub: Bug Report: Privacy violation in User-Agent header · Código del mod integrado: README de mods/privacy
Una autoauditoría de la comunidad merece atención. El participante morsik hizo que Claude revisara cada llamada a herramienta bajo ~/.claude/projects/**/*.jsonl y encontró 53 llamadas en 8 sesiones entre el 2026-08-09 y el 2026-11-01 que ponían la dirección en un User-Agent, casi todas de subagentes de flujos de trabajo que escribían su propio curl -A "TOOL/1.0 (dirección)" y no de WebFetch. Se siguen tres cosas: la ventana empieza mucho antes de noviembre; el vehículo principal son los comandos de shell de los subagentes; y tus transcripciones locales son el mejor material de auditoría que tienes. El script de la sección 7 está hecho justo para eso.
Issue #107757 de GitHub: Bug Report: Privacy violation in User-Agent header
6. El recorrido de la petición: de dónde sale la dirección, adónde va y dónde se sitúa cada defensa
Para juzgar si una defensa sirve, dibuja cada paso que dan los datos. Empieza en el inicio de sesión: los informes de la comunidad sitúan la dirección de la cuenta en el campo oauthAccount.emailAddress de ~/.claude.json (afirmación de un comentarista que no contrastamos con el código), y se colocaba en el contexto del modelo (confirmado de primera mano). El paso dos es el modelo generando una llamada a herramienta: un comando Bash, una URL de WebFetch, un Write que deja un script en disco. El paso tres es la comprobación previa a la llamada: tu hook PreToolUse y el tool.check del mod integrado viven aquí y solo ven los parámetros de texto de la llamada. El paso cuatro son las reglas de permisos: las reglas deny se mantienen en todo modo de permisos, las ask preguntan y el clasificador del modo auto actúa después de las reglas deterministas. El paso cinco es el sandbox: los comandos Bash, PowerShell y Monitor corren dentro de un límite impuesto por el sistema operativo cuya red pasa por un proxy local que coteja cada host con allowedDomains, lista que empieza vacía; Read, Edit, Write, WebFetch, WebSearch, hooks, servidores MCP, mods y los comandos que tecleas tras ! quedan fuera. El último paso es el servidor remoto escribiendo la cabecera en su registro, y a partir de ahí no hay ningún control local.
De ahí se desprenden dos hechos estructurales. Primero, toda comprobación textual (mod, hook, regla deny) es ciega a valores que solo existen en tiempo de ejecución: $(git config user.email), variables de entorno, contenidos de fichero que lee un script. Solo el proxy del sandbox es independiente del texto del comando, y controla el destino, no el contenido de la cabecera. Segundo, retirar la dirección del contexto es la única medida que cambia el punto de partida; todo lo demás son puestos de control después de que la dirección ya lo haya abandonado. La combinación sensata es, pues, esperar y verificar la corrección de raíz mientras se usa un hook contra las formas textuales, el sandbox contra los destinos y una identidad git separada para reducir lo que puedan revelar las consultas en tiempo de ejecución.
- Inicio de sesión → la dirección llega a ~/.claude.json (afirmación de la comunidad) y al contexto del modelo (primera mano)
- El modelo redacta una llamada: comando Bash / URL de WebFetch / Write de un script (puede insertar la dirección como contacto)
- Hook PreToolUse y tool.check del mod integrado: coincidencia textual sobre la llamada; exit 2 o rechazo la detienen
- Reglas de permisos: deny se mantiene en todo modo, ask pregunta, después juzga el clasificador de auto
- Proxy de red del sandbox: solo Bash/PowerShell/Monitor; allowedDomains pasa, deniedDomains se rechaza
- El servidor de terceros registra el User-Agent → ya no queda control local
Issue #107757 de GitHub: Bug Report: Privacy violation in User-Agent header · Documentación de Claude Code: Hooks · Documentación de Claude Code: Sandboxing · Documentación de Claude Code: Best practices · Documentación de Claude Code: Permissions
7. Autoauditoría: busca en tus transcripciones locales las llamadas que llevaron la dirección
Claude Code guarda los registros de sesión de cada proyecto como ficheros .jsonl bajo ~/.claude/projects, o bajo CLAUDE_CONFIG_DIR cuando está definido. El formato no está documentado, así que el script no asume una estructura fija: analiza cada línea como JSON, recorre cada objeto de forma recursiva y, cuando encuentra un nodo con type igual a tool_use y un objeto input, serializa ese input y busca en él la dirección que le pases, incluida su forma con codificación porcentual. Al acertar imprime la marca de tiempo, un prefijo del nombre de fichero, el nombre de la herramienta, si además se nombró un User-Agent, y los primeros 220 caracteres de la entrada redactada. Solo lee: no cambia nada ni hace ninguna llamada de red.
Documentación de Claude Code: Hooks · Documentación de Claude Code: Settings
#!/usr/bin/env python3
"""Read-only audit of local Claude Code transcripts: which recorded tool calls
carried the address you pass in? Nothing is modified or sent anywhere."""
import json, os, re, sys
from pathlib import Path
from urllib.parse import quote
if len(sys.argv) < 2 or "@" not in sys.argv[1]:
sys.exit("usage: python3 audit_transcripts.py you@example.com")
ADDR = sys.argv[1].strip().lower()
FORMS = {ADDR, quote(ADDR, safe=""), ADDR.replace("@", "%40")}
ROOT = Path(os.environ.get("CLAUDE_CONFIG_DIR", Path.home() / ".claude")) / "projects"
UA = re.compile(r"user[-_ ]?agent|(?:^|\s)-A\s|(?:^|\s)-U\s|-UserAgent", re.I)
def tool_uses(node): # the transcript format is undocumented: walk every object
if isinstance(node, dict):
if node.get("type") == "tool_use" and isinstance(node.get("input"), dict):
yield node
for value in node.values():
yield from tool_uses(value)
elif isinstance(node, list):
for value in node:
yield from tool_uses(value)
hits, files = 0, set()
for path in sorted(ROOT.glob("**/*.jsonl")):
for line in path.open(encoding="utf-8", errors="replace"):
try:
rec = json.loads(line)
except ValueError:
continue
for call in tool_uses(rec):
raw = json.dumps(call["input"], ensure_ascii=False)
if not any(form in raw.lower() for form in FORMS):
continue
hits += 1; files.add(path)
shown = raw
for form in FORMS:
shown = re.sub(re.escape(form), "<account email>", shown, flags=re.I)
print(f"{str(rec.get('timestamp', '?'))[:19]} {path.stem[:8]} "
f"tool={call.get('name')} ua_named={'yes' if UA.search(raw) else 'no'}")
print(" " + shown[:220])
print(f"\n{hits} tool call(s) in {len(files)} transcript file(s) contained the address.")
Tres cosas a tener en cuenta al leer la salida. Las líneas con ua_named=yes se corresponden a grandes rasgos con lo que detectaría el mod integrado; las líneas ua_named=no son las formas que el README admite que pasan (URL, cuerpos de petición, contenidos de script). Si los aciertos se concentran en Write o Edit, la dirección se escribió en un script y luego se ejecutó, que es precisamente el camino que la comunidad dice que el mod no ve. Y el número de aciertos no es el número de peticiones realmente enviadas: un comando pudo fallar, pudiste rechazarlo en el aviso, y la transcripción nunca registra si el servidor remoto recibió algo. Te dice que el modelo pretendía hacerlo, que basta para decidir si necesitas el hook de la sección 8.
8. Primera defensa determinista: un hook PreToolUse que rechaza cualquier entrada con tu identidad
La documentación de hooks especifica que un hook PreToolUse recibe por stdin un JSON con tool_name y tool_input (command para Bash; file_path y content para Write; new_string para Edit; url y prompt para WebFetch, etcétera); salir con código 2 bloquea la llamada y stderr se convierte en el motivo mostrado al modelo; alternativamente el hook puede imprimir un objeto hookSpecificOutput con permissionDecision igual a deny. Los matchers aceptan nombres de herramienta como Bash o Edit|Write y expresiones regulares. Desde 2.1.314 un matcher Bash también se ejecuta para comandos iniciados por la herramienta Monitor. Los hooks se disparan también dentro de subagentes, que es exactamente de donde, según la comunidad, salieron la mayoría de estas peticiones.
El hook de abajo es deliberadamente más amplio que el mod integrado: si cualquier campo de tool_input contiene una de tus identidades (una dirección por línea en ~/.claude/private-identifiers.txt, más lo que devuelva ahora mismo git config user.email), sale con 2 se nombre o no un User-Agent. También rechaza comandos Bash o PowerShell que contengan git config … user.email, porque una consulta en tiempo de ejecución es algo que ninguna comprobación textual puede ver. El coste son los falsos rechazos: cuando de verdad le pidas a Claude que escriba tu propia dirección en un fichero de configuración, el hook lo detendrá también, y su stderr le dirá al modelo que te pida hacer ese paso a mano. El compromiso es intencionado y refleja la actitud del propio README ante los falsos rechazos.
#!/usr/bin/env python3
"""PreToolUse hook: exit 2 (block) when a tool input carries one of your own
addresses, or reads the git identity at run time. Reads stdin JSON only."""
import json, os, re, subprocess, sys
from pathlib import Path
from urllib.parse import quote
def identities():
ids = set()
listed = Path(os.environ.get("IDENTITY_GUARD_FILE",
Path.home() / ".claude" / "private-identifiers.txt"))
if listed.is_file():
ids |= {l.strip().lower() for l in listed.read_text().splitlines() if "@" in l}
try: # whatever `git config user.email` would answer right now
out = subprocess.run(["git", "config", "--get", "user.email"],
capture_output=True, text=True, timeout=3).stdout.strip()
if "@" in out:
ids.add(out.lower())
except (OSError, subprocess.SubprocessError):
pass
return ids
payload = json.load(sys.stdin)
tool = payload.get("tool_name", "")
blob = json.dumps(payload.get("tool_input", {}), ensure_ascii=False).lower()
reasons = []
for addr in identities():
forms = {addr, quote(addr, safe=""), addr.replace("@", "%40"), addr.replace("@", "[at]")}
if any(form.lower() in blob for form in forms):
reasons.append(f"input contains a private identifier ({addr[:2]}***)")
if tool in ("Bash", "PowerShell") and re.search(r"git\s+config\b[^|;&]*user\.email", blob):
reasons.append("command reads the git identity at run time, which this hook cannot see")
if reasons:
sys.stderr.write("identity-guard: " + "; ".join(reasons)
+ ". Remove it, or ask the user to run this step by hand.\n")
sys.exit(2)
Dos notas de implementación. Usar Python en lugar de jq permite serializar una sola vez todo tool_input y buscar en él, así que no hacen falta nombres de campo por herramienta; la documentación avisa de que en Windows file_path llega con barras invertidas, pero este script no compara rutas, así que no le afecta. El hook no imprime JSON y confía solo en su código de salida: según la documentación, exit 2 más stderr es la forma estándar de bloquear y transmitir un motivo, mientras que un código que no sea 0 ni 2 no bloquea por defecto. Por eso el registro de la sección 9 fija onFailure: block (disponible desde 2.1.295), para que un fallo o un tiempo de espera agotado del script cuente también como bloqueo.
9. Defensas deterministas segunda y tercera: reglas deny y lista blanca de red del sandbox en un solo settings.json
La página de buenas prácticas fija los principios: las reglas deny se mantienen en todo modo de permisos, incluidos auto y bypassPermissions; una regla como Read(./.env) atrapa también cat .env porque Claude Code reconoce los comandos habituales de lectura de ficheros, pero no atrapará un script que abra el fichero por su cuenta; y una regla deny de WebFetch para un dominio no hace nada contra curl a ese mismo dominio salvo que el sandbox esté activo. Su conclusión: para cualquier cosa relacionada con la seguridad quieres ambas. La página de permisos añade que las reglas deny de Bash comparan el comando tal como está escrito, de modo que /usr/bin/curl o sh -c 'curl …' se cuelan, y por eso una restricción de red que deba cumplirse necesita la lista blanca del sandbox.
Documentación de Claude Code: Best practices · Documentación de Claude Code: Permissions · Documentación de Claude Code: Security
Hechos clave de la página de sandboxing: el sandbox está desactivado por defecto y se activa con /sandbox o "sandbox": {"enabled": true}; macOS usa Seatbelt, Linux y WSL2 usan bubblewrap más socat, Windows nativo no está soportado; no hay salida directa, las conexiones pasan por un proxy local que coteja allowedDomains, que empieza vacía; un host fuera de la lista pregunta en modo manual, se rechaza en modo dontAsk y se permite en bypassPermissions, mientras que deniedDomains se rechaza en todo modo; allowUnsandboxedCommands: false desactiva el reintento fuera del sandbox (modo estricto en la pestaña Overrides); y las entradas deny de credentials.files y credentials.envVars impiden que los comandos del sandbox lean ~/.ssh y similares o vean variables nombradas. Esas entradas de credentials, sin embargo, solo se aplican desde ajustes de usuario o gestionados; las de ajustes de proyecto y locales se ignoran.
{
"permissions": {
"deny": ["Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)", "Read(~/.claude.json)"],
"ask": ["Bash(curl *)", "Bash(wget *)", "Bash(dangerouslyDisableSandbox:true)"]
},
"hooks": {
"PreToolUse": [
{
"matcher": "Bash|PowerShell|Write|Edit|WebFetch|WebSearch",
"hooks": [
{
"type": "command",
"command": "python3 ~/.claude/hooks/identity_guard.py",
"timeout": 10,
"onFailure": "block"
}
]
}
]
},
"sandbox": {
"enabled": true,
"allowUnsandboxedCommands": false,
"network": {
"allowedDomains": ["github.com", "*.npmjs.org", "pypi.org", "files.pythonhosted.org"]
},
"credentials": {
"files": [
{ "path": "~/.ssh", "mode": "deny" },
{ "path": "~/.aws/credentials", "mode": "deny" }
],
"envVars": [{ "name": "GITHUB_TOKEN", "mode": "deny" }]
}
}
}Punto por punto: Read(~/.claude.json) apunta al fichero que la comunidad señala como almacén de la dirección, de modo que la herramienta Read del modelo y los comandos reconocidos como cat no puedan leerlo (el propio Claude Code sí puede); las reglas ask Bash(curl *) y Bash(wget *) hacen que los comandos de red pregunten siempre, y la página de seguridad señala que en modo manual esos comandos no se aprueban automáticamente de todos modos; Bash(dangerouslyDisableSandbox:true) es la regla ask que recomienda la página de sandboxing, que pregunta ante un reintento fuera del sandbox incluso en los modos auto y bypassPermissions y respalda a allowUnsandboxedCommands: false; allowedDomains es un marcador que debes sustituir por lo que tu compilación necesite de verdad. El matcher del hook dice Bash|PowerShell|Write|Edit|WebFetch|WebSearch; si descargas páginas con herramientas MCP, añade también un matcher para mcp__.*.
Documentación de Claude Code: Sandboxing · Documentación de Claude Code: Permissions · Documentación de Claude Code: Security
| Capa | Naturaleza | Cubre | No cubre | Base |
|---|---|---|---|---|
| La frase en el contexto del sistema (desde 2.1.234) | No determinista | Recuerda al modelo usar la dirección solo para identificarte | El modelo puede decidir que este caso es la excepción, que es lo que pasó | CHANGELOG; buenas prácticas |
| Convenciones en CLAUDE.md | No determinista | Nomenclatura de User-Agent del equipo, qué sitios pueden recibir un contacto | Cualquier regla que deba cumplirse siempre | Buenas prácticas |
| Mod integrado cc-plugin-privacy | Determinista (coincidencia textual) | Dirección más User-Agent nombrado en entradas Bash/PowerShell/Monitor | Dirección sin User-Agent, WebFetch/WebSearch/MCP, valores en ejecución, scripts con la dirección, otras codificaciones; anulable por un plugin superior | README |
| Tu hook PreToolUse | Determinista (coincidencia textual) | Cualquier forma de identidad en entradas Bash/PowerShell/Write/Edit/WebFetch/WebSearch; comandos git config user.email | Valores en ejecución, variables, identidades no listadas, tokens de producto descriptivos | Documentación de hooks |
| permissions.deny / ask | Determinista (comando tal como se escribe) | Lectura de .env y ~/.claude.json; curl/wget preguntan siempre | Programas llamados por ruta o envueltos en sh -c; scripts que abren ficheros por sí mismos | Documentación de permisos, buenas prácticas y seguridad |
| Lista blanca de red del sandbox (modo estricto) | Determinista (nivel de SO) | Destinos de comandos Bash/PowerShell/Monitor; ficheros y variables de credenciales | Read/Edit/Write/WebFetch/WebSearch, hooks, MCP, mods, comandos con !; contenido de cabeceras | Documentación de sandboxing |
| Retirar la dirección del contexto (anunciado) | Elimina la premisa | El modelo ya no conoce el correo de tu cuenta | Direcciones en git config, ficheros, entorno; nombres de proyecto en el User-Agent | Declaración en HN; CHANGELOG pendiente |
CHANGELOG.md de anthropics/claude-code · Código del mod integrado: README de mods/privacy · Documentación de Claude Code: Hooks · Documentación de Claude Code: Sandboxing · Documentación de Claude Code: Best practices · Documentación de Claude Code: Permissions
10. Verificación: confirma el rechazo con un comando inofensivo y pasa git a una identidad no-reply
Una configuración escrita no es una configuración que funcione. La documentación de hooks advierte de que una ruta mal escrita en settings.json hace que el hook no se ejecute nunca y de que conviene vigilar el aviso hook error en su primera ejecución. El script de abajo hace cinco cosas: imprime claude --version; alimenta cuatro cargas PreToolUse sintéticas directamente al hook (el fichero temporal de identidades contiene solo you@example.com y todos los destinos son nombres .invalid, así que no se envía nada); te indica que pidas a Claude, en una sesión real, ejecutar echo 'User-Agent: test TU-DIRECCIÓN' > /dev/null y observes el rechazo; imprime tu identidad git actual; y te recuerda comprobar /plugins y /sandbox.
Documentación de Claude Code: Hooks · Documentación de Claude Code: Sandboxing
#!/usr/bin/env bash
# Verify the guard without sending anything: every target is a non-routable .invalid name.
set -u
echo "1) version (the built-in mod needs 2.1.317+; read CHANGELOG.md for the context change)"
claude --version
echo "2) hook blocks synthetic payloads (expect exit=2 and an identity-guard reason on stderr)"
tmp=$(mktemp); echo "you@example.com" > "$tmp"
run() { printf '%s' "$1" | IDENTITY_GUARD_FILE="$tmp" python3 ~/.claude/hooks/identity_guard.py; echo " exit=$?"; }
run '{"tool_name":"Bash","tool_input":{"command":"curl -A \"bot/1.0 (you@example.com)\" http://leak-test.invalid/"}}'
run '{"tool_name":"Write","tool_input":{"file_path":"/tmp/fetch.py","content":"UA = \"tool/0.1 (mailto:you%40example.com)\""}}'
run '{"tool_name":"Bash","tool_input":{"command":"curl -A \"$(git config user.email)\" http://leak-test.invalid/"}}'
run '{"tool_name":"Bash","tool_input":{"command":"npm test"}}' # expect exit=0
rm -f "$tmp"
echo "3) inside a session, ask Claude to run exactly: echo 'User-Agent: test <your address>' > /dev/null"
echo " expected: the call is refused and the transcript shows the identity-guard reason"
echo "4) git identity any \$(git config user.email) would reveal:"; git config --get user.email || echo "(unset)"
echo " prefer a no-reply address for agent commits: git config --global user.email <id>+<name>@users.noreply.github.com"
echo "5) /plugins -> Installed should list cc-plugin-privacy@builtin; /sandbox -> Network shows the allowlist, Overrides shows strict mode"
Esa prueba con echo sale directamente de los comentarios del issue: no toca la red pero contiene tanto la dirección como las palabras User-Agent, justo la forma que el README promete rechazar. La comunidad obtuvo con ella se ejecutó, no se rechazó; tú deberías ver uno de dos resultados. Si el mod integrado funciona, el modelo recibe el REFUSAL del mod; si solo funciona tu hook, la transcripción muestra un motivo que empieza por identity-guard:. Si no aparece ninguno, tu hook no se está ejecutando: revisa la ruta en settings.json y que python3 esté en el PATH.
Issue #107757 de GitHub: Bug Report: Privacy violation in User-Agent header · Código del mod integrado: README de mods/privacy
Separar tu identidad git es la defensa más barata de todas. El README y la comunidad nombran $(git config user.email) como una vía en tiempo de ejecución que ninguna comparación textual puede ver. Una vez que tu user.email global sea una dirección no-reply emitida por tu plataforma de código, un comando que lo lea filtrará solo una dirección que no recibe correo. Esto cambia el correo de autor de tus commits, así que si tu equipo exige DCO o comprobaciones de firma, confirma antes que la dirección está vinculada a tu cuenta en la plataforma.
11. Orden de actuación: hoy, tras actualizar y de forma continua
- Hoy: ejecuta el script de auditoría de la sección 7 para saber si te afecta y si el vehículo fue el curl de los subagentes; guarda la salida para ti y no se la envíes a nadie.
- Hoy: instala el hook y los ajustes de las secciones 8 y 9 en el ámbito de usuario, ejecuta el script de verificación de la sección 10 y cambia tu identidad git global a una dirección no-reply.
- Actualiza a 2.1.317 o posterior (la declaración de HN decía que el canal estable seguía en 2.1.311), confirma en /plugins que cc-plugin-privacy@builtin está cargado y usa la prueba con echo para comprobar que rechaza de verdad: los informes de la comunidad sugieren que cargado y rechazando pueden ser dos cosas distintas.
- Tras cada actualización, lee el bloque de la versión más reciente de CHANGELOG.md en busca de una entrada que diga que el correo de la cuenta se ha retirado del contexto; hasta que la veas, trata la corrección como no publicada.
- De forma continua: vuelve a ejecutar la auditoría sobre sesiones nuevas de vez en cuando, y fija en CLAUDE.md la convención de que los User-Agent redactados por el modelo usen un token genérico sin nombre de proyecto ni de cliente. Eso es no determinista y solo un complemento.
- Equipos: compartid el hook y las reglas deny mediante el .claude/settings.json del repositorio (deny se aplica de inmediato, allow espera al diálogo de confianza), recordando que las entradas credentials y el sandbox estricto necesitan ajustes de usuario o gestionados.
Una última palabra sobre la proporción. La lección no es que no se pueda confiar en Claude Code; es que todo lo que se coloque en el contexto del modelo debe suponerse capaz de aparecer en cualquier cadena que el modelo genere. La dirección de correo es solo el caso más fácil de observar; los nombres de proyecto, de cliente y de hosts internos recorren el mismo camino. Los controles deterministas valen porque no dependen del juicio del modelo, y el script de auditoría vale porque te permite decidir el siguiente paso con tus propios datos y no con una captura de pantalla ajena.
Lo que no verificamos: no reprodujimos el comportamiento original de la dirección entrando en un User-Agent en ninguna versión; no probamos si el mod integrado en 2.1.317, 2.1.318 o 2.1.319 rechaza de verdad el comando que describe su README (la comunidad dice que no; no lo reprodujimos); no comprobamos la afirmación sobre un campo oauthAccount.emailAddress en ~/.claude.json; no encontramos ninguna entrada del CHANGELOG que diga que el correo se retiró del contexto, así que tratamos la corrección de raíz como anunciada pero no confirmada como publicada; y no leímos los issues #81138 y #37201 línea a línea, solo confirmamos que los enlaces resuelven. El hook, los ajustes y los scripts se probaron sin conexión solo con datos sintéticos y nombres .invalid, nunca en producción ni en una red real. Este artículo analiza el producto y el repositorio de código abierto de Anthropic; este sitio no tiene relación con Anthropic.