English · Поставить за минуту — вставь в Терминал (дальше по шагам):
curl -fsSL https://raw.githubusercontent.com/Lutamona/SubBar/main/scripts/get.sh | bashClaude Code на подписке упирается в лимиты: на 5 часов и на неделю. И тратит их не только на главное. Когда Claude раздаёт работу субагентам — пройтись по коду, прочитать файлы, прогнать тесты, — они едят тот же лимит, что и основная сессия. А субагентов на одну задачу бывает и три, и пять.
SubBar отдаёт эту рутину моделям OpenCode Go (DeepSeek и другие) — у них свой, отдельный лимит. Claude по-прежнему думает и пишет код на твоей подписке, а черновую работу делают субагенты на OpenCode.
- Лимит Claude — на главное. Поиск, чтение и прогоны субагентов уходят в OpenCode Go, подписка Claude остаётся основной сессии.
- Ничего не ломается. Основная сессия идёт в Anthropic байт в байт, как без SubBar. OpenCode сбоит — запрос субагента сам уходит в Claude, и работа не встаёт.
- Видно, что подмена работает. Внизу Claude Code — строка SubBar: модель субагентов, сколько их и сколько ответов пришло из OpenCode.
- Все лимиты в строке меню. Claude, ChatGPT/Codex, OpenCode Go, Command Code, Devin и любая подписка со своим JSON API: сколько осталось и когда сброс. Потрачено 90% — придёт уведомление (порог настраивается).
- Несколько ключей OpenCode. Кончился лимит на одном — субагенты сами переходят на следующий.
- Никаких конфигов. Добавил ключ — прокси сам запустился и дальше стартует при входе в систему. Выключил подмену одним переключателем — снова чистый Claude.
- Бесплатно и открыто. MIT, без своих серверов и телеметрии: всё работает на твоём Mac.
claude-sub запускает тот же Claude Code, только его запросы идут через маленький прокси на твоём Mac
(127.0.0.1:8479). Прокси смотрит на модель каждого запроса:
- основная модель и служебные запросы → Anthropic, по твоей подписке, байт в байт;
haikuс инструментами (так работают субагенты) → OpenCode Go, на модели, которую ты выбрал в SubBar.
Твой вход в Claude (токен подписки) в OpenCode не уходит никогда: туда идёт только ключ OpenCode, и это проверяет
сквозной тест. Обычный claude работает как раньше, мимо прокси.
- Mac на macOS 13 или новее — Apple Silicon или Intel.
- Claude Code, в который ты уже вошёл подпиской Pro или Max. Проверь:
claudeзапускается и отвечает. - Ключ OpenCode Go — оформи подписку на opencode.ai и скопируй API-ключ.
curl -fsSL https://raw.githubusercontent.com/Lutamona/SubBar/main/scripts/get.sh | bashСкрипт скачает готовое приложение из последнего релиза, сверит
контрольную сумму, положит его в /Applications/SubBar.app, запустит и добавит команду claude-sub.
Ни Xcode, ни Rust не нужны. В строке меню появятся кольца SubBar.
macOS спросит доступ к связке ключей «Claude Code-credentials» — нажми «Разрешить всегда». Так SubBar видит лимиты твоей подписки Claude; токен уходит только в Anthropic.
Если скрипт напишет, что добавил ~/.local/bin в PATH, открой новое окно Терминала — там заработает claude-sub.
Значок SubBar в строке меню → + → OpenCode Go → вставь ключ → Добавить.
Всё: первый ключ сам становится основным для субагентов, а прокси сам запускается и дальше стартует при входе
в систему. Проверить связь: экран «Субагенты» (кнопка ⇄) → «Проверить» →
✓ Отвечает за 1,2 с · OpenCode Go · «ок».
Уже входил в OpenCode CLI? Тогда вместо вставки нажми «Найти на этом Mac» в той же форме — ключ подтянется сам. Эта же кнопка найдёт входы ChatGPT/Codex, Command Code и Devin: они нужны только для лимитов, подмене — нет. Карточка Claude появится сама.
Есть ещё ключи OpenCode — добавь каждый своей карточкой: кончится лимит на одном, субагенты перейдут на следующий.
Экран «Субагенты» → переключатель «Строка в Claude Code». Или одной командой:
/Applications/SubBar.app/Contents/MacOS/SubBar statusline installСвоя строка состояния у тебя уже была — она останется первой, строка SubBar встанет второй. Копия настроек перед
правкой — ~/.claude/settings.json.subbar-backup, убрать строку — та же команда с remove.
claude-subОстальное как обычно, флаги тоже работают: claude-sub --resume, claude-sub -p "…". Входить заново не надо —
это тот же Claude Code с тем же входом.
Дай задачу побольше и скажи «раздай субагентам» — Claude позовёт субагентов haiku, и они уйдут в OpenCode.
claude-sub сам подсказывает ему, что субагенты haiku теперь работают на OpenCode и рутину стоит отдавать им
(отключить подсказку: SUBBAR_HINT=0 claude-sub).
Хочешь всегда через SubBar — добавь в
~/.zshrcстрокуalias claude='claude-sub'. Это безопасно: самclaude-subзовёт настоящийclaude, а если прокси не отвечает — запускает его без подмены.
По ней сразу видно, куда идут субагенты этой сессии:
| Строка | Что значит |
|---|---|
🟢 deepseek-v4.1-flash · 3 аг · 28 отв |
всё работает: 3 субагента, 28 ответов пришли из OpenCode |
⚪ deepseek-v4.1-flash · пока не запускались |
сессия идёт через SubBar, субагентов ещё не было |
⚪ … · ключ OpenCode #2 |
ответил запасной ключ: на основном кончился лимит |
🟡 … · 2 в Claude |
2 запроса откатились на настоящий Claude (OpenCode сбоил) — они тратят подписку |
🔴 … · 1 ош |
были ошибки — загляни в журнал |
🟡 подмена выключена · настоящий Claude |
подмену выключили в окне SubBar |
🟡 нет ключа OpenCode Go · настоящий Claude |
добавь ключ (шаг 2) |
⚪ настоящий Claude · не через claude-sub |
запущен обычный claude |
⚪ настоящий Claude · прокси SubBar не запущен |
прокси не работает: «Субагенты» → «Прокси как служба» или ↻ рядом |
🔴 прокси SubBar не отвечает — запросы сессии не проходят |
прокси пропал посреди сессии: «Субагенты» → ↻, или перезапусти claude-sub |
Из Терминала:
curl -s 127.0.0.1:8479/_subbar/status # статус прокси
tail -f ~/Library/Logs/SubBar/proxy.log # журналКольца в строке меню — до трёх окон лимита одной подписки: закреплённой или самой израсходованной. У Claude это 5 часов и неделя, у OpenCode Go — ещё и месяц. Клик — все подписки списком. Экран «Субагенты» (⇄) — пульт подмены: модель, ключи, откат в Claude, строка в Claude Code.
Скопируй это своему агенту — Claude Code, Cursor или Codex:
Установи SubBar: https://github.com/Lutamona/SubBar — действуй строго по docs/FOR-AI.md
и проверяй каждый шаг. Ключ OpenCode Go я добавлю сам в окне SubBar.
В docs/FOR-AI.md — всё для агента: установка, строка внизу Claude Code, правильный запуск, проверка и что делать, если что-то пошло не так.
Это безопасно для моей подписки Claude?
Прокси передаёт запросы основной сессии в Anthropic байт в байт — тот же вход, те же запросы, что и без SubBar.
Токен подписки Claude никогда не уходит в OpenCode: туда идёт только ключ OpenCode, и на это есть сквозной тест.
Прокси слушает только 127.0.0.1 и отбивает запросы из браузера, так что открытая вкладка не потратит твою квоту.
Одно исключение из «байт в байт»: если сессию вели на OpenCode (например, основная модель попала под подмену), а потом вернули в Claude, прокси убирает из истории «мысли» модели OpenCode. С чужой подписью Anthropic отвечал бы ошибкой на каждом ходу.
Сколько это экономит?
Зависит от того, сколько работы Claude отдаёт субагентам. Всё, что ушло в OpenCode, не тратит лимит Claude, — это видно по счётчику ответов в строке внизу. Основная сессия по-прежнему идёт по подписке Claude, а у OpenCode Go свой лимит: он виден в карточке SubBar.
На каких моделях работают субагенты?
deepseek-v4.1-flash (по умолчанию), space-bunny-free или muse-spark-1.3-contributor — выбирается на экране
«Субагенты», там же уровень размышления.
А sonnet тоже можно отправить в OpenCode?
Да: «Субагенты» → «Кого подменять» → «haiku и sonnet». Учти: подмена смотрит на модель запроса, а не на то, кто его сделал. Если основная сессия сама работает на подменяемой модели — например, на Sonnet в этом режиме, — она тоже уйдёт в OpenCode.
OpenCode лёг или кончился лимит — что будет?
Временный сбой — два быстрых повтора. Не помогло — запрос уходит в настоящий Claude (тратит подписку, строка покажет
· N в Claude). Кончился лимит ключа — берётся следующий ключ из карточек, основной вернётся сам после сброса.
О таком SubBar сообщит уведомлением macOS.
Прокси не запущен — Claude сломается?
Нет. claude-sub подождёт прокси до 20 секунд (если служба как раз перезапускается — до 90), а если тот так и не
ответит — предупредит и запустит обычный Claude без подмены.
Где мои данные?
~/Library/Application Support/SubBar/: главное там — state.json (подписки и ключи) и proxy.json (настройки
прокси). Читать их может только твой пользователь. Ключи лежат в открытом виде, как и у самих CLI.
SubBar ходит в сеть только к самим сервисам: Anthropic, OpenCode, ChatGPT, Command Code и адрес своей подписки, если ты его задал. Лимиты Devin он берёт у самого Devin CLI. Ни серверов разработчика, ни телеметрии.
macOS пишет «не удаётся проверить разработчика»
Приложение подписано без сертификата Apple Developer. Скрипт установки сам снимает пометку «скачано из интернета»; если ставил вручную из архива — выполни:
xattr -dr com.apple.quarantine /Applications/SubBar.appКак обновить?
Той же строкой, что и установка: поставит последнюю версию поверх, ключи и настройки останутся. Прокси перезапустится мягко — начатые запросы доделает.
Как удалить?
SB=/Applications/SubBar.app/Contents/MacOS/SubBar
"$SB" statusline remove # строка в Claude Code
"$SB" proxy-service off # прокси
launchctl bootout "gui/$(id -u)/ai.subbar" 2>/dev/null # автозапуск
pkill -x SubBar # само приложение
rm -rf /Applications/SubBar.app ~/.local/bin/claude-sub ~/Library/Logs/SubBar \
"$HOME/Library/Application Support/SubBar" \
~/Library/LaunchAgents/ai.subbar.plist ~/Library/LaunchAgents/ai.subbar.proxy.plist \
~/.claude/settings.json.subbar-backup ~/.claude/settings.json.subbar.lockСтроку export PATH="$HOME/.local/bin:$PATH" с пометкой SubBar в ~/.zshrc (или ~/.bash_profile) можно оставить — она ничему не мешает.
Нужны Command Line Tools (xcode-select --install) и Rust:
git clone https://github.com/Lutamona/SubBar.git && cd SubBar
./scripts/install.sh # соберёт, положит в /Applications и запустит
cargo test # юнит-тесты и сквозные тесты прокси на фейковых серверахВсе экраны и настройки, CLI и устройство прокси — в docs/REFERENCE.md.
MIT. Проект не связан с Anthropic и OpenCode.
Если SubBar сберёг тебе лимит — поставь ⭐, так его найдут другие.



