liaohch3/claude-tap

解決的問題

claude-tap 是一個本地代理與追蹤檢視器，旨在讓 AI 編碼代理的內部運作變得透明。它允許開發者檢視實際發送至與來自 LLM 的 API 流量與上下文，這些內容通常被代理的 CLI 或應用程式介面所隱藏。

工作原理

此工具作為 AI 代理（客戶端）與 LLM 提供商 API 之間的代理。它可在兩種主要模式下運作：

• 反向代理模式：將代理的 API 基礎 URL 重導向至本地代理，捕獲流量後再轉發至目標 API。
• 正向代理模式：向子流程注入 HTTPS_PROXY 與本地 CA 憑證，捕獲代理與任何提供者通訊的流量。

捕獲的資料以本地追蹤會話的形式儲存，可透過即時瀏覽器檢視器檢視，或匯出為自包含的 HTML 檔案，用於歸檔與分享。

適用對象

使用 AI 編碼代理（如 Claude Code、Codex、Gemini CLI、Cursor 等）並希望調試代理行為、分析系統提示或審計 Token 使用量與工具呼叫的開發者與 AI 研究人員。

主要亮點

• 深度上下文檢視：可檢視系統提示、對話歷史、工具模式、工具呼叫以及重構的串流回應。
• 詳細調試：可比較相鄰請求，精確識別各回合中提示或參數的變更。
• 廣泛客戶端支援：支援多種代理，包括 Claude Code、Codex、Gemini、Grok、Kimi、Cursor 等。
• 本地優先隱私保護：追蹤資料保留在本地機器上，敏感的認證標頭在記錄前會被隱藏。
• 可攜式成果物：可將追蹤會話匯出為獨立的 HTML 檢視器，用於檢閱或分享。