1. 为什么要把 Codex 接到串口调试上串口调试这件事做过上位机或者工业设备对接的人都不陌生。打开一个调试助手选 COM 口配波特率手敲01 03 00 00 00 01然后盯着日志看回包。问题在于一旦设备参数未知、寄存器地址不确定、从站号要一个个试这种人肉枚举就变得极其低效。你可能会花半小时在试 9600 还是 115200、8N1 还是 8E1 上。Codex 这类编码 Agent 的价值恰好在这里它能写脚本、能循环、能根据返回结果做判断。但传统串口调试助手是个纯 GUI 程序Agent 没法稳定地去点按钮、读文本框。所以真正要解决的问题不是让 AI 会发串口数据而是让串口调试工具本身暴露一套结构化的本地接口Agent 通过 HTTP 就能完成连接、发送、读状态。这就是 AI 通讯调试助手 V1.0.0 的设计出发点。它是一个 Windows WinForms 桌面工具既能当普通串口/网口调试助手用又在本地127.0.0.1:8765上开了一套 Agent API。Codex 通过这套 API 驱动它完成从参数扫描到 Modbus 寄存器读取的完整链路。而 Codex 本身要能跑起来得先解决鉴权和模型通道的问题。我实测下来把 Codex 的auth.json指向 TaoToken 的统一 Key 通道是最省事的做法——一个 Key 管住模型调用Agent 侧不用再维护多套凭证。下面就把这条链路从头到尾拆开讲。本篇适合三类人正在做上位机/工业通讯调试的开发者、想把 Codex 接入本地工具链的 Agent 玩家、以及需要批量测试 Modbus 设备的测试工程师。核心检索词就是 Codex、Agent API、串口、AI通讯调试助手、Modbus这几个词会贯穿全文。2. TaoToken 前置准备统一 Key 与 Codex 的 auth.json 改造在动串口之前先把 Codex 的模型通道理顺。Codex 默认走的是官方鉴权但如果你想让 Agent 侧统一管理 Key、方便切换模型、也方便后续接其他工具把 Base URL 和 Key 改到 TaoToken 是更清爽的方案。2.1 先拿 Key 和确认接入信息打开 TaoToken 控制台在 API Keys 页面创建一个 Key。这个 Key 就是你后面写进auth.json的凭证。同时确认两件事Base URL 用https://taotoken.net/api模型 ID 按你实际要用的填比如gpt-4o、claude-sonnet-4-5这类以控制台模型列表为准。这里有个容易踩的坑Base URL 不要带末尾斜杠也不要自己拼/v1Codex 客户端会按自己的规则拼接路径。写错了会直接 404 或者 401。2.2 Codex 的 auth.json 配置片段Codex 的配置文件通常在用户目录下的.codex文件夹里。Windows 一般是C:\Users\你的用户名\.codex\auth.jsonmacOS/Linux 是~/.codex/auth.json。如果文件不存在就新建一个。可复制的配置片段如下{ OPENAI_API_KEY: sk-你的TaoToken密钥, OPENAI_BASE_URL: https://taotoken.net/api, model: gpt-4o }三个字段对应三件套Base URL、Key、Model ID。缺一不可。有些版本的 Codex 用的是base_url小写下划线风格如果你写完发现不生效先检查字段名大小写是否和当前版本匹配。实测下来新版 Codex CLI 对OPENAI_BASE_URL和OPENAI_API_KEY这两个大写字段识别最稳。2.3 验证 Codex 通道是否通改完配置后别急着接串口先单独验证模型通道。在终端里跑一句最简单的对话请求codex exec 回复一句通道正常如果返回了正常文本说明 Base URL、Key、Model ID 三件套都对。如果报 401多半是 Key 写错或者带了多余空格如果报连接失败检查 Base URL 是不是写成了https://taotoken.net/api/多了斜杠。这一步通过之后Codex 就具备了调用模型的能力。接下来才是让它去驱动串口工具。2.4 为什么用统一 Key 而不是每个工具一套我试过在多个 Agent 工具之间来回切 Key维护成本很高。TaoToken 的统一 Key 通道的好处是Codex、Cline、Claude Code 这些工具可以共用同一个 Key 和 Base URL鉴权和转发都在通道侧完成。你只需要在各自的配置文件里填同样的三件套不用为每个工具单独申请凭证。对串口调试这种Agent 只是其中一个环节的场景来说这点很关键——你不想在调 Modbus 的时候还要分心去管 Key 过期。3. 可复制配置Agent API 与串口收发脚本通道通了现在进入正题让 Codex 通过 Agent API 操作串口。AI 通讯调试助手启动后Agent API 默认监听http://127.0.0.1:8765只绑定本地回环不对局域网开放。如果你在工具里配了 Token请求头要带上X-CommTool-Agent-Token: your-token。3.1 先查状态确认工具在线所有自动化流程的第一步都是GET /api/status。这个接口返回当前串口、网口、发送框、复选框和计数的完整状态。PowerShell 示例Invoke-RestMethod -Method Get -Uri http://127.0.0.1:8765/api/status典型返回里你会看到serialOpen、serialEndpoint、serialTxBytes、serialRxBytes这些字段。Codex 判断工具是否在线、串口是否已开、HEX 显示是否勾选全靠这个接口。serialRxBytes的增量是后面判断有没有收到回包的关键依据。3.2 串口连接配置连接串口用POST /api/serial/connect请求体字段比较全{ portName: COM5, baudRate: 115200, dataBits: 8, parity: None, stopBits: 1, encodingName: UTF-8, readTimeout: 1000, writeTimeout: 1000, dtrEnable: false, rtsEnable: false, closeExisting: true, open: true }parity可选None、Even、Odd、Mark、SpacestopBits支持1、1.5、2也接受One、OnePointFive、Two这种写法。closeExisting设为 true 表示打开前先关掉已有串口避免端口占用报错。PowerShell 调用$body { portName COM5 baudRate 115200 dataBits 8 parity None stopBits 1 encodingName UTF-8 readTimeout 1000 writeTimeout 1000 closeExisting $true open $true } | ConvertTo-Json -Compress Invoke-RestMethod -Method Post -Uri http://127.0.0.1:8765/api/serial/connect -ContentType application/json; charsetutf-8 -Body $body调用成功后界面左侧串口参数区会同步更新按钮变成已连接状态。这就是Agent 操作同步到界面的设计——不是后台偷偷发数据用户能实时看到每一步。3.3 设置收发选项发送 Modbus RTU 之前先把 HEX 日志、HEX 发送、自动追加 CRC 这几个选项打开。用POST /api/serial/options{ timestamp: true, hexLog: true, autoScroll: true, hexSend: true, appendCrlf: false, appendRtuCrc: true, repeatSend: false, dtrEnable: false, rtsEnable: false }没传入的字段保持原状态所以 Agent 可以只改自己关心的选项。appendRtuCrctrue是重点——它让工具自动给报文追加 Modbus RTU 的 CRC16你不用手算。3.4 发送 Modbus 读取报文发送用POST /api/serial/send。读取 1 号从站保持寄存器 1-10 的示例{ text: 01 03 00 01 00 0A, hexSend: true, appendCrlf: false, appendRtuCrc: true, send: true }注意text里不需要写 CRC工具会根据appendRtuCrctrue自动追加。sendtrue表示写入发送框后立即发送false则只更新发送框不发送。PowerShell$body { text 01 03 00 01 00 0A hexSend $true appendRtuCrc $true send $true } | ConvertTo-Json -Compress Invoke-RestMethod -Method Post -Uri http://127.0.0.1:8765/api/serial/send -ContentType application/json; charsetutf-8 -Body $body3.5 网口场景的对应配置如果你的设备走 Modbus TCP用网口接口。TCP Client 连接{ mode: TCP Client, remoteHost: 127.0.0.1, remotePort: 502, encodingName: UTF-8, closeExisting: true, open: true }发送 Modbus TCP 报文{ text: 00 01 00 00 00 06 01 03 00 01 00 0A, hexSend: true, appendCrlf: false, send: true }网口没有 CRC 追加因为 Modbus TCP 用 MBAP 头工具会显示 MBAP 摘要。4. 验证请求一次完整的 Modbus 寄存器读取配置都就位了现在跑一次完整链路确认从 Codex 指令到串口响应是通的。4.1 未知参数扫描流程假设你接了一个 Modbus RTU 从站但不知道通讯参数。让 Codex 按候选参数逐个尝试流程是这样的先调GET /api/status确认工具在线然后枚举系统串口比如 COM5从 9600 开始试常见波特率校验位依次试 8N1、8E1、8O1、8N2。每组参数调/api/serial/connect设置/api/serial/options打开hexLog、hexSend、appendRtuCrc再调/api/serial/send发探测报文然后查/api/status看serialRxBytes有没有增量。建议的探测报文01 03 00 00 00 01 01 03 00 01 00 05 01 03 00 01 00 0A对应的正常响应长度分别是 7 字节、15 字节、25 字节。如果serialRxBytes涨了对应长度基本可以判定参数正确。4.2 实测的一次读取我实测下来Codex 从 9600 开始扫最终识别到COM5 115200,8,N,1。随后发送读取保持寄存器 10-20 的报文01 03 00 0A 00 0B工具自动追加 CRC界面日志显示TX 8B 01 03 00 0A 00 0B 24 0F [RTU Unit1 FC0x03 CRC OK] RX 27B 01 03 16 00 00 42 48 00 00 3F 00 00 00 00 03 00 03 00 00 00 00 3F 00 00 01 A7 60 [RTU Unit1 FC0x03 CRC OK]TX 帧末尾的24 0F就是工具自动算出来的 CRC16。RX 帧里01是从站号03是功能码16是字节数22 字节数据后面是 11 个寄存器的值最后两字节A7 60是回包 CRC。CRC OK 说明收发都正常。4.3 用 Codex 解析回包拿到 RX 原始字节后Codex 可以按 Modbus 协议解析。寄存器值从第 4 个字节开始每两字节一个大端整数。比如00 00是 042 48是 170963F 00是 16128。Codex 写个解析脚本就能把 11 个寄存器值列出来和你的设备手册对照。这一步的意义在于Agent 负责尝试、发送、判断工具负责真实通讯和日志呈现人负责看界面复核。三者分工清晰。4.4 状态同步确认每次操作后/api/status返回的status字段和单独调GET /api/status结构一致。所以 Codex 可以在每次发送后同步界面状态确认serialTxBytes和serialRxBytes的增量符合预期。如果 TX 涨了但 RX 没动说明设备没回或者参数不对。5. 本篇常见错排查链路跑不通时按下面这几类真实报错逐个对照。5.1 401 鉴权失败报错长这样401 Unauthorized或者invalid api key。这是 Codex 侧的模型通道问题不是串口问题。检查auth.json里的OPENAI_API_KEY是不是 TaoToken 的 Key有没有多余空格OPENAI_BASE_URL是不是https://taotoken.net/api。如果 Key 刚创建确认控制台里它是启用状态。5.2 local proxy failed报错local proxy failed或connection refused。这通常是 Codex 客户端在尝试连本地代理但没连上。检查你的auth.json里 Base URL 是不是被写成了某个本地地址。正确做法是直接写 TaoToken 的 API 地址不要经过额外的本地代理层。另外确认网络能正常访问taotoken.net。5.3 reading choices 报错报错error reading choices或unexpected response format。这多半是模型 ID 写错了或者 Base URL 路径拼接不对。Codex 会按{base_url}/chat/completions这类路径请求如果你在 Base URL 里多写了/v1就会变成/v1/v1/...。把 Base URL 改回https://taotoken.net/api再试。5.4 OAuth 相关报错报错OAuth token expired或authentication flow failed。如果你之前用的是官方 OAuth 登录切到 TaoToken 后要把auth.json里的 OAuth 字段清掉只保留OPENAI_API_KEY和OPENAI_BASE_URL。两套鉴权混在一起会冲突。5.5 串口侧报错Agent API 返回ok: false且 message 是串口打开失败或端口被占用。检查closeExisting是否设为 true或者有没有别的程序占着 COM 口。如果返回CRC 校验失败说明设备回的帧 CRC 不对可能是波特率或校验位不匹配回到参数扫描步骤重试。5.6 Agent API 连不上Invoke-RestMethod报无法连接远程服务器。确认 AI 通讯调试助手已经启动Agent API 监听在127.0.0.1:8765。如果工具里配了 Token请求头必须带X-CommTool-Agent-Token否则会被拒。6. 把这条链路用起来跑通一次 Modbus 读取之后你会发现这套组合的真正价值在于可复用。Codex 的auth.json配好 TaoToken 三件套模型通道就固定了AI 通讯调试助手的 Agent API 提供结构化的串口操作两者之间用 HTTP 衔接脚本可以反复跑。几个实用建议。第一把参数扫描逻辑写成 Codex 的一个可复用脚本下次换设备直接跑不用重新想流程。第二serialRxBytes增量判断法比读日志文本更可靠因为 V1.0.0 的 API 暂时不直接返回历史日志和最新 RX 原始字节后续版本计划加GET /api/serial/logs和GET /api/serial/last-rx到时候解析会更顺。第三网口和串口两套接口结构对称Modbus TCP 和 RTU 可以共用一套 Agent 编排逻辑只是发送报文格式不同。如果你还在用传统方式一个个手敲报文试参数不妨把 Codex 接进来。模型通道走 TaoToken 统一 Key串口操作走本地 Agent API人只需要在界面上确认结果。这套链路我实测下来从零到读出寄存器值比手动调试快不少尤其是面对参数未知的设备时。需要长期跑编码和 Agent 任务的可以看下 Coding Plan只想先验证模型通道的直接去模型对话页面发一句试试串口工具侧的接入细节接入文档里有完整的接口清单。