# Quick Start

## 1. Установить AI-инструменты

```bash
bash setup.sh
```

Спросит про VLESS-прокси (по умолчанию `Y`; если не нужен, ответь `n`), затем установит лаунчеры
`ai-claude`, `ai-gpt`, `ai-deepseek`, `ai-kimi`, `ai-openrouter`, `ai-gemini`
в `~/bin`, если он уже есть в `PATH`, иначе в `~/.local/bin/`, и запишет API-ключи.

После установки, если команды не видны:
```bash
exec bash
```

## 2. Настроить сеть (Amnezia + ru-bypass)

Нужно один раз на каждой машине. .ru трафик идёт напрямую,
остальное — через Amnezia. Если Amnezia падает, не-.ru блокируется.

Запускай через `bash setup.sh` и выбери пункт `2) Сеть: ru-bypass + kill switch`.
Меню само предложит `GATEWAY` и `DEV` из `ip route show default`, даст выбрать профиль
(`home`, `office`, имя хоста и т.д.) и сохранит настройки в
`~/.config/ai-setup/network_<profile>.conf`.

Дополнительные поля можно оставить пустыми:
- `LOCAL_DNS` - DNS для `*.loc`
- `AMNEZIA_SERVER` - IP/домен сервера Amnezia, чтобы VPN мог подняться при kill switch
- `KILL_SWITCH_EXCEPTIONS` - IP/домены, которые должны ходить напрямую

После первого запуска systemd-сервисы и timer установлены - при перезагрузке всё поднимается само,
а RIPE-список обновляется ежедневно.

## Проверка сети

```bash
ip route get 8.8.8.8                            # -> dev amn0  (через VPN)
ip route get $(dig +short ya.ru A | head -1)    # -> dev <DEV> (напрямую)
bash tests/test_network.sh
```

## Временно отключить VPN (нужен российский IP)

```bash
# Выйти из Claude Code, затем:
sudo bash scripts/ks-off.sh
# Отключить Amnezia в GUI

# Вернуться к нормальному режиму:
# Подключить Amnezia в GUI, затем:
sudo bash scripts/ks-on.sh
```

## Подробнее

- `README.md` — полное описание всего проекта
- `home-configs/network/README.md` — детали сетевой настройки
- `EFFORT_MAPPING.md` — таблица effort-уровней по провайдерам