Claude Code 按需读取串口日志
UartX 1.4 让 Claude Code 通过只读命令查询相关 UART 日志,开发者可查看每次请求及其读取的原文。一次测试中,Claude 从 196 行日志里读取了约 30 行,AI 集成目前仅支持 Windows。
AI 深度解读
固件出问题时,串口(UART)可能已经刷了几千行日志。UartX 1.4 给 Claude Code 提供了一个按需取日志的入口 uartx-ctl。作者做过一次测试,开发板输出了 196 行,Claude Code 只取了约 30 行来分析。
这套做法有两个值得拆开的地方。一是让模型按当前线索取日志,少往上下文里塞内容。二是把每次请求和实际读到的行留在界面上,方便你回头核对模型的判断。
Claude Code 怎么挑出要看的日志
UartX 继续记录串口输出,Claude Code 通过 uartx-ctl 请求它当前需要的信息。比如排查网络重试时,可以先看与重试有关的日志,再决定要不要扩到其他记录。原文也提到了内存使用和传感器故障,这些都可以通过筛选视图观察。至于 uartx-ctl 支持哪些参数、能不能一次取回匹配行前后的上下文,作者没有展开。

模型的判断能追溯到哪些日志行
UartX 会展示 Claude Code 的分析结果、每次请求和实际分析过的日志行。假设模型说某次失败触发了连续重试,你可以回看它拿到了哪些记录,再判断这些行只能说明两个事件先后发生,还是有足够证据支持因果关系。


只读限制管到哪里
作者把这套集成描述为本地、只读。Claude Code 可以读取日志,无法通过这个入口向设备发送数据。原文称数据留在电脑上,但没有交代被选中的日志行进入 Claude Code 后如何处理,因此还无法据此确认完整的数据流向。
AI 功能目前仅支持 Windows。UartX 的核心日志记录功能支持 Windows、macOS 和 Linux。
我的判断
这套方案最扎实的地方是保留了取证过程。手动筛一遍日志再贴给模型,同样能缩小输入范围,而且筛选条件由人把关。UartX 多做的一步,是让模型可以按需发起请求,同时保留它看过哪些行的记录。看见取证过程,也更容易发现它把查询范围定窄了。
196 行里取约 30 行,是一次实测。作者没给出对照数据,也没交代有没有漏掉关键事件、最终定位是否正确、耗时是否更短。「这样更容易定位故障」目前还是经验之谈。尤其是故障需要串起多条线索时,比如先出现内存异常,随后才开始网络重试,只围绕「重试」筛选就有可能错过前因。
能拿来做什么
- 用 Claude Code 排查串口日志时,先给它一个具体问题,例如「第一次网络重试前,设备处于什么状态」,再让它指出结论对应的原始日志行。
- 遇到跨模块故障,先按症状筛选,再回到原始日志查看异常前后的连续记录,把初始化、内存变化和重试放回同一条时间线上。
- 如果平时要联调 Node 服务和串口设备,可以先用串口侧的关键时间点缩小范围,再去服务日志里核对同一时段的请求和错误。