1. 先做 CLI 与扩展对照
在编辑器集成终端执行最小命令。如果 CLI 能立即响应，而扩展总在约 60000ms 后报错，认证和基础网络已经获得重要反证，应继续检查扩展自身启动路径。
最小对照
claude --version
claude -p "ping"
2. 扩展启动比 CLI 多了哪些环节
| 环节 | 可能表现 | 验证 |
|---|---|---|
| 扩展定位二进制 | 找不到或版本不一致 | 比较扩展日志与终端路径 |
| 启动 shell | 启动脚本卡住 | 测试干净 shell |
| 读取配置 | 慢磁盘或失效目录 | 检查 additionalDirectories |
| 配置探针 IPC | 固定 60 秒无确认 | CLI 正常、扩展失败 |
3. 收集扩展日志而不是重复登录
记录扩展版本、Claude Code CLI 版本、编辑器版本、shell 和精确耗时。若错误每次都接近 60 秒，搜索前一分钟内是否已有子进程完成、但扩展没有收到初始化确认。
4. 检查慢路径与 shell 启动文件
- 检查配置中的附加目录是否指向离线盘、网络盘或不存在的路径。
- 测试登录 shell 启动是否本身耗时。
- 比较编辑器环境中的 PATH 与终端 PATH。
- 确认 CLI 与扩展没有加载两套冲突配置。
- 重启编辑器后用空白工作区测试。
5. 临时切换集成终端模式
公开 issue 的可用绕行方式之一是在编辑器设置中启用终端模式，让扩展使用集成终端路径。设置名可能随版本变化，应以当前扩展设置页为准。
settings.json 示例
{
"claudeCode.useTerminal": true
}该方式用于恢复工作并确认子进程路径差异，不代表已经修复扩展的配置探针。
6. 版本升级与回退要成对记录
先升级扩展和 CLI 到兼容的稳定组合。若升级后才发生，记录最后可用版本并临时回退其中一项；每次只改变一个版本，避免无法定位。问题解决后重新关闭临时终端模式，验证原生扩展路径。
7. 常见问题
Claude CLI 正常，扩展超时还要重置 API Key 吗？
通常不应先重置。CLI 成功说明凭据与基础网络大概率可用，应重点检查扩展子进程、配置探针和 PATH。
为什么总是刚好 60 秒失败？
固定时长通常对应扩展内部初始化等待上限，而不是随机网络延迟。结合扩展日志确认哪个子进程没有返回确认。
claudeCode.useTerminal 有什么作用？
它让扩展通过集成终端运行 Claude Code，可绕开部分原生扩展子进程路径，并作为定位差异的临时手段。
Cursor 和 VS Code 都可能遇到吗？
两者都可运行相关扩展，但环境、shell 和扩展版本不同。应分别记录编辑器版本与实际加载的扩展路径。
配置教程Claude Code API 与 Base URL相关排查Claude Code 常见网络与认证问题错误总览AI API 401、429 与 5xx相关排查Claude Code OAuth 刷新失败相关排查Claude Code MCP OAuth 超时
* 本文由 island AI Coding 技术团队根据官方文档与公开问题记录原创整理。公开 issue 描述的是特定版本和环境，修复状态可能变化；操作前请记录版本并保留回滚路径。更新时间：2026-09-01。