From fb952ad37134b8bc744be4f06f5b77fd8e1e7318 Mon Sep 17 00:00:00 2001
From: vitaly <nikitenko.vitaly@gmail.com>
Date: Sat, 6 Jun 2026 12:04:43 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8?=
 =?UTF-8?q?=D1=82=D1=8C=20=D1=81=D0=B5=D0=BA=D1=86=D0=B8=D1=8E=20=D0=BF?=
 =?UTF-8?q?=D1=80=D0=BE=20=D1=81=D0=B5=D1=82=D0=B5=D0=B2=D1=8B=D0=B5=20?=
 =?UTF-8?q?=D1=81=D0=BA=D1=80=D0=B8=D0=BF=D1=82=D1=8B=20=D0=B2=20README?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 README.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/README.md b/README.md
index ba2dbaa..8207854 100644
--- a/README.md
+++ b/README.md
@@ -40,6 +40,9 @@ home-configs/
 │       │   └── SKILL.md
 │       └── el-review-heavy/
 │           └── SKILL.md
+├── network/
+│   ├── ks-off.sh                # временно отключить UFW kill switch
+│   └── ks-on.sh                 # восстановить UFW kill switch
 ├── vless/
 │   └── servers.conf             # список VLESS-серверов для прокси
 ├── proxychains/
@@ -178,6 +181,44 @@ exec bash
 
 Также скрипт генерирует `~/.local/bin/claude-gpt-effort-proxy.py` — легковесный прокси, который маппит `xhigh` → `high` для `claude-code-proxy` (GPT-бэкенд). Без него Claude Code не смог бы использовать `xhigh` effort с GPT.
 
+## Сетевые скрипты (network/)
+
+Скрипты в `home-configs/network/` **не запускаются автоматически** — ни `ai-setup.sh`, ни системой. Это ручные утилиты, которые нужно запускать явно от root.
+
+Предназначены для окружения с Amnezia VPN и UFW kill switch (весь трафик через VPN, без VPN - только локалка).
+
+### ks-off.sh — временно отключить kill switch
+
+```bash
+sudo bash ~/path/to/home-configs/network/ks-off.sh
+```
+
+Отключает UFW. После этого нужно вручную отключить Amnezia через её GUI - трафик пойдёт напрямую через провайдера (российский IP). Используется когда нужен доступ к сайтам, которые блокируют VPN (ozon.ru и т.п.).
+
+**Перед запуском:** выйди из Claude Code - сессия будет идти с другого IP.
+
+### ks-on.sh — восстановить kill switch
+
+```bash
+sudo bash ~/path/to/home-configs/network/ks-on.sh
+```
+
+Включает UFW обратно. Перед запуском нужно подключить Amnezia через GUI - иначе скрипт предупредит, что интерфейс `amn0` не найден, и спросит подтверждение (без VPN весь интернет заблокируется).
+
+### Типичный workflow
+
+```
+# Нужен доступ к ru-сайтам напрямую:
+1. Выйти из Claude Code
+2. sudo bash ks-off.sh
+3. Отключить Amnezia в GUI
+
+# Возврат к нормальному режиму:
+4. Подключить Amnezia в GUI (дождаться amn0)
+5. sudo bash ks-on.sh
+6. Войти в Claude Code
+```
+
 ## Тесты
 
 В репозитории есть shell-тесты: