本文用于排查 Claude Code、Codex 或其他客户端访问卡特 Token 站接口时出现的网络与连接问题。

​
先确认请求地址

不同客户端的基础地址不同：
客户端地址
Claude Codehttps://api.cutaihub.com
Codexhttps://api.cutaihub.com/v1
网络排查时，建议先测试域名连通性： 
curl -I https://api.cutaihub.com
如果本机无法访问这个地址，客户端通常也无法正常请求。

​
API Error: Connection error

常见现象： 
API Error: Connection error.
ECONNREFUSED
ECONNRESET
ENOTFOUND
getaddrinfo ENOTFOUND
这通常说明请求还没正常到达服务端，可能卡在 DNS、代理、TLS 或本地网络链路。 排查步骤： 
nslookup api.cutaihub.com
curl -Iv https://api.cutaihub.com
如果 DNS 解析失败，尝试：
  • 切换网络，例如手机热点。
  • 切换 DNS，例如 1.1.1.1 或 8.8.8.8。
  • 关闭再开启代理软件。
  • 检查公司网络、防火墙或安全软件是否拦截。
如果 DNS 正常但 HTTPS 握手失败，继续看 TLS 和代理章节。

​
API Error: Request timed out

常见现象： 
API Error: Request timed out.
ETIMEDOUT
request timeout
超时可能有两类原因：
  • 网络链路慢或不稳定。
  • 当前会话上下文过长，模型响应时间超过客户端超时阈值。
先用 curl 判断网络延迟： 
curl -w "\nDNS:%{time_namelookup}s TCP:%{time_connect}s TLS:%{time_appconnect}s TOTAL:%{time_total}s\n" -o /dev/null -s https://api.cutaihub.com
如果网络正常，但 Claude Code 或 Codex 在长对话后超时，尝试：
  • Claude Code 输入 /clear 清空上下文。
  • Claude Code 输入 /compact 压缩上下文。
  • 关闭当前会话，重新在项目目录启动。
  • 减少一次请求里粘贴的大段文件或日志。

​
浏览器能打开，但 CLI 不能用

很多代理只接管浏览器，不一定接管终端里的 CLI 工具。Claude Code、Codex、npm、curl 都是命令行程序，通常需要系统代理、TUN 模式或显式代理环境变量。 检查当前终端是否设置代理： 
env | grep -i proxy
macOS / Linux 可以临时设置： 
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5://127.0.0.1:7890
Windows PowerShell： 
$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:HTTP_PROXY="http://127.0.0.1:7890"
端口要替换成你本机代理软件实际监听的端口。设置后重新运行： 
curl -Iv https://api.cutaihub.com
如果 curl 可以访问，再启动 Claude Code 或 Codex。

​
代理配置冲突

代理冲突也会导致连接失败。常见情况：
  • 同时开启系统代理和终端代理变量，但端口不一致。
  • HTTPS_PROXY 指向了已经关闭的代理端口。
  • 公司网络或安全软件拦截了本地代理端口。
  • VPN 和代理软件同时接管流量，路由冲突。
可以先清空当前终端代理变量测试： 
unset HTTP_PROXY HTTPS_PROXY ALL_PROXY http_proxy https_proxy all_proxy
curl -Iv https://api.cutaihub.com
Windows PowerShell： 
Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:ALL_PROXY -ErrorAction SilentlyContinue
如果清空后恢复正常，说明问题在代理配置。

​
TLS 或证书错误

常见现象： 
certificate verify failed
unable to get local issuer certificate
SSL routines
TLS handshake failed
排查方向：
  • 系统时间是否正确。
  • 公司代理或抓包软件是否替换了证书。
  • Node.js 证书链是否异常。
  • 是否设置了错误的 NODE_EXTRA_CA_CERTS。
检查： 
date
env | grep NODE_EXTRA_CA_CERTS
curl -Iv https://api.cutaihub.com
如果你在公司网络，需要使用公司代理证书，请让管理员提供正确 CA 文件，再配置 NODE_EXTRA_CA_CERTS。不要随意关闭证书校验。

​
WebFetch 联网功能失败

如果 Claude Code 调用 WebFetch 抓网页失败，但目标网页在浏览器里能打开，可能是 WebFetch 预检或 CLI 网络路径问题。 先确认 Claude Code 自身能访问卡特接口： 
curl -Iv https://api.cutaihub.com
再确认终端代理是否生效。浏览器能打开不代表 CLI 能打开。 如果报错和 Claude 官方预检有关，可以在 ~/.claude/settings.json 中尝试加入： 
{
  "skipWebFetchPreflight": true
}
Windows 路径通常是： 
C:\Users\用户名\.claude\settings.json
如果文件里已有其他字段，不要直接覆盖，合并这一项并保持 JSON 合法。

​
只在某个网络失败

如果家庭网络正常，公司或校园网络失败，通常是网络策略问题。 可以对比测试：
  • 当前 Wi-Fi。
  • 手机热点。
  • 关闭代理。
  • 开启代理或切换节点。
  • 换 DNS。
如果只有公司或校园网络失败，重点检查：
  • 是否限制 443 出站连接。
  • 是否拦截代理软件。
  • 是否要求安装企业 CA 证书。
  • 是否屏蔽了 api.cutaihub.com。

​
排障时提供什么

联系客服时请提供：
  • 操作系统。
  • 使用的客户端：Claude Code、Codex 或其他。
  • 使用的 Base URL。
  • 报错截图或终端文本。
  • curl -Iv https://api.cutaihub.com 的输出。
  • 是否使用代理、VPN、公司网络或校园网。
  • 是否只有某个网络环境失败。
不要发送完整 API Key。