Документация · Vox
Скажите — и Mac сделает сам
Vox — голосовой ассистент VoxTap. Он слушает и отвечает голосом, а думает и действует агент, который работает прямо на вашем Mac, — Claude Code или Grok на вашей подписке. VoxTap за это денег не берёт.
Как это устроено
VoxTap — уши и голос. Агент — голова и руки.
Вы говорите задачу. VoxTap распознаёт речь и передаёт её агенту. Агент сам решает, что делать: открывает приложения, нажимает кнопки, печатает, проверяет результат — и коротко отвечает голосом. Всё, что стоит запомнить, он записывает в память на вашем Mac.
Агент работает на вашей подписке Claude или Grok. VoxTap платит только за распознавание и голос — для вас Vox бесплатен.
Каждый раз Vox начинает с чистого листа, поэтому не тратит лимит на старые разговоры. Нужное он помнит через память.
Нажмите кружок >_ ещё раз — Vox остановится. Перед необратимым (отправить, удалить, купить) он спросит.
Подключение
Установите агента и войдите в аккаунт
Нужно один раз: поставить агента и войти в него. Дальше VoxTap сам находит его и запускает в фоне — Терминал держать открытым не нужно.
- 1Установите Claude Code
Откройте Терминал (⌘ Пробел → «Терминал») и вставьте команду установки.
$ curl -fsSL https://claude.ai/install.sh | bash - 2Войдите в аккаунт Claude
Откроется браузер — войдите тем же аккаунтом, где оформлена подписка. В карточке VoxTap для этого есть кнопка «Войти».
$ claude auth login - 3Проверьте
В ответе должно быть
"loggedIn": true. В карточке VoxTap статус станет «Готов».$ claude auth status - 4Включите Vox
Наведите на капсулу VoxTap внизу экрана и нажмите кружок агента. В карточке «Через что будет работать Vox» выберите агента со статусом «Готов» и нажмите «Начать». Сменить агента на ходу — ярлык агента слева от пилюли. Выбор запомнится — в следующий раз Vox включится сразу.
Вывод в Терминале может немного отличаться — это нормально.
Разрешения macOS
Чтобы Vox видел экран и нажимал кнопки
macOS спросит разрешения при первом действии. Их выдают приложению VoxTap — агент работает через него. Если окно не появилось: Системные настройки → Конфиденциальность и безопасность.
Чтобы слышать вас.
Уже выдано, если вы пользуетесь диктовкой.
Чтобы нажимать кнопки, печатать и переключать окна.
Уже выдано, если VoxTap вставляет текст.
Чтобы видеть окно, когда в нём нет подписей: холст, таблицы, картинки.
Нужно только Vox.
Память
Vox помнит — в обычных файлах на вашем Mac
Когда вы выключаете Vox, агент записывает итог разговора и всё устойчивое — кто вы, проекты, люди, договорённости. Заметки связаны ссылками, поэтому папку можно открыть в Obsidian как хранилище и увидеть граф.
- ✓Файлы лежат только на вашем Mac. Их можно читать и править — Vox увидит изменения в следующий раз.
- ✓Пароли, коды и содержимое чужих писем не записываются.
- ✓Выключить память или открыть папку — Настройки → Vox.
Нашли письмо Павла, ответили «согласен».
Связано: [[Павел Иванов]], [[VoxTap]]
Если что-то не так
Частые вопросы
В карточке написано «Не установлен», хотя Claude Code стоит
VoxTap ищет команду claude в обычных местах установки: ~/.local/bin, /opt/homebrew/bin, /usr/local/bin. Если вы ставили иначе, переустановите командой с этой страницы — она кладёт claude в ~/.local/bin.
Статус «Нужен вход»
Нажмите «Войти» в карточке — откроется Терминал с командой входа и браузер. Войдите аккаунтом с подпиской; через пару секунд статус сменится на «Готов». То же самое — команда claude auth login.
Vox отвечает, что закончился лимит
Агент работает на вашей подписке, у неё свои лимиты по времени. Дождитесь, когда лимит обновится, или выберите в Настройках → Vox модель «Быстрее» — она расходует лимит экономнее.
Как остановить Vox посреди задачи
Нажмите кружок >_ в капсуле — Vox остановится и выключится. Перед необратимыми действиями он и так спрашивает разрешения.
Как сменить агента или модель
Пока Vox работает — нажмите ярлык агента слева от пилюли и выберите другого. Или Настройки → Vox → «Показать выбор».
Vox не нажимает кнопки или «не видит» окно
Проверьте разрешения «Универсальный доступ» и «Запись экрана» для VoxTap: Системные настройки → Конфиденциальность и безопасность. После выдачи перезапустите VoxTap.
Сколько это стоит
Vox бесплатен в любом тарифе VoxTap. Агент работает на вашей подписке Claude или Grok — отдельно платить VoxTap не нужно.