常见问题
Last updated on
把这组 Claude Code 教程里最容易反复出现的误区、疑问和排查方向集中放在一起。
这页适合什么时候看？
不是一开始就必须看。
更适合在你已经照着主线做过一遍，但过程中出现了“好像哪里不对、又说不清到底哪里不对”的时候再回来看。
1. 我明明已经装好了，为什么还是不能用？
先不要把“安装成功”和“整条链路成功”混在一起。
通常按这个顺序判断：
- 先看
claude --version能不能正常返回版本号 - 再看
claude能不能正常启动 - 最后再看 CC Switch 里的供应商链路是不是可用
如果第一步就不对，回看 安装 Claude Code。 如果安装没问题但链路不通，回看 CC Switch。
2. 我启动了 Claude Code，但它看起来不像在读我的项目，是为什么？
最常见原因不是模型坏了，而是：
你没有在正确的项目目录里启动它。优先检查：
- 你是不是先
cd到了正确项目目录 - 你是不是在那个目录里运行的
claude
如果目录错了，优先回看 使用 Claude Code。
3. 我已经切了供应商，为什么还是感觉没生效？
这时候先不要慌，按这个顺序看：
- CC Switch 里当前启用的是不是你刚配置的那个供应商
- 你是不是切错到了别的应用，而不是 Claude / Claude Code
- 你现在启动的，真的是 Claude Code，而不是别的 CLI 工具
如果你想重新理顺这部分，回看 CC Switch。
4. 网络慢，是不是就等于整条链路失败了？
不是。
像下面这些，更可能是外围访问问题：
- 某个 GitHub 页面打开慢
- 某个 release 页面访问不稳定
- npm 安装时速度很慢
如果你已经做到：
- 安装成功
claude --version正常claude能启动- 已经完成过一次真实对话
那主线路径通常已经是通的。更多这种补充说明，可以看 网络与补充。
5. 我现在最该先排查哪一类问题？
如果你一时分不清，先按这个顺序来：
- 先排安装问题
- 再排接入链路问题
- 再排目录问题
- 最后再看是不是任务本身太复杂
先追求“能判断”，不要追求“一次全懂”
你现在最需要的，不是一下子掌握所有高级功能，而是能分清：当前问题到底出在安装、接入、目录，还是任务本身。
6. 我接下来应该继续看哪一类内容？
如果你已经跑通主线，后面通常有 3 条路：
如果你现在已经能正常启动并完成第一次对话，其实已经超过很多新手最难的那道坎了
后面要做的，不是推翻重来，而是在已经跑通的基础上，一点点补理解、补习惯、补配置。