liaohch3/claude-tap

これは何？

主な機能

• 01対応するコーディングエージェントのCLIから、ストリーミングAPIのリクエストとレスポンスを記録する。
• 02リクエストごとに、システムプロンプト、ツール定義、ツール呼び出し、トークン使用量を表示する。
• 03連続するリクエストを比較し、メッセージ、プロンプト、パラメーターの変更点を示す。
• 04各セッションを、単体で動作するHTMLビューアまたはコンパクトなトレースバンドルとしてエクスポートする。
• 05一般的な認証ヘッダーをマスキングし、すべてのトレースデータをローカルマシンに保存する。

ユースケース

• ターン間でコーディングエージェントの挙動が変わった理由を調査する。
• エージェントがモデルに送信するツールやシステムプロンプトを監査する。
• エージェントのセッション間で、トークン使用量やコンテキストの増加を比較する。
• レビュー用に、エージェントの実行を再現できるトレースをアーカイブまたは共有する。

クイックスタート

1. 1

   uv で claude-tap をインストール（推奨）

   uv tool install claude-tap
2. 2

   claude-tap 経由で Claude Code を実行

   claude-tap
3. 3

   または Codex CLI をトレース

   claude-tap --tap-client codex

使う前に知っておきたいこと

• !Python 3.11 以降と、トレース対象のエージェントクライアントを別途インストールする必要があります。
• !AWS のネイティブ Bedrock など、一部のクライアントではフォワードプロキシモードなどの追加設定が必要です。

トピック

よくある質問

claude-tap とは？

Claude CodeやCodex CLIなどのAIコーディングエージェントのAPI通信を記録し、プロンプト、ツール呼び出し、トークン使用量を確認できるローカルプロキシ兼トレースビューア。 claude-tapは、AIコーディングエージェントのCLIをローカルプロキシ経由で実行するか、プロキシを通せないクライアントではローカルのトランスクリプトを監視して、実際のAPI通信を記録します。各トレースでは、システムプロンプト、会話履歴、ツールスキーマ、ツール呼び出し、ストリーミング応答、トークン使用量に加え、連続するリクエスト間の差分を確認できます。

claude-tap は無料で使えますか？ライセンスは？

claude-tap は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

claude-tap は今もメンテナンスされていますか？

活発にメンテナンス中。claude-tap の最終コミットは 2026年10月19日 です。

claude-tap は何に使えますか？

ターン間でコーディングエージェントの挙動が変わった理由を調査する。 エージェントがモデルに送信するツールやシステムプロンプトを監査する。 エージェントのセッション間で、トークン使用量やコンテキストの増加を比較する。 レビュー用に、エージェントの実行を再現できるトレースをアーカイブまたは共有する。

claude-tap のインストール方法は？

uv で claude-tap をインストール（推奨）: uv tool install claude-tap claude-tap 経由で Claude Code を実行: claude-tap または Codex CLI をトレース: claude-tap --tap-client codex

claude-tap はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/liaohch3/claude-tap