Подключение агента

Настройте Codex, Cursor, Claude Code, Gemini CLI или Hermes для Telegram и MAX.

Установщик Windows уже ставит навык до входа. Прочитайте tg skill show или max skill show и проверьте, что агент загрузил навык. Команды ниже обновляют навык или устанавливают его отдельно после другого способа установки.

CLI — установленная программа для терминала (tg или max). Агент — ваш ИИ-помощник, например в редакторе или терминале. Skill, или навык, — файл инструкции, который агент читает, чтобы пользоваться CLI; сам навык не хранит вход в Telegram/MAX. PATH — список папок, в которых компьютер ищет команды: если tg --version или max --version работает в терминале агента, он видит установленный CLI.

Сначала установите CLI и войдите. Локальный агент вызывает tg или max в терминале. Skill учит его командам, форматам ответов и сценариям работы; установка CLI и вход всё равно нужны. MCP — другой способ дать агенту инструменты.

Выберите агента

Выполните команду своего мессенджера. Если используете оба — выполните обе.

АгентTelegramMAXГде лежит skill
Codextg skill install --for agentsmax skill install --for agents~/.agents/skills/<tool>-cli/SKILL.md
Cursor Agenttg skill install --for agentsmax skill install --for agents~/.agents/skills/<tool>-cli/SKILL.md
Claude Codetg skill install --for claudemax skill install --for claude~/.claude/skills/<tool>-cli/SKILL.md
Gemini CLItg skill install --for agentsmax skill install --for agents~/.agents/skills/<tool>-cli/SKILL.md
HermesСохраните tg skill show, как описано нижеСохраните max skill show, как описано ниже~/.hermes/skills/<tool>-cli/SKILL.md

<tool>-cli — это tg-cli или max-cli. ~ означает домашний каталог, в том числе на Windows. Без --for команда skill install устанавливает сразу в .claude/skills и .agents/skills.

Codex

Используйте локальный Codex в CLI или IDE. Он находит пользовательские skills в ~/.agents/skills. Выберите $tg-cli или $max-cli в разговоре; если новый skill не появился, перезапустите Codex. Команда CLI должна быть на PATH агента. Официальная инструкция Codex.

Cursor

Используйте режим Agent с доступом к терминалу. Cursor читает общий каталог ~/.agents/skills. Найдите tg-cli или max-cli через / в чате Agent. Если новый skill не появился, перезапустите Cursor. Также можно подключить MCP. Официальная инструкция Cursor.

Claude Code

В локальной сессии Claude Code вызовите /tg-cli или /max-cli. Пользовательские skills лежат в ~/.claude/skills. При работающем терминале MCP необязателен. Официальная инструкция Claude Code.

Gemini CLI

Проверьте наличие tg-cli или max-cli через gemini skills list. В запущенной сессии обновите список через /skills reload. Gemini поддерживает общий каталог ~/.agents/skills. Официальная инструкция Gemini.

Hermes

У Hermes свой каталог skills. Попросите его создать ~/.hermes/skills/tg-cli/SKILL.md из точного вывода tg skill show, либо ~/.hermes/skills/max-cli/SKILL.md из max skill show. Сохраните frontmatter и текст в UTF-8. Для Telegram на macOS или Linux:

mkdir -p ~/.hermes/skills/tg-cli
tg skill show > ~/.hermes/skills/tg-cli/SKILL.md

Для MAX используйте max-cli в пути и max skill show. Начните новую сессию Hermes и вызовите /tg-cli или /max-cli. В его окружении должны быть CLI и та же сессия аккаунта. Официальная инструкция Hermes.

Проверьте подключение

Попросите агента: «Используй tg-cli / max-cli: проверь мой аккаунт и покажи пять чатов. Затем разбери непрочитанные сообщения по чатам и скажи, кому нужно ответить. В этой задаче только читай».

Агент должен выполнить account show, chats list --limit 5 и inbox --limit 5 или аналогичные MCP-инструменты. Если команда не находится, переоткройте редактор после установки Node/npm; см. Windows и PATH. При отсутствии сессии войдите в том же окружении и профиле, которые использует агент.

CLI уже предлагает skill

При установленной AI_AGENT или CLAUDECODE оба CLI предлагают skill install, если копия skill отсутствует или старее CLI. Подсказка появляется на stderr, максимум раз в сутки; JSON на stdout остаётся пригодным для обработки. После обновления CLI повторите команду установки выше. Для Hermes обновите файл из skill show.

Другие клиенты

Для Claude Desktop используйте MCP. Агенту без поддержки skills дайте Markdown-документацию. Для облачного агента установите CLI и войдите в его окружении выполнения: локальная сессия туда автоматически не переносится.

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

На этой странице