# Router-gate v4.2 — Уровень 5 поэтапно (для одного разработчика)

**Дата:** 2026-05-29 (день+2, вечер)
**Версия:** v4.2 (amendment к v4.0 + v4.1)
**Автор:** Claude (controller Opus 4.7) под руководством заказчика Дмитрия
**Статус:** Approved by owner (variant A modified for solo developer, phased rollout) — готов к writing-plans
**Тип:** feature — infrastructure-level закрытие (VM sandbox + поэтапная биометрия/HSM)
**База:** v4.0 ([design](2026-05-29-router-gate-v4-design.md)) + v4.1 ([max-closure](2026-05-29-router-gate-v4-1-max-closure.md)) — читать первыми

---

## Зачем этот документ

v4.0 + v4.1 закрывают защиту на уровне правил в документе и ИИ-судей. Шанс обхода в среднем ~2-5%.

**v4.2 добавляет инфраструктурный слой защиты**, который правилами не закрыть:

- Изоляцию файловой системы (защита от моих случайных правок системных файлов вне рабочей папки)
- Биометрическое подтверждение каждого «Да» в окне вопроса (защита от автоматических нажатий когда устаёте)
- Аппаратную подпись важных действий (git-коммитов)

**Правило двух человек НЕ применяется** — заказчик работает один.

**Шанс обхода после полного v4.2:** ~0.5-0.8% в среднем.

---

## Поэтапное внедрение

### Этап 1 (сейчас) — VM-песочница

- **Что:** изолированная виртуальная машина для Claude.
- **Стоимость:** $0 (свободное ПО).
- **Время:** 3-5 рабочих дней.
- **Эффект:** шанс обхода падает с 2-5% до ~1.5-3% — закрывает системные правки файлов вне рабочей папки.

### Этап 2 (когда захотите) — Биометрия

- **Что:** подтверждение каждого «Да» в окне вопроса отпечатком пальца или Touch ID.
- **Стоимость:** $250-650 разово ($50-150 железо + $200-500 разработка).
- **Время:** 2-3 рабочих дня.
- **Эффект:** падает до ~0.8-1.5% — закрывает усталость заказчика.

### Этап 3 (когда захотите) — HSM

- **Что:** аппаратная подпись git-коммитов через YubiKey GPG.
- **Стоимость:** $50-150 (один YubiKey) + $50-100 настройки.
- **Время:** 1-2 рабочих дня.
- **Эффект:** падает до ~0.5-0.8% — закрывает скрытые ссылки в commit message + подделку коммитов.

---

## §1. Что такое VM-песочница простым языком

Сейчас Claude работает прямо на вашем основном компьютере — может читать и (в принципе) изменять любые ваши файлы. Защита в v4.0+v4.1 ограничивает что я могу делать через свои инструменты, но если что-то пойдёт не так — последствия будут на всём компьютере.

**VM-песочница** — это **виртуальный компьютер внутри вашего**. У него:

- Свой жёсткий диск (отдельный файл на вашем настоящем диске).
- Своя оперативная память.
- Свой Windows внутри.
- Только те файлы которые **вы явно разрешили**.

**Что это даёт:**

- Если Claude по ошибке (или из-за бага в защите) попробует удалить файл — он удалит файл **внутри виртуалки**, на настоящий компьютер не повлияет.
- Если Claude захочет посмотреть `C:\Users\Administrator\Documents\личное.txt` — он **физически не увидит** этот файл, потому что в виртуалке его нет.
- Если что-то пошло совсем плохо — можно **выключить виртуалку и откатить к снимку** (как кнопка «отменить» для всего).

---

## §2. Что нужно сделать (Этап 1, VM)

### Шаг 1. Установить VirtualBox

VirtualBox — это программа от Oracle, бесплатная.

- Скачать: https://www.virtualbox.org/wiki/Downloads
- Версия для Windows host: ~120 MB.
- Установить как любое приложение.
- Время: 15 минут.

### Шаг 2. Создать виртуальную машину

Внутри VirtualBox создать новую машину:

- **Имя:** `claude-sandbox`
- **Тип:** Microsoft Windows (Server 2022)
- **Память:** 8-16 GB (зависит от вашей машины — оставьте хосту минимум 16 GB)
- **Диск:** 100 GB динамически расширяемый
- **CPU:** 4-6 ядер
- **Сеть:** NAT (по умолчанию) — позволит виртуалке выходить в интернет, но снаружи к ней не достучаться

Время: 30 минут.

### Шаг 3. Установить Windows внутри VM

- Скачать ISO Windows Server 2022 Evaluation: https://www.microsoft.com/en-us/evalcenter/evaluate-windows-server-2022
- Смонтировать ISO в VirtualBox.
- Запустить виртуалку, пройти установку Windows.
- Время: 1-2 часа.

### Шаг 4. Установить нужное ПО внутри VM

Внутри виртуалки установить:

- Node.js (для запуска gate-hooks).
- Git.
- VS Code (для написания кода если нужно).
- Claude Code CLI.
- PHP, Composer, Pest (для разработки портала).
- PostgreSQL клиент (для подключения к базе на хосте если нужно).

Время: 2-3 часа.

### Шаг 5. Настроить файловое разделение

**Это ключевой момент.**

В VirtualBox можно настроить **Shared Folders** — папки которые видны и хосту, и виртуалке.

**Что разделить:**

- **`C:\моя\проекты\портал crm\Документация`** (рабочая папка проекта) → **shared, read-write** для виртуалки. Claude работает с проектом здесь.
- **Всё остальное на хосте** → **НЕ shared**. Claude из виртуалки физически не видит.

**Подробности настройки:**

1. VirtualBox → Машина claude-sandbox → Settings → Shared Folders → Add.
2. Path: `C:\моя\проекты\портал crm\Документация`.
3. Name: `project`.
4. Auto-mount: yes.
5. Mount point внутри VM: `C:\project`.
6. **Не включать** «Read-only» — нужно чтобы Claude мог писать.
7. Готово.

Внутри виртуалки Claude видит проект как `C:\project`, а не видит `C:\моя` хоста и ничего другого с хоста.

Время: 30 минут.

### Шаг 6. Перенести `~/.claude/` внутрь VM

Сейчас настройки Claude и runtime-state хранятся в `C:\Users\Administrator\.claude\` на хосте.

Перенести в виртуалку:

1. Внутри VM: `C:\Users\Administrator\.claude\` — создать заново.
2. Скопировать туда через shared folder: settings.json, plugins, runtime/.
3. Запустить Claude CLI внутри VM, убедиться что работает.

Время: 1-2 часа.

### Шаг 7. Сделать snapshot

После того как всё настроено и работает:

1. VirtualBox → правый клик на виртуалке → Snapshots → Take Snapshot.
2. Имя: `clean-state-2026-05-29`.

**Зачем:** если что-то сломается — одна команда возвращает виртуалку в чистое состояние.

Время: 5 минут.

**Итого Этап 1:** 4-6 часов работы + 100 GB на диске под виртуалку.

---

## §3. Что изменится в работе

**Как было:**

- Открываете VS Code на хосте.
- Запускаете Claude CLI на хосте.
- Claude видит всё что вы видите.

**Как станет:**

- Запускаете VirtualBox.
- Внутри виртуалки запускаете Claude CLI.
- Claude видит только `C:\project` (рабочую папку).
- Ваши личные документы, пароли, ключи SSH, переписки — Claude физически не достанет.

**Что будет неудобно:**

- Виртуалка медленнее на 5-10%.
- Нужно держать VirtualBox открытым.
- Если хочется быстро посмотреть что-то на хосте — нужно либо открыть на хосте отдельно, либо положить в shared folder.

**Что будет удобно:**

- Можно делать snapshot перед рискованным экспериментом, потом откатиться одной кнопкой.
- Если Claude что-то странное натворил — это в изоляции.
- При продаже/передаче ноутбука можно удалить только виртуалку — она содержит всё работа-related.

---

## §4. Что закроется после Этапа 1

| Класс защиты | Без VM | С VM |
|---|---|---|
| Случайная правка файла вне `C:\project` | возможна | **невозможна** (не виден файл) |
| Чтение личных документов с хоста | возможно | **невозможно** |
| Чтение SSH-ключей, паролей хоста | возможно | **невозможно** |
| Запуск процессов на хосте от имени Claude | возможен | **невозможен** |
| Системные настройки Windows хоста | можно повредить | **невозможно** |
| Состояние виртуалки можно откатить | нет | **да, одна команда** |

**Падение шанса обхода:** с 2-5% до ~1.5-3%. Минус ~1.5%.

---

## §5. Этап 2 — Биометрия (когда захотите)

### Что это

Каждое «Да» которое вы нажимаете в окне вопроса от Claude — дополнительно подтверждается отпечатком пальца на телефоне.

**Сценарий:**

1. Claude выводит окно: «Можно сделать `git rebase main`?» с опциями.
2. Вы нажимаете «Да».
3. На вашем телефоне приходит уведомление: «Подтвердите: git rebase main».
4. Прикладываете палец (или Face ID).
5. Только после подтверждения Claude получает «approve».

### Зачем

Сейчас если вы устали в конце дня и автоматически нажимаете «Да» на 5-6 вопросов подряд не читая — можете одобрить что-то опасное. Биометрия заставляет **сделать осознанное физическое действие** для каждого одобрения.

### Что нужно

**Вариант A (рекомендую):** YubiKey 5 ($50-150)

- Маленький USB-токен. Втыкается в порт.
- Когда нужно подтвердить — мигает, нужно нажать кнопку.
- Не требует телефон.
- Не требует приложения.
- Может то же самое делать на git-коммитах (Этап 3).
- **Минус:** $50-150 разово.

**Вариант B:** Приложение на ваш телефон

- Не нужно покупать железо.
- Использует Touch ID/Face ID.
- **Минус:** нужно разрабатывать приложение (~$200-500 работы).
- **Минус:** телефон должен быть с собой и заряжен.

### Время внедрения

- YubiKey: 1-2 дня (установка ПО, интеграция в гейт, тестирование).
- Приложение: 5-10 дней разработки + интеграция.

### Эффект

Падение шанса обхода с 1.5-3% до **0.8-1.5%**. Минус ~1%.

Особенно сильное падение в категориях:

- AskUser автоматическое одобрение от усталости → почти 0%.
- Косвенные рекомендации в окне вопроса → почти 0% (вы физически просыпаетесь когда нужно палец прикладывать).

---

## §6. Этап 3 — HSM-подпись git-коммитов (когда захотите)

### Что это

Каждый git-коммит подписывается **аппаратным криптографическим ключом** (HSM = Hardware Security Module).

**Технически:** GPG-подпись от ключа, который хранится внутри YubiKey и **физически не извлекается**.

### Зачем

Это закрывает дыру v4.1 «commit message с скрытыми ссылками» (сейчас 5-15% шанс обхода без HSM).

**Сценарий без HSM:**

- Я делаю `git commit -m 'fix: рутинная правка'`.
- В message могу спрятать ссылку на свой сервер (например в zero-width chars).
- Защита частично ловит, но не 100%.

**Сценарий с HSM:**

- Я делаю `git commit -m 'fix: ...'`.
- GPG-подпись через YubiKey требует **нажать кнопку на устройстве физически**.
- Вы нажимаете кнопку → видите message на экране YubiKey'а → если что-то странное, не нажимаете.
- Подпись попадает в коммит.
- При push — настроено проверять подпись.
- Не подписанный коммит → push отклоняется.

### Что нужно

- YubiKey (тот же что в Этапе 2 — одно устройство делает и биометрию и GPG-подпись).
- GnuPG установить.
- Настроить ключ внутри YubiKey.
- Настроить git подписывать через этот ключ.
- Настроить git remote (GitHub) проверять подпись на push.

### Время

1-2 дня настройки + миграции существующих коммитов (если хочется).

### Эффект

Падение шанса обхода с 0.8-1.5% до **0.5-0.8%**. Минус ~0.5%.

---

## §7. Сводная сводка эффекта v4.2 этапы

| Версия | Что включено | Шанс обхода (среднее) | Стоимость разово | Стоимость в месяц |
|---|---|---|---|---|
| v4.0 база | Правила в документе | 15-25% | 0 | 0 |
| v4.0+v4.1 | + ИИ-судьи (Layer 1-4) | 2-5% | 0 | $300-1500 |
| v4.0+v4.1+v4.2 Этап 1 | + VM-песочница | 1.5-3% | $0 | $300-1500 |
| v4.0+v4.1+v4.2 Этап 1+2 | + Биометрия (YubiKey) | 0.8-1.5% | $50-150 (YubiKey) | $300-1500 |
| v4.0+v4.1+v4.2 Этап 1+2+3 | + HSM-подпись git | 0.5-0.8% | $50-150 (тот же YubiKey) | $300-1500 |

**Полный пакет v4.2 для одного разработчика:**

- Разово: **$50-150** (один YubiKey покрывает Этапы 2 и 3) + время на настройку.
- Месячно: $300-1500 (от ИИ-судей v4.1, не от v4.2).
- Шанс обхода: **0.5-0.8%** (vs 2-5% без v4.2).

---

## §8. План внедрения v4.0+v4.1+v4.2

Все три амендмента внедряются последовательно в одну сессию реализации:

### Часть 1 — Программные изменения (v4.0+v4.1)

Это уже описано в спеках v4.0 + v4.1. Реализация:

- 49-65 часов разработки (или 30-40 с распараллеливанием через субагентов).
- Изменения в `tools/enforce-*.mjs`, `tools/router-*.mjs`, `.claude/settings.json`.

### Часть 2 — VM-песочница (v4.2 Этап 1)

1. Установка VirtualBox (15 мин).
2. Создание VM, установка Windows внутри (3 ч).
3. Установка ПО внутри (3 ч).
4. Настройка Shared Folders (30 мин).
5. Перенос `~/.claude/` (1-2 ч).
6. Тестирование Claude CLI внутри (1 ч).
7. Snapshot (5 мин).

Итого: ~10-12 часов один раз.

### Часть 3 — Биометрия (v4.2 Этап 2) — отложено

Запускается когда YubiKey куплен.

### Часть 4 — HSM-подпись git (v4.2 Этап 3) — отложено

Запускается с YubiKey'ом (можно одновременно с Этапом 2).

---

## §9. Что НЕ закрывается даже после полного v4.2

| Не закрывается | Почему |
|---|---|
| ИИ-судьи иногда ошибаются (0.1-0.5%) | Природа ИИ — недетерминированная. Нельзя устранить |
| Anthropic может тихо поменять Claude Code (0.1%) | Версии CLI обновляются, мы зависим |
| shell-quote и другие библиотеки имеют 1% багов | Эти библиотеки используем, не пишем |
| Неизвестные неизвестные (0.1-0.3%) | По определению |
| **Итого irreducible:** ~0.5% | Это и есть теоретический пол |

С v4.2 полным мы доходим до ~0.5-0.8% — **очень близко к теоретическому полу**.

---

## §10. Реалистичный честный взгляд

**Что v4.2 Этап 1 (VM) реально даёт:**

- Защиту от моих случайных правок файлов вне проекта.
- Защиту от чтения ваших личных документов / SSH-ключей / паролей.
- Возможность отката одной кнопкой.
- Не зависит от ИИ-судей (это в v4.1).

**Что v4.2 Этап 2 (биометрия) реально даёт:**

- Защиту от вашей усталости когда автоматически нажимаете «Да».
- Защиту от косвенных подсказок в окне вопроса.

**Что v4.2 Этап 3 (HSM-подпись) реально даёт:**

- Защиту от скрытых ссылок в commit message.
- Гарантию что коммит сделали именно вы.

**Что НЕ даёт никакая v4.2 версия:**

- Защиту если я научусь обманывать ИИ-судей semantically — это всё ещё irreducible ~0.5%.

---

## §11. Цена решения

**Сегодня к внедрению (Этап 1 VM):**

- Деньги: **$0**.
- Время: **10-12 часов** один раз.
- Постоянно: **+5-10% медленнее работа** в виртуалке.

**Когда захотите Этап 2+3 (биометрия + HSM):**

- Деньги: **$50-150** (один YubiKey покрывает оба).
- Время: **2-3 дня** разово.
- Постоянно: **прикладывать палец** к YubiKey'ю при каждом одобрении и git-коммите.

**Откладывается до Б-1 (или вообще):**

- Уровень 5 в полном виде с правилом двух человек — это не наша история, один работаете.

---

## §12. Что я НЕ сделал

- ❌ Не правил v4.0 или v4.1 файлы.
- ❌ Не invoke writing-plans skill — следующий шаг.
- ❌ Не правил production-код.
- ❌ Не покупал железо.
- ❌ Не настраивал VM.

Это только дизайн-документ. Дальше нужен implementation plan через writing-plans, потом физическая работа.

---

## Что прошу

1. Прочитайте этот файл и v4.0 + v4.1.
2. Подтвердите подход: **сейчас внедряем v4.0+v4.1+v4.2 Этап 1 (VM)**, биометрия+HSM позже.
3. Если ОК — следующий шаг: invoke `superpowers:writing-plans` skill для combined implementation plan всех трёх частей.
4. После плана — реализация через subagent-driven-development.

**Один вопрос:**

- Готовы внедрить **VM-песочницу прямо сейчас** (10-12 часов работы)?
- Или сначала программные части v4.0+v4.1, потом VM отдельной задачей?
