1. IDEA 插件市场提示未加载 Marketplace 插件,先别急着重装
你打开 IDEA,点进 Settings → Plugins,本来想装个 Lombok 或者 MyBatisX,结果页面顶部弹出一行红字:Marketplace plugins are not loaded. Check the internet connection and refresh。点刷新按钮,转两圈,还是这行字。重启 IDEA,没用。换网络,好像也没用。
这个报错在国内开发者里出现频率极高,但它其实不是 IDEA 坏了,也不是插件市场挂了,而是 IDEA 内置的 HTTP 客户端在访问plugins.jetbrains.com时握手失败或者超时。IDEA 的插件市场请求走的是它自己的网络栈,和你浏览器能不能打开网页是两回事。浏览器能开,不代表 IDEA 能开,因为 IDEA 默认不读系统代理,也不读你浏览器里的那套配置。
所以排查顺序应该是:先确认 IDEA 的 HTTP 代理设置,再确认请求出口是否可达,最后才是考虑手动下载插件兜底。这篇就按这个顺序走,从 HTTP 代理配置讲到统一 API 通道的接入,每一步都给可复制的配置和验证动作。适合所有被这行红字卡住、想一次弄明白而不是反复重启的 IDEA 用户。
核心检索词先摆出来:IDEA 插件市场未加载 Marketplace 插件,本质是 IDEA 的 HTTP 代理链路没配通。你要做的是让 IDEA 的请求有一个稳定、可达的出口,而不是反复点刷新。
2. 先定位:IDEA 的 HTTP 代理到底读的是哪份配置
很多人第一反应是去系统设置里改代理,或者去浏览器里改,改完发现 IDEA 还是那行红字。原因是 IDEA 有自己独立的代理配置入口,优先级和系统代理不一样。
2.1 三个容易混淆的代理入口
IDEA 里跟网络相关的设置分散在几个地方,我列一下你对照着看:
| 入口路径 | 作用范围 | 是否影响插件市场 |
|---|---|---|
| Settings → Appearance & Behavior → System Settings → HTTP Proxy | IDEA 全局 HTTP 代理 | 是,主要看这个 |
| Settings → Tools → HTTP Proxy(部分版本) | 同上,版本差异 | 是 |
| 系统环境变量 HTTP_PROXY / HTTPS_PROXY | 进程级 | 部分场景生效,不稳定 |
| 浏览器代理 | 仅浏览器 | 否 |
关键结论:插件市场请求走的是 IDEA 自己的 HTTP Proxy 配置,你改系统代理或者浏览器代理,IDEA 不一定认。所以第一步永远是打开Settings → Appearance & Behavior → System Settings → HTTP Proxy,看这里选的是什么。
2.2 三种代理模式的区别
这个页面通常有三个选项:
- No proxy:不走代理,直连。国内直连
plugins.jetbrains.com大概率超时,就是你现在看到的现象。 - Auto-detect proxy settings:自动探测系统代理。探测逻辑不透明,经常探测不到或者探测到错的,不推荐。
- Manual proxy configuration:手动填主机和端口。这是最可控的方式,也是下面要重点讲的。
如果你现在选的是 No proxy 或者 Auto-detect,先切到 Manual,这是排查的起点。
2.3 为什么"检查互联网连接并刷新"这句话会误导人
IDEA 的报错文案写的是"检查互联网连接",但它检测的其实是"我能不能通过当前代理配置访问到插件市场"。你网是通的,只是 IDEA 这条链路不通,它就报这句话。所以别被文案带偏,重点不是"有没有网",而是"IDEA 这条请求走没走通"。
理解这一点之后,后面的操作就有方向了:要么给 IDEA 配一个能通的代理出口,要么把请求统一收敛到一个稳定的 API 通道上。前者是传统做法,后者是现在更省心的做法,两条路我都会给。
3. 可复制配置:HTTP 代理设置与统一 API 通道接入
这一节是全文的操作核心,分两部分:先把 IDEA 的 HTTP 代理配好,再把需要走统一通道的请求收敛到 TaoToken 的 API 上。两部分配置都给完整片段,你直接抄。
3.1 IDEA HTTP Proxy 手动配置
打开Settings → Appearance & Behavior → System Settings → HTTP Proxy,选Manual proxy configuration,然后选HTTP,填入:
Host name: 127.0.0.1 Port number: 7890端口号填你本地实际在用的那个。填完点Check connection,在弹窗里输入:
https://plugins.jetbrains.com如果返回Connection successful,说明 IDEA 这条链路通了,回到插件市场点刷新,红字应该消失。如果还是失败,说明你本地那个端口本身不通,或者端口填错了,先确认本地服务在跑。
注意:这里填的 127.0.0.1 和端口,指的是你本机已经在运行的一个 HTTP 出口服务。如果你本机没有这样的服务,这一步会一直失败,那就直接看 3.2 的统一通道方案。
3.2 统一 API 通道:把 Key 和 Base URL 收敛到一处
如果你不想在本地维护一个出口服务,更省心的做法是把需要联网的请求统一走 TaoToken 的 API 通道。它的作用是给你一个稳定的 Base URL 和统一的 Key,模型调用、编码辅助这类请求都从这一个口出去,不用每个工具单独配。
先拿 Key。打开控制台:
https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite在控制台里创建一个 API Key,复制出来。然后你的统一配置就是三件套:
Base URL: https://taotoken.net/api API Key: 你刚复制的那串 Model ID: 按你实际要用的模型填这三件套在下面几个场景里是通用的,配一次到处能用。
3.3 Claude Code 接入配置(settings.json)
如果你在用 Claude Code,配置文件通常在~/.claude/settings.json,写入:
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "你的API Key" } }保存后重启 Claude Code,它会读这个 Base URL 和 Key。注意 Base URL 后面不要多加/v1之类的路径,按上面这个写就行。
3.4 Cline / MCP 场景配置
如果你在 IDEA 里用 Cline 这类插件,或者配 MCP,同样填三件套。以 Cline 为例,在插件设置里选 API Provider 为 OpenAI Compatible,然后:
{ "baseUrl": "https://taotoken.net/api", "apiKey": "你的API Key", "model": "你的Model ID" }MCP 的配置如果是走 HTTP 的,也是把 Base URL 指向https://taotoken.net/api,Key 用同一个。这样你 IDEA 里的编码辅助请求和插件市场之外的联网请求,出口是统一的,排查起来只有一个地方要看。
3.5 Codex auth.json 配置
如果你用 Codex,配置文件在~/.codex/auth.json,写入:
{ "base_url": "https://taotoken.net/api", "api_key": "你的API Key" }保存后重新启动 Codex 进程。三件套里的 Model ID 在调用时指定,不在这个文件里写死。
配完这些,你的 IDEA 生态里需要联网的请求就有了一个统一出口。插件市场本身走的是 3.1 的代理配置,模型和编码辅助走 3.2 到 3.5 的统一通道,两条线互不干扰。
4. 验证请求:刷新插件市场并确认连接恢复
配置写完不算完,得验证。这一节给具体的验证动作和预期结果。
4.1 验证 IDEA 代理链路
回到Settings → Appearance & Behavior → System Settings → HTTP Proxy,点Check connection,输入https://plugins.jetbrains.com。预期结果是弹窗显示Connection successful。
然后回到Settings → Plugins → Marketplace,点右上角刷新图标。预期结果是红字消失,插件列表正常加载出来,搜索框能搜到插件。如果列表出来了但很慢,说明链路通但带宽一般,属于正常范围。
4.2 验证统一 API 通道
用 curl 直接打一下你的 Base URL,确认 Key 有效:
curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer 你的API Key" \ -H "Content-Type: application/json" \ -d '{ "model": "你的Model ID", "messages": [{"role": "user", "content": "ping"}] }'预期结果是返回一个 JSON,里面有choices字段和模型回复内容。如果返回 401,说明 Key 不对或者没带上;如果返回连接错误,说明 Base URL 写错了。这一步通了,说明你的统一通道是活的。
4.3 在 IDEA 里跑一次真实请求
打开 Cline 或者你配好的编码插件,发一句"帮我写一个 Java 的 Hello World",看它能不能正常返回。能返回,说明 IDEA 里的统一通道也通了。这一步是把 4.2 的命令行验证落到实际工具里,两者都通才算完整。
4.4 验证清单
把上面的验证整理成一张对照表,你逐项打勾:
| 验证项 | 操作 | 预期结果 |
|---|---|---|
| IDEA 代理 | Check connection 输入插件市场地址 | Connection successful |
| 插件市场 | 点刷新 | 红字消失,列表加载 |
| API 通道 | curl 打 chat/completions | 返回 choices |
| 工具内请求 | 插件里发一句话 | 正常返回内容 |
四项都过,这个问题就算彻底解决了。
5. 本篇常见错排查:401、local proxy failed、reading choices、OAuth
配置过程中最容易撞的几个报错,我按真实出现的文案逐个拆。
5.1 401 Unauthorized
这个几乎都是 Key 的问题。三种可能:Key 复制时多了空格或者少了字符;Key 没带上Bearer前缀;Key 本身在控制台里被删了或者过期了。排查动作:重新去控制台复制一次 Key,粘贴时注意前后不要有空格,Header 写成Authorization: Bearer 你的Key。如果还不行,去控制台确认这个 Key 的状态是启用。
5.2 local proxy failed / Connection refused
这个出现在 3.1 那步,Check connection 直接失败。原因是 127.0.0.1 那个端口上没有服务在跑,或者端口填错了。排查动作:确认你本机那个出口服务确实在运行,确认端口号和配置里写的一致。如果你本机根本没有这样的服务,别在这条路上耗,直接用 3.2 的统一通道方案,把需要联网的请求走 API,插件市场那步改用下面的手动安装兜底。
5.3 reading choices 相关报错
这个通常出现在统一通道调用时,报错里带reading 'choices'或者cannot read property choices。原因是返回的 JSON 结构和你预期的不一样,最常见的是 Base URL 写错了路径,比如多写了或者少写了/v1,导致请求打到了错误的端点,返回的不是标准的 chat completions 结构。排查动作:确认 Base URL 是https://taotoken.net/api,调用路径按文档拼,不要自己猜。然后用 4.2 的 curl 先验证,curl 通了再回到工具里。
5.4 OAuth 相关报错
如果你在配 Claude Code 或者 Codex 时看到 OAuth 相关的提示,通常是因为工具还在走它默认的登录流程,没读你写的配置文件。排查动作:确认配置文件路径对(Claude Code 是~/.claude/settings.json,Codex 是~/.codex/auth.json),确认 JSON 格式没写错(逗号、引号),然后完全重启工具进程,不是关窗口,是杀进程重开。工具启动时会读一次配置,不重启不生效。
5.5 插件市场还是红字,但 Check connection 是成功的
这种情况少见但存在,通常是 IDEA 缓存了旧的失败状态。排查动作:File → Invalidate Caches → Invalidate and Restart,重启后再进插件市场。如果还不行,检查 IDEA 版本是不是太老,老版本的插件市场端点可能变了,升级 IDEA 到较新版本再试。
5.6 手动安装兜底
如果代理这条路你实在走不通,插件市场又急着用,可以手动装。去plugins.jetbrains.com搜你要的插件,下载对应 IDEA 版本的.zip,然后Settings → Plugins → 齿轮图标 → Install Plugin from Disk,选下载的文件。这是兜底方案,不解决联网问题,但能让你先把活干了。
6. 把出口收敛到一处,后面少踩很多坑
回到最开始那个场景:IDEA 插件市场红字,你点刷新没用,重启没用。现在你应该清楚了,问题不在 IDEA 本身,而在它那条 HTTP 请求链路没配通。配通的方式有两条,一条是给 IDEA 配本地代理出口,一条是把需要联网的请求统一收敛到 TaoToken 的 API 通道。
我自己的习惯是两条都配:插件市场走 3.1 的代理配置,模型调用和编码辅助走 3.2 到 3.5 的统一三件套。这样以后不管换什么工具,Base URL 和 Key 都是同一套,排查的时候只看一个地方,不用每个工具单独查。
如果你主要是在 IDEA 里做长期编码、跑 Agent 类的任务,建议直接上 Coding Plan,把调用额度固定下来,比每次临时配省事:
https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite如果你只是想先验证一下模型通不通,用模型对话页面发一句话最快:
https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite接入文档在这里,路径和参数都以文档为准:
https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite最后留一个实用技巧:配完代理和统一通道之后,把Check connection和 4.2 的 curl 命令存成一个文本片段,下次再遇到红字,先跑这两步,30 秒就能定位是代理挂了还是 Key 失效了,不用再从头排查一遍。