先定位失败发生在哪一层
Claude Code 的请求链路通常包括本地终端、环境变量、代理客户端或协议库、DNS、出口网络、TLS 和目标服务。任何一层都可能表现成超时或连接重置。最有效的排障方式不是反复更换 IP，而是保留同一出口，逐层确认解析、握手和目标响应。
LyProxy 可提供静态住宅 IP 与 HTTP/SOCKS5 接入。具体国家、线路、认证格式、库存和价格属于动态产品信息；本页只说明通用配置与验收方法。Anthropic 的产品支持范围、账号规则和地区政策应以 Anthropic 官方文档为准。
LyProxy 产品信息与 Claude Code 配置的对应关系
对 Claude Code 这类终端工具，最关键的产品字段不是宣传词，而是代理主机、端口、认证方式、协议、出口国家和有效期。静态住宅 IP 有利于减少长期开发环境中的网络变量；如果客户端只明确支持 HTTP 代理，就应使用兼容路径，而不是因为产品提供 SOCKS5 就强行套用。
LyProxy 负责交付网络出口和对应凭据，目标工具是否读取环境变量、是否支持远程 DNS、账号是否有权限以及 Anthropic 服务是否正常，分别属于客户端、账号和第三方服务层。把这些责任边界写清，客服与技术团队才能根据证据定位问题，而不是把所有错误归结为“代理不行”。
配置路径对比
| 路径 | 适用情况 | 优点 | 常见故障 | 验证方式 |
|---|---|---|---|---|
| HTTP/HTTPS 环境变量 | 运行环境明确支持 HTTP 代理 | 配置直观，日志易定位 | 变量未继承、认证字符未编码 | 在同一 shell 检查变量并请求目标 |
| SOCKS5 / ALL_PROXY | 客户端或包装工具明确支持 | 适配更多 TCP 场景 | DNS 仍在本地解析、库不支持 socks5h | 分别测试本地与远程 DNS |
| 系统级代理客户端 | 多个工具共享同一出口 | 集中管理规则 | 分流规则、TUN/DNS 冲突 | 检查命中规则和出口 IP |
| 固定静态住宅出口 | 长期开发与重复排障 | 变量更少、便于复现 | 把账号或平台问题误判为网络问题 | 记录直连/代理对照结果 |
10 分钟分层排障流程
- 在同一个终端确认代理变量实际存在，认证信息中的特殊字符已经正确编码，且子进程能继承变量。
- 先请求一个公开 IP/地区检查端点，再请求 Anthropic 官方目标；分别记录 DNS、连接、TLS、HTTP 状态和总耗时。
- 临时对照直连、HTTP 代理与 SOCKS5 路径。若只有某一协议失败，应检查客户端支持与 DNS 模式，而不是立即替换账号或出口。
- 保留命令、时间、出口、错误码和响应头；删除令牌、密码和代理凭据后再交给团队或客服。
不要把网络、账号和服务状态混在一起
连接成功只能证明到目标的网络链路可用，不能证明账号有权限、地区受支持、配额充足或服务没有故障。
出现 401/403 时优先检查令牌、账号、组织与官方地区政策；出现 DNS/连接/TLS 错误时再集中排查网络层。
生产团队应把代理凭据放入秘密管理，不要写入仓库、截图、公开工单或可被前端下载的配置文件。
15 秒 PoC 流程演示
先定义目标市场，再测试链路并记录证据；只有结果可复现，才进入扩容决策。
常见问题
Claude Code 必须用 SOCKS5 吗？
不必须。应使用运行环境明确支持的代理路径；HTTP/HTTPS 环境变量通常更直观，SOCKS5 需确认客户端和 DNS 模式。
为什么浏览器能用，Claude Code 仍超时？
浏览器与终端可能使用不同代理规则、DNS 或证书链。需要在 Claude Code 所在的同一终端验证。
SOCKS5 和 socks5h 有什么区别？
常见实现中 socks5h 表示通过代理端解析域名，可避免本地 DNS 路径不同；是否支持取决于客户端。
401/403 是代理坏了吗？
通常不是直接证据。应先检查令牌、账号权限、组织、地区政策和目标服务响应。
日志应该保留什么？
保留时间、协议、出口国家、DNS/连接/TLS/HTTP 阶段、错误码和耗时；共享前删除全部凭据。
来源、引用与信息边界
每条来源只支持旁边标注的具体信息。LyProxy 的实时库存、线路、运营商与价格仍需在采购时确认。
- LyProxy 静态住宅代理第一方产品入口；实时资源以控制台为准
- Anthropic Claude Code settingsClaude Code 官方设置说明
- Anthropic status区分官方服务故障与本地网络问题
- IETF RFC 1928: SOCKS5SOCKS5 协议定义
- MDN: Proxy servers and tunnelingHTTP 代理与隧道背景
- IETF RFC 9110: HTTP SemanticsHTTP 状态与语义
下一步
先完成一轮有记录的小规模 PoC，不要根据一次测速直接扩大采购。