Claude Code 教程目录
Anthropic Claude Code Tutorial
Claude Code 常见报错与排查
排错要先分类：安装环境、认证计费、项目命令、权限规则、MCP server、上下文污染。不要一上来重装所有东西。
排查顺序
- 确认 Claude Code 命令可执行。
- 确认认证和账号状态。
- 在空目录运行最小任务。
- 回到项目目录检查权限和 settings。
- 如果是 MCP，单独检查 server 命令和日志。
常见问题表
| 现象 | 可能原因 |
|---|---|
| 命令找不到 | npm 全局路径或安装未完成。 |
| 总是要求确认 | 权限模式保守或 allow 规则不足。 |
| 不能读文件 | 路径不在工作区或 deny 规则命中。 |
| MCP 工具不可见 | server 未启动、配置层级不对或命令失败。 |
| 回答跑偏 | 会话过长、目标不清或项目记忆过时。 |
常见问题
最有效的排错信息是什么？
命令、当前目录、报错原文、settings 相关片段和你期望 Claude Code 做的动作。
参考来源
内容基于 Anthropic 官方 Claude Code 文档、Claude Code 最佳实践文章和 Model Context Protocol 官方资料整理，并改写为中文教程站结构。