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

2.6 KiB
Raw Blame History

Quick Start

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

bash setup.sh

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

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

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-список обновляется ежедневно.

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

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)

# Выйти из 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-уровней по провайдерам