遇到问题别慌，按症状一步步排查即可解决
怎么用这页？（新手最快）
- 先找到你看到的"症状"（比如：找不到命令 / 权限不足 / Key 无效）。
- 照着做 2～3 个动作就能排除大部分问题。
- 如果还不行，把"报错原文 + 你做了什么"复制给 Claude。
- 快速诊断：在 Claude Code 中输入
/doctor检查安装健康状态。
症状1：运行 claude 提示“找不到命令”
你看到的可能是
claude : 无法将“claude”项识别为 cmdlet...command not found: claude
- 先验证是否安装成功：
claude --version - 如果也找不到：回到 第01章 重新安装 CLI（重点检查 Node.js 是否可用）。
- 如果安装过但仍找不到：重启终端/电脑（PATH 生效常见需要重启）。
症状2：npm 找不到 / Node.js 相关问题
- 运行：
node -v和npm -v - 如果找不到：按 第01章 Node.js 重新安装，务必勾选 Add to PATH。
症状3：API Key 无效 / 401 / 鉴权失败
- 先确认：Key 没有多空格、没有少字符（复制时最常见）。
- 确认你配的是“正确的 Key 类型”（看 概念扫盲）。
- 换一个最短的测试问题，减少干扰：
你好，回复 OK
补充：我明明配过 Key，但重开终端就又失效
- 你很可能用的是“临时配置”：PowerShell 的
$env:XXX=...或 CMD 的set XXX=...只在当前窗口有效。 - 最省心的永久方案：回到 第01章-智谱 运行
npx @z_ai/coding-helper，让它写入~/.claude/settings.json。 - 如果你不想用向导：请在 第01章 里按“永久配置”手动写入
settings.json。
补充：我在 CMD 输入 $env:... 报错
$env:是 PowerShell 语法，CMD 不认识。- 解决方案 1：换用 PowerShell/Windows Terminal 再执行教程命令。
- 解决方案 2：在 CMD 用
set ANTHROPIC_AUTH_TOKEN=...这种写法（见 10分钟跑通-第2步）。
症状4：网络慢 / 连接失败 / 超时
- 先换一个网络（手机热点也行）验证是否是网络问题。
- 如果你在公司网络：可能被限制外网，优先换网络测试。
- 避免一次发很长内容：分段发（更容易成功，也更省钱）。
症状5：不能改文件 / 权限不足
- 输入
/status看看是不是只读模式。 - 只读模式退出：关闭 Claude Code，重新启动时别用
--read-only参数。 - 如果是系统权限：Windows 尽量在你自己的文件夹操作，不要动系统目录。
症状6：教程说用 D 盘，但我电脑没有 D 盘
- 不需要 D 盘。建议用你的用户目录：
%USERPROFILE%（Windows）或~/（Mac）。 - 最简单：按 10分钟跑通-第3步 的命令创建练习文件夹即可。
把问题复制给 Claude 的模板（直接复制）
提示词
我遇到问题了，请一步一步带我排查（每一步告诉我“要输入什么命令/要点哪里/成功时会看到什么”）。
我在做的事情：
1) ...
2) ...
我看到的报错原文（完整复制）：
...
我的系统：Windows / Mac
我当前目录（如果有）：...