章节导航

前面八章讲的是怎么用，这一章讲的是遇到问题往哪儿翻。附录不需要顺序读，把它当成一本速查册就行。

这一章讲什么

Claude Code 迭代很快，模型 ID、快捷键、可用资源都会随版本变化。日常写代码的时候没必要背这些细节，但真出问题的时候手边有一份对照表能省下大量时间。附录把最容易被反复检索的内容集中放在一起，遇到卡壳先来这里找。

四个子页面各自独立，你可以直接跳到需要的那一页。

排错手册

第一节按错误场景分成网络、认证、权限、工具、模型五类，每类列出常见症状和排查顺序。里面还整理了 claude doctor 命令的输出解读，以及日志文件在各操作系统里的默认位置。看到红色报错先来这里对一下号。

模型 ID 与选型

第二节整理了当前主流的模型 ID，从 claude-opus-4-8 到 claude-haiku-4-5-20251001 各挑什么场景。附了一张选型表，把任务类型、上下文窗口、价格档次并列在一起，帮你在质量和成本之间做取舍。还讲了 Fast 模式和普通模式的区别，别再以为 Fast 是切了别的模型。

快捷键参考

第三节是纯速查表。REPL 里所有能省鼠标操作的键位、Vim 模式的额外键位、粘贴多行代码时容易踩的坑，都汇总在这一页。打印下来贴在显示器边上都行。

资源清单

第四节整理了官方文档、社区渠道、Cookbook、MCP 生态、Agent SDK 示例等外部资源。教程终究会过时，学会自己查最新一手资料才是长期收益。这一节告诉你去哪儿查。

使用建议

附录里不放教学性质的内容，全是查表用的。第一次读可以快速扫一眼知道有哪些页，日后按需回来。