Gemini 与 Google AI Studio 网络环境配置

问题说明

Gemini（gemini.google.com）和 Google AI Studio（aistudio.google.com）都按访问地区提供服务。与其他 AI 工具相比，Google 的服务域名更多、账号体系更复杂，常见问题包括：提示地区不可用、页面不断跳转、AI Studio 能打开但调用模型报错，以及 API 在终端中返回地区错误。

操作步骤

第 1 步：选择支持地区的节点

Gemini 与 AI Studio 在许多国家和地区可用，但中国内地和中国香港不在支持范围内。建议选择美国、日本、新加坡等地区的节点。各地区节点在 AI 工具上的对比，可以参考 不同地区节点在 AI 工具上的表现。

切换节点后，建议使用无痕窗口重新打开，避免浏览器缓存了之前的地区判断结果。

第 2 步：统一 Google 相关域名的出口

登录、页面、接口分别使用不同的 Google 域名。如果其中一部分走了直连或另一个节点，就可能出现反复跳转登录或页面加载不完整。在 Clash 系客户端中，可以用类似下面的规则把 Google 流量统一交给一个代理组（示例名为 AI）：

rules:
  - DOMAIN-SUFFIX,gemini.google.com,AI
  - DOMAIN-SUFFIX,aistudio.google.com,AI
  - DOMAIN-SUFFIX,generativelanguage.googleapis.com,AI
  - DOMAIN-SUFFIX,google.com,AI
  - DOMAIN-SUFFIX,googleapis.com,AI
  - DOMAIN-SUFFIX,gstatic.com,AI

更具体的域名放在前面，宽泛的放在后面。规则匹配顺序的原理见 分流规则：让 AI 流量走对节点。

第 3 步：检查账号的地区信息

Google 在判断服务可用性时，除了 IP 地区外，也可能参考账号关联的国家或地区。在 Google 账号的服务条款页面中可以看到当前账号适用的国家或地区版本。如果它与使用地区长期不一致，部分服务可能受限。这类信息通常不能随意修改，建议保持稳定的使用地区。

第 4 步：为 Gemini API 设置终端代理

在 AI Studio 中创建 API Key 后，如果要在终端或脚本中调用，需要让终端走代理。端口以你的代理客户端设置为准，示例使用 7890：

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export GEMINI_API_KEY="你的 API Key"

PowerShell：

$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:GEMINI_API_KEY="你的 API Key"

终端代理的更多细节可参考 Claude Code 终端网络配置，方法是通用的。

第 5 步：手机端使用

在手机上使用 Gemini App 时，代理客户端以系统 VPN 方式运行，同样需要选择支持地区的节点。切换节点后建议完全关闭 App 再打开，让它重新判断地区。如果手机与电脑使用同一个 Google 账号，尽量让两端的出口位于同一地区，避免账号在短时间内出现多个国家的登录记录。

验证是否生效

网页端：打开 Gemini 和 AI Studio，能正常进入对话界面、发送消息即可。

API 端：列出可用模型，能返回 JSON 列表即说明网络和地区都没有问题：

curl "https://generativelanguage.googleapis.com/v1beta/models" \
  -H "x-goog-api-key: $GEMINI_API_KEY"

如果返回中包含 User location is not supported for the API use，说明出口地区不受支持；如果命令长时间无响应，说明终端没有走代理。

常见错误

• 使用香港节点：网页提示不可用，API 返回地区错误。
• 只代理了 gemini.google.com：登录相关域名走直连，导致反复跳转。
• 把 API Key 写进脚本并提交到仓库：Key 泄露后应立即在 AI Studio 中删除并重新创建。

问题排查

1. 用无痕窗口测试，排除缓存与扩展的影响。
2. 将代理客户端临时切到全局模式，判断是否为规则问题。
3. 同时测试网页和 API：网页正常而 API 失败，多为终端未走代理；两者都失败，多为节点地区问题。

更多内容见 Gemini 专题 与 Google AI Studio 专题。