常见问题
使用过程中的常见问题及解决方案
常见问题
安装问题
找不到 claude 命令
安装完成后终端提示 command not found: claude。
解决方案：
- 关闭并重新打开终端
- 如果仍然无效，检查 npm 全局路径是否在 PATH 中：
npm config get prefix确保输出的路径在系统环境变量 PATH 中。
- 检查 npm 全局路径：
npm config get prefix- 确保该路径在 PATH 中，如果不在，添加到 shell 配置：
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrcGit 未安装
启动 Claude Code 时提示 Git 相关错误。
解决方案： 参考 环境准备 安装 Git。
Node.js 版本过低
提示需要 Node.js 18 或更高版本。
解决方案：
- 检查当前版本：
node -v - 如果低于 18，参考 环境准备 升级 Node.js
API 错误
401 认证失败
Error: 401 Unauthorized原因： API Key 无效或已过期
解决方案：
- 检查令牌是否正确复制（包含
sk-前缀） - 登录 控制台 确认令牌是否有效
- 如已失效，重新创建令牌
403 访问被拒
Error: 403 Forbidden原因： 余额不足或令牌权限不足
解决方案：
- 登录控制台检查账户余额
- 确认令牌分组是否支持你使用的模型
429 请求频率超限
Error: 429 Too Many Requests原因： 请求频率超过 API 限制
解决方案： 稍等片刻后重试，避免短时间内发送大量请求
500/502/503 服务器错误
Error: 500 Internal Server Error原因： 服务临时故障
解决方案： 等待几秒后重试，如持续出现请联系客服
连接超时
Error: ETIMEDOUT / ECONNREFUSED原因： 网络问题或服务不可达
解决方案：
- 检查网络连接是否正常
- 确认
ANTHROPIC_BASE_URL配置正确 - 不要使用代理/VPN 访问
配置问题
无法连接到服务
如果出现连接错误：
解决方案（Windows）：
- 按
Win + R，输入cmd回车 - 运行修复命令：
powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"- 重新打开终端，再次运行
claude
配置文件格式错误
解决方案：
- 确保 JSON 使用双引号，不是单引号
- 检查是否有多余的逗号
- 使用 JSON 校验工具检查格式
快速诊断清单
遇到问题时，按顺序检查：
| 检查项 | 命令 | 预期结果 |
|---|---|---|
| Git 版本 | git --version | 显示版本号 |
| Node.js 版本 | node -v | v18.x.x 或更高 |
| Claude 安装 | claude --version | 显示版本号 |
| API 地址 | 检查配置文件 | https://bakastream.icu/ |
| API Key | 检查配置文件 | 以 sk- 开头 |
| 账户余额 | 登录控制台查看 | 余额充足 |
错误代码速查
| 错误码 | 含义 | 快速解决 |
|---|---|---|
| 401 | 认证失败 | 检查令牌是否正确 |
| 403 | 权限不足 | 检查余额和令牌分组 |
| 429 | 请求过多 | 稍后重试 |
| 500 | 服务器错误 | 稍后重试 |
| 502 | 网关错误 | 稍后重试 |
| 503 | 服务不可用 | 稍后重试 |
| ENOTFOUND | DNS 解析失败 | 检查网络和 URL |
| ETIMEDOUT | 连接超时 | 检查网络 |
| ECONNREFUSED | 连接被拒 | 检查服务状态 |
获取帮助
如果以上方案都无法解决问题：
- 站长微信：zzxy_rainor
- 联系客服微信：zzxy_rainor