连接问题排查
连接超时、无法访问 QCode 服务时的排查步骤
连接问题排查¶
快速检查：90% 的连接问题是环境变量配置错误或网络问题。先运行下面的诊断命令。
一键诊断¶
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
curl -I https://asia.qcode.cc/api/health
如果 curl 返回 200 OK，说明 QCode 服务正常，问题在本地配置。
连接超时 (ETIMEDOUT)¶
Error: connect ETIMEDOUT
| 原因 | 解决方案 |
|---|---|
| 网络无法访问 | 检查代理/VPN，尝试 curl https://asia.qcode.cc |
| DNS 解析失败 | nslookup asia.qcode.cc，更换 DNS 为 223.5.5.5 |
| 防火墙拦截 | 联系 IT 开放 asia.qcode.cc 443 端口 |
| 代理冲突 | 检查 HTTP_PROXY 变量是否干扰 |
SSL 证书错误¶
Error: unable to verify the first certificate
# macOS
brew install ca-certificates
# Ubuntu
sudo apt install ca-certificates
# 公司自签证书
export NODE_EXTRA_CA_CERTS="/path/to/company-ca.pem"
ECONNREFUSED¶
ANTHROPIC_BASE_URL 格式错误。正确格式：
# 国内用户推荐深圳直连（最低延迟）
export ANTHROPIC_BASE_URL="http://103.236.53.153/api"
# 海外用户使用国际入口
# export ANTHROPIC_BASE_URL="https://api.qcode.cc/"
常见错误：http://（缺 https）、.../api/（多尾部斜杠）、缺少 /api。
中国大陆接入点¶
| 接入点 | 地址 |
|---|---|
| 深圳直连（推荐国内） | http://103.236.53.153/api |
| 国际入口（推荐海外） | https://api.qcode.cc/ |
| 亚洲备用 | https://asia.qcode.cc/api |
| 企业专属 | 联系客服获取 |
使用深圳接入点的用户可在 probe.qcode.cc 查看 API Key 实时使用情况。