JetBrains AI 使用
在国内使用 JetBrains 系列 IDE(如 IntelliJ IDEA、WebStorm、PyCharm 等)接入 OpenAI、Claude 等 AI 编程助手时,很多人都会遇到一个问题:即使电脑已经设置了代理,JetBrains AI 仍然无法连接或报错无法访问 API。
本文将详细说明为什么会出现这种情况、如何正确设置 JetBrains 的代理、以及选择什么样的节点才能真正访问 OpenAI 或 Claude,并附上实用的操作建议。
一、特别注意:JetBrains AI 设置中的「地区」必须改为海外
极其重要:JetBrains AI 的模型可见性与设置中的地区配置直接相关!
如果你在 JetBrains 中使用 AI 功能,发现 只能看到“千问”(Qwen)模型,没有 OpenAI 或 Claude 模型可选,那么原因可能是:
地区设置选成了「中国」或自动定位为中国
解决方法:
- 打开 AI Settings:
Settings > Tools > AI Assistant > Providers > Region > Change找到
Region(地区)设置项将地区设置为:
美洲(Americas)
或 欧洲、日本、新加坡等可用地区
应用设置后,重新加载 AI 提供商列表
这时你会发现:
OpenAI、Claude、StarCoder 等模型都会出现,不再只剩下千问。
二、现象:JetBrains AI 无法使用,即使系统已开启代理
你可能会遇到下面这些情况:
ClashX、Shadowrocket 等代理已启动并开启“增强模式”;
浏览器访问 ChatGPT 正常;
但 JetBrains AI 功能(如 AI Assistant)报错:
Cannot connect to OpenAI API;即使你全局翻墙、改了 hosts,也一样不通。
这是为什么?答案是——JetBrains 不走系统代理。
三、原理:JetBrains 使用独立网络栈,不读取系统代理设置
JetBrains 是基于 Java 开发的桌面应用,它的网络请求使用的是 Java 的网络栈(JVM),不会自动读取 macOS 或 Windows 的系统代理设置,哪怕你打开了 ClashX 的系统增强模式,也无法生效。
JetBrains 与 Git 类似,默认都不会走系统代理,必须手动设置才能生效。
四、解决方案:手动配置 JetBrains 的代理
操作路径:
- 打开 IDE 设置:
Settings > Appearance & Behavior > System Settings > HTTP Proxy勾选:
Manual proxy configuration输入 ClashX 的代理地址:
Host:
127.0.0.1Port:
7890(HTTP)或7891(SOCKS5),根据你的 Clash 配置选择
勾选
Use proxy authentication(如有账号密码)点击
Check connection测试是否成功点击
OK保存即可
五、关于节点:代理节点不能是中国或香港地区
JetBrains 配置正确后,仍然可能连不上 AI 模型,问题可能出在你使用的代理节点不合规。
正确的节点选择:
| 地区 | 是否推荐 | 说明 |
|---|---|---|
| 🇺🇸 美国 | ✅ 强烈推荐 | 官方支持地区,最稳定 |
| 🇯🇵 日本 | ✅ 推荐 | 速度快,延迟低 |
| 🇸🇬 新加坡 | ✅ 推荐 | 东南亚优选,OpenAI 支持 |
| 🇰🇷 韩国 | ✅ 推荐 | Claude、OpenAI 都支持 |
| 🇭🇰 香港 | ❌ 不推荐 | 已被 OpenAI/Claude 限制或封禁 |
| 🇨🇳 中国大陆 | ❌ 完全不支持 | 全面屏蔽 |
| 🇹🇼 台湾 | ⚠️ 不稳定 | 某些 IP 段可能被封锁 |
六、附录:代理工具的 TUN 模式 / 增强模式对 JetBrains 为何无效?
很多人误以为开启了 ClashX 的增强模式或 TUN 模式,JetBrains 就可以“自动走代理”,但实际上它根本不会生效。
常见代理模式对比
| 模式 | 原理 | 对系统软件有效 | JetBrains 有效? |
|---|---|---|---|
| 系统代理 | 设置网络首选项或 http_proxy 环境变量 | ✅ 多数软件 | ❌ 无效 |
| 增强模式 | PAC + 网络劫持 | ✅ 浏览器类应用 | ❌ 无效 |
| TUN 模式 | 虚拟网卡,重定向 TCP/IP | ✅ 全局拦截 | ❌ 无效 |
| 手动代理 | 应用自己配置代理 | ✅ | ✅ 有效 |
原因分析:
JetBrains 是 Java 应用,使用的是 JVM 的网络栈,不读取系统代理或 OS 网络设置;
Java 中很多网络操作(如
HttpURLConnection、Socket)不会自动走 TUN 流;只有在 JetBrains 的 IDE 中手动设置代理,它才会走你想要的链路。
七、JetBrains AI 使用总结和注意事项
操作步骤总结:
在 JetBrains 的 AI 设置中手动设置地区为“美洲”或其他官方支持区域
使用 ClashX 等代理工具,确保代理正常且为海外节点(非香港/中国)
手动在 JetBrains 中配置代理,不依赖系统代理
测试 API 是否通畅(curl 方式或 test connection)
⚠️ 常见问题排查清单:
JetBrains 的地区设置是否改为美洲或其他?
是否设置了 JetBrains 的手动代理?
使用的节点是否为中国、香港、台湾?(如是,请换节点)
是否使用了被滥用的机场节点,可能被平台封锁?
结语
JetBrains AI 在中国大陆的使用受到诸多限制,但只要掌握正确的方式:配置独立代理、选择正确节点、手动调整地区设置,就可以顺利接入 OpenAI、Claude 等强大模型,提升开发效率。
别再被“只能用千问”限制住了,换个地区、配对节点,完整世界就打开了。