无法使用时
按 Claude Code 中看到的提示，排查安装、连接和使用问题。
找不到 claude 命令
终端显示 command not found: claude，或“无法识别 claude”，表示当前终端找不到 Claude Code。
- 按安装步骤完成安装。
- 关闭当前终端，重新打开后执行
claude --version。 - 仍找不到时，按安装程序的提示，将安装目录加入 PATH。
安装排查也可参考官方说明 ↗。
配置后仍无法使用
- 到API 密钥重新复制自己的密钥和连接地址。
- 退出旧的 Claude Code，在已配置的终端中重新运行
claude。 - 若用过其他服务，检查终端及用户、项目配置中是否还留有旧地址。
- 用新会话发送一句“你好”，记录屏幕上的完整提示。
如果仍出现官方登录选择，先确认 SAM 配置已经在当前启动环境中生效。
出现 API Error
Claude Code 的连接或使用报错通常显示为 API Error。按后面的提示处理即可，不需要自行编写请求。
| 看到的提示 | 怎么处理 |
|---|---|
| 401 / 密钥无效 | 重新复制 SAM 密钥，核对地址，然后重启 Claude Code。 |
| 402 / 余额不足 | 打开钱包查看余额，补充余额后继续。 |
| 403 / 无权使用 | 确认账号已开通使用权限；涉及模型时，核对模型选择。 |
| 404 / 模型不存在 | 在 /model 中重新选择控制台列出的模型。 |
| 400 / 参数或消息错误 | 保留完整报错，用新会话测试；持续出现时反馈管理员。 |
| 429 / 使用受限 | 减少同时使用的会话，按提示等待后再试。 |
| 502 / 503 / 504 | 连接或服务暂时异常，稍后重试；反复出现时反馈时间和报错。 |
回复中断或一直等待
看到 Server error mid-response、499 或连接中断时，回复可能不完整。先确认前面的文件修改或命令有没有执行，再决定是否继续。
如果持续重试、长时间没有进展，可以停止当前请求，保留报错，再用新会话发送一句简单消息。
反馈问题
请提供发生时间和时区、所选模型、Claude Code 版本、完整报错截图。若使用日志中有对应记录，也提供详情中的请求编号。
截图或配置中不要包含真实密钥。