报错对照表
把终端里的报错文字和下面对一下，大部分问题一两分钟就能解决。按 Ctrl+F（Mac 是 ⌘+F）搜报错里的关键词最快。
安装阶段
| 看到的报错 | 原因 | 怎么办 |
|---|---|---|
'claude' 不是内部或外部命令无法将"claude"项识别为…command not found: claude | 装好了，但当前窗口还不认识这个新命令 | 关掉终端重新打开再试。还不行就重新跑一遍安装命令，留意最后几行有没有提示把某个路径加到 PATH，照它说的做 |
Claude Code on Windows requires git-bash | Windows 没装 Git | 去 git-scm.com 下载安装（一路 Next），重开 PowerShell 再装 Claude Code |
The token '&&' is not a valid statement separator | 在 PowerShell 里粘了 CMD 的命令 | 用 PowerShell 那条：irm https://claude.ai/install.ps1 | iex |
'irm' is not recognized…'irm' 不是内部或外部命令 | 在 CMD（命令提示符）里粘了 PowerShell 的命令 | 关掉，改开 Windows PowerShell 再粘 |
无法加载文件 …，因为在此系统上禁止运行脚本 | PowerShell 默认不让跑脚本 | 先执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned，问你时输 Y 回车，再重新安装 |
curl: (28) / Could not resolve host / 403 / 一直卡住不动 | 访问 claude.ai 的下载地址网络不通 | 换个网络或开代理后重试；也可以先装 Node.js LTS，再用 npm install -g @anthropic-ai/claude-code 安装 |
EACCES: permission denied（Mac 上用 npm 装） | 没有写系统目录的权限 | 改用官方脚本 curl -fsSL https://claude.ai/install.sh | bash，不需要管理员权限 |
启动和连接
| 看到的报错 / 现象 | 原因 | 怎么办 |
|---|---|---|
启动后让你选登录方式、要登录 Anthropic 账号Select login method | Claude Code 没读到 unipaxtools 的地址和密钥 | Windows：setx 之后要重开 PowerShell；Mac：执行 source ~/.zshrc 或重开终端。用 CC Switch 的确认卡片已经点亮。见 新手路线第 6 步 |
401 / Invalid API key / authentication_error | 密钥没对上 | 按 Claude Code 报 401 逐条查：变量名是 ANTHROPIC_AUTH_TOKEN；地址结尾没有 /；密钥完整、前后没有空格；环境里没残留旧的 ANTHROPIC_API_KEY |
403 / insufficient balance / 余额不足 | 余额用完了，或者套餐今天的额度用完了 | 看控制台右上角余额和「我的订阅」。套餐日额度第二天自动恢复；急用可以先充点余额 |
429 / rate limit / 提示达到日限额、周限额 | 套餐的日 / 周 / 月额度到上限了 | 等到下个周期重置，或者升级 Claude Max。额度说明见 订阅套餐 |
no available accounts / 无可用账号 | 该分组暂时没有可用的上游 | 等一两分钟重试。持续出现请联系客服，附上报错截图 |
model not found / 模型不存在 | 密钥选的分组里没有这个模型 | 到「API 密钥」页看这个密钥的分组，确认跟你买的套餐一致；或者在 Claude Code 里输 /model 换一个模型 |
Connection error / ECONNREFUSED / fetch failed / 超时 | 网络连不到 unipaxtools，或者地址写错 | 浏览器打开 us-proxy.unipaxtools.com 看能不能打开；检查 ANTHROPIC_BASE_URL 有没有拼错。开着代理软件的，试试关掉或切换规则 |
| CC Switch 里切换了，Claude Code 还是用的老配置 | 旧窗口里有手动设的环境变量，优先级更高 | 关掉终端重开；如果之前用 setx / ~/.zshrc 设过，两种方式只留一种 |
付款和账号
| 问题 | 怎么办 |
|---|---|
| 付了钱余额没变 / 套餐没开通 | 刷新页面。超过 1 分钟还没到，去「我的订单」复制订单号，发给客服 |
| 电脑上扫不了二维码 | 要用手机微信扫电脑屏幕上的码。微信识别不了本机相册里的二维码 |
| 密钥忘了 / 没保存 | 找不回来。到「API 密钥」页删掉旧的，新建一个，然后把新密钥重新填一遍（第 6 步） |
| 收不到邮箱验证码 | 看看垃圾邮件箱；换成 GitHub / Google 一键登录不需要验证码 |
上面都对不上？把完整的报错截图和你执行的命令（记得把密钥打码）发给客服 QQ 495063912。
卡住了？先对照 报错对照表，还解决不了就加客服 QQ 495063912，把报错截图发过来。