deepseek v4 代理失效需按五步排查：一、验证 http_proxy/https_proxy 环境变量是否生效；二、确保两变量协议一致且 url 编码合规；三、检查代理软件规则是否绕过 api.deepseek.com；四、gui 应用需进程级注入代理参数；五、通过日志、curl 和抓包交叉验证链路。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已为 DeepSeek V4 配置代理，但请求仍直连失败或返回连接超时，则很可能是环境变量未被正确加载、代理规则格式不兼容，或代理软件未按预期拦截 DeepSeek 客户端流量。以下是解决此问题的步骤：
一、验证环境变量是否生效
DeepSeek V4 客户端（如通过 Anthropic 兼容 API 调用）依赖系统级 HTTP_PROXY / HTTPS_PROXY 环境变量进行代理路由。若变量未被进程继承，代理将完全失效。
1、在终端中执行 echo $HTTP_PROXY（Linux/macOS）或 echo %HTTP_PROXY%（Windows CMD）确认变量已设置。
2、若输出为空，说明环境变量未设置或未持久化。需重新配置并确保新开终端窗口生效。
3、对于 Node.js 进程（如运行 Claude Code 的环境），还需验证其是否读取用户级变量：启动前在 Shell 中执行 export NODE_OPTIONS="--no-warnings" 并再次检查变量值。
二、修正代理规则格式与协议匹配
DeepSeek V4 的请求默认使用 HTTPS 协议，若仅配置 HTTP_PROXY 而未同步设置 HTTPS_PROXY，部分客户端（尤其是基于 Node.js 的实现）会忽略代理，导致直连失败。
1、确保同时设置两个变量，且地址协议一致：HTTP_PROXY=http://127.0.0.1:1080 与 HTTPS_PROXY=http://127.0.0.1:1080（注意：此处使用 http:// 前缀，非 https://，因多数本地代理（Clash/V2Ray）监听 HTTP 代理协议）。
2、禁止在代理 URL 中混用认证信息与特殊字符未编码：隧道 ID 或密码含 @ / : / / 等字符时，必须进行 URL 编码，例如 user@domain 应编码为 user%40domain。
3、避免使用 SOCKS5 代理直接赋值给 HTTP_PROXY：SOCKS 代理需显式声明协议，如 HTTP_PROXY=socks5://127.0.0.1:1080，否则会被忽略。
三、绕过代理软件的规则冲突
某些代理客户端（如 Clash for Windows、Surge）默认启用“TUN 模式”或“全局规则”，可能因域名匹配策略跳过 api.deepseek.com 的代理转发，或将其误判为直连域名。
1、打开代理软件界面，进入「规则」或「Rule Providers」设置页。
2、查找是否存在类似 DOMAIN-SUFFIX,deepseek.com,DIRECT 或 FINAL,DIRECT 的兜底规则，将其临时禁用或修改为 PROXY。
3、手动添加强制代理规则：DOMAIN,api.deepseek.com,PROXY，保存后重启代理核心。
四、启用进程级代理注入（适用于 GUI 应用）
若 DeepSeek V4 以桌面应用形式运行（如 Electron 封装的 Claude Code），其可能不继承 Shell 环境变量，需通过启动参数强制注入代理配置。
1、定位应用启动脚本或快捷方式目标路径，例如 Windows 下为 "C:\Program Files\Claude Code\claude-code.exe"。
2、右键快捷方式 → 属性 → 在“目标”末尾添加： --proxy-server="http://127.0.0.1:1080"（注意空格）。
3、Linux/macOS 用户可创建 wrapper 脚本，在启动命令前插入 HTTP_PROXY=http://127.0.0.1:1080 HTTPS_PROXY=http://127.0.0.1:1080 前缀再执行原命令。
五、验证代理链路是否真正生效
仅检查环境变量或代理软件界面无法确认流量实际走向，必须通过底层网络观测手段交叉验证。
1、启动代理软件日志功能，过滤关键词 api.deepseek.com 或 443，确认有出站连接记录。
2、在另一终端执行：curl -v https://api.deepseek.com/health --proxy http://127.0.0.1:1080，观察响应头中是否出现 Via 或 X-From-Proxy 字段。
3、使用 Wireshark 抓包，筛选目标 IP（可通过 nslookup api.deepseek.com 获取），若源地址显示为本地代理端口（如 1080），而非真实公网出口，则代理链路已通。
