Files
ai-setup/QUICK_START.md
vitaly 38b5f2710c docs: sync README/QUICK_START/EFFORT_MAPPING with current code
- Update ai-openrouter models in ai-setup.sh output and header
- Fix effort persistence wording (statusbar -> launcher)
- Unify KS_EXCEPTIONS -> KILL_SWITCH_EXCEPTIONS in docs and setup.sh prompt
- Clarify menu item 7 only updates AI launchers
- Add IPv6 note after ks-off.sh
- Scope UFW before.rules insertion to *filter section

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-14 09:16:37 +03:00

61 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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-уровней по провайдерам