55 lines
2.6 KiB
Markdown
55 lines
2.6 KiB
Markdown
# Claude — панель для iTerm2 Toolbelt
|
||
|
||
Сверху — дерево активных сессий Claude Code и их субагентов (модель, контекст, worktree),
|
||
снизу — лимиты подписки и баланс extra usage.
|
||
|
||
## Установка
|
||
|
||
```bash
|
||
tar xzf claude-panel.tar.gz
|
||
cd claude-panel
|
||
./install.sh
|
||
```
|
||
|
||
Затем в iTerm2: **View → Toolbelt → Show Toolbelt**, **Toolbelt → Claude**, и перезапустите
|
||
открытые сессии `claude`. Повторный запуск `install.sh` обновляет установленное.
|
||
|
||
Нужно: macOS, iTerm2, python3, jq (`brew install jq`, в macOS 15+ уже есть).
|
||
|
||
## Что ставится
|
||
|
||
| Что | Куда |
|
||
|---|---|
|
||
| скрипт панели | `~/Library/Application Support/iTerm2/Scripts/AutoLaunch/claude_agents.py` |
|
||
| хук Claude Code | `~/.claude/hooks/agents_panel_hook.sh` + записи в `~/.claude/settings.json` |
|
||
| пример настроек | `~/.config/claude-agents/config.example.json` |
|
||
|
||
Перед изменением `settings.json` и заменой файлов старые копии кладутся в
|
||
`~/.claude-panel-backup/<дата>/`. Ваши остальные хуки и настройки не трогаются.
|
||
|
||
## Работа с панелью
|
||
|
||
- клик по сессии или агенту — последние сообщения (копятся, пока окно открыто);
|
||
- ⌘-клик по сессии — перейти в её вкладку;
|
||
- клик по `⎇ папка` — открыть в ней `lf` в соседней панели;
|
||
- цвет точки: зелёный — работает, жёлтый — ждёт вас, серый — свободен;
|
||
- сессии внутри tmux (и `tmux -CC`) тоже видны: клик по `⎇` делит панель tmux, ⌘-клик переключает на неё;
|
||
- цвет токенов: жёлтый > 500k, красный > 700k.
|
||
|
||
## Настройки
|
||
|
||
Скопируйте `config.example.json` в `~/.config/claude-agents/config.json` и оставьте только
|
||
нужные ключи. Меняется на лету, кроме `port`.
|
||
|
||
## Если что-то не так
|
||
|
||
`http://127.0.0.1:8766/raw` — что панель видит: логи хука, причины скрытия сессий,
|
||
ошибки лимитов и баланса.
|
||
|
||
## Удаление
|
||
|
||
```bash
|
||
./uninstall.sh # настройки и логи остаются
|
||
./uninstall.sh --purge # удалить всё
|
||
```
|