1. 先还原断连现场：Native Host 被杀时 WebSocket 到底断在哪一环
Chrome 一关，Native Host 辅助进程就会被系统直接回收，WebSocket 随之断开——复刻 Codex 浏览器插件时，这是最磨人的一个坑。在 TaoToken 官网（https://taotoken.net/?utm_source=taotoken_aicg_blog_end）创建一把 API Key，把 Claude Code 接进来之后，可以让 Claude Code 沿着 WebSocket Server → WebSocket Local → Chrome Extension 这条链路，逐段排查断连点，再验证重连是否真的跑通。
这个坑的根源不难理解：Native Host 的生命周期完全由 Chrome 控制，浏览器一退，辅助进程就被回收，WebSocket 连接和会话鉴权跟着一起消失。旧方案里，每次重开 Chrome 都要重新鉴权；新设计想把承载连接的进程从浏览器里挪出去，由 WebSocket Local 单独常驻。麻烦的是，断连点不一定只有一个：可能是 Server 没收到 Agent 的指令，也可能是 Local 进程没起来，还可能是 Extension 没连上。与其对着日志猜，不如让 Claude Code 顺着链路把排查清单列出来。
1.1 链路里的三个角色
原文把产品拆成三段：Agent、WebSocket Server / WebSocket Local、Chrome Extension。排障也要按这三段切，不要一上来就怀疑 Extension 的代码。
WebSocket Server 负责管理连接。Agent 发指令时，它把指令路由到对应的 Browser Connection，等待执行完再把结果返回给 Agent。WebSocket Local 则同时扮演两个身份：在 Server 看来它是客户端，在 Extension 看来它是服务端。指令从 Server 下发后，Local 负责转发给 Extension，Extension 再把 Chrome API 的调用结果原路送回去。这套拓扑来自复刻 Codex 浏览器插件时的核心设计，排障时照着这段拆正好。
1.2 为什么 Chrome 关闭会连带杀掉连接
Native Host 是 Chrome 亲自拉起的辅助进程，自然由 Chrome 管理。浏览器主进程退出时，系统会把辅助进程一并回收，WebSocket 连接随之断开。这里的关键不是“断一次”这么简单，而是连接里保存的鉴权信息、会话状态全在进程内存里，进程没了，身份也丢了，所以每次打开 Chrome 都要重新鉴权。
原文设计里专门提到，旧版本通过 Native Host 通知 Extension，Chrome 一关这个辅助进程就被 kill。正因为如此，新方案才把 WebSocket Local 提升为独立的本地常驻进程。理解了这条因果链，排查时就知道该往哪儿看：不是看 Server 的地址有没有写错，而是看连接到底挂在了谁的生命周期上。
1.3 问题出在会话归属
与其说问题是“连接断了”，不如说问题是“连接的宿主选错了”。Native Host 把 WebSocket 绑定在浏览器进程的生命周期上，浏览器退，连接就死；如果换成 WebSocket Local，Chrome 退出后，Local 和 Server 之间仍然保持连接，Extension 重新打开时只需要在本地重新连一下 Local。把连接从 Chrome 的进程树里挪出来，是这条链路最核心的修复思路。
Claude Code 接入后，第一步就是让它分析这段因果链。它可以帮你说清楚：当前版本的断连是发生在 Server 与 Local 之间，还是 Local 与 Extension 之间；是进程被回收导致的，还是重连逻辑没写导致的。
2. Claude Code 连上 TaoToken，把排查过程变成对话
排障前先把工具链准备好。Claude Code 能不能稳定拿到模型能力，取决于 Base URL 和 Key 对不对，这一步不值得反复试错，直接按下面的方式配好即可。
2.1 打开官网创建 Key
打开 TaoToken 完成注册登录，在控制台创建一个 API Key。这个 Key 就是 Claude Code 访问模型时使用的身份凭证，下文涉及 Key 的地方统一用YOUR_API_KEY代替。创建完成后先别急着复制进代码，回到官网模型广场确认一下当前模型 ID 的写法，避免凭记忆填错。
官网地址和接口地址要分开记：日常看模型、看用量、管理 Key 都走官网页面；填进 Claude Code 的 Base URL 是另一回事，见下一节。
2.2 settings.json 里把 Claude Code 指到 TaoToken
在~/.claude/settings.json里加一段env配置，这是 Claude Code 原生支持的方式：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "YOUR_MODEL_ID" } }YOUR_MODEL_ID以模型广场当时列表为准，不要编造一个固定模型名。也可以不用配置文件，直接在终端导出环境变量，效果一样：
export ANTHROPIC_BASE_URL=https://taotoken.net/api export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY export ANTHROPIC_MODEL=YOUR_MODEL_ID注意两个容易被绕晕的地址：官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end ，用来注册、建 Key、看模型广场和用量；而填进 Claude Code 的 Base URL 一定是https://taotoken.net/api，末尾不要带/v1。把这两个地址分开记，后面基本不会遇到“一直 404”的尴尬。
2.3 让 Claude Code 沿链路给排查清单
配置保存后重启 Claude Code，在对话里先把链路背景交代清楚。可以直接用这段描述：
我现在在排查一个浏览器插件连接链路：Agent → WebSocket Server → WebSocket Local → Chrome Extension。Chrome 关闭后 Native Host 被杀，WebSocket 断开，重开后必须重新鉴权。请按这条链路列出排查清单，并在每一步注明该看哪个日志、什么现象代表正常。Claude Code 返回的清单一般会包含三类检查：Server 端连接是否在线、Local 端进程是否常驻、Extension 端 ws 是否连回。拿到这个清单再动手，比直接改代码要稳得多。
3. 让 Claude Code 对着连接链路定位断连点
链路拆成三段后，排障就变成逐段确认。Claude Code 在这里是分析助手，它负责把每一段应该满足的条件列出来，你在本地核实，再把结果贴回去。
3.1 从 Agent 到 WebSocket Server 的远端路由是否正常
第一段链路在远端。Claude Code 会把这段拆成几个问题：Agent 发消息时，WebSocket Server 有没有正确接收；Server 是否按 connectionId 把指令路由到目标连接；执行结果能不能原路返回。对应到代码里，需要检查 Server 建连时是否把连接注册进了连接表，消息回调里能不能查到目标连接，心跳定时器有没有维持活跃状态。
如果这一段不正常，现象通常是 Agent 侧显示已连接，但指令发出去没有回包，浏览器端也收不到任何动作。先把 Server 日志调出来，对照 Claude Code 给的清单逐行看。
3.2 从 WebSocket Local 到 Extension 的本地通道
第二段链路在本地。Claude Code 会建议你确认两件事：WebSocket Local 是否真的以独立进程在跑，而不是像 Native Host 一样依托于 Chrome；Extension 建立 ws 连接时，目标地址是不是指向 WebSocket Local 的监听端口。
地址写错是高频问题。比如端口不一致，或者路径拼错，都会让 Extension 反复重连却始终连不上。检查时可以打两行日志：Local 启动时打印它监听在哪个端口，Extension 弹起时打印它连的是哪个端口。两个端口对不上，问题就在配置，不用动 Server 代码。
3.3 把 Chrome 关闭再重开，验证 WebSocket Local 是否接管
这一步需要你在本地实际操作，Claude Code 不会替你关浏览器。先关闭 Chrome，再看 WebSocket Local 的进程还在不在；然后重开 Chrome，观察 Extension 能不能自动连回。把观察结果贴回对话，Claude Code 会告诉你重连逻辑是否真正生效。
验证的标准不是“重开 Chrome 后插件立刻能收到指令”，而是两个动作之间的时间差有没有依赖 Chrome 的存活。真正跑通的状态是：Chrome 还没打开，Local 与 Server 之间的连接已经建立；Chrome 打开后，Extension 只做一次本地重连，不再需要走整套鉴权流程。
3.4 实际调用一次接口确认 TaoToken 链路正常
链路修复后，还要确认这一次 Claude Code 走的模型通道是通的。最简单的方式是让 Claude Code 生成一段 WebSocket Local 的重连示例代码。它能正常写出来，说明你已经通过 Base URLhttps://taotoken.net/api成功调用了模型接口，API Key 和模型 ID 都没填错。
再加上第 3.3 节本地重连的日志确认，“API 通道 + WebSocket 链路”就形成了双验证闭环。到这里，排障才算真正收尾。
4. 用 WebSocket Local 换掉 Native Host 的保活方案
原文设计把 WebSocket Local 定位成 Native Host 的替代者。排障过程中，Claude Code 会不断把话题引到同一个结论上：连接不能挂在浏览器进程上，必须让本地常驻进程来扛。
4.1 Native Host 生命周期由 Chrome 管理，Local 进程独立
把 Native Host 和 WebSocket Local 放在一起对比会更清楚。Native Host 是 Chrome 临时雇的短工，浏览器一关门，短工就被解雇，连接、鉴权全部清零；WebSocket Local 是自己养的常驻岗，Chrome 在不在岗位都在。
新方案的核心不是多写一个进程，而是把“连接宿主”从浏览器进程树里移出去。这一改动直接消除了“每次重开都要重新鉴权”的体验问题。Claude Code 在分析这条链路时，也会按这个标准去检查 Local 进程的启动方式——如果 Local 还是由 Chrome 的 Native Host 机制拉起的，那换汤不换药。
4.2 WebSocket Local 的双角色设计与断线重连
WebSocket Local 在实现上有两个角色要同时维护：朝上看，它是 WebSocket Server 的客户端，负责保持远端连接；朝下看，它是 Extension 的服务端，负责接收浏览器端的连接。原文设计里去掉了 Chrome Native Messaging，也是因为 Extension 自己就能通过 ws 协议收到指令，再由 Chrome API 去操作浏览器，中间那条 Native Messaging 通道属于冗余。
双角色意味着要处理两种断线：与 Server 之间断线时，Local 要自动重连并重新鉴权；与 Extension 之间断线时，Local 要保持监听，等 Extension 下次连回来。这两条路径的重连逻辑不同，不能共用同一套失败处理。
4.3 Claude Code 帮检查重连逻辑的代码清单
让 Claude Code 审查重连逻辑时，给它明确的范围：心跳间隔、重连退避、鉴权持久化、消息补偿。按这个顺序查，比笼统地问“怎么让它更稳”更有效。
Claude Code 会指出哪些状态应该持久化、哪些流程在进程重启后会丢，再由你决定在本地怎么改。比如鉴权 token 是否落盘，Extension 重连过来时要不要重新验证身份，断线期间 Server 下发的消息要不要缓存。这些都是它擅长检查的点，你只需要把现有代码贴过去，它会按清单逐项标注风险。
5. 排障对照：断连时优先看这三类日志
链路有三段，日志也有三处。把断连点、现象和检查动作整理成一张表，排查时直接对着表看，不会乱。
| 断连点 | 典型现象 | 检查动作 |
|---|---|---|
| WebSocket Server | Agent 已连接但指令无回包 | 看建连日志、connectionId 路由表 |
| WebSocket Local | Chrome 关闭后进程消失 | 任务管理器或 ps 查看进程是否常驻 |
| Chrome Extension | 插件显示断开、反复重连 | DevTools 看 ws 目标地址和端口 |
5.1 WebSocket Server 侧：连接是否注册成功
Server 的日志一般会打出每次建连、断开的记录。优先确认三行：Agent 连接是否注册、目标浏览器连接是否注册、心跳回包是否正常。这一段的问题大多出在连接注册表没有清理失效连接，导致路由时找不到目标。
5.2 WebSocket Local 侧：进程是否常驻
Chrome 关闭后，用任务管理器或ps查一下 Local 进程。如果进程跟着消失，说明它还是被 Native Host 通道拉起的，根本没换成独立常驻方案；如果进程还在但 Extension 重连不上，再看端口监听和服务端逻辑。
5.3 Extension 侧：ws 建连地址是否指向 Local
Extension 的 DevTools 里可以直接观察到 WebSocket 请求的目标地址。最常见的错误是把地址写成了原来的 Native Host 地址，或者漏了端口。这张表本身就是给 Claude Code 看的排查输入，把对应日志贴给它，它会继续缩小范围，直到定位到具体代码。
排障离不开验证。回到 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 的模型广场和用量页，可以确认本轮调用是否真实发生，顺便核对模型 ID 有没有写错。
6. 跑通后去控制台对一下这次调用
配置保存后，先在 TaoToken 模型对话 里用同一把 Key 发一条测试消息，确认模型 ID 和 Base URL 没填错。接着回到 Claude Code 里执行刚才的重连验证，再到控制台用量页看这一笔调用有没有被记上。如果模型对话通了但 Claude Code 不通，问题大概率出在环境变量没读到配置，而不是 Key 本身的问题。
如果这个方案要天天跑，建议打开 Coding Plan 看看套餐是否匹配使用频率。Key 的统一管理在 控制台 API Keys，Claude Code 的环境变量写法可以对照 接入文档 再核对一遍。先验证、再买量、最后查文档，这套顺序能避免 Key 还没建好就急着开套餐的常见失误。
