claude-tap
攔截並檢視來自 Claude Code、Codex CLI、Gemini CLI、Cursor CLI、OpenCode、Kimi/Kimi Code、Pi 和 Hermes 的編碼代理 API 流量,於本機追蹤檢視器中。
claude-tap 是什麼?
攔截並檢視來自 Claude Code、Codex CLI、Gemini CLI、Cursor CLI、OpenCode、Kimi/Kimi Code、Pi 和 Hermes 的編碼代理 API 流量,於本機追蹤檢視器中。
claude-tap 概覽
這是什麼
claude-tap 是一個本機代理與追蹤檢視器,專為 AI 編碼代理設計。您可以透過 CLI 執行它,或監聽本機應用程式的轉錄,然後檢查真實的 API 流量與代理上下文:系統提示、對話歷史、工具模式、工具呼叫、串流回應、Token 用量以及請求差異。它支援多種客戶端,包括 Claude Code、Codex CLI、Codex App、Gemini CLI、Grok Build CLI、Kimi CLI、MiMo Code、OpenCode、OpenClaw、Pi、Hermes Agent、Cursor CLI、Qoder CLI、Antigravity CLI 與 CodeBuddy CLI。
主要功能
- 檢視確切上下文:檢查提示、訊息、工具定義、工具呼叫、工具結果、重構的串流回應與 Token 用量。
- 以證據除錯:比較相鄰請求,找出哪些提示、訊息、工具或參數發生變化。
- 分享可攜帶的工件:每次執行會寫入本機追蹤工作階段,可匯出為自含式 HTML 檢視器以供檢閱或歸檔。
- 將追蹤保留在本機:無需託管儀表板,常見的驗證標頭會在記錄前被編輯。
- 跨客戶端使用同一工作流程:使用同一工具追蹤 Claude Code、Codex CLI、Gemini CLI 等多種客戶端。
使用情境
- 透過檢視確切上下文與請求差異來除錯代理行為。
- 比較相鄰請求,了解代理如何在回合之間調整上下文。
- 將追蹤工作階段匯出為可攜帶的 HTML 檔案,便於協作或歸檔。
- 將所有追蹤資料保留在本機以保護隱私,無需上傳至外部儀表板。
快速開始
需要 Python 3.11+。安裝方式: bash uv tool install claude-tap # 或使用 pip pip install claude-tap 快速開始:執行 claude-tap 即可啟動 Claude Code 並啟用即時瀏覽器檢視器。對於其他客戶端,請使用 --tap-client 參數,例如 claude-tap --tap-client codex。詳細用法請參閱儲存庫 README。
授權與價格
授權:MIT。價格:開放原始碼。
內容整理自該專案公開的 README 與儲存庫資訊。