Что это

Веб-дашборд на :8200 (routing/transparent-proxy.js), который переписывает ~/.claude/settings.json, держит пулы ключей и поднимает локальные прокси. UI — /__switch, HTTP API — /__switch/api/*.

Адрес у Claude Code один и навсегда — http://127.0.0.1:20100 (front-door, routing/frontdoor-proxy.js, режим по умолчанию). Вбиваешь его один раз в любой клиент — терминал, Warp, Orca, Claude Code Desktop → Third-Party Inference — и больше не трогаешь: активный бэкенд лежит в ~/.claude/active-backend.json, дашборд меняет только его. Переключение шлюза не требует перезапуска ни одной сессии, что критично для Orca (несколько pty с claude сразу). Реальный ключ во внешний клиент не нужен (ANTHROPIC_AUTH_TOKEN=dummy) — его подставляет прокси. Плата: пока режим включён, дашборд должен быть запущен, он и поднимает :20100. Тумблер и адрес для копирования — вкладка «Настройки», разбор устройства — ARCHITECTURE.md.

Четыре денежных шлюза — AgentRouter, GoRouter, JustWoker, Tabi Token — ходят через локальные SSE keepalive-прокси (routing/keepalive-proxy.js): они держат SSE-поток на паузах thinking-моделей, режут [1m]-суффиксы моделей и умеют fallback для count_tokens. WAF AgentRouter пускает только «настоящие» запросы Claude Code, поэтому ключ никогда не уезжает в settings.json: он лежит в ~/.claude/<префикс>-active-key.txt и подставляется прокси на каждый запрос — смена активного ключа работает без рестарта CC.

Баланс считается не на глазок. Точная цифра берётся из /api/user/self панели куками профиля браузера (balanceSource: self); если куки не привязаны — показывается анкер, вписанный руками кнопкой ✏️ вписать (из него вычитается расход); и только когда нет ни того, ни другого, включается прикидка выдача + бонусы − расход. Источник видно бейджем в строке: ⚡ точный · ✏️ вручную · ~ прикидка. Расход везде — GET /dashboard/billing/usage (центы), кеш — в routing/*-sessions.json.

Тумблер 💸 авторотация в сайдбаре — один на все денежные шлюзы. Реагирует не на порог баланса, а на отказ шлюза «нет баланса»: активный ключ подменяется на следующий пригодный (кандидат — самый маленький баланс, которому хватает). Журнал подмен — карточка на вкладке шлюза, живёт в памяти процесса и после рестарта пуст.

Статус-лайн Claude Code (routing/statusline-autoreger.sh) показывает внизу CLI живой баланс активного ключа ($) и контекстное окно (⧉), при устаревшем кеше сам дёргает рефреш через дашборд. Установщик подключает его сам; на готовой установке — node tools/enable-statusline.js и перезапуск claude.

На macOS работает всё, что нужно для своих аккаунтов: точный баланс (своя схема расшифровки куки Chromium), статус-лайн, ЛК в браузере, переключение бэкендов, OAuth официального Claude. Не портированы автореги (Camoufox) и ТГ-пульт — они Windows-специфичны. Детали и диагностика — docs/MAC-SETUP.md.

Ровно эти 12 вкладок видны на свежей установке — остальное скрыто по умолчанию. Порядок и видимость — кнопка ⋮ Настроить вкладки (перетаскивание + глазок), выбор хранится в localStorage.

Легаси — 16 вкладок, не развиваются (11 скрыты по умолчанию + 5 в архивной группе «Чтим память»)

Код и данные не удалены, вкладки включаются через ⋮ Настроить вкладки. Разбор — в ARCHITECTURE.md.

Модуль	Статус
VyceAI	OpenAI-совместимый пул через прокси :20131. 🪤 Прокси поднимают только скрипты restart-dashboard, активация вкладки его не спавнит — если порт лежит, «Подключить» уведёт клиент в мёртвый адрес.
Aerolink · Evomap · Conduit · Svrtr · HelpCoder	Ручные пулы ключей через apiKeyHelper + *-active-key.txt.
Cun	Пул ключей cun.ai через AUTH_TOKEN.
Ourtoken	Пул ключей; кнопка «Подключить» ведёт в OmniRoute :20128 — внешний Docker, без него активация бесполезна.
AnyModel	Автореги сторонних моделей.
Video API · Картинки API	CRUD-хранилища ключей провайдеров (NanoBanana, fal, Replicate, Imagen…). Обёрток под сами провайдеры нет.
XPeach (архив)	Похоронен как шлюз: все ключи 403 banned, регистрация не проходит. Код, пул, прокси :20157 и шкала в статуслайне живые.
FreeModel (архив)	Автореги свёрнуты, аккаунты и ротатор :20126 остались на месте; шкала квот 5h/7d в статуслайне работает.
TokenRouter (архив)	Аккаунты на диске; импорт и удаление требуют живого OmniRoute :20128.
Devin · Notion (архив)	Хранилища сессий. У Notion нет своего сервера в репо: :8190 — это внешний дашборд, к которому ходит CLI.
Telegram-пульт (tgbot/)	Не вкладка, а бот: переключение бэкендов с телефона + живая claude-сессия. Команды /menu, /status, /backends, /cd, /pwd, /new, /stop. Запуск npm run tgbot.

Шлюз тормозит или рвёт поток? Настройка SSE-прокси (хедж / пинги / пре-коммит) и диагностика «кто виноват» — routing/KEEPALIVE-TUNING.md.

Сервисы и порты

Порт	Сервис	Файл
20100	front-door — единственный адрес для Claude Code, режим по умолчанию	routing/frontdoor-proxy.js
8200	Dashboard — UI /__switch + все /__switch/api/*	routing/transparent-proxy.js
20133	AgentRouter keepalive (SSE, claude-*)	routing/keepalive-proxy.js
20132	AgentRouter proxy (gpt-*, Anthropic→OpenAI конвертер)	routing/agentrouter-proxy.js
20155	Tabi Token keepalive (SSE)	routing/keepalive-proxy.js
20156	GoRouter keepalive (SSE)	routing/keepalive-proxy.js
20158	JustWoker keepalive (SSE, апстрим — корень api.justwoker.icu, без /v1)	routing/keepalive-proxy.js
20157	XPeach keepalive (SSE; вкладка в архиве, прокси живой)	routing/keepalive-proxy.js
20150–20250	Custom OpenAI proxies — свободный порт из диапазона, поднимается на активацию	routing/custom-openai-proxy.js
20126	FreeModel Key Rotator (легаси)	routing/freemodel-rotator.js
20130	FreeModel OpenAI Proxy (легаси)	routing/freemodel-openai-proxy.js
20131	VyceAI OpenAI Proxy (легаси)	routing/vyceai-openai-proxy.js
20128	OmniRoute (внешний Docker, опц., архив)	docker ghcr.io/diegosouzapw/omniroute
—	Telegram-пульт — long-poll, порт не слушает	tgbot/bot.js

🪤 20126 / 20130 / 20131 поднимаются только скриптами routing/restart-dashboard.bat (.sh), вкладки их не спавнят. Активация VyceAI просто прописывает base URL :20131 — если процесса нет, клиент упрётся в закрытый порт.

---

Установка с нуля

Windows

Голый Windows, где нет ни git, ни node — открой PowerShell (есть в любой Windows) и вставь одну строку. Bootstrap сам поставит Git + Node.js через winget, склонирует репо и запустит интерактивный установщик.

irm https://raw.githubusercontent.com/WormAlien/hub-cc/master/install.ps1 | iex

[!NOTE]
Если после установки Git появилась ошибка про bash — закрой это окно PowerShell, открой новое и вставь строку ещё раз (PATH обновляется только в новой сессии). Со второго запуска git/node уже на месте, дойдёт до конца.

macOS

Голый мак, где нет вообще ничего — открой Терминал и вставь одну строку. Дальше только Enter: bootstrap ставит Command Line Tools (в них git), клонирует репо и прогоняет install-mac.sh — Homebrew → node → npm install → Playwright chromium → Claude Code → конфиги из *.example → дашборд.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/WormAlien/hub-cc/master/install-mac.sh)"

Хочешь в свою папку — задай HUBCC_DIR (сама папка станет корнем репо, промежуточные создадутся):

HUBCC_DIR="$HOME/Documents/AbuseHub" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/WormAlien/hub-cc/master/install-mac.sh)"

Проверено на чистом MacBook: одна вставка, дальше Enter. Реагировать надо в трёх местах:

1. Окно «Установить инструменты разработчика» → Установить, подождать 5–10 минут, вернуться в Терминал и нажать Enter (скрипт ждёт именно этого).
2. Пароль от мака — просит установщик Homebrew через sudo. Вводится слепо, символы не показываются — это нормально.
3. «Терминал» запрашивает доступ к папке «Документы» (только если ставишь в Documents) → OK. Промахнулся и нажал «Запретить» — Системные настройки → Конфиденциальность и безопасность → Файлы и папки → Терминал.

[!IMPORTANT]
Именно /bin/bash -c "$(curl …)", а не curl … | bash. При пайпе stdin занят самим скриптом, и интерактивные вопросы читают тело скрипта вместо твоего ответа. Так же бутстрапится сам Homebrew.

[!NOTE]
Папку Documents писать латиницей, хотя Finder показывает «Документы» — на диске она английская.

Дальше запуск в любой момент: двойной клик на DASHBOARD.command в корне репо либо bash routing/restart-dashboard.sh. Дашборд: http://localhost:8200/__switch

Если git и node уже стоят

Windows (git-bash):

git clone https://github.com/WormAlien/hub-cc.git
cd hub-cc
bash install.sh

macOS — то же, но bash install-mac.sh.

Установщик спрашивает только там, где без ответа нельзя (winget — если нет node/git · git identity — если не настроен · доп. зависимости · запустить дашборд). Что он делает:

1. Проверяет node/npm/git, при нехватке предлагает поставить через winget.
2. Настраивает git identity и credential.helper (без них git pull падает на merge-коммите).
3. Дописывает Git\usr\bin в user-PATH, если cat не виден из cmd — иначе apiKeyHelper молча отдаёт пустой ключ и Claude Code пишет «Authentication failed».
4. npm install + npx playwright install chromium chromium-headless-shell.
5. Ставит Claude Code, если его нет. Уже установленную версию не трогает (пин не нужен; если зачем-то нужна конкретная — CLAUDE_CODE_VERSION=2.1.153 bash install.sh).
6. Создаёт ~/.claude/settings.json из шаблона (если ещё нет) и подключает статуслайн.
7. Копирует локальные конфиги из *.example (routing/.env, al-sessions, video-keys, image-keys, tgbot/.env).
8. Зовёт install-deps.sh — тяжёлое и опциональное: Python-стек (Camoufox-автореги, grok-launcher, venv для ✈ Открыть TG), sqlite3.exe, OmniRoute в Docker на :20128, .env ТГ-бота. Запускается и отдельно: bash install-deps.sh.
9. Запускает дашборд и печатает шпаргалку.

[!NOTE]
API-ключи и токены установщик не спрашивает: в терминале секрет остаётся в скроллбэке и в истории. Ключ шлюза вписывается в дашборде — вкладка шлюза → ключ → Активировать.

Установщик дополнительно ловит частую ошибку hub-cc/hub-cc: такую двойную вложенность надо исправить до создания tools/tg-venv, иначе venv запомнит старый путь и сломается после переноса папки.

[!TIP]
Дашборд не открылся / :8200 не отвечает? Запусти START.bat в корне репо (двойной клик). Он поднимает ротатор + дашборд в видимом окне и не закрывается — если что-то падает, текст ошибки останется на экране. Браузер откроется сам на http://localhost:8200/__switch.

[!IMPORTANT]
Версию Claude Code фиксировать не надо. Исторический пин 2.1.153 («новее ломает apiKeyHelper») не подтвердился: ротация ключей на лету работает на всех версиях. CLAUDE_CODE_API_KEY_HELPER_TTL_MS=0 нужен только с выключенным front-door, для режимов на apiKeyHelper — дашборд выставляет переменную сам при активации.

Перенос папки проекта. Путь к репо нигде не прописан, поэтому папку можно переносить и переименовывать: останови дашборд (routing/stop-dashboard.sh на маке, закрыть окно на Windows) → перенеси → запусти из нового места. Статус-лайн привязан через шим в ~/.claude/, указатель на корень обновляет restart-dashboard при каждом старте. Если что-то всё же отвязалось — node tools/relocate.js. Пробелы в пути работают, но в терминале путь надо брать в кавычки.

Вручную, без установщика — те же шаги командами (git-bash)

# 0. системные зависимости (winget)
winget install OpenJS.NodeJS.LTS          # Node.js LTS (>=18) + npm
winget install Git.Git                     # Git for Windows (git-bash)
winget install Docker.DockerDesktop        # опц.: только под backend OmniRoute
winget install Python.Python.3.11          # опц.: стабильнее для opentele/tgcrypto

# 1. зависимости
npm install
npx playwright install chromium chromium-headless-shell

# 2. Claude Code (любая свежая версия, пин не нужен)
npm config delete prefix
npm install -g @anthropic-ai/claude-code

# 3. базовый settings.json (в шаблоне уже base http://127.0.0.1:20100 + dummy-токен)
cp claude-settings.example.json ~/.claude/settings.json

# 4. локальные конфиги/секреты (gitignored)
cp routing/.env.example             routing/.env
cp routing/al-sessions.example.json routing/al-sessions.json
cp routing/video-keys.example.json  routing/video-keys.json
cp routing/image-keys.example.json  routing/image-keys.json
cp tgbot/.env.example               tgbot/.env   # впиши BOT_TOKEN + ALLOWED_USERS

# 5. опц. Python-зависимости (✈ Открыть TG)
py -3.11 -m venv tools/tg-venv
tools/tg-venv/Scripts/pip install -r tools/tg-venv-requirements.txt

# 6. запуск
routing/restart-dashboard.bat              # keepalive-прокси + дашборд :8200 + откроет UI
npm run tgbot                              # опц.: ТГ-пульт

---

Дашборд

http://localhost:8200/__switch. Сайдбар держит активное состояние: пилюля ACTIVE с базой активного бэкенда, баланс активного ключа с полосой запаса пула, тумблер 💸 авторотация, счётчики записей у каждой вкладки. Ниже — панель 📜 Логи (две вкладки: история уведомлений и серверные логи прокси, у которых больше нет своих окон), ⟳ Автообновление, ⋮ Настроить вкладки и 🔄 Рестарт дашборда.

Над контентом любой вкладки — глобальная шкала «Общий запас free-tier»: сумма доступного по всем шлюзам плюс строка на каждый (ключей / LIVE / DEAD / доступно).

Claude Code

Активный маршрут из ~/.claude/settings.json (имя бэкенда + режим + base URL) и кнопка 🎫 Подключить — официальный Claude по OAuth (api.anthropic.com, не трогает /login-сессию), рядом состояние OAuth-сессии.

AgentRouter

Пул ключей agentrouter.org. WAF пускает только реальный Claude Code: probe и листинг моделей обязаны нести CC-заголовки, поэтому apiKeyHelper не годится — в settings.json уезжает dummy, а настоящий ключ лежит в ~/.claude/ar-active-key.txt и подставляется прокси :20133/:20132 на каждый запрос. База — https://agentrouter.org без /v1.

• Маршрутизация моделей — клик по модели = полная настройка Claude Code в один клик: ~/.claude/ar-active-model.txt + settings.model + base + токен + оба прокси. claude-* идут в keepalive :20133, gpt-* — в конвертер :20132 (Anthropic→OpenAI).
• Маппинг claude-тиров — opus/sonnet/haiku → модель шлюза (routing/ar-modelmap.json). Читается прокси по mtime, без рестарта. Закрывает сабагентов (своих haiku-моделей у шлюза нет); пустой тир = не маппить. Клик по чипу модели маппинг не трогает.
• Чек-ин — карточка «🎁 подарков ждут» с настраиваемой границей суток (по умолчанию 20:30 МСК) показывает, сколько аккаунтов готовы забрать бонус. В таблице колонка 🎁 $25: меню из трёх пунктов — ⚡ забрать автоматически / 🌐 открыть браузер руками / 📦 отметить забранным; после сбора ячейка тикает обратным отсчётом до сброса. Детект бонуса есть только у AgentRouter.
• ✏️ вписать — это не «выдача», а анкер баланса: вписанная из ЛК цифра перекрывает цифру шлюза, пустое поле сбрасывает анкер. 💳 Балансы всех — пакетный прогон.
• 🌐 ЛК — браузер аккаунта (видимый Chromium, профиль agentrouter/profiles/<label>/). Ключа ещё нет → открывается регистрация по реф-ссылке; ключ вписан → agentrouter.org/console/topup. Аккаунт можно добавить без ключа: активация и пинг у него выключены, ключ вписывается потом кнопкой 🔑.
• 🪤 Два фильтра, не путать. WAF смотрит на заголовки (user-agent: claude-cli/… → 200, curl → 401 unauthorized client detected). Content-filter смотрит на текст и только на gpt-путях: режет точную подстроку you are a helpful assistant. (с точкой) → 500 sensitive words detected — именно её шлёт пробник валидации модели у CC. Лечится WAF_PHRASES/wafSanitize в agentrouter-proxy.js.

Карточка ⚡ Keepalive есть у каждого шлюза: четыре поля (хедж, максимум дублей, попыток на запрос, пре-коммит), кнопки Применить и Рекомендованные, график латентности (среднее и худший ответ по минуте, выбор окна) и строка счётчиков запросов · ремапов · keepalive · хеджей · ретраев · ошибок · ответ. Что чем крутить — routing/KEEPALIVE-TUNING.md.

Тулбар над таблицей: 🔌 Подключить, ↻ Обновить, 📡 Пинг статусов, 💳 Балансы всех, 🔗 Профили, ➕ Добавить (в том числе 🐙 прямо из менеджера GitHub), 📋 Вставить аккаунт (share-код), поле фильтра и сортировка (порядок помнится). Колонки: e-mail · API Key · Status · Баланс · 🎁 $25 · GitHub · Добавлен · Actions, клик по заголовку = сортировка, в подвале сводка по пулу.

GoRouter

Пул ключей gorouter.app, активация через SSE keepalive :20156. Структура вкладки та же, что у AgentRouter, но маппинг тиров и keepalive стоят до каталога моделей, а колонки 🎁 нет.

• Чек-ина у GoRouter нет — ни колонки, ни кнопки. $5, который легко спутать с чек-ином, это реф-бонус рефереру за приведённого.
• Прикидка баланса — база GO_DEFAULT_GRANT = 70, шаг $25; используется только когда нет ни точной цифры, ни анкера.
• Маппинг claude-тиров — routing/gorouter-modelmap.json.
• 🌐 ЛК — аккаунт без ключа → регистрация по реф-ссылке, с ключом → gorouter.app/wallet.

JustWoker

Пул ключей api.justwoker.icu (панель New API), активация через SSE keepalive :20158 — структурная копия вкладки GoRouter.

• Прикидка баланса — JW_DEFAULT_GRANT = 10, шаг $5; расход из /dashboard/billing/usage.
• Маппинг claude-тиров — routing/justwoker-modelmap.json. В каталоге шлюза только opus: claude-opus-5, claude-opus-5-thinking, claude-opus-4-8, claude-opus-4-8-thinking.
• 🌐 ЛК — без ключа → регистрация https://api.justwoker.icu/sign-up?aff=IFYf, с ключом → api.justwoker.icu/wallet.
• Кнопки «+N» нет намеренно: чек-ин у шлюза включён, но бонус случайный (мин/макс квота) — обещать цифру нечем.
• 🪤 База для Claude Code — корень https://api.justwoker.icu, без /v1. POST /v1/messages отдаёт 200, POST /v1/v1/messages — 404. /v1 нужен только листингу моделей.
• ⚠️ GitHub-аккаунту нужен год. Шлюз отдаёт github_minimum_account_age_days: 365, регистрация по email/паролю выключена. Свежекупленные гитхабы тут не пройдут — это ответ сайта, а не поломка дашборда.

Tabi Token

Пул ключей tabitoken.com, активация через SSE keepalive :20155.

• Выдача — $100 по умолчанию, +$20 рефереру за приведённого по рефке.
• Маппинг claude-тиров — routing/tabi-modelmap.json, читается прокси по mtime, без рестарта.
• 🌐 ЛК — без ключа → регистрация по реф-ссылке, с ключом → tabitoken.com/wallet.

GitHub аккаунты

Хранилище купленных аккаунтов: они нужны для чек-ина бонусов и для регистрации на JustWoker (там только GitHub, и аккаунт должен быть старше 365 дней).

• Поля — логин/пароль/2FA-секрет/recovery-коды/ник/apiToken/заметка. Секреты замаскированы, показ через меню ⋯.
• TOTP считается локально в браузере — base32 + HMAC-SHA1 (RFC 6238), крупная цифра с обратным отсчётом 30 с, без внешних сервисов.
• Фильтры-чипы — по возрасту (месяц / год / без метки) и по занятости (свободные / занятые), каждый с числом; сверху сводка «сколько заняты, сколько свободны, сколько записей в каждом пуле».
• Плашки занятости показывают, в каком шлюзе аккаунт уже израсходован; кнопка 🔗 Сверить привязки дописывает привязку в записи шлюзов.
• Профиль браузера на аккаунт — открывает Chromium с профилем github/profiles/<id>/.
• Импорт пачкой — три формата строк с превью и общей меткой возраста.

Колонка GitHub есть на всех четырёх шлюзах: бейдж 🐙 в строке открывает модалку привязки, где занятые аккаунты подсвечены, а свободные видны сразу.

Telegram аккаунты

Пул авторегов из freemodel/tg_pool.json. Поиск, четыре фильтра (статус · health · «свободен для» · сортировка), кнопки 🩺 Чек непроверенных и 🩺 Чек всех с полосой фонового прогона, строка статистики и таблица TG/номер · DC · Auth Key · Status · Сервисы. Добавление — вставкой списка (phone|hex:dc, hex:dc, phone hex dc) или 📎 Импорт .session; ✈ Открыть запускает портативный Telegram Desktop на этом аккаунте.

Health

Куда реально смотрит Claude Code: имя бэкенда, base, порт, а при включённом front-door — вся цепочка front-door → активный бэкенд → реальный порт с пилюлей «сервис на этом порту жив/мёртв». Ниже git-состояние репо (ветка, local → remote, «отстал на N коммитов») и аптайм дашборда, затем список сервисов по портам: точка со статусом, :порт · pid · Nмс, у keepalive и front-door кнопка 🔄 перезапустить, у осиротевшего порта — 💀 убить.

Плагины / MCP

Слева плагины Claude Code (тоггл enabledPlugins, кнопка ★ Включить рекомендованные), справа MCP-серверы из ~/.claude.json — тоггл, добавление и удаление. Счётчик у вкладки показывает, сколько из сколького включено.

Настройки

• 🎨 Тема дашборда — 22 темы в четырёх группах, кнопка 🎲 случайной темы, закреплённая активная палитра. Выбор в localStorage['dashboard-theme'], дефолт — Zen. Перекрашиваются только цвета интерфейса: на прокси, ключи и бэкенды тема не влияет.
• Обновление дашборда — git pull + рестарт одной кнопкой, с бейджем «отстал на N».
• Front Door :20100 — тумблер, пилюли «прокси жив/лежит» и «Claude Code смотрит сюда / ходит напрямую», кнопка 🔄 поднять, строка бэкенд → upstream → ключ и готовый блок для внешних клиентов: ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN=dummy с кнопкой копирования.
• Тоггл статус-бара CC и автокомпакта — обе настройки через /api/settings/apply.
• JSON-редактор ~/.claude/settings.json + ♻️ Сбросить на рабочий / ↺ Перечитать, и отдельная карточка бэкапов (~/.claude/settings-backups/).
• OmniRoute env — OMNIROUTE_BASE_URL + OMNIROUTE_API_KEY → routing/.env.

Тема — это набор оверрайдов CSS-переменных --color-*, навешенных инлайном на <html>: все утилиты Tailwind перекрашиваются сами, без правок разметки. Палитры считаются двумя функциями (_surf — поверхности и текст, _acc — шесть семантических акцентов), поэтому 22 темы занимают в коде столько же места, сколько две.

---

Статуслайн Claude Code

Строка внизу CLI: активный шлюз и модель, доступные деньги на активном ключе, занятое контекстное окно и, если есть, готовые к сбору бонусы.

В statusLine.command прописывается шим ~/.claude/autoreger-statusline.sh, который находит репо через ~/.claude/autoreger-root.txt (указатель обновляет restart-dashboard на каждом старте) — поэтому перенос папки бар не ломает. Сам скрипт — routing/statusline-autoreger.sh. Если бара нет — docs/STATUSLINE.md.

• Баланс $ — есть у AgentRouter, GoRouter, Tabi, JustWoker, XPeach (цифра из *-sessions.json), FreeModel (окно квот 5h/7d) и Ourtoken. ~ = устаревший кеш; при протухании >90 с скрипт сам дёргает GET /__switch/api/{ar,tb,go,xp,jw}/balance (fire-and-forget), следующий рендер уже свежий.
• Контекст ⧉ — total_input_tokens/context_window_size из payload Claude Code; при отсутствии — ⧉ ?.
• Шлюз определяется по apiKeyHelper/ANTHROPIC_BASE_URL из settings.json, без сети.

---

Reference

Скрипты

# Дашборд
routing/restart-dashboard.bat            # Windows: keepalive-прокси + дашборд :8200 + откроет UI
bash routing/restart-dashboard.sh        # macOS/git-bash; стоп — routing/stop-dashboard.sh
START.bat                                # запуск в видимом окне (ошибка останется на экране)
DASHBOARD.command                        # macOS: запуск двойным кликом
node routing/transparent-proxy.js        # дашборд вручную

# Обслуживание
UPDATE.bat   / bash update.sh            # git pull + рестарт
DOCTOR.bat   / bash doctor.sh            # диагностика окружения
FIX.bat      / bash fix.sh               # починка типовых поломок установки
SHARE.bat    / bash share.sh             # экспорт/импорт аккаунтов между машинами
node tools/enable-statusline.js          # подключить статуслайн на готовой установке
node tools/relocate.js                   # перепривязать шимы после переноса папки

# ЛК/сессии шлюзов (GitHub-вход, чек-ин бонусов)
node agentrouter/open-session.js <label>
node gorouter/open-session.js <label>
node tabi/open-session.js <label>
node justwoker/open-session.js <label>

# Документация
node tools/render-readme-shots.js        # перерисовать скриншоты README (нужен живой :8200)
npm run check-deps                       # не забыт ли новый файл в git

Структура и конфиги

Папка / файл	Что
install.sh · install-mac.sh	Установщики Windows и macOS (второй качается одним файлом)
install-deps.sh	Тяжёлое и опциональное: Python-стек, sqlite3, OmniRoute, ТГ-бот
install-lib.sh	Общие хелперы установщиков (ask/prompt/set_env + режим AUTO)
routing/transparent-proxy.js	Dashboard :8200 + HTTP API + пулы ключей
routing/frontdoor-proxy.js	Front-door :20100 — фиксированный вход для клиентов
routing/keepalive-proxy.js	SSE keepalive: agentrouter :20133 / tabi :20155 / gorouter :20156 / xpeach :20157 / justwoker :20158 (параметризован env PORT/UPSTREAM/KEY_FILE/MODELMAP_FILE)
routing/agentrouter-proxy.js	AgentRouter gpt-конвертер :20132 (Anthropic→OpenAI)
routing/proxy-dashboard.html	UI целиком: Tailwind 4, 22 темы, вся разметка вкладок
routing/{agentrouter,gorouter,tabi,xpeach,justwoker}-sessions.json	Пулы ключей + кеш балансов (gitignored)
routing/{ar,gorouter,tabi,xpeach,justwoker}-modelmap.json	Маппинг claude-тиров (редактируется на вкладках)
routing/github-accounts.json	GitHub-аккаунты: логин/пароль/TOTP/recovery (gitignored)
routing/custom-openai-proxy.js · routing/custom-providers.json	Custom-провайдеры (json — gitignored)
routing/statusline-autoreger.sh	Статус-лайн CC: шлюз/модель · $баланс · ⧉ контекст
agentrouter/ · gorouter/ · tabi/ · justwoker/ · github/	open-session.js (вход в ЛК) + профили браузера
freemodel/ · conduit/ · svrtr/ · helpcoder/ · anymodel/ · vyceai/ · cun/	Легаси-шлюзы
tgbot/	Telegram-пульт (bot.js + .env)
internal/dashboard-api.js	Прослойка CLI ↔ HTTP
tools/render-readme-shots.js	Скриншоты README: свой headless Chromium, тема zen, блюр персонального
docs/assets/*.html	Исходники hero-баннера и картинки статуслайна — рисуются той же палитрой
~/.claude/settings.json	Активный backend (дашборд редактирует и бэкапит перед каждой записью)
~/.claude/active-backend.json	Состояние front-door: кого сейчас отдаёт :20100
~/.claude/{ar,tabi,gorouter,xpeach,justwoker}-active-key.txt · -active-model.txt	Активный ключ и модель шлюза

Карта документации — docs/README.md, полная архитектура — ARCHITECTURE.md.

Troubleshooting

Симптом	Причина / фикс
После git pull вкладка отдаёт 404 на своих же /api/…	Процесс на :8200 поднят со старого кода. Рестарт: кнопка 🔄 Рестарт дашборда в сайдбаре либо routing/restart-dashboard.bat (bash routing/restart-dashboard.sh)
CC говорит Not logged in · Please run /login	В settings.json попал не тот ключ. Откат: Настройки → JSON-редактор → бэкапы (~/.claude/settings-backups/) либо любой ~/.claude/settings.json.bak-<timestamp> — их пишет дашборд перед каждой записью. Затем перезапустить Claude Code
Статус-бар CC не показывает баланс $	Активен режим без шкалы (шкала есть у AgentRouter, GoRouter, Tabi, JustWoker, XPeach, FreeModel, Ourtoken) или кеш ещё пуст — нажми 💳 Балансы всех на вкладке шлюза
Дашборд не открывается / :8200 занят	routing/restart-dashboard.bat — сам убивает старый процесс на :8200 и ждёт освобождения порта
AgentRouter: 400 content-blocked	Почти всегда base64-картинка в теле (скриншот в tool_result или image_url от конвертера). Режется IMAGE_B64_RE в wafSanitize: data-url → валидная 1×1 PNG, сырой блоб → [image omitted]. Проверь, что запрос идёт через :20133/:20132, а не в agentrouter.org напрямую. Кириллический bypass отключён с 15.08 — WAF сам режет хомоглифы, чистая латиница проходит
AgentRouter gpt-модель не отвечает	Не поднят конвертер :20132 — выбери gpt-модель заново или подними routing/agentrouter-proxy.js
Шлюз не активируется	Рестарт дашборда пересоздаёт keepalive активного шлюза и снимает процессы прошлого запуска; неактивные поднимаются при активации. Точечно — кнопка 🔄 перезапустить в Health
Ключи не ротируются «на лету»	В дефолтном front-door-режиме это не про TTL: ключ подставляет прокси на каждый запрос. Если front-door выключен и режим сидит на apiKeyHelper — нужен CLAUDE_CODE_API_KEY_HELPER_TTL_MS=0, дашборд выставляет его сам при активации. Версия CC тут ни при чём

Безопасность

[!CAUTION]
Дашборд не требует аутентификации. Любой, кто достанет до :8200/__switch, увидит ключи шлюзов, логины и пароли GitHub, TOTP-секреты и recovery-коды, а POST-роуты переписывают settings.json. Поднимай его только на своей машине и не открывай порт наружу.

• Реальные ключи и пароли — в routing/*.json (gitignored) и ~/.claude/*-active-key.txt; в UI они замаскированы (👁/📋), целиком не показывается ни один ключ.
• ~/.claude/settings.json бэкапится перед каждым изменением: *.bak-<timestamp> рядом с файлом плюс каталог ~/.claude/settings-backups/.
• Gitignored: routing/.env, tgbot/.env, все routing/*-sessions.json и routing/*-keys.json, routing/github-accounts.json, routing/custom-providers.json, профили и сессии всех шлюзов, conduit/accounts/, freemodel/{sessions,tg_pool.json}, manual_sessions/, ready_to_sell/, tools/{tg-venv,telegram-portable,tg-profiles}. Картинки: *.png игнорируются везде, кроме docs/*.png — 🪤 исключение однократное, docs/подпапка/x.png снова попадёт под игнор и молча не уедет в коммит.
• Скриншоты для README снимаются с блюром персонального (tools/render-readme-shots.js): метки аккаунтов, ники GitHub, суммы. Правило простое — если добавил в UI новую колонку с деньгами или логином, допиши селектор в MASK этого скрипта.

Перед коммитом:

git diff --cached | grep -E "sk-[a-z]{2,}-[a-f0-9]+|auth_key_hex|fe_oa_|aero_live_|totpSecret|recoveryCodes|ghp_" || echo "OK: no keys in staged diff"

Поддержать проект

Всё здесь бесплатное и таким останется. Если сэкономило тебе время — лучший способ сказать спасибо: взять подписку на XGATE, наш VPN. Деньги идут на серверы, автореги и разработку этого репозитория.

🎟️ Промокод ABUSEHUB	3 дня бесплатно, карта не нужна — вводится в боте
🤖 Telegram-бот	@xgateonline_bot — покупка, ключи, саппорт
🔑 Личный кабинет	cabinet.xgate.online — подписка, устройства, статистика
📄 Документация	docs.xgate.online — настройка под iOS/Android/Windows
💸 Партнёрка	20% с каждого платежа приведённых, пожизненно — ссылка в боте

Почему это релевантно этому репо. Регистрации, капчи и API-эндпоинты не любят выжженные IP публичных VPN — с них ловишь бан ещё на форме. У XGATE свой небольшой пул нод (DE · CH · NL · FI · RU), а не перепроданный чужой пул: Reality (XTLS), XHTTP за CDN, Hysteria2 — проходит DPI и операторские белые списки. От 150 ₽/мес, оплата картой и СБП в рублях или криптой, 1–20 устройств на подписку.

Disclaimer

Образовательные цели. Используй в рамках ToS соответствующих сервисов (AgentRouter, GoRouter, Tabi Token, JustWoker, Anthropic).

License

MIT