diff --git a/QUICK_START.md b/QUICK_START.md
new file mode 100644
index 0000000..8e066c8
--- /dev/null
+++ b/QUICK_START.md
@@ -0,0 +1,61 @@
+# Quick Start
+
+## 1. Установить AI-инструменты
+
+```bash
+bash ai-setup.sh
+```
+
+Спросит про VLESS-прокси (можно пропустить — `n`), затем установит лаунчеры
+`ai-claude`, `ai-gpt`, `ai-deepseek`, `ai-kimi`, `ai-openrouter`, `ai-gemini`
+в `~/.local/bin/` и запишет API-ключи.
+
+После установки, если команды не видны:
+```bash
+exec bash
+```
+
+## 2. Настроить сеть (Amnezia + ru-bypass)
+
+Нужно один раз на каждой машине. .ru трафик идёт напрямую,
+остальное — через Amnezia. Если Amnezia падает, не-.ru блокируется.
+
+```bash
+# Запустить Amnezia, затем узнать gateway и интерфейс:
+ip route show default
+# Пример: default via 192.168.1.1 dev wlp1s0
+
+# Запустить скрипт (дефолты: GATEWAY=192.168.1.1, DEV=wlp1s0)
+sudo bash home-configs/network/ru-bypass.sh
+
+# Если параметры отличаются:
+sudo GATEWAY=10.0.0.1 DEV=enp3s0 bash home-configs/network/ru-bypass.sh
+```
+
+После первого запуска systemd-сервисы установлены — при перезагрузке всё поднимается само.
+
+## Проверка сети
+
+```bash
+ip route get 8.8.8.8                            # -> dev amn0  (через VPN)
+ip route get $(dig +short ya.ru A | head -1)    # -> dev wlp1s0 (напрямую)
+bash tests/test_network.sh
+```
+
+## Временно отключить VPN (нужен российский IP)
+
+```bash
+# Выйти из Claude Code, затем:
+sudo bash home-configs/network/ks-off.sh
+# Отключить Amnezia в GUI
+
+# Вернуться к нормальному режиму:
+# Подключить Amnezia в GUI, затем:
+sudo bash home-configs/network/ks-on.sh
+```
+
+## Подробнее
+
+- `README.md` — полное описание всего проекта
+- `home-configs/network/README.md` — детали сетевой настройки
+- `EFFORT_MAPPING.md` — таблица effort-уровней по провайдерам