aspy
Claude Code 与 Anthropic API 之间的流量观测代理
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:aspy。 它的用途是:Claude Code 与 Anthropic API 之间的流量观测代理 完整的 Skill 内容见:https://321skill.com/skills/aspy/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我分析一下刚才那个复杂数据处理的思考过程用了多少Token?” 通过集成好的 MCP 功能,Claude 可以调用 aspy_stats 工具,直接返回当前会话的详细 Token 使用情况和成本估算。或者,在终端运行 TUI 代理,你可以实时看到每个工具调用、思考块的流式输出和累计费用,就像给 Claude Code 装上了“仪表盘”。
介绍
Aspy 是一个专为 Claude Code 设计的可观测性代理工具,它解决了开发者在与 Claude 交互时无法直观了解底层 API 调用、工具使用、思考过程和成本消耗的痛点。
使用方式非常灵活:你可以将其作为独立的 TUI(终端用户界面)代理运行,实时监控所有流量;或者通过 MCP(模型上下文协议)服务器集成到 Claude Code 中,让 Claude 也能查询会话历史和统计数据;还可以安装 Claude Code 插件,通过简单的斜杠命令快速获取信息。
这个工具特别适合深度使用 Claude Code 进行开发的工程师、希望优化 AI 使用成本的项目管理者,以及对 AI 内部工作机制充满好奇的研究者。它能让你清晰地看到 Claude 的“思考”过程、每一次工具调用的细节,以及累积的 Token 消耗和费用。
建议初次使用者从 TUI 代理模式开始,它能提供最直观的实时数据流。请注意,MCP 服务器和插件功能需要 TUI 代理在后台运行以收集数据。此外,Aspy 主要服务于 Claude Code 与官方 Anthropic API 的交互,对于其他 AI 客户端或 API 的兼容性可能有限。
核心特点
与同类代理或监控工具相比,Aspy 深度集成 Claude Code 生态,不仅能作为被动流量嗅探器,还能通过 MCP 协议让 Claude 主动查询自身的历史会话、思考块和统计数据,实现了观测与交互的双向闭环。
注意事项
主要针对 Claude Code 与 Anthropic API 的交互进行观测,不适用于其他 AI 客户端或非官方的 API 端点。
常见问题
Aspy 会影响 Claude Code 的正常使用速度吗?
作为本地代理,Aspy 会引入极小的网络延迟,但通常不影响使用体验,并能提供宝贵的观测数据。
使用 Aspy 需要 Anthropic API 密钥吗?
需要。Aspy 是代理工具,Claude Code 仍需配置有效的 Anthropic API 密钥才能通过它访问服务。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/aspy/raw/index.md 读取 aspy 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/aspy/raw/index.md(查看排版版本)