claude-tap CLI
Локальный прокси и просмотрщик трафика для кодинг-агентов: показывает системные промпты, вызовы инструментов и расход токенов Claude Code, Codex и других CLI
- 3 336 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Перехватывает сетевой трафик кодинг-агента через локальный прокси
- Часть режимов требует доверять локальному CA-сертификату
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/claude-tapОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Перехватывает сетевой трафик кодинг-агента через локальный прокси
- Часть режимов требует доверять локальному CA-сертификату
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
claude-tap запускается перед кодинг-агентом и перехватывает его сетевой трафик локально, не отправляя данные никуда за пределы машины. В просмотрщике видно системный промпт, историю сообщений, схемы и вызовы инструментов, потоковые ответы и расход токенов по каждому запросу. Можно сравнить два соседних запроса и увидеть построчный дифф того, что изменилось в контексте между шагами агента. Каждый сеанс сохраняется как самостоятельный HTML-файл, который можно переслать коллеге без запуска claude-tap заново.
Для кого. Для разработчиков, которые отлаживают поведение кодинг-агентов и хотят видеть реальный запрос к модели, а не догадываться о нем.
Подходит, если
- Нужно понять, почему агент повел себя неожиданно, и посмотреть его реальный контекст
- Нужно сравнить, что изменилось в промпте между двумя запросами подряд
- Нужно посчитать расход токенов по конкретной сессии
- Работаете через нестандартный шлюз вроде DeepSeek или AWS Bedrock и хотите проверить, что именно уходит наружу
Не подходит, если
- Нужен только готовый лог использования, а не полная трассировка запросов
- Работаете с клиентом, для которого claude-tap не поддерживает перехват (проверьте список поддерживаемых)
Пример запроса к агенту
Запусти Claude Code через claude-tap и покажи, что изменилось в системном промпте между последними двумя запросамиОграничения
Требует Python 3.11 и установленного клиента, который нужно трассировать. Для части клиентов (Gemini CLI, OpenCode, Pi, Hermes Agent) используется режим forward-прокси, который перехватывает весь трафик процесса, а не только запросы к модели. На macOS для некоторых клиентов нужно доверять локальному CA-сертификату в связке ключей пользователя.
Как отключить. Просто запускайте агента напрямую вместо claude-tap; удалить пакет можно командой uv tool uninstall claude-tap или pip uninstall claude-tap.
Частые вопросы
Данные уходят на сторонний сервер?
Нет, просмотрщик работает локально, трассы хранятся на диске, а типовые заголовки авторизации маскируются перед записью.
С какими агентами это работает?
С Claude Code, Codex CLI и App, Gemini CLI, Grok Build CLI, Kimi CLI, OpenCode, Pi, Hermes Agent, Cursor CLI, Qoder CLI, Antigravity CLI, CodeBuddy CLI и рядом других, полный список в README.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыФорк Harbor для оценки кодовых агентов в песочницах: Claude Code, Codex и другие запускаются в задачах без интернета.
Локальный разбор прогонов вашего ИИ-агента: проверки, трассы и повтор вызовов, а Claude Code и Codex получают 23 MCP-инструмента.
Скилл учит Claude Code и Cursor подключать трассировку Tracely и превращать провальные запуски агента в тесты для CI
MCP-сервер tapflow: агент управляет iOS-симуляторами и Android-эмуляторами на вашем Mac и воспроизводит сценарии для CI
CLI для замера производительности: агент сравнивает ветки, ищет медленные места и подтверждает ускорение числами, а не на глаз.
agentevals оценивает поведение ИИ-агента по его OpenTelemetry-трассам и отдает MCP-инструменты и навыки /eval и /inspect.
Коротко о README
README описывает claude-tap как локальный прокси и просмотрщик трассировки для кодинг-агентов, устанавливаемый через PyPI. Поддерживает более десятка клиентов через режимы reverse- и forward-прокси, а для Cursor работает по транскриптам без перехвата трафика. Просмотрщик собран в один самодостаточный HTML-файл со структурным диффом, поиском, разбивкой расхода токенов, темной темой и поддержкой нескольких языков интерфейса. Есть отдельные гайды по работе с DeepSeek API и AWS Bedrock через Claude Code. Лицензия MIT.