更新记录2026-06-10 v3.0.4 发布增加新的命令opencode-trace支持 Anthropic 与 OpenAI 格式使用方式与claude-trace基本一致具体说明参看 https://github.com/hanqunfeng/claude-trace/claude-trace v2.0.4English | 简体中文记录你与 Claude Code 的所有交互。以直观的 Web 界面查看 Claude 隐藏的内容系统提示词、工具输出和原始 API 数据。mariozechner/claude-trace 的分支版本完整支持 Claude Code V2通过反向代理支持原生二进制。Claude Code V2 支持Claude Code V2 以原生二进制形式分发macOS 为 Mach-OLinux 为 ELFWindows 为 PE不再是 Node.js 脚本。原有的拦截方式node --require interceptor claude已无法使用。本分支会自动检测二进制类型并选择对应的拦截策略Claude Code 版本二进制类型拦截模式V1.xNode.js 脚本通过--require注入interceptor-loader.jsV2原生二进制本地反向代理重定向ANTHROPIC_BASE_URL针对原生二进制claude-trace 会在127.0.0.1启动本地 HTTP 反向代理通过ANTHROPIC_BASE_URL将 Claude Code 指向该代理将流量转发到真实 API读取~/.claude/settings.json或ANTHROPIC_BASE_URL环境变量实时将请求/响应对写入.claude-trace/若~/.claude/settings.json中已设置ANTHROPIC_BASE_URL会使用临时配置目录不会修改原始 settings 文件。第三方模型CC-Switch 与自定义端点claude-trace 不仅支持官方 Anthropic API也支持第三方模型提供商。任何通过自定义ANTHROPIC_BASE_URL路由 Claude Code 的方案均可使用——包括 CC-Switch、LiteLLM、企业网关和自托管代理。工作原理CC-Switch 等工具通过向~/.claude/settings.json写入ANTHROPIC_BASE_URL及 API Key来配置 Claude Code。运行claude-trace时反向代理会读取~/.claude/settings.json或ANTHROPIC_BASE_URL环境变量中的上游地址启动127.0.0.1上的本地日志代理重定向Claude Code 到本地代理使用临时配置不修改原始settings.json转发已记录的流量到真实上游CC-Switch 本地代理、DeepSeek、OpenRouter、LiteLLM 等Claude Code → claude-trace 代理记录日志 → CC-Switch / 自定义端点 → 模型提供商启动时会显示解析出的上游地址例如Upstream API: http://127.0.0.1:15721 Reverse proxy started at http://127.0.0.1:xxxxx示例CC-Switch安装并配置 CC-Switch选择你偏好的提供商DeepSeek、OpenRouter、本地代理等在 CC-Switch 中切换提供商——配置会写入~/.claude/settings.json照常运行 claude-traceclaude-traceclaude-trace 会自动识别 CC-Switch 端点无需额外参数。~/.claude/settings.json示例由 CC-Switch 管理{env:{ANTHROPIC_BASE_URL:http://127.0.0.1:15721,ANTHROPIC_API_KEY:sk-...}}其他自定义端点也可手动设置上游# 通过环境变量exportANTHROPIC_BASE_URLhttps://your-gateway.example.comclaude-trace# 或直接编辑 ~/.claude/settings.json注意事项上游需支持Anthropic Messages API/v1/messages或使用 CC-Switch、LiteLLM 等能转换为该格式的网关API Key 及 settings 中的其他env项会保留——仅在本地将ANTHROPIC_BASE_URL覆盖为日志代理地址若网关使用非标准路径可用--include-all-requests捕获更多请求HTML 日志会显示实际上游 URL 和每次请求的模型名便于确认会话使用的提供商安装从 npm 安装npminstall-ghanqunfeng/claude-trace从源码安装gitclone https://github.com/hanqunfeng/claude-trace.gitcdclaude-tracenpmrun setup# 安装根目录 frontend 依赖npmrun buildnpmlink# 可选全局可用 claude-trace 命令使用# 启动 Claude Code 并记录日志自动识别 V1 JS / V2 原生二进制claude-trace# 记录所有 API 请求代理模式默认只记录 /v1/messagesclaude-trace --include-all-requests# 记录敏感 header 且不脱敏请谨慎使用claude-trace --include-sensitive-headers# 向 Claude 传递参数claude-trace --run-with chat--modelsonnet-3.5# 指定 Claude 二进制路径claude-trace --claude-path /usr/local/Caskroom/claude-code/2.1.153/claude# 查看帮助claude-trace--help# 提取 OAuth tokenclaude-trace --extract-token# 从已有 .jsonl 生成 HTML 报告claude-trace --generate-html logs.jsonl report.html# 生成 HTML 并包含所有请求claude-trace --generate-html logs.jsonl --include-all-requests# 生成会话摘要与可搜索索引claude-trace--index日志保存在当前目录的.claude-trace/log-YYYY-MM-DD-HH-MM-SS.{jsonl,json,html}。HTML 文件自包含可在任意浏览器中打开无需服务器。CLI 选项参数说明--include-all-requests记录所有 API 流量不仅限于/v1/messages--include-sensitive-headers记录 auth token、cookie 等不做脱敏--log NAME自定义日志文件名不含扩展名--claude-path PATHClaude 二进制路径省略则自动检测--no-open生成 HTML 后不自动打开浏览器--run-with ARGS...将后续参数传给 Claude--extract-token提取 OAuth token 后退出--generate-html FILE [OUT]从 JSONL 生成 HTML 报告--index生成会话摘要与索引请求过滤代理模式Claude Code V2默认记录/v1/messages请求--include-all-requests记录所有经代理的 API 流量拦截模式Claude Code V1Node.js默认记录上下文中消息数大于 2 的/v1/messages请求--include-all-requests记录所有api.anthropic.com请求会话索引为编码会话生成 AI 摘要claude-trace--index功能说明扫描.claude-trace/下所有.jsonl日志过滤有意义的会话消息数 2、未压缩调用 Claude CLI 为每个会话生成标题和摘要创建summary-YYYY-MM-DD-HH-MM-SS.json元数据文件生成按时间排序的index.html主索引链接到各会话的 HTML 文件注意索引会调用 Claude API产生额外 token 消耗。你将看到的内容系统提示词— Claude 收到的隐藏指令工具定义— 可用工具的描述与参数工具输出— 文件读取、搜索、API 调用的原始数据思考块— Claude 内部推理过程Token 用量— 含缓存命中的详细统计原始 JSONL 日志— 完整请求/响应对便于分析交互式 HTML 查看器— 按模型筛选浏览会话调试视图— 原始 HTTP 流量JSON 调试视图会话索引— AI 生成的摘要与可搜索索引环境要求Node.js 16已安装 Claude Code CLIV1 Node.js 或V2 原生二进制开发开发模式npmrun setup# 首次安装根目录 frontend 依赖npmrun dev# predev 编译并复制 JS loader然后启动 watch开发模式会 watch 编译主应用src/和前端frontend/src/。打开http://localhost:8080/test可预览 HTML 查看器与示例数据。测试 CLInpmrun buildnodedist/cli.jsnpmrun typecheck构建npmrun build构建产物dist/— 编译后的 CLI、拦截器与反向代理frontend/dist/— 打包后的 Web 界面CSS JS自包含 HTML 报告内嵌 CSS/JS架构双拦截模式的两部分系统后端src/CLIcli.ts— 检测原生/Node.js 二进制启动对应拦截模式反向代理reverse-proxy.ts—Claude Code V2本地 HTTP 代理记录流量并实时生成 HTML拦截器interceptor.ts—Claude Code V1在 Node.js 进程中 hookfetch()拦截器加载器interceptor-loader.js— V1 的--require钩子HTML 生成器html-generator.ts— 将前端嵌入自包含 HTML 报告索引生成器index-generator.ts— AI 会话摘要与可搜索索引共享会话处理器shared-conversation-processor.ts— 前后端共用的解析逻辑Token 提取器token-extractor.js— 提取 OAuth tokenV1 Node.js 路径前端frontend/src/app.ts— 主组件数据处理与视图切换index.ts— 应用入口components/simple-conversation-view.ts— 会话展示与工具可视化components/raw-pairs-view.ts— 原始 HTTP 流量查看器components/json-view.ts— JSON 调试视图styles.css— Tailwind CSSVS Code 主题变量许可证MIT — 原作者 Mario Zechner由 hanqunfeng/claude-trace 维护。
claude-trace：记录你与 Claude Code 的所有交互
发布时间：2026/6/10 17:45:46
更新记录2026-06-10 v3.0.4 发布增加新的命令opencode-trace支持 Anthropic 与 OpenAI 格式使用方式与claude-trace基本一致具体说明参看 https://github.com/hanqunfeng/claude-trace/claude-trace v2.0.4English | 简体中文记录你与 Claude Code 的所有交互。以直观的 Web 界面查看 Claude 隐藏的内容系统提示词、工具输出和原始 API 数据。mariozechner/claude-trace 的分支版本完整支持 Claude Code V2通过反向代理支持原生二进制。Claude Code V2 支持Claude Code V2 以原生二进制形式分发macOS 为 Mach-OLinux 为 ELFWindows 为 PE不再是 Node.js 脚本。原有的拦截方式node --require interceptor claude已无法使用。本分支会自动检测二进制类型并选择对应的拦截策略Claude Code 版本二进制类型拦截模式V1.xNode.js 脚本通过--require注入interceptor-loader.jsV2原生二进制本地反向代理重定向ANTHROPIC_BASE_URL针对原生二进制claude-trace 会在127.0.0.1启动本地 HTTP 反向代理通过ANTHROPIC_BASE_URL将 Claude Code 指向该代理将流量转发到真实 API读取~/.claude/settings.json或ANTHROPIC_BASE_URL环境变量实时将请求/响应对写入.claude-trace/若~/.claude/settings.json中已设置ANTHROPIC_BASE_URL会使用临时配置目录不会修改原始 settings 文件。第三方模型CC-Switch 与自定义端点claude-trace 不仅支持官方 Anthropic API也支持第三方模型提供商。任何通过自定义ANTHROPIC_BASE_URL路由 Claude Code 的方案均可使用——包括 CC-Switch、LiteLLM、企业网关和自托管代理。工作原理CC-Switch 等工具通过向~/.claude/settings.json写入ANTHROPIC_BASE_URL及 API Key来配置 Claude Code。运行claude-trace时反向代理会读取~/.claude/settings.json或ANTHROPIC_BASE_URL环境变量中的上游地址启动127.0.0.1上的本地日志代理重定向Claude Code 到本地代理使用临时配置不修改原始settings.json转发已记录的流量到真实上游CC-Switch 本地代理、DeepSeek、OpenRouter、LiteLLM 等Claude Code → claude-trace 代理记录日志 → CC-Switch / 自定义端点 → 模型提供商启动时会显示解析出的上游地址例如Upstream API: http://127.0.0.1:15721 Reverse proxy started at http://127.0.0.1:xxxxx示例CC-Switch安装并配置 CC-Switch选择你偏好的提供商DeepSeek、OpenRouter、本地代理等在 CC-Switch 中切换提供商——配置会写入~/.claude/settings.json照常运行 claude-traceclaude-traceclaude-trace 会自动识别 CC-Switch 端点无需额外参数。~/.claude/settings.json示例由 CC-Switch 管理{env:{ANTHROPIC_BASE_URL:http://127.0.0.1:15721,ANTHROPIC_API_KEY:sk-...}}其他自定义端点也可手动设置上游# 通过环境变量exportANTHROPIC_BASE_URLhttps://your-gateway.example.comclaude-trace# 或直接编辑 ~/.claude/settings.json注意事项上游需支持Anthropic Messages API/v1/messages或使用 CC-Switch、LiteLLM 等能转换为该格式的网关API Key 及 settings 中的其他env项会保留——仅在本地将ANTHROPIC_BASE_URL覆盖为日志代理地址若网关使用非标准路径可用--include-all-requests捕获更多请求HTML 日志会显示实际上游 URL 和每次请求的模型名便于确认会话使用的提供商安装从 npm 安装npminstall-ghanqunfeng/claude-trace从源码安装gitclone https://github.com/hanqunfeng/claude-trace.gitcdclaude-tracenpmrun setup# 安装根目录 frontend 依赖npmrun buildnpmlink# 可选全局可用 claude-trace 命令使用# 启动 Claude Code 并记录日志自动识别 V1 JS / V2 原生二进制claude-trace# 记录所有 API 请求代理模式默认只记录 /v1/messagesclaude-trace --include-all-requests# 记录敏感 header 且不脱敏请谨慎使用claude-trace --include-sensitive-headers# 向 Claude 传递参数claude-trace --run-with chat--modelsonnet-3.5# 指定 Claude 二进制路径claude-trace --claude-path /usr/local/Caskroom/claude-code/2.1.153/claude# 查看帮助claude-trace--help# 提取 OAuth tokenclaude-trace --extract-token# 从已有 .jsonl 生成 HTML 报告claude-trace --generate-html logs.jsonl report.html# 生成 HTML 并包含所有请求claude-trace --generate-html logs.jsonl --include-all-requests# 生成会话摘要与可搜索索引claude-trace--index日志保存在当前目录的.claude-trace/log-YYYY-MM-DD-HH-MM-SS.{jsonl,json,html}。HTML 文件自包含可在任意浏览器中打开无需服务器。CLI 选项参数说明--include-all-requests记录所有 API 流量不仅限于/v1/messages--include-sensitive-headers记录 auth token、cookie 等不做脱敏--log NAME自定义日志文件名不含扩展名--claude-path PATHClaude 二进制路径省略则自动检测--no-open生成 HTML 后不自动打开浏览器--run-with ARGS...将后续参数传给 Claude--extract-token提取 OAuth token 后退出--generate-html FILE [OUT]从 JSONL 生成 HTML 报告--index生成会话摘要与索引请求过滤代理模式Claude Code V2默认记录/v1/messages请求--include-all-requests记录所有经代理的 API 流量拦截模式Claude Code V1Node.js默认记录上下文中消息数大于 2 的/v1/messages请求--include-all-requests记录所有api.anthropic.com请求会话索引为编码会话生成 AI 摘要claude-trace--index功能说明扫描.claude-trace/下所有.jsonl日志过滤有意义的会话消息数 2、未压缩调用 Claude CLI 为每个会话生成标题和摘要创建summary-YYYY-MM-DD-HH-MM-SS.json元数据文件生成按时间排序的index.html主索引链接到各会话的 HTML 文件注意索引会调用 Claude API产生额外 token 消耗。你将看到的内容系统提示词— Claude 收到的隐藏指令工具定义— 可用工具的描述与参数工具输出— 文件读取、搜索、API 调用的原始数据思考块— Claude 内部推理过程Token 用量— 含缓存命中的详细统计原始 JSONL 日志— 完整请求/响应对便于分析交互式 HTML 查看器— 按模型筛选浏览会话调试视图— 原始 HTTP 流量JSON 调试视图会话索引— AI 生成的摘要与可搜索索引环境要求Node.js 16已安装 Claude Code CLIV1 Node.js 或V2 原生二进制开发开发模式npmrun setup# 首次安装根目录 frontend 依赖npmrun dev# predev 编译并复制 JS loader然后启动 watch开发模式会 watch 编译主应用src/和前端frontend/src/。打开http://localhost:8080/test可预览 HTML 查看器与示例数据。测试 CLInpmrun buildnodedist/cli.jsnpmrun typecheck构建npmrun build构建产物dist/— 编译后的 CLI、拦截器与反向代理frontend/dist/— 打包后的 Web 界面CSS JS自包含 HTML 报告内嵌 CSS/JS架构双拦截模式的两部分系统后端src/CLIcli.ts— 检测原生/Node.js 二进制启动对应拦截模式反向代理reverse-proxy.ts—Claude Code V2本地 HTTP 代理记录流量并实时生成 HTML拦截器interceptor.ts—Claude Code V1在 Node.js 进程中 hookfetch()拦截器加载器interceptor-loader.js— V1 的--require钩子HTML 生成器html-generator.ts— 将前端嵌入自包含 HTML 报告索引生成器index-generator.ts— AI 会话摘要与可搜索索引共享会话处理器shared-conversation-processor.ts— 前后端共用的解析逻辑Token 提取器token-extractor.js— 提取 OAuth tokenV1 Node.js 路径前端frontend/src/app.ts— 主组件数据处理与视图切换index.ts— 应用入口components/simple-conversation-view.ts— 会话展示与工具可视化components/raw-pairs-view.ts— 原始 HTTP 流量查看器components/json-view.ts— JSON 调试视图styles.css— Tailwind CSSVS Code 主题变量许可证MIT — 原作者 Mario Zechner由 hanqunfeng/claude-trace 维护。
相关文章
AI Agent Harness Engineering：未来每个 SaaS 软件的标配功能？
AI Agent Harness Engineering：未来每个 SaaS 软件的标配功能？ 摘要/引言 开门见山：痛点引爆的Agent时代革命 你有没有试过用Jira追三个月前遗留的「数据导出格式兼容Excel 2013/365离线筛选」bug？开发负责人说“优先级排Q3重构”…
具身机器人研究全都错了？最新论文：不能只靠VLA和世界模型
更多的机器人示范数据、更大的视觉-语言-动作（VLA）模型，再配上更懂“物理定律”的世界模型，就可以实现“通才机器人智能”吗？这是当前具身智能的主流研究范式，但一篇刚刚发表在 arXiv 上的研究论文却给出了…
DS18B20的STM32F103C8T6使用方法 HAL库全解（超详细时序拆解+源码逐行解析）
DS18B20的STM32F103C8T6使用方法 HAL库全解（超详细时序拆解源码逐行解析）0. 原创前言网上大部分DS18B20教程我都看过，基本都是丢一段源码、简单标几个注释，只告诉你怎么调用函数，根本不讲底层逻辑。很多同学照搬代码后…
我把常用算法做成了动画，聊聊“可视化学习“到底有没有用
先抛观点：算法是"过程 空间结构"的东西，而文字和静态图天然丢失了"过程"这一维。这就是为什么很多人"看懂了题解却写不出代码"——你记住了结论，没记住状态怎么变。 这段时间我深度用了一个算法可视化站点&am…
放弃“流量收割”：B2B 企业如何构建合规高效的企微服务协同体系
放弃“流量收割”与“对抗规则”：B2B 企业如何构建合规且高效的企微服务体系近年来，随着企业微信生态规则的不断完善与收紧，许多过去在“私域运营”中风生水起的企业开始感到阵痛。特别是对于 B2B 行业而言，过去那种依赖非规手段进…
AI赋能学术提质：百考通AI助力高校课程论文高效合规创作
https://www.baikaotongai.com/ 在高校系统化教学体系中，课程论文是衔接课堂理论与学术实践的核心载体。不同于毕业论文的深度研究属性，课程论文侧重考核学生对单门课程知识点的理解、梳理与应用能力，是贯穿本科、专科阶段常态化的课业考核形…
1980-2019年全球地表水和地下水盐度数据集
本数据集提供了一个1980—2019年期间全球地表水（河流、湖泊/水库）和地下水盐度监测数据的综合汇编，旨在反映全球淡水资源的盐度状况及其时空分布特征。数据基于电导率（EC）监测结果构建，部分地下水数据还包含…
ProfControl简单平面库
创建TaskInfo类public class TaskInfo{public IAgv AgvName { get; set; }public IStation PickStation { get; set; }public IStation DropStation { get; set; }public IPocketLines PocketLine { get; set; }public bool IsMovingObstacle { get; set; } // 是否正在移动障碍…
如何在5分钟内快速解锁VMware的macOS支持：终极完整指南
如何在5分钟内快速解锁VMware的macOS支持：终极完整指南 【免费下载链接】unlocker VMware Workstation macOS 项目地址: https://gitcode.com/gh_mirrors/unloc/unlocker 你是否曾经想在Windows或Linux电脑上体验macOS系统，却发现VMware中根本没…
NomNom存档编辑器架构解析：跨平台游戏数据管理技术实现深度剖析
NomNom存档编辑器架构解析：跨平台游戏数据管理技术实现深度剖析 【免费下载链接】NomNom NomNom is the most complete savegame editor for NMS but also shows additional information around the data youre about to change. You can also easily look up each …
从导航软件到游戏寻路：用C++手把手实现Dijkstra最短路径算法（附完整代码）
从导航软件到游戏寻路：用C手把手实现Dijkstra最短路径算法每次打开手机地图导航，或是操控游戏角色穿越复杂地形时，背后都藏着一个数学魔法——最短路径算法。Dijkstra算法作为图论中的经典解决方案，从1956年诞生至今，已…
告别B站收藏夹吃灰：用BiliTools让每一秒学习都物超所值
告别B站收藏夹吃灰：用BiliTools让每一秒学习都物超所值 【免费下载链接】BiliTools A cross-platform bilibili toolbox. 跨平台哔哩哔哩工具箱，支持下载视频、番剧等等各类资源 项目地址: https://gitcode.com/GitHub_Trending/bilit/BiliTools …
LED驱动技术全解析：从核心架构到实战选型与避坑指南
1. 从一颗灯珠到千亿市场：LED驱动的技术演进与商业逻辑十几年前，当我第一次从料盘上拿起一颗0603封装的白色LED时，它微弱的光晕和高达几块钱的单颗成本，让我很难想象今天它几乎照亮了我们生活的每一个角落。从手机屏幕的一抹背光&…
索引堆及其优化
索引堆及其优化 引言 索引堆是一种数据结构，广泛应用于计算机科学和软件工程领域。它主要用于解决优先队列问题，如最小堆和最大堆。本文将详细介绍索引堆的概念、实现方法以及优化策略。 索引堆的定义 索引堆是一种基于堆数据结构的索引机制。它通过维护一个堆来存储数据…
从零到日增237精准粉丝，我靠CSDN这张AI卡片爆了！手把手复刻全流程，含配置避坑清单
更多请点击： https://intelliparadigm.com 第一章：CSDN AI 数字营销的官方引流卡片是什么功能？ CSDN AI 数字营销平台推出的「官方引流卡片」，是一种面向技术创作者的轻量级、可嵌入式内容分发组件，专为提升博文、教程…
Zotero Duplicates Merger：5步彻底清理文献库重复条目
Zotero Duplicates Merger：5步彻底清理文献库重复条目 【免费下载链接】ZoteroDuplicatesMerger A zotero plugin to automatically merge duplicate items 项目地址: https://gitcode.com/gh_mirrors/zo/ZoteroDuplicatesMerger 还在为文献库中堆积如山的重…
利用随机有限集理论对蜂群的ILQR和MPC控制研究附Matlab代码
✅作者简介：热爱科研的Matlab仿真开发者，擅长数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。🍎 往期回顾关注个人主页：Matlab科研工作室🍊个人信条：格物致知,完整Matlab代码及仿真咨询…
为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因
更多请点击： https://intelliparadigm.com 第一章：为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因 Gemini邮件的客户转化效率（CTE）显著偏低，根本原因常被误判为…