Files
ai-setup/QUICK_START.md
Виталий Никитенко 083a614940 feat(eltex): add ai-eltex launcher for corporate LLM proxy
ai-eltex runs Claude Code through the Eltex LiteLLM proxy
(http://llm.eltex.loc:4000, team GLM subscription). The personal key
from admins is checked via /v1/models and stored in
~/.config/ai-setup/eltex_key; the model is taken from the key's
allowed list (ELTEX_MODEL / ELTEX_BASE_URL override). The proxy
ignores effort/thinking, so no effort forcing. /logout-eltex and
/logout in ai-eltex drop the key; setup.sh status shows it.

ru-bypass: hosts block now has an end marker and only that block is
rewritten, manual entries outside it survive; llm.eltex.loc/llm2 added
since the VPN DNS does not resolve it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 12:21:02 +07:00

66 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
```
Установит лаунчеры
`ai-claude`, `ai-gpt`, `ai-deepseek`, `ai-kimi`, `ai-glm`, `ai-eltex`, `ai-openrouter`, `ai-opencode`, `ai-gemini`, `ai-cursor`
в `~/bin`, если он уже есть в `PATH`, иначе в `~/.local/bin/`, и запишет API-ключи.
После установки, если команды не видны:
```bash
exec bash
```
Обновление всех AI-инструментов одной командой:
```bash
./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-список обновляется ежедневно.
## Проверка сети
```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-уровней по провайдерам