代码里调用 OpenAI、Claude API 怎么走代理：Python、Node.js 与服务器三种场景

为什么浏览器能用，代码却超时

客户端的“系统代理”主要给浏览器和部分桌面 App 用，你写的 Python、Node.js 程序不一定理会它，于是请求直接发往 api.openai.com 或 api.anthropic.com，在国内网络下表现为连接超时。解决思路分三种场景：本地脚本设置环境变量或在代码里显式指定代理；Node.js 额外处理内置 fetch；线上服务器尽量部署在 API 支持地区，不走代理。下文以 127.0.0.1:7890 举例，端口以客户端设置中显示的 HTTP / 混合端口为准。

先设环境变量：最通用的一步

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1

Windows PowerShell、CMD 的写法和长期生效方法见 终端代理设置。设置后用 curl 确认网络通了，能拿到 HTTP 状态码（哪怕是 401）就说明代理生效：

curl -sS -o /dev/null -w "%{http_code}\n" https://api.anthropic.com/v1/models

Python：requests、httpx 与官方 SDK

环境变量对 requests 和 httpx 都有效。需要在代码里写死（比如只让这一个脚本走代理）时：

import os
import requests

proxies = {"http": "http://127.0.0.1:7890", "https": "http://127.0.0.1:7890"}
r = requests.get(
    "https://api.openai.com/v1/models",
    headers={"Authorization": f"Bearer {os.environ['OPENAI_API_KEY']}"},
    proxies=proxies,
    timeout=30,
)
print(r.status_code)

httpx 的较新版本用 proxy 参数，较旧版本是 proxies，以所用版本文档为准：

import httpx

with httpx.Client(proxy="http://127.0.0.1:7890", timeout=30) as client:
    print(client.get("https://api.anthropic.com/v1/models").status_code)

OpenAI 与 Anthropic 的 Python SDK 底层使用 httpx，通常也会读取环境变量；想单独控制时，可以通过 http_client 参数传入自定义客户端：

import httpx
from openai import OpenAI
from anthropic import Anthropic

proxy_client = httpx.Client(proxy="http://127.0.0.1:7890")
openai_client = OpenAI(http_client=proxy_client)        # 读取 OPENAI_API_KEY
claude_client = Anthropic(http_client=proxy_client)     # 读取 ANTHROPIC_API_KEY

直接传入 httpx.Client 会替换 SDK 的默认超时等设置，SDK 一般另提供保留默认值的包装类，具体以所用 SDK 版本的文档为准。

Node.js：给 fetch 设置全局代理

Node.js 内置的 fetch 基于 undici，但在很多版本中不会自动读取 HTTPS_PROXY。用 undici 包提供的 ProxyAgent 设置全局 dispatcher：

import { ProxyAgent, setGlobalDispatcher } from 'undici';

const proxy = process.env.HTTPS_PROXY;
if (proxy) setGlobalDispatcher(new ProxyAgent(proxy));

const res = await fetch('https://api.openai.com/v1/models', {
  headers: { Authorization: `Bearer ${process.env.OPENAI_API_KEY}` },
});
console.log(res.status);

只在设置了环境变量时启用代理，部署到海外服务器时代码不用改。如果全局设置对内置 fetch 没有生效，改用从 undici 导入的 fetch。官方 Node SDK 底层同样基于 fetch，多数情况下全局 dispatcher 会一并生效；SDK 也支持传入自定义请求选项，参数名以所用版本文档为准。

服务器：优先部署在支持地区

线上服务不建议依赖梯子：节点切换、订阅到期都会让接口直接不可用。更稳的做法是把调用 API 的服务放在 OpenAI、Anthropic 支持地区的云服务器上（支持地区以官方页面为准），各平台的地区要求见 ChatGPT 专题 与 Claude 专题。

如果只是在自己的 Linux 开发机上临时调试，可以参考 Linux 梯子配置 运行代理内核。两个常见坑：

• systemd 服务不读 shell 配置：在 unit 文件里用 Environment=HTTPS_PROXY=... 写入。
• 容器里的 127.0.0.1 指向容器自己：要填宿主机可达的地址，Linux 上可用 --add-host=host.docker.internal:host-gateway 把宿主机映射进来。

API Key 怎么保管