client-tools — субагент для Claude Code: что делает и как установить
Субагент client-tools помогает настроить клиентские и вебхук-инструменты для голосовых ИИ-агентов, связывая их с внешними API и скриптами в браузере.
AGPL-3.0 ★ 78 316 обновлён 2026-10-24
.claude/agents/client-tools.mdЧто делает client-tools
Субагент помогает описывать функции в конфигурации голосового агента, позволяя модели запускать внешние действия. Инструменты делятся на серверные вебхуки, системные вызовы и клиентские скрипты для браузера. Настройки помещаются в секцию conversation_config.agent.prompt, где вебхуки и клиентские обработчики попадают в список tools, а встроенные функции — в built_in_tools.
В вебхуках настраиваются схема запроса, заголовки авторизации и таймаут от 5 до 120 секунд. Метод по умолчанию — GET. Если нужно передавать тело запроса с параметрами, метод POST необходимо указывать явно. Схема поддерживает переменные окружения рабочей области и аутентификацию через OAuth2 или токены Bearer.
Серверный обработчик на Node.js или Python принимает вызов с идентификатором беседы и параметрами, возвращая агенту строковый или структурированный JSON-ответ.
Какие задачи решает
- описать схему вебхука с заголовками авторизации и таймаутом
- передать контекст разговора через переменную
{{system__conversation_history}} - связать голосового ассистента с клиентскими действиями в браузере
- написать серверный обработчик вызовов на Node.js или Python
Примеры запросов агенту
- Создай конфигурацию вебхука
get_weatherс методомPOSTи авторизацией по токену - Добавь клиентский инструмент для обновления интерфейса страницы в
conversation_config - Напиши серверный обработчик на FastAPI для приёма вызова
lookup_order
Как установить client-tools
Вручную: положить файлы
.claude/agents/client-tools.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/client-tools.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/client-tools.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о client-tools
Как установить client-tools в Claude Code?
Создайте файл конфигурации субагента по пути .claude/agents/client-tools.md внутри вашего проекта.
Что делает client-tools?
Помогает проектировать инструменты для голосовых агентов ElevenLabs: вебхуки к серверным API, вызовы системных функций и действия в браузере пользователя.
Какой HTTP-метод используется для вебхуков по умолчанию?
По умолчанию платформа использует метод GET. Если серверу требуется тело запроса с параметрами, задайте "method": "POST" вручную.