网络接入

Claude API 国内接入与连通性

从公网 HTTPS、域名解析和模型列表逐层验证,不用关闭证书校验掩盖网络问题。

由 Claude Agent 技术团队 维护 · 发布于 2026-07-14 · 更新于 2026-09-05

Claude API 国内接入前先检查什么

国内网络接入的关键不是更换模型名,而是确认域名解析、HTTPS、长连接和客户端 Base URL。Claude Agent 当前提供公网 HTTPS 入口;实际延迟和可达性仍会受所在地区、运营商、企业网络和请求模型影响。

curl -I https://claudeagent.com.cn/
curl https://claudeagent.com.cn/api/status
curl https://claudeagent.com.cn/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

先确认首页与状态接口可达,再用 Key 请求模型列表。不要用关闭证书校验的方式掩盖 TLS 或中间人问题。

网络问题分层定位

层级检查常见处理
DNS域名是否解析到可访问地址更换合规 DNS 或联系网络管理员
HTTPS证书链、系统时间、SNI更新系统证书与运行时
鉴权401/403 与 Authorization 格式重新复制 Key 并核对分组
模型路由503 与 /v1/models换用列表内模型或查看状态页
长连接流式中断与 idle timeout调整客户端读取超时并有限重试

企业网络如果使用 TLS 检查或出口代理,应由网络管理员确认策略。API Key 和请求正文可能是敏感数据,不应交给未知的二次代理。

客户端地址不要混用

Claude Code 和 Anthropic SDK 使用 https://claudeagent.com.cn 作为根地址;OpenAI SDK 与多数兼容客户端使用 https://claudeagent.com.cn/v1。多写一个或少写一个 /v1 都可能导致 404。

常见问题

国内接入是否保证所有网络都可达?

不能。实际可达性和延迟受地区、运营商、企业网络、模型和实时负载影响。

Claude Code 地址要加 /v1 吗?

不要;OpenAI-compatible 客户端才通常使用 /v1。