Skip to content
Back to search

claude-vpn-killswitch

Claude VPN kill-switch: Claude ходит в сеть только через VPN

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mrnikitavasilenko-del--claude-vpn-killswitch/badge.svg)](/listings/mrnikitavasilenko-del--claude-vpn-killswitch)

HTML

<a href="/listings/mrnikitavasilenko-del--claude-vpn-killswitch"><img src="/api/listings/mrnikitavasilenko-del--claude-vpn-killswitch/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. [Скачайте архив](https://github.com/mrnikitavasilenko-del/claude-vpn-killswitch/releases/latest/download/claude-vpn-killswitch.zip) и распакуйте его. 2. Включите VPN. 3. Запустите **`install.cmd`**. Если Windows предупредит о файле из интернета, нажмите «Подробнее» → «Выполнить в любом случае» (или «Запустить»). В окне UAC нажмите «Да».

Готово. Защита запускается сама при каждом входе в Windows, а после установки открывается окно настроек. Ярлык **Claude kill-switch** появится на рабочем столе и в меню «Пуск».

**Обновление.** Раз в сутки приложение проверяет, не вышла ли новая версия. Если вышла, Windows покажет уведомление, а в окне появится кнопка **Обновить**: она скачает новую версию и установит её сама, без окна UAC. Можно и вручную: скачать архив и снова запустить `install.cmd`. После обновления защита снова включена: пауза и выключение сбрасываются, а выключенные уведомления и свои описания VPN сохраняются.

**Удаление.** Запустите **`uninstall.cmd`**.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines
  1. {
  2. "name": "claude-vpn-killswitch",
  3. "description": "Claude VPN kill-switch: Claude ходит в сеть только через VPN",
  4. "owner": { "name": "mrnikitavasilenko-del" },
  5. "plugins": [
  6. {
  7. "name": "killswitch",
  8. "source": "./",
  9. "description": "Claude Code и десктопный Claude ходят в сеть только через VPN (Windows)"
  10. }
  11. ]
  12. }
README.md · README · 200 lines
  1. # Claude VPN kill-switch
  2. [![Windows 10 | 11](https://img.shields.io/badge/Windows-10%20%7C%2011-0078D4?logo=windows)](#требования)
  3. [![Последний релиз](https://img.shields.io/github/v/release/mrnikitavasilenko-del/claude-vpn-killswitch?label=%D0%B2%D0%B5%D1%80%D1%81%D0%B8%D1%8F)](https://github.com/mrnikitavasilenko-del/claude-vpn-killswitch/releases/latest)
  4. [![Лицензия MIT](https://img.shields.io/badge/%D0%BB%D0%B8%D1%86%D0%B5%D0%BD%D0%B7%D0%B8%D1%8F-MIT-green)](LICENSE)
  5. Claude Code и десктопный Claude ходят в сеть **только через VPN**. Если VPN не включён или упал,
  6. запросы Claude не уходят, а Windows показывает уведомление. Браузер и остальные программы не затрагиваются.
  7. > Неофициальный проект, не связан с Anthropic.
  8. <p align="center">
  9. <picture>
  10. <source media="(prefers-color-scheme: dark)" srcset=".github/menu-dark.png">
  11. <img src=".github/menu-light.png" width="424" alt="Окно Claude kill-switch: защищено, Claude ходит в сеть только через VPN">
  12. </picture>
  13. </p>
  14. Проект состоит из двух частей:
  15. - **Приложение** — сама защита: правила брандмауэра Windows, фоновый сторож и окно настроек. Нужно обязательно.
  16. - **Плагин для Claude Code** — по желанию. Показывает состояние защиты прямо в Claude Code.
  17. Сам плагин ничего не блокирует.
  18. ## Требования
  19. - Windows 10 или 11.
  20. - Учётная запись администратора: при установке Windows спросит разрешение (окно UAC).
  21. Защита ставится для того, кто вошёл в Windows и подтвердил это окно.
  22. - VPN-клиент в режиме TUN/VPN, то есть с собственным сетевым адаптером (см. [какие VPN подходят](#какие-vpn-подходят)).
  23. - Десктопный Claude и/или Claude Code.
  24. - Claude Code — в нативной версии, то есть установленный командой с сайта Anthropic.
  25. Claude Code, установленный через npm (`npm install -g @anthropic-ai/claude-code`), работает как `node.exe`,
  26. и килл-свитч его не блокирует. Если стоит такая версия, окно настроек предупредит об этом.
  27. ## Установка приложения
  28. 1. [Скачайте архив](https://github.com/mrnikitavasilenko-del/claude-vpn-killswitch/releases/latest/download/claude-vpn-killswitch.zip) и распакуйте его.
  29. 2. Включите VPN.
  30. 3. Запустите **`install.cmd`**. Если Windows предупредит о файле из интернета, нажмите «Подробнее» →
  31. «Выполнить в любом случае» (или «Запустить»). В окне UAC нажмите «Да».
  32. Готово. Защита запускается сама при каждом входе в Windows, а после установки открывается окно настроек.
  33. Ярлык **Claude kill-switch** появится на рабочем столе и в меню «Пуск».
  34. **Обновление.** Раз в сутки приложение проверяет, не вышла ли новая версия. Если вышла, Windows покажет
  35. уведомление, а в окне появится кнопка **Обновить**: она скачает новую версию и установит её сама, без окна UAC.
  36. Можно и вручную: скачать архив и снова запустить `install.cmd`. После обновления защита снова включена:
  37. пауза и выключение сбрасываются, а выключенные уведомления и свои описания VPN сохраняются.
  38. **Удаление.** Запустите **`uninstall.cmd`**.
  39. ## Установка плагина для Claude Code
  40. Сначала установите приложение (см. выше). Затем в Claude Code выполните две команды, по очереди.
  41. Добавить магазин плагинов этого проекта:
  42. ```
  43. /plugin marketplace add mrnikitavasilenko-del/claude-vpn-killswitch
  44. ```
  45. Установить плагин:
  46. ```
  47. /plugin install killswitch@claude-vpn-killswitch
  48. ```
  49. Приложение можно поставить и из Claude Code: команда `/killswitch install` делает то же самое, что `install.cmd`.
  50. Плагин добавляет:
  51. - **строку над полем ввода** с состоянием защиты: зелёная «Защищено» и имя VPN-адаптера, через который идёт Claude;
  52. красная «Claude заблокирован», когда VPN не подключён; жёлтая «Защита на паузе». Обновляется раз в 30 с;
  53. - **команду `/killswitch`**: `status` (по умолчанию) — состояние, `menu` — окно настроек,
  54. `install` — установить или переустановить приложение. Команда отвечает сама, без запроса к модели,
  55. поэтому работает и без VPN, когда Claude заблокирован.
  56. Выключить защиту или поставить её на паузу можно только переключателями в окне настроек — у команды `/killswitch`
  57. такой возможности нет. Так защиту не выключить случайно, набрав команду в чате.
  58. **Обновление.** Чтобы плагин обновлялся сам, включите автообновление магазина: команда `/plugin`,
  59. вкладка Marketplaces, `claude-vpn-killswitch`, пункт **Turn on auto-update**. Вручную: `claude plugin update killswitch`.
  60. **Удаление.** `claude plugin uninstall killswitch`. Приложение при этом остаётся и продолжает защищать.
  61. ## Окно настроек
  62. Открывается ярлыком **Claude kill-switch**. Светлая или тёмная тема — как в Windows.
  63. Сверху — состояние защиты:
  64. | Состояние | Что значит |
  65. |---|---|
  66. | **Защищено** | VPN подключён, Claude ходит в сеть только через него |
  67. | **Claude заблокирован** | VPN не подключён, Claude в сеть не ходит. Включите VPN |
  68. | **Защита на паузе** | до перезагрузки Claude ходит в сеть без VPN |
  69. | **Защита выключена** | Claude ходит в сеть без VPN, пока не включить «Запуск при входе в Windows» |
  70. | **Claude не найден** | Claude ещё не установлен — защита включится сама, когда он появится |
  71. | **Сторож не запущен**, **Защита не работает** | что-то сломалось: перезагрузите компьютер или переустановите приложение |
  72. | **Килл-свитч не установлен** | окно открыто из плагина, а приложение не установлено |
  73. Ниже:
  74. - **VPN-туннель** — найденный адаптер VPN и подключён ли он;
  75. - **Правил брандмауэра** — сколько правил блокировки сейчас действует (по два на каждую программу Claude);
  76. - **Защита** — если выключить, Claude ходит без VPN до перезагрузки;
  77. - **Запуск при входе в Windows** — если выключить, защита отключается совсем, пока его не вернуть;
  78. - **Уведомления Windows** — «VPN не включён», «Запрос Claude заблокирован» и «Доступно обновление»;
  79. - когда вышла новая версия — строка **Доступна версия …** с кнопкой **Обновить**.
  80. Переключатели работают без прав администратора.
  81. ## Какие VPN подходят
  82. Любой, который создаёт сетевой адаптер (режим TUN/VPN). VPN узнаётся по описанию адаптера.
  83. - Проверено: **Happ**, **WireGuard**, **AmneziaVPN**.
  84. - Должны работать, но не проверялись: OpenVPN, Outline, v2rayN, Hiddify, sing-box в режиме TUN,
  85. Cisco AnyConnect, FortiClient.
  86. - Не подходят: режим «системный прокси» (без адаптера) — включите в клиенте режим TUN;
  87. встроенный VPN Windows (IKEv2, L2TP, SSTP, PPTP) — через него Claude будет заблокирован.
  88. ## Если Claude не работает при включённом VPN
  89. Откройте окно настроек и посмотрите строку **VPN-туннель**.
  90. - **«не найден»** — килл-свитч не узнал ваш VPN, поэтому блокирует Claude. Узнайте описание адаптера:
  91. в PowerShell выполните `Get-NetAdapter | ft Name, InterfaceDescription` и найдите строку вашего VPN.
  92. Откройте Блокнот от имени администратора, откройте в нём файл
  93. `C:\Program Files\ClaudeKillSwitch\vpn-adapters.txt` и допишите описание адаптера отдельной строкой —
  94. целиком, в точности как в выводе команды. Через 5 секунд Claude заработает. Обновления этот файл не трогают.
  95. Если не хочется возиться — [откройте issue](https://github.com/mrnikitavasilenko-del/claude-vpn-killswitch/issues)
  96. с названием VPN-клиента и описанием адаптера, добавим в следующую версию.
  97. - **«отключён»**, хотя VPN включён, — через VPN не идёт весь интернет (раздельное туннелирование).
  98. Включите в клиенте режим, при котором через VPN идёт весь трафик.
  99. ## Как работает
  100. - Брандмауэр Windows запрещает каждому exe Claude исходящий трафик на всех сетевых адаптерах, кроме VPN,
  101. и на всех подключениях удалённого доступа (PPPoE, встроенный VPN Windows).
  102. Через VPN трафик проходит, напрямую — нет. Защита работает, даже если VPN-клиент упал или не запущен.
  103. - Фоновый сторож (задача планировщика при входе в Windows) раз в 5 с:
  104. - пересоздаёт правила, если Claude обновился (у десктопа меняется папка `app-<версия>`)
  105. или появился новый сетевой адаптер (например, раздача интернета с телефона);
  106. - показывает уведомление «VPN не включён», если Claude запущен, а VPN нет;
  107. - показывает уведомление «Запрос Claude заблокирован» с адресом, куда Claude пытался выйти
  108. (не чаще раза в минуту — Claude Code повторяет запрос до 10 раз).
  109. Для этого установщик включает аудит блокировок брандмауэра (событие 5157 в журнале безопасности).
  110. - Под защитой: нативный Claude Code (`~\.local\bin\claude.exe` и его версии), десктопный Claude
  111. (`%LOCALAPPDATA%\AnthropicClaude`), встроенный в десктоп Claude Code (вкладка Code)
  112. и десктоп из Microsoft Store.
  113. - Раз в сутки сторож спрашивает у GitHub номер последнего релиза. Обновление ставит отдельная задача планировщика
  114. «Claude kill-switch update» с правами администратора — только по кнопке **Обновить** и только последний релиз
  115. отсюда. Архив скачивается в `Program Files`, куда обычные программы писать не могут, — подменить его по дороге нельзя.
  116. ## Проверка
  117. 1. Запустите Claude и выключите VPN → уведомление «VPN не включён», в окне — «Claude заблокирован».
  118. 2. `claude -p "ping"` → уведомление «Запрос Claude заблокирован», а в конце
  119. `API Error: Connection refused — a firewall or proxy may be blocking it`. Браузер при этом работает.
  120. Ответ `403` или `Request not allowed` означал бы, что запрос дошёл до Anthropic, — защита не сработала.
  121. 3. Включите VPN → `claude` снова отвечает.
  122. Журнал блокировок (PowerShell от администратора):
  123. `Get-WinEvent -FilterHashtable @{LogName='Security'; Id=5157} | ? { $_.Properties[1].Value -match 'claude' }`
  124. Список правил (PowerShell от администратора): `Get-NetFirewallRule -Group 'Claude kill-switch'`.
  125. ## Ограничения
  126. - **Маршрутизация VPN-клиента.** Если в клиенте для Anthropic стоит правило «напрямую», трафик уйдёт мимо VPN
  127. от имени самого клиента, и брандмауэр его не увидит. `anthropic.com` и `claude.ai` должны идти через VPN.
  128. - **Claude Code через npm** работает как `node.exe` и не блокируется. Окно настроек предупредит об этом.
  129. Поставьте нативную версию.
  130. - **Дочерние процессы** (`git`, `node`, `curl`, MCP-серверы), которые запускает Claude, не блокируются.
  131. - **Cowork** работает в виртуальной машине Hyper-V, его трафик идёт не от `claude.exe`.
  132. - **Выключатель без UAC.** Флаги паузы и выключения лежат в `%LOCALAPPDATA%`, их может поставить любая программа
  133. от имени пользователя, в том числе сам Claude Code через терминал. Это защита от случайной утечки,
  134. а не от программы, которая хочет обойти её намеренно.
  135. - **Новый адаптер** (например, раздача с телефона) закрывается не мгновенно, а в течение 5 секунд.
  136. - **DNS** обслуживает система: если DNS идёт мимо VPN, провайдер увидит имя `api.anthropic.com`.
  137. - Защищается только пользователь, который ставил приложение.
  138. - **Аудит блокировок** пишет в журнал безопасности все блокировки брандмауэра на компьютере, не только Claude:
  139. журнал заполняется быстрее. `uninstall.cmd` выключает аудит обратно (даже если он был включён до установки).
  140. ## Что в репозитории
  141. - `install.cmd`, `uninstall.cmd` — установить и удалить приложение. Внутри только запуск `windows\install.ps1`:
  142. файл `.ps1` по двойному щелчку открывается в Блокноте, а не выполняется.
  143. - `windows\install.ps1` — установщик: копирует приложение в `Program Files\ClaudeKillSwitch`, создаёт задачу
  144. автозапуска и ярлыки, включает аудит блокировок. С `-Uninstall` убирает всё обратно.
  145. - `windows\killswitch.ps1` — само приложение: фоновый сторож с правилами брандмауэра, окно настроек,
  146. проверка обновлений. `windows\icon.ico` — его значок.
  147. - `.claude-plugin\`, `hooks\`, `types\` — плагин для Claude Code.
  148. - `.github` — скриншоты для этой страницы и правила сообщений об уязвимостях (`SECURITY.md`).
  149. ## Лицензия
  150. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.