jianshuo/ccglass

解决的问题

许多 AI 编码代理（如 Claude Code 或 Codex）使用原生应用程序或 Node.js 环境，这些环境通常会忽略系统代理设置。这使得在不使用复杂 CA 证书或通过修补程序破坏应用程序的情况下，几乎无法检查发送给 LLM 提供商的实际流量（例如系统提示词、工具架构与完整的消息历史记录）。

运作原理

ccglass 作为一个轻量级的本地反向代理与网页仪表板。它通过将客户端的基础 URL 环境变量（例如 ANTHROPIC_BASE_URL 或 OPENAI_BASE_URL）重定向至 localhost，来拦截编码代理与 AI API 之间的纯 HTTP 传输。对于硬编码 URL 的工具，它提供了一种带有 TLS MITM 的转发代理模式，以解密并记录目标流量。所有捕获的请求都以内容寻址格式存储以节省空间，并可通过网页界面实时查看。

适用对象

使用 AI 编码代理或 IDE 扩展功能（如 Cursor、Cline 或 Continue）的开发者，他们希望调试代理的行为、审核发送的确切提示词，或追踪 Token 使用量与成本。

特色亮点

• 实时请求流：实时查看完整的系统提示词、工具调用与消息历史记录。
• 代理循环可视化：显示模型工具选择与本地执行结果之间流程的时序图。
• 回合间差异比较：比较两个请求，精确查看回合之间新增或变更了哪些上下文。
• 成本与 Token 追踪：实时计算输入/输出/缓存 Token 以及每次请求的预估美元成本。
• 广泛兼容性：支持多种提供商，包括 Claude Code、DeepSeek-TUI、Ollama、OpenRouter 以及各种 IDE 扩展功能。
• 自我检查 (MCP)：当与 Claude Code 一起使用时，代理可以使用 MCP 工具在聊天中检查其自身的代理请求。