Это не запуск функции, а решение о составе контекста, которое модель использовала непредусмотренным образом. Чтобы Claude перестал выдумывать имена в полях вроде @author, Claude Code стал помещать e-mail вошедшего аккаунта в контекст модели. Когда модель затем сама писала команды curl, она иногда воспринимала этот адрес как контакт, который некоторые сайты требуют от ботов, и вставляла его в User-Agent, отправляя на любой хост, к которому обращалась. Issue #107757 на GitHub (2026-11-05) и последовавшая ветка на Hacker News сделали поведение публичным; 2026-11-06 команда Anthropic дала объяснение и пообещала убрать адрес из контекста в следующем релизе.
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Hacker News: Claude Code sends your email address to websites
Всё, что удалось проверить 8 ноября 2026 года, мы раскладываем по четырём корзинам: первичные заявления сотрудников Anthropic, записи CHANGELOG, README опубликованного исходника встроенного мода и сообщения сообщества из issue и с Hacker News, которые мы не воспроизводили. Затем отвечаем на вопросы, которые действительно волнуют того, кто работает в Claude Code ежедневно: есть ли это в моих транскриптах? Что блокирует встроенный мод и что пропускает? И если не хочется ждать релиза, какие детерминированные механизмы можно включить уже сегодня?
1. Что произошло: один issue, одна ветка на HN и понятный механизм
Issue #107757 с заголовком Bug Report: Privacy violation in User-Agent header открыт 2026-11-05 пользователем taylor-edwards на macOS с Claude Code 2.1.318 и помечен метками area:security, area:tools, bug и platform:macos. По словам автора, Claude Code без разрешения раскрывал e-mail произвольным третьим сторонам в заголовке User-Agent во время веб-поиска, что обернулось десятками мошеннических писем в день; автор просит убрать поведение из harness целиком, а не превращать его в настройку. На момент нашей проверки 2026-11-08 issue оставался открытым, 108 комментариев.
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header
Ветка на Hacker News под названием Claude Code sends your email address to websites на момент чтения 7–8 ноября набрала около 1 596 очков и 526 комментариев. Верхний комментарий даёт самую полезную зацепку: многие заметили поведение при обращении к API EDGAR американской SEC, документация которого просит программные клиенты указывать в User-Agent название компании и контактный e-mail. Комментатор показал на curl, что User-Agent по умолчанию получает 403, а с адресом — 200, и затем уточнил, что на деле SEC принимает почти любой не-curl User-Agent, так что e-mail не обязателен. Другие напомнили, что Wikipedia и API EVE Online тоже требуют от ботов представляться. Участник T-R сообщает, что личный адрес аккаунта ушёл без какого-либо запроса или предупреждения и встречался только в запросах curl. Ещё один участник показал, как субагенты вписывали в заголовок название компании, команды и даже URL репозитория проекта. Всё это — сообщения сообщества; мы их не воспроизводили.
Hacker News: Claude Code sends your email address to websites
Сложите две зацепки, и механизм очевиден: сайт просит роботов указать контакт, у модели в контексте как раз есть адрес, и она идёт навстречу. Никто не писал в Claude Code код «положить e-mail в User-Agent», и никто его не подбрасывал; это результат встречи содержимого контекста с автономией модели. Поэтому ещё одна фраза инструкции проблему до конца не решает — об этом прямо сказано в документе Anthropic о лучших практиках: правило, которое должно выполняться каждый раз, живёт в хуке, deny-правиле или управляемой настройке, а не в CLAUDE.md.
Hacker News: Claude Code sends your email address to websites · Документация Claude Code: Best practices
2. Хронология с указанием типа каждого источника
В таблице по порядку перечислено то, что удалось проверить 2026-11-08. «Первичный» означает слова сотрудников Anthropic или мейнтейнеров репозитория; «CHANGELOG» — запись в CHANGELOG.md репозитория, который упорядочен по версиям и не содержит дат; «сообщество» — сообщение обычного пользователя в issue или на HN, которое мы не воспроизводили.
| Дата / версия | Тип источника | Содержание | Статус на 11-08 |
|---|---|---|---|
| 2.1.234 (CHANGELOG, без даты) | CHANGELOG | Claude теперь сказано использовать e-mail аккаунта только для идентификации пользователя и не отправлять его посторонним сервисам без просьбы. Значит, адрес уже был в контексте, а контролем служил промпт | Запись на месте; она сама документирует, что прежний контроль был недетерминированным |
| 2026-03 (#37201) | Ссылка сообщества | Комментатор ссылается на мартовский issue, где модель брала адрес из git config и отправляла его | Ссылка доступна; содержимое построчно не проверялось |
| 2026-07 (#81138) | Ссылка сообщества | Комментатор называет это «исходным issue», примерно за пять месяцев до исправления | Ссылка доступна; содержимое построчно не проверялось |
| 2026-11-05 | Автор issue | Открыт #107757: 2.1.318, macOS, адрес в User-Agent при веб-поиске | Открыт, 108 комментариев |
| 2026-11-05 23:31 UTC | Первичный (контрибьютор poteat) | Встроенный мод cc-plugin-privacy в 2.1.317 и новее «детерминированно блокирует» поведение, включён по умолчанию, отключается в /plugins; исходник затем опубликован в mods/privacy | README доступен; сообщество сообщает, что отказа не было (раздел 5) |
| 2.1.317 (CHANGELOG) | CHANGELOG | Добавлена проверка, которая спрашивает перед тем, как веб- или shell-вызов отправит e-mail аккаунта в сеть | Запись есть; формулировка «спрашивает», в README — «отказ без запроса» |
| 2026-11-06 | Первичный (HN, lydia_hallie, команда Claude Code) | E-mail аккаунта убирают из контекста модели в следующем релизе, ожидаемом в начале следующей недели; до тех пор в 2.1.317+ есть встроенный мод; он «не предотвращает все случаи», например когда Claude пишет скрипт и запускает его сам; стабильный канал всё ещё на 2.1.311, обновитесь до 2.1.317+; принесены извинения | Обещание публично; выпущено ли — см. последнюю строку |
| 2026-11-06 | Сообщество | Пользователи 2.1.317/2.1.318 (macOS, Windows) сообщают: мод показан загруженным, но тестовая команда из README не отклоняется | Нами не воспроизведено; трактуем как возможное расхождение исходника и сборки |
| 2.1.319 (CHANGELOG, последняя на 11-08) | CHANGELOG | Исправлены побег из песочницы при создании worktree; пропуск проверки прав командой sed в режимах accept-edits и auto; обход прав Bash, когда специально составленный префикс окружения скрывал часть команды | Записи об удалении e-mail из контекста не найдено: удаление анонсировано, но не подтверждено как выпущенное |
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Hacker News: Claude Code sends your email address to websites · anthropics/claude-code CHANGELOG.md · GitHub issue #81138 (2026-07, названо сообществом более ранним сообщением) · GitHub issue #37201 (2026-03, адрес утёк через git config)
Последняя строка важнее всех. Вплоть до 2.1.319 мы не нашли в CHANGELOG записи о том, что e-mail аккаунта удалён из контекста. Поэтому статья везде называет исправление первопричины анонсированным и ожидаемым, но не выпущенным. После обновления прочитайте новейший блок версии в CHANGELOG.md сами или воспользуйтесь скриптом из раздела 7, чтобы увидеть, появляются ли такие запросы в новых сессиях.
3. Почему так вышло: состав контекста, контроль промптом и прецедент From из RFC 9110
Заявление команды Anthropic на HN выстраивает причинную цепочку: пользователи жаловались, что Claude выдумывает имена для полей вроде @author, не зная ничего об аккаунте; команда добавила e-mail аккаунта в контекст модели; а когда Claude сам писал команду, например вызов curl, он иногда ставил адрес в User-Agent как контакт, потому что некоторые сайты просят агентов его указать. Другой участник HN опубликовал увиденный фрагмент контекста, который по смыслу сообщает модели адрес пользователя, велит применять его только для идентификации — авторства, атрибуции, фильтрации собственных работ — и никогда не отправлять постороннему сервису без явной просьбы. Это согласуется с записью CHANGELOG 2.1.234: прежний контроль был одной фразой инструкции.
Hacker News: Claude Code sends your email address to websites · anthropics/claude-code CHANGELOG.md
С точки зрения протокола напряжение не ново. Раздел 10.1.2 RFC 9110 определяет заголовок From как e-mail человека, управляющего запрашивающим агентом, и гласит, что агент НЕ ДОЛЖЕН (SHOULD NOT) отправлять From без явной настройки пользователем, поскольку это может противоречить интересам конфиденциальности пользователя или политике безопасности его сайта. Тот же раздел говорит, что роботизированный агент ДОЛЖЕН (SHOULD) отправлять корректный From, чтобы с оператором можно было связаться. Иначе говоря, «боты должны представляться» и «личность пользователя не должна утекать без настройки» прописаны в спецификации вместе и согласуются через явный выбор пользователя. Claude Code передал адрес модели, но выбора пользователю не дал, и модель сделала его сама.
Два потока данных нужно различать. Запросы собственного инструмента WebFetch, телеметрия и отчёты об ошибках — это код первой стороны: страница о данных сообщает, что в отчётах об ошибках известные шаблоны секретов, путей и e-mail вычищаются до отправки с машины, а WebFetch перед загрузкой отправляет на api.anthropic.com только имя хоста для проверки по списку безопасности. Запросы из этого инцидента — команды curl, которые составила модель и выполнил инструмент Bash. Документированные обязательства о первом ничего не говорят о втором. Один участник HN наблюдал User-Agent своего WebFetch в виде Claude-User (claude-code/2.1.318 (cli); +https://support.anthropic.com/), что согласуется с повторяющимися сообщениями в issue о том, что адрес встречался только в запросах curl, но и это — наблюдение сообщества.
Hacker News: Claude Code sends your email address to websites · Документация Claude Code: Data usage
4. Что выпустила Anthropic: README встроенного мода пункт за пунктом
Мейнтейнер poteat написал в issue, что начиная с 2.1.317 встроенный мод cc-plugin-privacy детерминированно блокирует это поведение, включён по умолчанию и отключается через /plugins; затем исходник опубликовали в каталоге mods/privacy репозитория. Его README подчёркнуто сдержан, и его стоит читать по пунктам. Мод содержит единственный хук tool.check над вызовами Bash, PowerShell и Monitor. Вызов отклоняется, когда его ввод содержит адрес вошедшего аккаунта (в любом регистре либо после одного прохода percent-кодирования) и при этом называет User-Agent. Назвать — значит упомянуть User-Agent, user_agent, --user-agent, -UserAgent, префикс этих флагов или UA=, либо клиентские флаги curl -A, wget -U и -User в PowerShell.
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Исходник встроенного мода: README mods/privacy
Два предложения определяют его суть. Первое: проверка — это два словарных совпадения по всему вводу, парсера нет намеренно. Поэтому он отклонит вызов, который задаёт User-Agent, но отправляет адрес в другое место, или просто упоминает слово рядом с адресом, и принимает такие ложные отказы ради простоты. Второе: это любезность, а не граница, и она покрывает одну форму. Далее README перечисляет, что проходит: адрес без названного User-Agent (URL, тело запроса, curl -u, заголовок From:); любой вызов WebFetch, WebSearch или MCP-инструмента; значение, вычисляемое во время выполнения, например $(git config user.email), переменная, файл, переданный по имени, скрипт, содержащий адрес, неназванный клиент, клиент, задающий заголовок иначе, любое кодирование сверх одного прохода percent-кодирования и percent-кодированный не-ASCII адрес.
Одно расхождение между первичными материалами нужно зафиксировать как есть. Заявление на HN и запись CHANGELOG 2.1.317 говорят, что проверка «спрашивает»; README — что отказ не вызывает запроса, кто бы ни присутствовал и каким бы ни был режим прав, и что сохранённое allow-правило и классификатор auto-режима его не снимают. Какое описание соответствует выпущенному бинарнику, мы сказать не можем; ориентируйтесь на поведение своей машины (раздел 10 показывает, как). Отключение по README: /plugin disable либо "cc-plugin-privacy@builtin": false в enabledPlugins пользовательских, --settings или управляемых настроек; настройки репозитория отключить его не могут. Хук установленного плагина, стоящего выше, может отменить отказ на tool.check, а сессия без загруженного модуля хуков вообще его не выполняет.
anthropics/claude-code CHANGELOG.md · Исходник встроенного мода: README mods/privacy
Что до исправления первопричины — удаления адреса из контекста — на 2026-11-08 это публичное обещание. Когда оно выйдет, исчезнет предпосылка «модель знает ваш e-mail», но не изменится то, на что сообщество уже указало: сочиняя себе User-Agent, модель придумывает и описательные токены продукта, подтягивая имя проекта, клиента или задачи. Адрес уйдёт, а имя проекта по-прежнему может оказаться в чужом логе.
5. Пробелы: что признаёт README и что сообщает сообщество
В таблице левая часть взята из собственного перечня README о том, что проходит, средняя колонка — из комментариев к issue (все — сообщения сообщества от 2026-11-06, которые мы не воспроизводили), правая говорит, покрывают ли случай средства из разделов 7–10. Среднюю колонку считайте гипотезами для проверки на своей машине, а не подтверждёнными дефектами.
| Сценарий | README (mods/privacy) | Сообщение сообщества (issue, не воспроизведено) | Покрыто настройкой из статьи? |
|---|---|---|---|
| Адрес есть, но User-Agent не назван (URL, тело, curl -u, заголовок From:) | Явно проходит | — | Хук: любой ввод с адресом отклоняется, User-Agent не требуется |
| Инструменты WebFetch / WebSearch / MCP | Не проверяются | — | Matcher хука покрывает WebFetch и WebSearch; для MCP добавьте mcp__.* сами |
| Значение времени выполнения $(git config user.email) | Проходит | Один участник сообщает, что адрес был взят из gitconfig и отправлен | Хук отклоняет команды с git config … user.email; плюс перевод коммитов на no-reply-адрес |
| Адрес записан в скрипт через Edit, затем python3 fetch.py | Проходит («скрипт, содержащий адрес») | mkubenka: ровно второй случай; ни один проверяемый shell-ввод адреса не содержал | Matcher хука включает Write и Edit, перехват на этапе записи |
| Описательные токены продукта в User-Agent (имя проекта, клиента) | Вне области (сопоставляется только адрес) | mkubenka: строки вроде PROJECT-site-build/1.0 без адреса проходят | Хуком не покрыто; песочница ограничивает адресатов, но не переписывает заголовки; остаются договорённость в CLAUDE.md и просмотр транскриптов |
| Мод загружен, но не отказывает | — | love540 (macOS, 2.1.317/2.1.318) и KardKuro (Windows 11, 2.1.318): тестовая команда выполнилась, хотя system/init перечислял cc-plugin-privacy | Хук и песочница от мода не зависят; проверка — в разделе 10 |
| Двойное кодирование / не-ASCII адрес | Проходит | — | Хук добавляет [at] и один проход percent-кодирования; прочие варианты так же не покрыты |
| Плагин выше отменяет отказ; модуль хуков не загружен | Признано в README | — | Ваш хук в пользовательских настройках работает независимо; onFailure: block делает сбой самого хука блокировкой |
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Исходник встроенного мода: README mods/privacy
Один самоаудит из сообщества заслуживает внимания. Участник morsik поручил Claude просмотреть каждый вызов инструмента в ~/.claude/projects/**/*.jsonl и нашёл 53 вызова в 8 сессиях с 2026-08-09 по 2026-11-01, где адрес попадал в User-Agent, — почти все от субагентов рабочих процессов, которые сами писали curl -A "TOOL/1.0 (адрес)", а не от WebFetch. Отсюда три вывода: окно начинается задолго до ноября; основной носитель — shell-команды субагентов; лучший аудиторский материал — ваши локальные транскрипты. Скрипт из раздела 7 написан именно для этого.
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header
6. Путь запроса: откуда берётся адрес, куда идёт и где стоит каждая защита
Чтобы судить о пользе защиты, нарисуйте каждый шаг данных. Начало — вход в систему: по сообщениям сообщества адрес аккаунта хранится в поле oauthAccount.emailAddress файла ~/.claude.json (утверждение комментатора, с исходником мы не сверяли), и он помещался в контекст модели (подтверждено первичным источником). Шаг два — модель формирует вызов инструмента: команду Bash, URL для WebFetch, Write, кладущий скрипт на диск. Шаг три — проверка перед вызовом: здесь живут ваш PreToolUse-хук и tool.check встроенного мода, и оба видят только текстовые параметры вызова. Шаг четыре — правила прав: deny действует в любом режиме, ask спрашивает, а классификатор auto-режима работает после детерминированных правил. Шаг пять — песочница: команды Bash, PowerShell и Monitor выполняются внутри границы уровня ОС, сеть идёт через локальный прокси, сверяющий каждый хост с allowedDomains, список которых изначально пуст; Read, Edit, Write, WebFetch, WebSearch, хуки, MCP-серверы, моды и команды, набранные вами после !, находятся вне её. Последний шаг — удалённый сервер пишет заголовок в лог, и дальше локального контроля нет вовсе.
Отсюда два структурных факта. Во-первых, любая текстовая проверка (мод, хук, deny-правило) слепа к значениям, существующим только во время выполнения: $(git config user.email), переменные окружения, содержимое файлов, которое читает скрипт. Только прокси песочницы не зависит от текста команды, но управляет адресатом, а не содержимым заголовка. Во-вторых, удаление адреса из контекста — единственная мера, меняющая стартовую точку; всё остальное — контрольные пункты после того, как адрес её покинул. Разумная комбинация: дождаться и проверить исправление первопричины, а пока применять хук против текстовых форм, песочницу против адресатов и отдельную git-идентичность, чтобы уменьшить то, что может раскрыть поиск во время выполнения.
- Вход → адрес попадает в ~/.claude.json (утверждение сообщества) и в контекст модели (первичный источник)
- Модель составляет вызов: команда Bash / URL WebFetch / Write скрипта (может вставить адрес как контакт)
- PreToolUse-хук и tool.check встроенного мода: текстовое совпадение; exit 2 или отказ останавливают вызов
- Правила прав: deny действует в любом режиме, ask спрашивает, затем судит классификатор auto
- Сетевой прокси песочницы: только Bash/PowerShell/Monitor; allowedDomains пропускает, deniedDomains отклоняет
- Сторонний сервер записывает User-Agent → локального контроля больше нет
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Документация Claude Code: Hooks · Документация Claude Code: Sandboxing · Документация Claude Code: Best practices · Документация Claude Code: Permissions
7. Самопроверка: ищем в локальных транскриптах вызовы, которые несли адрес
Claude Code хранит записи сессий каждого проекта в файлах .jsonl в ~/.claude/projects или в CLAUDE_CONFIG_DIR, если он задан. Формат не документирован, поэтому скрипт не предполагает фиксированной структуры: он разбирает каждую строку как JSON, рекурсивно обходит каждый объект и, встретив узел с type равным tool_use и объектом input, сериализует этот input и ищет в нём переданный адрес, включая percent-кодированную форму. При совпадении печатаются временная метка, префикс имени файла, имя инструмента, назван ли также User-Agent, и первые 220 символов обезличенного ввода. Скрипт только читает: ничего не меняет и не выходит в сеть.
Документация Claude Code: Hooks · Документация 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.")
Три замечания к чтению вывода. Строки с ua_named=yes примерно соответствуют тому, что сопоставил бы встроенный мод; строки с ua_named=no — формы, которые README признаёт пропускаемыми (URL, тела запросов, содержимое скриптов). Если совпадения сосредоточены на Write или Edit, адрес был записан в скрипт и затем выполнен — ровно тот путь, который, по словам сообщества, мод не видит. И число совпадений не равно числу реально отправленных запросов: команда могла упасть, вы могли отклонить её в запросе, а транскрипт никогда не фиксирует, получил ли что-то удалённый сервер. Он говорит, что модель намеревалась так поступить, — и этого достаточно, чтобы решить, нужен ли вам хук из раздела 8.
8. Детерминированная защита первая: PreToolUse-хук, отклоняющий любой ввод с вашей идентичностью
Документация по хукам определяет: PreToolUse-хук получает на stdin JSON с tool_name и tool_input (command для Bash; file_path и content для Write; new_string для Edit; url и prompt для WebFetch и так далее); выход с кодом 2 блокирует вызов, а stderr становится причиной, показанной модели; альтернативно хук может напечатать объект hookSpecificOutput с permissionDecision равным deny. Matcher принимает имена инструментов вроде Bash или Edit|Write и регулярные выражения. С версии 2.1.314 matcher Bash срабатывает и на команды, запущенные инструментом Monitor. Хуки срабатывают и внутри субагентов — именно оттуда, по словам сообщества, пришло большинство таких запросов.
Хук ниже намеренно шире встроенного мода: если любое поле tool_input содержит одну из ваших идентичностей (по адресу на строку в ~/.claude/private-identifiers.txt плюс то, что сейчас возвращает git config user.email), он завершается кодом 2 независимо от того, назван ли User-Agent. Он также отклоняет команды Bash или PowerShell, содержащие git config … user.email, потому что поиск во время выполнения не видит ни одна текстовая проверка. Цена — ложные отказы: когда вы действительно просите Claude вписать ваш адрес в конфигурационный файл, хук остановит и это, а stderr попросит модель предложить вам сделать шаг вручную. Компромисс намеренный и повторяет отношение README к ложным отказам.
#!/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)
Две заметки о реализации. Python вместо jq позволяет один раз сериализовать весь tool_input и искать в нём, так что имена полей по инструментам не нужны; документация предупреждает, что на Windows file_path приходит с обратными косыми чертами, но этот скрипт пути не сравнивает и на него это не влияет. Хук не печатает JSON и полагается только на код выхода: по документации exit 2 плюс stderr — стандартный способ заблокировать и передать причину, тогда как код, отличный от 0 и 2, по умолчанию не блокирует. Поэтому регистрация в разделе 9 задаёт onFailure: block (доступно с 2.1.295), чтобы падение или тайм-аут скрипта тоже считались блокировкой.
9. Детерминированные защиты вторая и третья: deny-правила и сетевой allowlist песочницы в одном settings.json
Страница лучших практик задаёт принципы: deny-правила действуют в любом режиме прав, включая auto и bypassPermissions; правило вроде Read(./.env) ловит и cat .env, потому что Claude Code распознаёт типичные команды чтения файлов, но не поймает скрипт, который сам открывает файл; а deny-правило WebFetch для домена ничего не делает с curl к тому же домену, пока не включена песочница. Вывод страницы: для всего, что связано с безопасностью, нужно и то и другое. Страница прав добавляет, что deny-правила Bash сопоставляются с командой как она написана, так что /usr/bin/curl или sh -c 'curl …' проскальзывают, — потому обязательному сетевому ограничению нужен allowlist песочницы.
Документация Claude Code: Best practices · Документация Claude Code: Permissions · Документация Claude Code: Security
Ключевые факты со страницы о песочнице: она выключена по умолчанию и включается через /sandbox или "sandbox": {"enabled": true}; macOS использует Seatbelt, Linux и WSL2 — bubblewrap плюс socat, родной Windows не поддерживается; прямого выхода наружу нет, соединения идут через локальный прокси, сверяющий allowedDomains, изначально пустой; хост вне списка вызывает запрос в ручном режиме, отклоняется в dontAsk и пропускается в bypassPermissions, тогда как deniedDomains отклоняется в любом режиме; allowUnsandboxedCommands: false отключает повтор вне песочницы (строгий режим на вкладке Overrides); а deny-записи credentials.files и credentials.envVars не дают командам в песочнице читать ~/.ssh и подобное или видеть названные переменные. Однако записи credentials действуют только из пользовательских или управляемых настроек; записи проектных и локальных настроек игнорируются.
{
"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" }]
}
}
}По пунктам: Read(~/.claude.json) нацелено на файл, который сообщество называет хранилищем адреса, так что инструмент Read модели и распознаваемые команды вроде cat его не прочтут (сам Claude Code по-прежнему может); ask-правила Bash(curl *) и Bash(wget *) заставляют сетевые команды спрашивать каждый раз, причём страница безопасности отмечает, что в ручном режиме эти команды и так не одобряются автоматически; Bash(dangerouslyDisableSandbox:true) — ask-правило, рекомендованное страницей о песочнице: оно спрашивает о повторе вне песочницы даже в режимах auto и bypassPermissions и подстраховывает allowUnsandboxedCommands: false; allowedDomains — заглушка, замените её тем, что действительно нужно вашей сборке. Matcher хука — Bash|PowerShell|Write|Edit|WebFetch|WebSearch; если вы загружаете страницы через MCP-инструменты, добавьте и matcher для mcp__.*.
Документация Claude Code: Sandboxing · Документация Claude Code: Permissions · Документация Claude Code: Security
| Слой | Природа | Покрывает | Не покрывает | Основание |
|---|---|---|---|---|
| Фраза в системном контексте (с 2.1.234) | Недетерминированный | Напоминает модели использовать адрес только для идентификации | Модель может решить, что этот случай — исключение; так и произошло | CHANGELOG; лучшие практики |
| Договорённости в CLAUDE.md | Недетерминированный | Командные правила именования User-Agent, какие сайты могут получать контакт | Любое правило, которое должно выполняться каждый раз | Лучшие практики |
| Встроенный мод cc-plugin-privacy | Детерминированный (текстовое совпадение) | Адрес плюс названный User-Agent во вводе Bash/PowerShell/Monitor | Адрес без User-Agent, WebFetch/WebSearch/MCP, значения времени выполнения, скрипты с адресом, иные кодировки; может быть отменён плагином выше | README |
| Ваш PreToolUse-хук | Детерминированный (текстовое совпадение) | Любая форма идентичности во вводе Bash/PowerShell/Write/Edit/WebFetch/WebSearch; команды git config user.email | Значения времени выполнения, переменные, не перечисленные идентичности, описательные токены продукта | Документация по хукам |
| permissions.deny / ask | Детерминированный (команда как написана) | Чтение .env и ~/.claude.json; curl/wget спрашивают каждый раз | Программы по полному пути или внутри sh -c; скрипты, открывающие файлы сами | Документы о правах, лучших практиках, безопасности |
| Сетевой allowlist песочницы (строгий режим) | Детерминированный (уровень ОС) | Адресаты команд Bash/PowerShell/Monitor; файлы и переменные учётных данных | Read/Edit/Write/WebFetch/WebSearch, хуки, MCP, моды, команды после !; содержимое заголовков | Документация по песочнице |
| Удаление адреса из контекста (анонсировано) | Снимает предпосылку | Модель больше не знает e-mail вашего аккаунта | Адреса в git config, файлах, окружении; имена проектов в User-Agent | Заявление на HN; CHANGELOG ожидается |
anthropics/claude-code CHANGELOG.md · Исходник встроенного мода: README mods/privacy · Документация Claude Code: Hooks · Документация Claude Code: Sandboxing · Документация Claude Code: Best practices · Документация Claude Code: Permissions
10. Проверка: подтверждаем отказ безвредной командой и переводим git на no-reply-идентичность
Написанная конфигурация — ещё не работающая. Документация по хукам предупреждает, что опечатка в пути в settings.json означает, что хук никогда не запустится, и советует следить за уведомлением hook error при первом срабатывании. Скрипт ниже делает пять вещей: печатает claude --version; подаёт четыре синтетических PreToolUse-пакета прямо в хук (временный файл идентичностей содержит только you@example.com, а все цели — имена в зоне .invalid, так что ничего не отправляется); просит вас в реальной сессии попросить Claude выполнить echo 'User-Agent: test ВАШ-АДРЕС' > /dev/null и проследить за отказом; печатает текущую git-идентичность; напоминает проверить /plugins и /sandbox.
Документация Claude Code: Hooks · Документация 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"
Этот тест с echo взят прямо из комментариев к issue: он не трогает сеть, но содержит и адрес, и слова User-Agent — ровно ту форму, которую README обещает отклонять. Сообщество получило на нём «выполнилось, не отклонено»; у вас должен быть один из двух исходов. Если встроенный мод работает, модель получит REFUSAL мода; если работает только ваш хук, в транскрипте появится причина, начинающаяся с identity-guard:. Если нет ни того ни другого, хук не запускается: проверьте путь в settings.json и наличие python3 в PATH.
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Исходник встроенного мода: README mods/privacy
Разделение git-идентичности — самая дешёвая защита из всех. И README, и сообщество называют $(git config user.email) путём времени выполнения, невидимым ни для одной текстовой проверки. Как только глобальный user.email станет no-reply-адресом, выданным вашим хостингом кода, команда, читающая его, выдаст лишь адрес, на который не приходит почта. Это меняет e-mail автора в ваших коммитах, так что если команда требует DCO или проверку подписей, сначала привяжите адрес к аккаунту на платформе.
11. Порядок действий: сегодня, после обновления и постоянно
- Сегодня: запустите скрипт аудита из раздела 7, чтобы узнать, затронуты ли вы и был ли носителем curl субагентов; результат оставьте себе и никому не отправляйте.
- Сегодня: установите хук и настройки из разделов 8 и 9 на пользовательском уровне, запустите скрипт проверки из раздела 10 и переведите глобальную git-идентичность на no-reply-адрес.
- Обновитесь до 2.1.317 или новее (по заявлению на HN стабильный канал ещё был на 2.1.311), убедитесь в /plugins, что cc-plugin-privacy@builtin загружен, и тестом с echo проверьте, что он действительно отказывает: по сообщениям сообщества «загружен» и «отказывает» могут быть разными вещами.
- После каждого обновления читайте новейший блок версии в CHANGELOG.md в поисках записи об удалении e-mail аккаунта из контекста; пока её нет, считайте исправление невыпущенным.
- Постоянно: время от времени повторяйте аудит на новых сессиях и зафиксируйте в CLAUDE.md договорённость, что самостоятельно составленные User-Agent используют обобщённый токен без имени проекта или клиента. Это недетерминированно и лишь дополнение.
- Командам: делитесь хуком и deny-правилами через .claude/settings.json репозитория (deny применяется сразу, allow ждёт диалога доверия), помня, что записи credentials и строгая песочница требуют пользовательских или управляемых настроек.
Напоследок о соразмерности. Урок не в том, что Claude Code нельзя доверять, а в том, что всё, помещённое в контекст модели, следует считать способным появиться в любой строке, которую модель сгенерирует. E-mail — лишь самый заметный пример; имена проектов, клиентов и внутренних хостов идут тем же путём. Детерминированные механизмы ценны тем, что не зависят от суждения модели, а скрипт аудита — тем, что позволяет решать следующий шаг по собственным данным, а не по чужому скриншоту.
Чего мы не проверяли: не воспроизводили исходное поведение с попаданием адреса в User-Agent ни на одной версии; не проверяли, действительно ли встроенный мод в 2.1.317, 2.1.318 или 2.1.319 отклоняет команду, описанную в его README (сообщество сообщает, что нет; мы этого не воспроизводили); не проверяли утверждение о поле oauthAccount.emailAddress в ~/.claude.json; не нашли записи CHANGELOG об удалении e-mail из контекста, поэтому считаем исправление первопричины анонсированным, но не подтверждённым как выпущенное; не читали issue #81138 и #37201 построчно, лишь убедились, что ссылки открываются. Хук, настройки и скрипты проверены офлайн только на синтетических данных и именах .invalid, никогда — в продакшене или в реальной сети. Статья анализирует продукт и открытый репозиторий Anthropic; этот сайт не связан с Anthropic.