04 问题排查与售后

HeroKing2026/8/5大约 3 分钟

问题排查与售后

装机手内部 + 客户自助都参考。装机出问题先查这里。

5 个原因 + 检查方法：

PROXY_ADDR 错了
- 检查脚本顶部的 PROXY_ADDR 是否填对
- 跑 curl -v https://claude.ai 看是连到哪里
用户名密码错了
- 重新跑脚本，仔细输密码
- bash/PowerShell 的密码是隐藏的，容易输错
openclash 没在跑
- 远程登录 OpenWrt 看 openclash 状态
- 跑 curl -x http://user:pass@ip:port https://claude.ai 测试
公网 IP 变了（家庭宽带常发生）
- 看 OpenWrt 的 WAN IP
- 改 PROXY_ADDR 里的 IP
- 重跑脚本
域名 DNS 解析失败
- nslookup claude.ai 看是否能解析
- 如果用域名访问 nginx，确认 DNS 没问题

原因：PATH 没更新

解决：

bash：source ~/.bashrc 或 source ~/.zshrc 然后重试
PowerShell：新开一个 PowerShell 窗口
CMD：新开一个 CMD 窗口
如果还不行：手动加 PATH
- macOS/Linux：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
- Windows：设置 > 系统 > 关于 > 高级系统设置 > 环境变量

原因：客户机器没装 Node.js

解决：

原因：Anthropic / OpenAI 改了官方 install 脚本的接口

解决：

这是正常的。装完只是工具，还要登录：

如果跳不出浏览器：

原因：账号没绑 API Key，或者订阅没激活

解决：

Claude Code：
- 订阅 Pro/Max：在 https://claude.ai/settings 确认订阅状态
- 用 API Key：在 ~/.claude.json 里配 apiKey
Codex：
- 订阅 ChatGPT：在 https://chatgpt.com/ 确认订阅
- 用 API Key：在环境变量 OPENAI_API_KEY 里设

原因：当前 shell 没有代理环境变量（脚本退出后 env var 消失了）

解决：

跑 claude / codex 命令之前，手动 export：

export HTTP_PROXY=http://user:pass@ip:port
export HTTPS_PROXY=http://user:pass@ip:port

或者让客户用自己公司/家里的代理（如果允许访问 api.anthropic.com / api.openai.com）
或者用 Claude Code / Codex 内部的代理设置（每个工具的 ~/.claude.json / ~/.codex/config.toml 有 proxy 配置）

原因：nginx 上的脚本版本落后于本仓库

解决：