Files
ai-setup/QUICK_START.md
Виталий Никитенко 60b915de5f feat(setup): add ./setup.sh update CLI mode
./setup.sh update (или --update) запускает git pull --ff-only + перегенерацию
всех ai-* лаунчеров без интерактивного меню — то же, что пункт меню 7 (логика
вынесена в общую do_update). Неизвестный аргумент печатает usage и выходит
с кодом 1, без аргументов открывается меню как раньше.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-17 06:00:27 +03:00

2.6 KiB
Raw Blame History

Quick Start

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

bash setup.sh

Установит лаунчеры ai-claude, ai-gpt, ai-deepseek, ai-kimi, ai-glm, ai-openrouter, ai-opencode, ai-gemini, ai-cursor в ~/bin, если он уже есть в PATH, иначе в ~/.local/bin/, и запишет API-ключи.

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

exec bash

Обновление всех AI-инструментов одной командой:

./setup.sh update

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-уровней по провайдерам