liaohch3/claude-tap

何を解決するか

claude-tap は、AI コーディングエージェントの内部動作を透明化するためのローカルプロキシおよびトレースビューアです。開発者がLLMに送信・受信される実際のAPIトラフィックやコンテキストを確認できるようにし、エージェントのCLIやアプリケーションインターフェースによってしばしば隠蔽される情報を可視化します。

動作方法

このツールはAIエージェント（クライアント）とLLMプロバイダーのAPIの間にプロキシとして機能します。主に2つのモードで動作します：

• リバースプロキシモード：エージェントのAPIベースURLをローカルプロキシにリダイレクトし、トラフィックをキャプチャした後、ターゲットAPIに転送します。
• フォワードプロキシモード：子プロセスに HTTPS_PROXY とローカルCA証明書を挿入し、エージェントが通信するあらゆるプロバイダーのトラフィックをキャプチャします。

キャプチャされたデータはローカルのトレースセッションとして保存され、ライブブラウザベースのビューアで閲覧可能または自己完結型のHTMLファイルとしてエクスポートしてアーカイブ・共有が可能です。

対象ユーザー

Claude Code、Codex、Gemini CLI、Cursorなど、AIコーディングエージェントを使用し、エージェントの挙動をデバッグ、システムプロンプトを分析、トークン使用量やツール呼び出しを監査したい開発者やAI研究者。

特徴

• 詳細なコンテキストの確認：システムプロンプト、会話履歴、ツールスキーマ、ツール呼び出し、再構成されたストリーミング応答を表示可能。
• 詳細なデバッグ：隣接するリクエストを比較し、ターン間でプロンプトやパラメータに何が変更されたかを正確に特定可能。
• 広範なクライアント対応：Claude Code、Codex、Gemini、Grok、Kimi、Cursorなど、多数のエージェントと互換性あり。
• ローカル最優先のプライバシー：トレースはローカルマシン上に保持され、機密性の高い認証ヘッダーは記録前に非表示処理される。
• ポータブルなアーティファクト：トレースセッションをスタンドアロンのHTMLビューアとしてエクスポートし、レビューまたは共有可能。