ccglass：看到你的 Coding Agent 到底在发什么
> 来源: https://github.com/jianshuo/ccglass
> 日期: 2026-05-23
> 作者: 王建硕 (Jian Shuo Wang) — 百姓网创始人
一句话版本
ccglass 是一个 npm 一键安装的本地代理工具，能让你亲眼看到 Claude Code / Codex / DeepSeek-TUI / Kimi 每次发到模型的所有内容——包括完整的 system prompt、每轮对话历史、tool schema、token 消耗和费用，还能对比两轮请求之间的差异。
这是什么
用 npm install -g ccglass 装好，再 ccglass 回车，一个交互式菜单让你选要监控哪个 coding agent。选好后它会：
1. 在本机启动一个反向代理 + Web 仪表盘
2. 通过环境变量（ANTHROPIC_BASE_URL / OPENAI_BASE_URL / DEEPSEEK_BASE_URL）把 agent 的 API 请求指向本机代理
3. 在浏览器仪表盘里实时展示每一笔请求的完整内容
相当于给你的 coding agent 装了个"抓包工具"。
为什么需要这个
这其实是痛点驱动的项目：
- Claude Code / Codex 这些 CLI 都是 Node/native 应用，完全忽略系统的
HTTP_PROXY和HTTPS_PROXY - 所以传统抓包工具（Charles、mitmproxy）根本看不到它们的流量
- 有人尝试 patch
fetch，但一更新就失效 - 不需要 CA 证书、不需要 TLS 固定——ccglass 只拦截到 localhost 的明文 HTTP 一跳，agent 自己向 API 做 HTTPS
核心功能
| 功能 | 说明 |
|---|---|
| **实时请求流** | 每笔 API 调用即时显示在仪表盘，点击展开 system prompt、messages、tools，长内容有折叠 toggle |
| **对话流程视图** | 时序图展示 agent 循环：模型选了哪个工具→工具怎么本地执行→结果如何回传，tool_use/tool_result 按 call_id 配对着色 |
| **逐轮差异对比** | 选两个请求对比，精确看到本轮新增了哪些上下文、哪些块触发了 cache breakpoint |
| **Token/缓存/费用** | 从 response usage 提取精确数字、缓存命中率、各供应商定价的 USD 估算 |
| **响应重组+导出** | 用 SSE 流重建完整的最终消息（stop_reason、tool calls、usage），支持导出为 raw/Markdown/JSON/HAR |
| **MCP 自检** | 监控 Claude Code 时，ccglass 把自己的查询工具注册到 agent 的 MCP 中——agent 可以在聊天里直接查询刚发出的请求 |
支持的编码 Agent
| 命令 | 工具 | 格式 |
|---|---|---|
| `ccglass claude` | Claude Code | Anthropic Messages |
| `ccglass codex` | Codex (OpenAI) | OpenAI Responses / Chat |
| `ccglass deepseek` | DeepSeek-TUI dispatcher | OpenAI Chat |
| `ccglass deepseek-tui` | DeepSeek-TUI runtime | OpenAI Chat |
| `ccglass kimi` | Kimi (Moonshot, via Claude Code) | Anthropic Messages |
| `ccglass run --provider -- | 任意客户端 | 根据 provider 自动适配 |
技术细节
- 无运行时依赖：核心代理 + 仪表盘无需任何第三方包；MCP 自检功能（仅 Claude Code）额外依赖
@modelcontextprotocol/sdk+zod - 日志存储：
./.ccglass/，auth token 默认掩盖（/NNNN.json --no-redact关闭） - Issue 自动化：提 issue 后 Claude 自动调查代码并开修复 PR，评论
@claude继续迭代
同类项目对比
| 项目 | 方案 | 优点 | 缺点 |
|---|---|---|---|
| **ccglass** | 环境变量劫持 base URL + 本地反向代理 | 零配置、无 CA 证书、NPM 一键安装 | 只支持已知的 env var 模式 |
| claude-code-inspector (PyPI) | 跨平台代理拦截 | 支持更多客户端（含 Cursor/Gemini-CLI） | Python 生态，需 pip |
| agentgateway.dev | Kubernetes 代理 | 企业级、可做 ACL | 需要 K8s 集群 |
| mitmproxy / Charles | 系统级 HTTPS 中间人 | 通用方案 | 需要 CA 证书，不支持忽略 HTTP_PROXY 的 app |
与我们项目的关联
ccglass 与 OpenClaw 生态高度相关：
1. 环境变量模式一致：OpenClaw 也通过 ANTHROPIC_BASE_URL / OPENAI_BASE_URL 等环境变量切换 provider 和模型
2. 互补关系：lossless-claw 关注上下文的无损压缩管理，ccglass 关注请求内容的完全可见性——一个管你"少发了什么"，一个管你"发了什么"
3. 调试利器：使用 OpenClaw + 各种 coding agent 时，ccglass 可以直接"插在中间"看到实际发给模型的内容，对 prompt 调试、token 优化、成本分析极有价值
4. MCP 自检机制：ccglass 的"agent 检查自己刚刚发出的请求"思路，在 agent 可观测性领域有参考意义
评分
| 维度 | 评分 | 说明 |
|---|---|---|
| **实用性** | ⭐⭐⭐⭐⭐ | 抓包 coding agent 是刚需，解决了现有工具解决不了的问题 |
| **易用性** | ⭐⭐⭐⭐⭐ | npm install + 一个命令，和 ollama 一样简单 |
| **创新性** | ⭐⭐⭐⭐ | 思路简单但巧妙——不劫持 HTTPS 只劫持 env var 一跳 |
| **生态兼容** | ⭐⭐⭐⭐⭐ | 覆盖主流 coding agent，MIT 开源，无 runtime 依赖 |
| **成熟度** | ⭐⭐⭐ | 98 stars，早期项目，功能框架已完整但社区还小 |
综合评分：8.8/10
一句话总结
> 给你的 coding agent 装个"抓包工具"——ccglass 让 Claude Code / Codex / DeepSeek / Kimi 的每笔 API 请求完全透明，npm install -g ccglass 一行搞定。