跳到文章正文
Claude 实用教程

Claude Code卡顿怎么办?/doctor诊断、上下文与搜索范围检查

先区分安装、登录与运行中性能问题,再使用/doctor查看诊断;按实际提示缩小搜索和任务范围,保…

Claude Code卡顿怎么办?/doctor诊断、上下文与搜索范围检查

Claude Code慢、搜索不全或界面像卡住,原因未必相同。官方运行中排错页提供诊断和资源问题线索。本文先收集可复现现象,再用只读检查定位,不直接删除配置或重装整个开发环境。

第一步:区分失败阶段

命令根本不存在、登录失败与启动后高CPU是三类问题。先记录版本、操作系统、项目大小、现象时间与是否可复现。请求仍在等待批准时也可能看起来没有进展,先看是否有待处理操作,不连续发送相同任务。

保存当前工作和未提交修改,再尝试退出或重启会话。停止进程不会撤销已经改过的文件,恢复前仍要查看工作树,不把重启当成完整回滚。

排错记录:能否启动;能否登录;是否仅某仓库出现;卡在读取、搜索、工具还是回答;有无权限请求;最近一次已完成动作;必要错误说明。不要记录凭据或完整私人上下文。

第二步:运行官方诊断

会话内可运行/doctor检查安装、设置、扩展和上下文使用,诊断可能提出需要确认后才能应用的修复。CLI不能正常进入时,可从终端使用claude doctor。先阅读发现的问题,不把所有建议一次性应用。

/doctor

# 无法正常进入交互界面时,从终端运行:
claude doctor

第三步:缩小搜索和任务范围

大型仓库搜索慢时,明确目录与文件类型比一句“找所有相关代码”更容易验证。先确认文件确实存在、路径正确、忽略规则和环境是否影响检索,不因为一次没找到就断言项目没有该实现。

任务上下文越来越长并反复压缩时,保存当前目标、已验证事实和未完成事项,再拆为清晰阶段。不要让模型不断重读全仓库来弥补含糊任务,也不要省略必要约束以追求快。

只在指定练习包的src目录查找JWT验证相关实现,先列路径与匹配依据,不读取凭据、不安装依赖、不修改文件。未覆盖目录明确说明,不把局部搜索当成全仓库结论。

第四步:一次改变一个条件

先用小仓库或同仓库的小范围只读任务比较,再判断是项目规模、扩展、配置还是会话状态问题。每次只调整一个变量,记录前后差别;没有证据时不把网络、模型或本机硬件固定认定为根因。

涉及安装和登录的诊断应转到官方相应页面,运行中性能页并不涵盖所有安装问题。不要为了消除慢请求切换到不受限制权限或运行不明修复脚本,性能与权限边界应分别处理。

第五步:按真实结果验收

重试同一小任务,检查能否完成、搜索范围是否准确、结果是否有文件依据,以及资源占用是否恢复合理。仅界面恢复输入不代表后台命令已停止,必要时检查自己的后台任务状态。

保存诊断摘要和可复现步骤,向支持渠道提供脱敏必要信息,不上传密钥、私人仓库全文或完整环境变量。无法确定时保留未确认项,避免把暂时恢复称为根因已解决。

官方资料

资料核对日期:2026年11月15日。

本文地址:https://www.163264.com/21256