liaohch3/claude-tap

解決する課題

claude-tap は、AIコーディングエージェントの内部動作を検査する方法を提供します。Claude Code、Codex、Gemini CLI などの CLI ベースのエージェントが LLM に送信している正確なシステムプロンプト、ツール呼び出し、会話履歴が見えないという「ブラックボックス」問題を解決します。

仕組み

ローカルプロキシおよびトレースビューアとして機能します。AIエージェントの CLI を claude-tap 経由で実行することで、エージェントと LLM プロバイダー間の API トラフィックをインターセプトします。リバースプロキシモード（エージェントのベース URL を localhost にリダイレクト）またはフォワードプロキシモード（HTTPS_PROXY とローカル CA 証明書を注入）で動作可能です。キャプチャされたトラフィックは、ライブのブラウザベースのビューアで表示されるか、レビュー用にポータブルな HTML ファイルとしてエクスポートされます。

対象ユーザー

• 開発者: エージェントの動作をデバッグしたい AI コーディングエージェントの利用者。
• プロンプトエンジニア: システムプロンプトやツールスキーマがどのように構築されているかを正確に確認する必要がある方。
• 研究者: さまざまなエージェント CLI からバージョン管理されたシステムプロンプトのスナップショットをアーカイブする方。

ハイライト

• 幅広いクライアントサポート: Claude Code、Codex、Gemini CLI、Grok Build、Kimi、Cursor CLI など、幅広いエージェントに対応しています。
• 詳細な検査: システムプロンプト、ツール定義、ツール呼び出し、ストリーミングレスポンス、トークン使用量を取得します。
• リクエストの差分比較: 隣接するリクエストを比較して、ターン間のプロンプトやコンテキストで何が変化したかを正確に特定できます。
• プライバシー重視: トレースはユーザーのローカルマシンに保存され、記録前に一般的な認証ヘッダーが削除されます。
• ポータブルな成果物: セッションは、共有やアーカイブが容易な自己完結型の HTML ファイルとしてエクスポートできます。