先判断：失败发生在本地、网络还是接口

排障第一步不是重装，也不是马上更换模型，而是判断请求在哪个阶段失败。命令无法启动属于本地工具层；命令可以启动但连接不上，通常属于网络或地址层；连接返回 401、403、404，则进入鉴权、权限和路径判断；请求运行一段时间后超时，还要考虑上下文、**和任务规模。

• 启动失败：检查 Node.js、npm、Codex 和 PATH。
• 连接失败：检查网络、域名、**和 *ase **L。
• 401/403：检查令牌、额度、分组和模型权限。
• 404/model not found：检查路径和 Model ID。
• 超时：缩短任务后再判断网络或服务状态。

️ 第一步：确认本地工具没有先出问题

打开新的 PowerShell 窗口，逐条执行工具检查。不要在一个长期打开的旧终端里排查，因为旧窗口可能保留了过期环境变量。

node -v
npm -v
where.exe node
where.exe npm
codex --version

如果 node、npm 或 codex 无法识别，先处理安装和 PATH。只有本地工具层通过后，才有意义继续检查中转地址和令牌。

第二步：从灵能API页面核对服务入口

进入灵能API公开页面或控制台，重新确认当前服务入口、模型列表和令牌状态。不要把浏览器能打开官网，直接等同于 API 请求地址可用；官网页面和接口服务是两个不同的访问目标。

建议记录三项脱敏信息：域名、*ase **L 的版本路径、当前 Model ID。不要记录完整 API Key。模型、价格和服务说明可能变化，排障时以当天页面信息为准。

• 官网入口：https://www.lnsns.com/
• *ase **L：确认协议、域名和版本路径完整。
• Model ID：从当前列表重新复制。

第三步：处理 *ase **L 最常见的三种错误

地址层级是 CC Switch 配置中最常见的问题。对于兼容接口，*ase **L 通常填写到 /v1。不要把官网首页填进去，也不要将完整的聊天接口路径继续拼接到基础地址后面。

正确示例：  https://www.lnsns.com/v1
常见错误：  https://www.lnsns.com
常见错误：  https://www.lnsns.com/v1/v1
常见错误：  把完整接口路径直接填入基础地址

出现 404 时，先逐字符检查地址，不要先更换模型。修改后保存配置，重新获取模型列表或执行连接测试，确认地址问题是否已经解决。

**步：用错误码区分令牌和权限问题

401 通常意味着请求没有通过身份认证，优先查看 API Key 是否完整、是否被撤销、是否粘贴了空格或换行，以及当前启用卡片是否就是刚修改的那张。不要在排障过程中把完整 Key 发出来。

403 更接近权限、额度或访问策略问题。此时单纯重贴 Key 往往没有帮助，应回到控制台确认账户状态、令牌分组和目标模型是否允许使用。

• 401：身份认证失败，优先检查 Key 和启用卡片。
• 403：账户、额度、分组或模型权限问题。
• 令牌疑似泄露：撤销旧 Key，创建新 Key 后重新测试。

第五步：处理模型列表获取失败

如果 CC Switch 点击获取模型列表后失败，先不要手动猜模型。按照地址、Key、网络、协议四项顺序检查。地址正确但列表仍为空，可能是令牌没有对应模型权限，也可能是当前客户端要求另一种协议选项。

如果服务页面能正常打开，但客户端请求超时，不能直接说明 API 一定可用。浏览器访问网页和程序调用接口可能经过不同的**、DNS 或安全策略。

• 先检查 *ase **L 是否保存成功。
• 再检查 API Key 是否有效且属于当前服务。
• 确认客户端选择了正确的兼容协议。
• 最后检查网络、**和服务状态。

⏱️ 第六步：超时问题从小任务开始缩小范围

项目级任务超时，不一定是线路坏了。长日志、多个文件、历史对话和复杂指令都会放大输入上下文。排查时先切换到空目录，发送一句只读任务，再逐步增加内容。

mkdir codex-timeout-check
cd codex-timeout-check
codex

如果短任务成功、长任务超时，优先减少一次性读取的文件数量和输出范围。如果短任务也超时，再检查网络、**、域名解析和服务端状态。每次只改变一个变量，才能知道真正原因。

• 短任务成功：优先调整上下文和输出长度。
• 短任务也失败：优先检查网络和基础配置。
• 只有某项目失败：检查项目环境、**变量和目录规模。

✅ 第七步：保存配置后必须重启旧进程

很多‘配置没生效’其实是旧进程残留。CC Switch 里切换卡片后，关闭当前 Codex、PowerShell 和相关**进程，再重新打开。不要用同一个旧窗口继续验证。

codex --version
cd D:\work\your-project
codex

新进程启动后先发送只读任务，确认当前目录和线路。若仍然显示旧模型或旧错误，检查是否还有其他终端、脚本或环境变量覆盖了 CC Switch 配置。

常见现象与快速处理表

排障记录只保留错误码、卡片名称、Model ID、*ase **L 和时间，不记录完整 API Key 或项目敏感内容。

• 官网能打开但 API 超时：分别检查网页访问和程序**。
• 模型列表为空：检查 Key、分组、协议和当前服务状态。
• 401：重新确认 Key 是否有效，不要公开完整密钥。
• 403：检查余额、模型权限和令牌范围。
• 404：检查 *ase **L 是否重复 /v1。
• model not found：复制最新 Model ID。
• 切换不生效：关闭旧进程并重新启动。

第八步：把排障结果沉淀成恢复卡片

某条线路排障成功后，不要继续覆盖原卡片。可以把已验证的参数保存成稳定主卡片，并保留一张恢复卡片。以后遇到同类错误时，先切回恢复卡片，就能快速判断问题是服务变化还是新配置错误。

需要查看当前模型、令牌和服务信息时，通过可点击的灵能API官网入口进入：https://www.lnsns.com/。实际页面信息优先于旧截图和排障笔记。

• 主卡片：只保留稳定参数。
• 实验卡片：用于测试新模型和新地址。
• 恢复卡片：保持可用，定期做轻量测试。

最终排障清单

按这套顺序排查，通常可以把‘中转站不能用’拆成一个明确的本地、网络、权限、地址或任务规模问题。

• 本地 node、npm、codex 命令可用。
• 官网信息与当前模型列表已重新确认。
• *ase **L 没有重复版本路径。
• API Key、分组和模型权限相互匹配。
• 模型列表获取和连接测试至少完成一项。
• 切换配置后旧 Codex 已关闭并重新启动。
• 短任务通过后，才进入真实项目。