Repolode
liaohch3

liaohch3/claude-tap

Локальный прокси и просмотрщик трассировки, который перехватывает API-трафик AI-агентов для программирования, например Claude Code и Codex CLI, чтобы изучать промпты, вызовы инструментов и расход токенов.

Звёзды
3,293
Форки
284
Открытые issues
40
Последний коммит
вчера

Что это?

claude-tap запускает CLI AI-агента для программирования через локальный прокси или отслеживает локальные транскрипты клиентов, которые нельзя проксировать, и записывает реальный API-трафик. Каждая трассировка показывает системные промпты, историю диалога, схемы инструментов, вызовы инструментов, потоковые ответы, расход токенов и различия между соседними запросами.

Поддерживается широкий набор клиентов, включая Claude Code, Codex CLI, Gemini CLI, Kimi CLI, OpenCode, Pi, Hermes Agent и Cursor CLI; режим — reverse proxy или forward proxy — зависит от клиента. Перед записью распространённые заголовки авторизации очищаются от секретов, а трассировки хранятся локально — размещённая панель управления не нужна.

Просмотрщик представляет собой автономный HTML-файл, который можно экспортировать и передавать для проверки или архивирования. В нём есть структурные различия, поиск, разбивка расхода токенов, просмотр в браузере во время запуска и режим встраивания через iframe.

Ключевые возможности

  • 01Перехватывает потоковые API-запросы и ответы поддерживаемых CLI AI-агентов для программирования.
  • 02Показывает системные промпты, определения инструментов, вызовы инструментов и расход токенов для каждого запроса.
  • 03Сравнивает соседние запросы, выделяя изменения в сообщениях, промптах и параметрах.
  • 04Экспортирует каждый сеанс в виде автономного HTML-просмотрщика или компактного пакета трассировки.
  • 05Удаляет секреты из распространённых заголовков авторизации и хранит все данные трассировки на локальной машине.

Сценарии использования

  • Выяснить, почему поведение AI-агента для программирования изменилось между ходами диалога.
  • Проверить, какие инструменты и системные промпты агент отправляет модели.
  • Сравнить расход токенов и рост контекста в разных сеансах агента.
  • Архивировать трассировку запуска агента или поделиться ею для проверки и воспроизведения.

Быстрый старт

  1. 1

    Установите claude-tap с помощью uv (рекомендуется)

    uv tool install claude-tap
  2. 2

    Запустите Claude Code через claude-tap

    claude-tap
  3. 3

    Или трассируйте Codex CLI

    claude-tap --tap-client codex

Что важно знать

  • Необходимо отдельно установить Python 3.11 или новее и клиент агента, который вы хотите трассировать.
  • Некоторым клиентам, например AWS Bedrock в нативном режиме, требуется дополнительная настройка, например режим прокси-сервера пересылки.

Темы

Частые вопросы

Что такое claude-tap?
Локальный прокси и просмотрщик трассировки, который перехватывает API-трафик AI-агентов для программирования, например Claude Code и Codex CLI, чтобы изучать промпты, вызовы инструментов и расход токенов. claude-tap запускает CLI AI-агента для программирования через локальный прокси или отслеживает локальные транскрипты клиентов, которые нельзя проксировать, и записывает реальный API-трафик. Каждая трассировка показывает системные промпты, историю диалога, схемы инструментов, вызовы инструментов, потоковые ответы, расход токенов и различия между соседними запросами.
claude-tap можно использовать бесплатно? Какая у него лицензия?
claude-tap распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
claude-tap всё ещё поддерживается?
Активно поддерживается. Последний коммит в claude-tap — 19 окт. 2026 г..
Для чего можно использовать claude-tap?
Выяснить, почему поведение AI-агента для программирования изменилось между ходами диалога. Проверить, какие инструменты и системные промпты агент отправляет модели. Сравнить расход токенов и рост контекста в разных сеансах агента. Архивировать трассировку запуска агента или поделиться ею для проверки и воспроизведения.
Как установить claude-tap?
Установите claude-tap с помощью uv (рекомендуется): uv tool install claude-tap Запустите Claude Code через claude-tap: claude-tap Или трассируйте Codex CLI: claude-tap --tap-client codex
Где скачать claude-tap?
Исходный код и инструкции по установке — на GitHub: https://github.com/liaohch3/claude-tap

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Промпт-навык для AI-агентов, который помогает писать только необходимый для задачи код, отдавая предпочтение повторному использованию и минимальным решениям.

167,5 тыс.9,1 тыс.JavaScriptMITОбновлён позавчера