把 Codex 装进 VS Code 当 AI 编码搭子，用得顺手时几乎感觉不到它的存在；可一旦侧边栏的面板加载不出来、登录转半天报错、或者风扇突然狂转，很多人的第一反应是「扩展坏了，卸载重装」。重装有时确实有用，但三类高发故障各有各的根源，不分清表现就动手，常常白忙一场。这篇按排障文的惯例给出排查顺序：先分清是哪一类问题，再按对应路径处理——登录令牌冲突怎么重认证、用量（usage）看不见去哪查、高 CPU 发烫怎么降载，逐类说清。
先分表现：三类故障的定位顺序
排障第一步是归类，别急着动配置。看两个地方就能把方向定下来：一看登录与加载——面板空白、登录后报错，多半落在账号凭据一端；二看资源占用——任务管理器里扩展宿主进程吃满一个核、机器发烫，落在本地负载一端；第三类表现介于两者之间：能正常对话，但面板里的用量信息不显示或长期不刷新，这属于账号与版本一端。三类问题对应三条路径，下面逐一展开。动手前先确认扩展是最新版：扩展市场里点一下更新，不少历史缺陷在新版本里已经修掉，版本行为截至发稿版本，以官方更新日志为准。想省事，可以把报错原文丢给 DeepSeek 帮你判别属于哪类故障，再用 Kimi 查扩展的 issue 区确认是否已知问题，豆包适合把重装步骤整理成一份核对清单。
| 故障类 | 典型表现 | 常见报错或信号 | 处理主线 |
|---|---|---|---|
| 登录与加载类 | 侧边栏面板加载不出来，登录后报错 | Refresh Token Already Used、token_exchange_failed | 关掉多余窗口、只留一份扩展、退出登录后重装重认证 |
| 用量展示类 | 对话一切正常，用量与额度始终不显示 | 面板用量长期不刷新 | 查档位、查登录账号、升版本重新登录，再用 CLI 的 /status 交叉验证 |
| 资源占用类 | 任务管理器里扩展宿主进程吃满一个核 | 机器发烫、风扇狂转 | 降 reasoning 档、拆小任务、收窄打开的文件夹、重型任务走云端 |
令牌冲突：Refresh Token Already Used 的处理路径
第一类是登录类故障，社区里最典型的报错是 Refresh Token Already Used，有时伴随 token_exchange_failed 一类的交换失败码。机制上不神秘：扩展的登录态靠一套刷新令牌维持，令牌只能被使用一次，用旧即换新。当同一份凭据被两个进程同时争抢——比如开了多个编辑器窗口、机器上装了两份来源不同的扩展、或者旧凭据残留在配置里——其中一个先用了，另一个再来用就会撞车，报出来的就是这一句。处理按顺序走：先关掉多余的编辑器窗口，只留一个；再检查是否重复安装，预装与手动安装并存时卸掉一份，多安装来源的坑在config.toml 分层一篇讲过，扩展端同理；然后在扩展面板里退出登录，卸载扩展，重新安装并走一遍浏览器认证。整套动作做完，凭据只剩一个持有者，冲突自然消失。
usage 不可见：额度信息去哪了
第二类表现是对话一切正常，面板里的用量与额度却始终不显示。先分清两件事：如果收到的是 You've hit your usage limit 一类提示，那是额度真的用完了，属于配额问题，处理思路与接口限流一篇相通；而「看不见用量」是展示层的问题，额度可能还有剩。排查按三步走：第一步核对账号档位，部分档位本身不提供用量面板，这不是故障；第二步核对登录账号是否就是你以为的那个，多账号切换后看错档位是高频乌龙；第三步升级扩展版本并重新登录一次，让本地凭据与账号状态重新同步。交叉验证的土办法是用 CLI 侧的 /status 这类账号状态命令看一眼用量，CLI 能看到而扩展看不到，问题就锁定在扩展端，反过来也一样。
高 CPU：发烫机器的降载手段
第三类是资源类故障：扩展宿主进程吃满 CPU，机器发烫风扇狂转。常见来源有四个，对应四个手段。一是推理档位开太高：reasoning 档位越高，模型思考越久，本地等待与界面活动的时间越长，日常小改动把档位降回中低档，负担立刻减轻，档位与审批模式的搭配见审批模式详解一篇。二是任务给太大：让 agent 一口气跨几十个文件重构，中间状态全压在本地，拆成小步任务逐个确认，节奏更稳。三是大仓库索引：超大项目的文件扫描与检索本身吃资源，把打开的文件夹收窄到当前工作目录，扫的范围小了，占用跟着降。四是分流：重型长任务改走云端任务跑，本地只做查看与验收。整体排查节奏与MCP 连不上一篇的三查法同构：先定位、再收窄、后处理。降载仍无效时，禁用其他扩展做二分排查，确认是否第三方扩展冲突。
VS Code 扩展故障速查
- 先分表现：加载登录类、用量展示类、资源占用类，三条路径别混
- 令牌冲突：关多余窗口、留一份扩展、退出登录后重装重认证
- usage 不可见：查档位、查账号、升版本重新同步，再用 CLI 交叉验证
- 高 CPU：降 reasoning 档、拆小任务、收窄仓库、重型任务走云端
- 动手前先升级扩展，版本行为以官方更新日志为准
VS Code 扩展故障怎么办速查
- 重装扩展会丢对话历史吗？：会话记录与登录凭据分开存放，重装主要清凭据；稳妥起见，重装前把重要会话里的结论抄进笔记或提交到仓库，别把没落盘的改动留在工作区。
- 机器发烫一定是扩展的错吗？：不一定。先开任务管理器看占用的进程名，扩展宿主进程高才指向扩展；若占用来自其他进程，按对应方向排查，别急着卸扩展。
- usage 一直不显示，还能继续用吗？：能。对话链路与用量展示是两条路，展示缺失不影响功能；但额度接近上限时不会有面板预警，建议用 CLI 的状态命令定期自查，避免中途被限。
