Claude Semafor

1Как это работает

Claude Code умеет вызывать внешние команды в ключевые моменты: вы отправили запрос, Claude запускает инструмент, задаёт вопрос, заканчивает ответ. Небольшой скрипт semafor.py на вашем компьютере ловит эти события и по Wi-Fi сообщает о них семафору. Семафор зажигает светодиод этой сессии нужным цветом.

Claude Code ──hooks──► semafor.py ──Wi-Fi/HTTP──► Claude Semafor
 (ваш компьютер)                              (светодиоды + экран)

2Устройство и кнопка

photo-controls.jpgКрупный план под углом, чтобы были видны кнопка, разъём USB-C и экран

Кнопка

3Что значат цвета

Сессии Claude Code

Служебные режимы ленты

photo-leds.jpgКрупно лента: рядом жёлтый, красный и зелёный светодиоды (в полутёмной комнате, без пересвета)

4Включение и зарядка

Нажмите кнопку — устройство включится и начнёт подключаться к Wi-Fi (голубая бегущая точка). Значок батареи в левом верхнем углу экрана показывает заряд. Когда заряда мало, значок мигает.

Заряжайте через USB-C любым зарядным устройством на 5 В. Если подключить кабель к выключенному устройству, оно не включится полностью: загорится только экран с надписью CHARGE, а по окончании — DONE. Лента и Wi-Fi при этом выключены. Чтобы включить устройство, нажмите кнопку.

На работающем устройстве во время зарядки рядом с батареей виден значок молнии, а когда аккумулятор заряжен — надпись DONE.

5Подключение к Wi-Fi

При первом включении устройство не знает вашу сеть. Через несколько секунд (до полуминуты, если оно пробует старые сети) оно поднимает собственную точку доступа, а на экране появляется WiFi setup.

1. На телефоне или ноутбуке откройте список Wi-Fi сетей и подключитесь к открытой сети Semafor-XXXX. Её имя написано на экране под AP: (на экран помещаются первые 10 символов).
2. Страница настройки обычно открывается сама. Если нет — откройте в браузере http://4.3.2.1.
3. Выберите свою сеть в списке, введите пароль и нажмите Save & Connect. Устройство отключит точку доступа и подключится к сети. Когда подключение пройдёт, лента погаснет, а на экране появится noHost: компьютеры ещё не подключены.

Если за 5 минут к точке доступа никто не подключился, устройство выключается, чтобы не тратить батарею. Нажмите кнопку, чтобы попробовать снова.

6Установка на компьютер

На компьютер ставится один файл, semafor.py. Он регистрирует обработчики событий (hooks) в Claude Code. Поддерживаются macOS и Linux.

Исходный код, README и обновления лежат в репозитории claude_semafor_host на GitHub.

Что понадобится

• Claude Code, уже установленный и хотя бы раз запущенный.
• Python 3. Проверьте в Терминале:

  python3 --version

  Если команда не найдена:
  • macOS: выполните xcode-select --install или brew install python;
  • Ubuntu / Debian: sudo apt install python3.
• Компьютер и семафор должны быть в одной сети.

Установка

1. Скачайте скрипт:

   git clone https://github.com/vovan-io/claude_semafor_host.git
   cd claude_semafor_host

2. Установите его:

   python3 semafor.py install

   Скрипт скопирует себя в ~/.claude/semafor.py и добавит обработчики в ~/.claude/settings.json. Ваши настройки сохранятся, а рядом появится резервная копия settings.json.bak. Команду можно запускать повторно, например после обновления: дубликатов не будет.
3. Перезапустите Claude Code, если он был открыт: обработчики читаются при старте.

7Сопряжение

Сопряжение выдаёт компьютеру личный ключ (токен). Без него устройство не принимает команды. Это нужно сделать один раз для каждого компьютера.

1. Удерживайте кнопку 3 секунды, пока на экране не появится PAIRING с таймером, и сразу отпустите. Если держать дальше, начнётся отсчёт до выключения.
2. За 60 секунд выполните на компьютере:

   python3 ~/.claude/semafor.py register

   Ответ при успехе:

   paired as host_id=0 (name=macbook) via 192.168.1.108 (mdns semafor.local), leds=8
   saved -> /Users/you/.claude/semafor.json

3. Режим сопряжения закроется сам. На экране появится номер компьютера и его имя.

8Проверка

Прогоните первый светодиод через все цвета:

python3 ~/.claude/semafor.py test

Светодиод должен загореться жёлтым, затем красным, зелёным и погаснуть. После этого откройте Claude Code и отправьте любой запрос. Пока Claude работает, светодиод «дышит» жёлтым. Когда ответ готов, он становится зелёным.

Посмотреть состояние всех компьютеров и сессий:

python3 ~/.claude/semafor.py status

9Несколько компьютеров

Повторите установку и сопряжение на каждом компьютере. Подключить можно до 8 компьютеров. Лента показывает сессии одного, активного, компьютера. Его номер и имя крупно видны на экране.

• Короткое нажатие переключает ленту на следующий компьютер.
• Если на неактивном компьютере Claude ждёт ответа, в правом верхнем углу экрана появляется !. Нажимайте кнопку, пока не увидите красный светодиод.
• Переименовать компьютер, сделать его активным или удалить можно в веб-интерфейсе.

10Веб-интерфейс

Откройте в браузере на любом устройстве в той же сети http://semafor.local или IP-адрес семафора.

Компьютеры

Настройки устройства

Сети Wi-Fi

Питание и диагностика

В разделе Power показаны заряд и напряжение батареи. Run self-test в разделе Diagnostics перезагружает устройство в режим проверки железа: по ленте бежит радуга, по экрану — шахматная доска. Выход из проверки — нажатие кнопки.

11Экраны дисплея

12Сон и энергосбережение

Устройство выключается само, чтобы беречь аккумулятор:

• через 60 минут без активности Claude Code;
• через 5 минут в режиме настройки Wi-Fi, если к нему никто не подключился;
• при критическом разряде батареи;
• по вашей команде: удержание кнопки 3 + 5 секунд.

Включается коротким нажатием кнопки. Подключённые компьютеры и сети Wi-Fi запоминаются, повторно настраивать ничего не нужно.

13Обновление прошивки

Готовые файлы прошивки выкладываются на странице Releases. Обновлять можно по Wi-Fi, кабель не нужен.

1. Скачайте firmware.bin из последнего релиза.
2. Узнайте токен вашего компьютера:

   python3 -c "import json,os;print(json.load(open(os.path.expanduser('~/.claude/semafor.json')))['token'])"

   Браузер запомнит токен, вводить его нужно один раз.
3. В веб-интерфейсе вставьте токен в поле Token, выберите файл и нажмите Flash. На экране появится OTA. Через полминуты устройство перезагрузится с новой прошивкой.

14Если что-то не так

15Справочник команд

Все команды: python3 ~/.claude/semafor.py <команда>. Любую можно направить на конкретный адрес ключом --host 192.168.1.108.