国内调用 OpenAI、Claude 和 Gemini API 的代理:选择与配置
OpenAI、Anthropic 和 Google 的 API 对来自中国大陆和俄罗斯的请求返回什么,代理与 API 中转有何区别,服务器适合哪种代理,以及如何在 Python、Node.js 和命令行工具中配置。
关键要点
从中国大陆的网络连接 api.openai.com 和 Gemini API 时,TCP 连接超时,api.anthropic.com 返回 403 Request not allowed。
从俄罗斯的地址请求时,OpenAI 返回 403 Country, region, or territory not supported,Anthropic 返回 403 Request not allowed,两者都在检查密钥之前拒绝。
Gemini API 返回 400 User location is not supported for the API use,并且先检查密钥,再检查国家。
OpenAI 和 Anthropic 使用位于支持国家的数据中心代理就足够。Gemini 我们推荐 ISP 代理。
Python 库、Codex CLI、Gemini CLI 和 Claude Code 都读取 HTTPS_PROXY。Node.js 只有在设置 NODE_USE_ENV_PROXY=1 时才读取该变量。
使用代理时,账号和密钥都归您所有,连接一直加密到 API。
快速对比
| 因素 | OpenAI | Anthropic (Claude) | Google (Gemini) |
|---|---|---|---|
| 中国大陆,无密钥 | TCP 连接超时 | 403 Request not allowed | TCP 连接超时 |
| 俄罗斯,无密钥 | 403,不支持该国家 | 403 Request not allowed | 403,与德国相同 |
| 德国,无密钥 | 401,需要密钥 | 401,需要密钥 | 403 PERMISSION_DENIED |
| 先检查什么 | 国家 | 国家 | 密钥 |
| Python 中的代理 | HTTPS_PROXY 或 DefaultHttpxClient | HTTPS_PROXY 或 DefaultHttpxClient | HTTPS_PROXY 或 HttpOptions |
| Node.js 中的代理 | NODE_USE_ENV_PROXY 或 undici | NODE_USE_ENV_PROXY 或 undici | NODE_USE_ENV_PROXY |
| 命令行工具中的代理 | HTTPS_PROXY (Codex) | HTTPS_PROXY (Claude Code) | HTTPS_PROXY (Gemini CLI) |
从中国大陆和俄罗斯请求时 API 返回什么
2026 年 11 月 15 日,我们从上海、成都和武汉的网络,以及莫斯科和圣彼得堡的托管服务器,向 OpenAI、Anthropic 和 Google 的 API 发送了相同的请求,并以德国的一台服务器作为对照。请求不带密钥,因此结果反映的是服务在检查账号之前如何处理请求地址。
从中国大陆连接 api.openai.com 和 generativelanguage.googleapis.com 时,TCP 连接在建立之前就超时了,请求根本没有到达 API。api.anthropic.com 可以连上,并返回 403 和 Request not allowed。
从俄罗斯的地址请求时,OpenAI 返回 403 和错误码 unsupported_country_region_territory。同样的请求从德国发出,得到的是 401,提示需要密钥。可见国家检查在前。
Anthropic 对俄罗斯地址同样返回 403 Request not allowed,从德国则返回 401,要求提供 x-api-key 请求头。
Google 先检查密钥。不带密钥或密钥无效时,俄罗斯和德国得到的回答完全相同,因此 Gemini 的地址只能通过带有效密钥的请求来测试。
HTTP/1.1 403 Forbidden
{
"error": {
"code": "unsupported_country_region_territory",
"message": "Country, region, or territory not supported",
"param": null,
"type": "request_forbidden"
}
}HTTP/1.1 403 Forbidden
{
"error": {
"type": "forbidden",
"message": "Request not allowed"
}
}“OpenAI 和 Anthropic 先按请求地址检查国家,再检查密钥。因此即使请求不带密钥,也会收到 403。”
Country, region, or territory not supported 与 User location is not supported
Country, region, or territory not supported,错误码 unsupported_country_region_territory,是 OpenAI 在请求地址位于不受支持国家时返回的回答。它在检查密钥之前就返回,因此换一个密钥或账号都不会改变结果。Codex CLI 会把 API 的回答显示为 unexpected status 403 Forbidden 加上同样的文字。
User location is not supported for the API use,代码 400 FAILED_PRECONDITION,是 Gemini API 的回答。Google 先检查密钥,因此只有带有效密钥的请求才会收到这个错误。
Request not allowed,代码 403,是 Anthropic API 的回答。
位于支持国家的服务器也可能出现这些错误。服务看的是请求出网时的地址,而这个地址可能与服务器所在国家不同。修改代码之前,请先检查服务器的出口地址。
关于 Gemini,Google 开发者论坛上有一个案例:一台法国的服务器收到 User location is not supported,而法国在 Google 的列表中,同一台服务器调用 Anthropic API 却一切正常。
代理能改变什么,不能改变什么
代理改变的是请求到达 API 时的来源地址。如果这个地址位于服务商列表中的国家,请求就会进入密钥检查。密钥、账号、付款方式和手机验证都保持不变。
每家服务商都公布了国家列表。OpenAI 在支持国家页面上写明,在列表以外的国家和地区访问其服务,可能导致账号被封禁或暂停。Anthropic 的支持地区政策以用户及其组织所在地为准。Google 公布了 Gemini API 和 AI Studio 可用的国家列表。中国大陆和香港都不在这三份列表中。
连接之前,请阅读您所使用服务商的条款。Proxya 无法保证服务商会如何评估某个具体账号。
代理与 API 中转的区别
国内也有 API 中转服务。中转服务以人民币收费,发放自己的密钥,再用自己的账号把请求转发给服务商。
使用代理时,账号和密钥都归您所有,账单由服务商直接开给您。从您的服务器到 API 的整条连接都是加密的:代理只传递加密的数据流,看不到密钥,也看不到请求内容。
中转服务要换上自己的密钥,就必须在自己的服务器上以明文接收您的请求。选择哪种方式,取决于您是否拥有服务商的账号和付款方式。
选择哪种代理
对 API 来说,只有一点重要:地址要位于服务商列表中的国家。
数据中心代理,低至 $1.70/个/月,适用于 OpenAI 和 Anthropic。在我们的测试中,从德国一个托管地址发出的请求,两者都返回了 401,说明地址被接受,API 已转入密钥检查。
ISP 代理,低至 $2.50/个/月,是我们为 Gemini 推荐的类型。地址注册在互联网服务商而不是托管商名下,整个租期内归您专用,流量不限。如果同一地址还用于网页版,例如 ChatGPT、claude.ai 和 Google AI Studio,也适合选择 ISP 代理。
住宅代理,低至 $2.40/GB,地址会轮换,按流量计费。API 不需要住宅代理。
同一账号的请求请保持在同一地址和同一国家。多个账号请使用各自的地址。
用一条命令测试代理
修改代码之前,先用 curl 测试代理地址。返回 401 表示 API 接受了该地址,正在等待密钥。返回带有国家错误的 403,表示该地址位于不受支持的地区。
使用 SOCKS5 时请写 socks5h。这样 api.openai.com 由代理解析,而不是由您本地的 DNS 服务器解析。
这种测试不适用于 Gemini:不带密钥时,任何国家得到的回答都一样。请在代码中用带密钥的请求来测试。
# 401:地址已被接受,API 等待密钥
# 带国家错误的 403:地址位于不受支持的地区
curl -x http://USER:PASS@HOST:PORT https://api.openai.com/v1/models
curl -x http://USER:PASS@HOST:PORT https://api.anthropic.com/v1/models
# SOCKS5:由代理解析域名
curl -x socks5h://USER:PASS@HOST:PORT https://api.openai.com/v1/modelsPython:OpenAI、Anthropic 和 Gemini
三个官方库在创建客户端时都会读取 HTTPS_PROXY 变量。这是最简单的方式,代码无需改动。
如果只希望 API 请求经过代理,而应用的其他流量不经过,请在客户端中直接设置地址。OpenAI 和 Anthropic 为此提供 DefaultHttpxClient,Google 使用 HttpOptions 中的 client_args 参数。Gemini 的异步客户端在 async_client_args 中传入同一地址。
我们通过一个记录连接的本地代理,在当前版本的库上测试了这两种方式。三个库都把域名交给代理,因此 DNS 查询由代理完成。
# 该变量对整个进程生效
export HTTPS_PROXY=http://USER:PASS@HOST:PORT
python app.py# 仅对当前窗口生效
$env:HTTPS_PROXY = "http://USER:PASS@HOST:PORT"
python app.py# 只有这些客户端经过代理
from openai import OpenAI, DefaultHttpxClient
from anthropic import Anthropic, DefaultHttpxClient as AnthropicHttpxClient
from google import genai
from google.genai import types
PROXY = "http://USER:PASS@HOST:PORT"
openai_client = OpenAI(http_client=DefaultHttpxClient(proxy=PROXY))
claude_client = Anthropic(http_client=AnthropicHttpxClient(proxy=PROXY))
gemini_client = genai.Client(
http_options=types.HttpOptions(client_args={"proxy": PROXY}),
)Node.js
Node.js 内置的 fetch 默认不读取 HTTPS_PROXY。设置 NODE_USE_ENV_PROXY=1,或以 --use-env-proxy 参数启动 node 后,才会使用该变量。Node.js 24 支持此功能,Node.js 22 从 22.21 开始支持。
OpenAI、Anthropic 和 Google 的库都使用这个 fetch,因此对三者来说设置变量就足够了。
第二种方式通过 undici 包在客户端中设置代理,fetch 和 ProxyAgent 要从同一个包中引入。如果只传入 ProxyAgent 而不使用该包的 fetch,OpenAI 库会报连接错误。
整个进程请只用一种方式。在我们的测试中,加载 undici 包之后,内置 fetch 不再读取代理变量,Gemini 库的请求直接发了出去,没有经过代理。
# Node.js 24,或 22.21 及更新版本
export NODE_USE_ENV_PROXY=1
export HTTPS_PROXY=http://USER:PASS@HOST:PORT
node app.js// fetch 和 ProxyAgent 来自同一个包
import OpenAI from "openai";
import Anthropic from "@anthropic-ai/sdk";
import { fetch, ProxyAgent } from "undici";
const dispatcher = new ProxyAgent("http://USER:PASS@HOST:PORT");
const openai = new OpenAI({ fetch, fetchOptions: { dispatcher } });
const claude = new Anthropic({ fetch, fetchOptions: { dispatcher } });Codex、Gemini CLI、Claude Code 和没有代理设置的程序
Codex CLI 和 Gemini CLI 都读取 HTTPS_PROXY 变量。在我们的测试中,它们的全部连接都经过了代理:Codex 连接 api.openai.com、chatgpt.com 和 github.com,Gemini CLI 连接 generativelanguage.googleapis.com 和 play.googleapis.com。Gemini CLI 设置中的 proxy 参数在我们的测试中没有让流量改走代理,因此请使用环境变量。
Claude Code 同样读取 HTTPS_PROXY,不支持 SOCKS 代理。完整配置,包括通过本地端口使用 SOCKS5,见另一篇指南。
对于没有代理设置的程序,请使用 Proxya Desktop 的隧道模式。它让电脑的全部流量经过代理,程序照常连接即可。
# Codex CLI、Gemini CLI 和 Claude Code 读取同一个变量
export HTTPS_PROXY=http://USER:PASS@HOST:PORT
codex
gemini
claude服务器上的注意事项
如果同一台服务器上还运行着其他服务,请在 API 客户端中设置代理。HTTPS_PROXY 对整个进程生效,也包括发往其他外部服务的请求。
使用环境变量时,请在 NO_PROXY 中列出需要直连的地址:localhost、内部域名和内网地址。
推理模型的回答可能需要几分钟。如果长请求中途断开,请开启流式输出,让数据在连接上持续传输。
代理地址及其用户名和密码应与 API 密钥一起保存在环境变量或密钥管理服务中,不要写在代码里。
常见问题
在我们的测试中,从中国大陆的网络连接 api.openai.com 时,TCP 连接超时,请求没有到达 API。从俄罗斯地址请求则返回 403 和错误码 unsupported_country_region_territory。
OpenAI 判定请求来源地址所在的国家不受支持。该回答带有 403 代码,并在检查密钥之前返回。如果服务器位于支持的国家,请检查它的出口地址。
这是 Gemini API 对来自不受支持地区请求的回答,代码为 400 FAILED_PRECONDITION,只有带有效密钥的请求才会收到。开发者反映,位于支持国家的服务器地址也会遇到这个错误,因此 Gemini 我们推荐 ISP 代理。
这是 Anthropic API 对来自不受支持地区请求的回答。在我们的测试中,来自中国大陆和俄罗斯地址的请求都收到了 403 和这条消息。从支持国家的地址发出同样不带密钥的请求,得到的是 401。
使用代理时,您用的是自己的账号和密钥,账单由服务商开出,连接一直加密到 API。中转服务通过自己的账号出售访问权限,并在自己的服务器上接收您的请求。
位于 Google 列表中国家的 ISP 代理。地址注册在互联网服务商而不是托管商名下,整个租期内不变。
位于 OpenAI 支持国家的数据中心代理或 ISP 代理。从服务器发出请求时,数据中心代理就足够。如果同一地址还要用于 ChatGPT 网站,请选择 ISP 代理。
Proxya 的代理支持 HTTP 和 SOCKS5。对于 SDK 和命令行工具,HTTP 更简单:本文中的所有库无需额外安装即可使用 HTTP 代理,而 Claude Code 不支持 SOCKS。
Google 先检查密钥,再检查国家。API key not valid 表示密钥有误,与地址无关。请先核对密钥,再通过代理发送带有效密钥的请求。
如果这些密钥属于同一个账号,可以。不同账号建议使用各自的地址。
服务商把访问权限与用户所在国家关联。OpenAI 写明,从列表以外的国家访问可能导致账号被封禁或暂停。我们无法保证服务商会如何评估某个具体账号。