故障排查
Troubleshoot performance and stability
Troubleshoot performance and stability 这一页讲的，就是 Troubleshoot performance and stability 这件事在 Claude Code 里到底怎么用。
页面信息
这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。
如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。
这一页先讲明白
这一页是遇到问题时的急救箱。
当安装失败、登录不通、命令跑不动、结果不对时，先来这里排查。
排错最怕瞎撞墙。官方这页的价值就是帮你先分门别类：到底是环境问题、权限问题、网络问题，还是命令本身没写清。
先分清类别，修起来才快。
每次排错都先记下报错原文、运行环境和你刚刚做了什么。
不要一上来全盘重装。先查最小可验证项，比如版本、登录状态、网络连通、目录是否正确。
Documentation Index
这里不是让你背"Documentation Index"这个词，而是让你看它真干活时怎么使。
如果你打算把外接能力往里挂，这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。
Performance and stability
这里不是让你背"Performance and stability"这个词，而是让你看它真干活时怎么使。
High CPU or memory usage
看到这里，就把"High CPU or memory usage"当成一件真要上手的活来看。
看这段时要特别盯工具和权限边界，别为了省事一把全开。
Auto-compaction stops with a thrashing error
这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。
看这段时要特别盯工具和权限边界，别为了省事一把全开。
Command hangs or freezes
这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Search and discovery issues
这段就是排错时拿来照着查的，先一项项看清楚，再动手改。
看这段时要特别盯工具和权限边界，别为了省事一把全开。
Search and discovery issues 1
看到这里，别光点头，下面这条命令先跑起来再说。
brew install ripgrepSearch and discovery issues 2
看到这里，别光点头，下面这条命令先跑起来再说。
apk add ripgrepSearch and discovery issues 3
看到这里，别光点头，下面这条命令先跑起来再说。
winget install BurntSushi.ripgrep.MSVCSlow or incomplete search results on WSL
这一块主要是在说"Slow or incomplete search results on WSL"真到手上该怎么用，哪里最容易踩坑。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Get more help
这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。
如果你打算把外接能力往里挂，这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。
照着做一遍
这页属于“Troubleshoot performance and stability”这类活，最稳的办法还是一小步一小步来。
下面这三步不一定华丽，但通常最不容易绕晕。
第 1 步：先起步
每次排错都先记下报错原文、运行环境和你刚刚做了什么。
第 2 步：边做边看
不要一上来全盘重装。先查最小可验证项，比如版本、登录状态、网络连通、目录是否正确。
一眼看懂这一页
这页的作用，就是把原本偏专业的话题，拆成能直接照着走的明白话。
Troubleshoot performance and stability
|
v
Troubleshoot performance and stability 这一页讲的，就是 Troubleshoot performance and stability 这件事在 Claude Code 里到底怎么用。
|
v
照着步骤去做文末提醒
这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。
人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。