claude-tap Agent工作流
经 AI Skill Hub 精选评估，claude-tap Agent工作流 获评「强烈推荐」。这款AI工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 8.2 分，适合有一定技术背景的用户使用。
📚 深度解析
**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。
**安装与环境准备**
claude-tap Agent工作流 依赖 Python 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 Python 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。
**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 claude-tap Agent工作流 的版本更新，及时通知重要功能变化。
📋 工具概览
claude-tap Agent工作流 是一款基于 Python 开发的开源工具，专注于 Agent调试、API观察、流量拦截 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
📖 中文文档
claude-tap Agent工作流 是一款基于 Python 开发的开源工具，专注于 Agent调试、API观察、流量拦截 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
# 方式一：pip 安装（推荐）
pip install claude-tap
# 方式二：虚拟环境安装（推荐生产环境）
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install claude-tap
# 方式三：从源码安装（获取最新功能）
git clone https://github.com/liaohch3/claude-tap
cd claude-tap
pip install -e .
# 验证安装
python -c "import claude_tap; print('安装成功')"
- 访问 GitHub 仓库页面
- 按照 README 文档完成依赖安装
- 根据系统环境完成初始化配置
- 参考官方示例或文档开始使用
- 遇到问题可在 GitHub Issues 中查找解答
# 命令行使用
claude-tap --help
# 基本用法
claude-tap input_file -o output_file
# Python 代码中调用
import claude_tap
# 示例
result = claude_tap.process("input")
print(result)
# claude-tap 配置文件示例（config.yml） app: name: "claude-tap" debug: false log_level: "INFO" # 运行时指定配置文件 claude-tap --config config.yml # 或通过环境变量配置 export CLAUDE_TAP_API_KEY="your-key" export CLAUDE_TAP_OUTPUT_DIR="./output"
claude-tap
claude-tap is a local proxy and trace viewer for AI coding agents. Run your CLI through it, then inspect the real API traffic: system prompts, conversation history, tool schemas, tool calls, streaming responses, token usage, and request diffs.
It works with Claude Code, Codex CLI, Gemini CLI, Kimi CLI, OpenCode, Pi, Hermes Agent, Cursor CLI, Qoder CLI, and Antigravity CLI.
<p align="center"> <img src="docs/demo.gif" alt="claude-tap demo showing a real Codex trace" width="100%"> <br> <sub>Open a real agent run, inspect every request, and compare how context changes between turns.</sub> </p>
Light viewer overview |
Dark mode for long review sessions |
Structured diff across adjacent requests |
Viewer Features
Trace viewer capabilities
The viewer is a single self-contained HTML file (zero external dependencies):
- Structural diff — compare consecutive requests to see exactly what changed: new/removed messages, system prompt diffs, character-level inline highlighting
- Path filtering — filter by API endpoint (e.g.,
/v1/messagesonly) - Model grouping — sidebar groups requests by model, with Claude-family priority ordering
- Token usage breakdown — input / output / cache read / cache creation
- Tool inspector — expandable cards with tool name, description, and parameter schema
- Search — full-text search across messages, tools, prompts, and responses
- Dark mode — toggle light/dark themes (respects system preference)
- Keyboard navigation —
j/kor arrow keys - Copy helpers — one-click copy of request JSON or cURL command
- i18n — English, 简体中文, 日本語, 한국어, Français, العربية, Deutsch, Русский
Requires a messaging platform configured in ~/.hermes/.env.
Install
Requires Python 3.11+ and the client you want to trace.
```bash
Start only the proxy for custom setups
claude-tap --tap-no-launch --tap-port 8080
Quick Start
Run the client you want to inspect through claude-tap. Flags after -- are passed to the selected client.
```bash
Guides and Integrations
- OpenClaw setup guide for integrating
claude-tapwith OpenClaw. Simplified Chinese version: OpenClaw 设置指南. - Claude Code with DeepSeek API for routing Claude Code through DeepSeek's Anthropic-compatible API. Simplified Chinese version: Claude Code 搭配 DeepSeek API.
- Client support matrix for exact environment variables, proxy modes, and URL rewrite rules.
<details> <summary>Qoder CLI examples</summary>
Qoder CLI talks to multiple Qoder endpoints, so claude-tap defaults to forward proxy mode for --tap-client qoder.
```bash
Reverse mode is opt-in and only useful when ~/.hermes is configured with an
Browser login, PAT, or job token must be configured before launch.
qodercli login
claude-tap --tap-client qoder -- -p "hello" --permission-mode dont_ask
</details>
<details>
<summary>Antigravity CLI examples</summary>
Antigravity CLI talks to multiple Google/Antigravity endpoints, so claude-tap defaults to **forward proxy** mode for `--tap-client agy`. Its Code Assist model API also honors `CLOUD_CODE_URL`; claude-tap injects that automatically so model requests such as `/v1internal:streamGenerateContent` are captured by the same local proxy.
On macOS, Antigravity may not honor per-process CA environment variables. claude-tap automatically trusts the local CA in your current user's login keychain on first `agy` launch. This does not use `sudo` or the System keychain, though macOS may prompt to unlock the login keychain.
Optional: trust the CA separately before launching a forward-proxy client.
claude-tap trust-ca
</details>
<details>
<summary>Viewer, export, and advanced options</summary>
CLI Options
All flags are forwarded to the selected client, except these --tap-* ones:
--tap-client CLIENT Client to launch: claude (default), agy, codex, gemini, kimi, opencode, pi, hermes, cursor, or qoder
--tap-target URL Upstream API URL (default: auto per client)
--tap-live Start real-time viewer while the client runs (default: on)
--tap-no-live Disable the real-time viewer server (pre-v0.1.75 behavior)
--tap-live-port PORT Port for live viewer server (default: auto)
--tap-no-open Don't auto-open live or generated HTML viewers in a browser
--tap-output-dir DIR Trace output directory (default: ./.traces)
--tap-port PORT Proxy port (default: auto)
--tap-host HOST Bind address (default: 127.0.0.1, or 0.0.0.0 in --tap-no-launch mode)
--tap-no-launch Only start the proxy, don't launch client
--tap-max-traces N Max trace sessions to keep (default: 50, 0 = unlimited)
--tap-no-update-check Disable PyPI update check on startup
--tap-no-auto-update Check for updates but don't auto-download
--tap-proxy-mode MODE Proxy mode: reverse or forward (default: reverse for claude/codex/kimi, forward for agy/gemini/opencode/pi/hermes/cursor/qoder)
--tap-trust-ca On macOS, explicitly trust the local CA in the user login keychain before launch (agy does this automatically)</details>
API Key users — default OpenAI API target works out of the box
claude-tap --tap-client codex
Reverse mode for compatible API-key / Vertex flows
claude-tap --tap-client gemini --tap-proxy-mode reverse -- -p "hello"
</details>
<details>
<summary>OpenCode examples</summary>
[OpenCode](https://opencode.ai) is a multi-provider terminal AI assistant. Because it can talk to many providers, claude-tap defaults to **forward proxy** mode for opencode: it injects `HTTPS_PROXY` plus the local CA into the child process so traffic to any provider is captured.
claude-tap 是一个专为开发者设计的交互式追踪工具，旨在通过可视化界面实时监控和分析 AI 客户端的通信过程。它能够帮助开发者深入理解模型请求与响应的细节，是调试 AI 工作流、优化 Prompt 以及分析 API 调用行为的利器。
内置强大的 Trace viewer 功能，通过单个自包含的 HTML 文件实现零依赖可视化。支持 Structural diff 功能，能够精确对比连续请求之间的差异（如新增/删除的消息、System Prompt 的变化），并提供字符级的行内高亮显示。此外，还支持按 API endpoint 进行路径过滤，并能根据 Model 进行分组管理，方便开发者快速定位特定模型的交互记录。
在使用前，请确保您的系统中已配置好 messaging platform，相关配置需存储在 ~/.hermes/.env 文件中。
项目要求 Python 版本为 3.11 及以上。您可以通过 pip 进行安装，并配合需要进行追踪的客户端使用。如果需要针对自定义环境进行设置，可以使用 `claude-tap --tap-no-launch --tap-port 8080` 仅启动代理服务，而不自动启动客户端。
快速上手非常简单：只需通过 `claude-tap` 启动您想要检查的客户端即可。需要注意的是，在命令中使用 `--` 后跟随的所有参数都会被透传给所选的客户端。此外，我们提供了针对 OpenClaw 和 Claude Code 搭配 DeepSeek API 等多种集成场景的详细指南，帮助您快速完成环境搭建。
默认情况下，系统通过环境变量进行配置。对于特定的 Reverse mode（反向代理模式），仅在 ~/.hermes 配置生效时才建议开启。在使用浏览器登录、PAT 或 Job Token 时，请务必在启动前完成相关配置。对于 Antigravity CLI 等涉及多个端点的工具，claude-tap 会默认切换为 forward proxy 模式以确保通信正常。
对于使用 API Key 的用户，默认的 OpenAI API 目标已开箱即用。针对兼容 API-key 或 Vertex AI 的工作流，可以通过 `--tap-proxy-mode reverse` 参数开启反向代理模式。此外，针对 OpenCode 等多供应商终端 AI 助手，claude-tap 也会自动适配为 forward proxy 模式以实现无缝接入。
专业的Agent调试工具，架构设计合理，Star数稳定增长。填补AI Agent可观测性空白，对Agent开发者有实用价值。
- 构建多智能体协作系统的 Agent 开发者
- 跨境业务、多语言内容运营团队
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- Python 依赖冲突：建议用 venv / uv 隔离环境
- CLI：直接 npm install -g / pip install，命令行调用
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 构建多智能体协作系统的 Agent 开发者
- 跨境业务、多语言内容运营团队
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- Python 依赖冲突：建议用 venv / uv 隔离环境
👥 适合人群
🎯 使用场景
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
⚖️ 优点与不足
- +MIT 协议，可免费商用
- +完全开源免费，无授权费用
- +本地部署，数据完全自主可控
- +开发者社区支持，遇问题可查可问
- −安装和初始配置可能需要一定技术基础
- −功能完整性通常不如成熟商业产品
- −技术支持主要依赖开源社区，响应速度不稳定
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。
🔗 相关工具推荐
❓ 常见问题 FAQ
AI Skill Hub 点评：claude-tap Agent工作流 的核心功能完整，质量优秀。对于AI爱好者来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | claude-tap |
| 原始描述 | 开源AI工作流：Intercept and inspect Coding Agent API traffic from Claude Code, Codex CLI, Gemi。⭐475 · Python |
| Topics | Agent调试API观察流量拦截工作流编码Agent |
| GitHub | https://github.com/liaohch3/claude-tap |
| License | MIT |
| 语言 | Python |
收录时间：2026-05-17 · 更新时间：2026-05-19 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。