Claude Code Troubleshooting Index: Orders 33-35 on Install, Runtime, and Config Diagnosis

🌏 中文版

This page was originally planned as a single collection of every Claude Code troubleshooting scenario. While writing it became clear that the three problem classes have very different investigation paths — install failures mean reading setup logs, mid-run crashes mean network and API errors, and silent config misses mean diffing settings files across scopes. Cramming them together would only get in the way. So this troubleshooting group is now split into series orders 33-35, each expanding its symptoms, diagnostic tools, and fixes:

• Order 33: Installation & login troubleshooting: command not found, PATH issues, authentication failures, can't reach the API — for when it doesn't work at all (中文版)
• Order 34: Claude Code Runtime Troubleshooting Guide: CPU/Memory, Session Hangs, Auto-Compact Thrashing, Search Failures: interrupted responses, performance anomalies, search and context issues — for when it works but runs poorly (中文版)
• Order 35: Claude Code Config Not Taking Effect: Diagnosing with /context, /doctor, and /mcp, Plus a Common Errors Reference: CLAUDE.md ignored, hooks not firing, MCP servers missing, overridden settings — for "configured but not taking effect," including /context, /doctor, and /mcp usage plus a common-errors table (中文版)

For the full series map and underlying mechanics, start from the entry post.

References

• Debug your configuration — Claude Code Docs — Basis of the config diagnosis post: diagnostic commands, safe mode, and common configuration pitfalls
• Error reference — Claude Code Docs — Source of the runtime error table: meaning and recovery steps per message
• Troubleshooting index (Chinese version)

Changelog

• 2026-08-26: Collection split into orders 33-35; this page is now an index.