liaohch3/claude-tap

Intercept and inspect Coding Agent API traffic from Claude Code, Codex CLI, Gemini CLI, Cursor CLI, OpenCode, Kimi/Kimi Code, Pi, and Hermes in a local trace viewer.

解決的問題

claude-tap 提供了一種檢查 AI 編程代理內部運作機制的方法。它解決了「黑盒」問題，即使用者無法看到由 Claude Code、Codex 或 Gemini CLI 等基於 CLI 的代理發送給 LLM 的確切系統提示詞、工具呼叫與對話歷史。

工作原理

它作為一個本地代理與追蹤查看器。透過 claude-tap 執行 AI 代理 CLI，該工具會攔截代理與 LLM 提供商之間的 API 流量。它可以運行在反向代理模式（將代理的 base URL 重定向到 localhost）或正向代理模式（注入 HTTPS_PROXY 與本地 CA 憑證）。擷取的流量隨後會在即時瀏覽器查看器中展示，或者匯出為可移植的 HTML 檔案用於審查。

適用對象

  • 開發者：使用 AI 編程代理並希望除錯代理行為的開發者。
  • 提示詞工程師：需要確切查看系統提示詞與工具模式是如何建構的工程師。
  • 研究人員：從各種代理 CLI 封存版本化系統提示詞快照的研究人員。

亮點

  • 廣泛的用戶端支援：支援包括 Claude Code、Codex、Gemini CLI、Grok Build、Kimi、Cursor CLI 等在內的多种代理。
  • 深度檢查：擷取系統提示詞、工具定義、工具呼叫、串流回應與 Token 使用情況。
  • 請求差異對比：允許使用者比較相鄰的請求，以精確找出輪次之間提示詞或上下文的具體變化。
  • 注重隱私：追蹤數據儲存在使用者的本地機器上，並且在記錄之前會遮蔽常見的身份驗證標頭。
  • 可移植的產物：對話可以匯出為自包含的 HTML 檔案，以便於分享或封存。