很多人搜「GPT 插件安装」，装完却发现在插件里怎么都调不通——因为你装的是外壳，通道还得自己接。这篇按浏览器扩展、IDE 插件、桌面客户端三类分开讲：每类怎么装、装完在哪填地址和密钥、为什么这一步绕不过去，最后给一套五分钟就能跑通的验证顺序。
很多人搜「GPT 插件安装」，照着教程点完安装按钮，打开却发现在插件里怎么都调不通。原因通常不在安装步骤，而在于你装的只是一个外壳：界面、按钮、对话框都给你了，但请求该发到哪个地址、用谁的身份发，插件自己并不知道。所以这篇不按插件名字分类，而是按它跑在哪里分三类讲。
三类分别是浏览器扩展、编辑器插件、独立桌面客户端。它们的安装路径、配置入口、报错方式完全不同，把浏览器扩展的配置思路套到编辑器插件上，只会白折腾。下面每类都给到「装在哪、在哪填、怎么确认填对了」，最后给一套五分钟能跑完的验证顺序。
先分清你说的「插件」是哪一种
判断方法很简单：看它改的是哪一层。改网页请求的是浏览器扩展，改编辑器补全的是 IDE 插件，自己开一个窗口的是桌面客户端。这三层的配置项互不相通，装错层就会出现「设置项里根本没有地址那一栏」的情况。
- 浏览器扩展
- 跑在网页里，给聊天页面加侧边栏、划词翻译、网页总结这类增强，只能影响浏览器里发生的请求。
- IDE 插件
- 跑在编辑器进程里，做补全、问答、改代码，读的是编辑器自己的设置项，和浏览器扩展互不影响。
- 桌面客户端
- 本身是独立程序，有些在扩展市场里挂条目，但配置入口在应用自己的设置页，不在浏览器里。
三类各自的安装与配置落点
安装动作本身都不难，难的是装完之后知道去哪一栏填东西。下面这张对照表可以先扫一眼，再按后面的步骤逐类操作。
| 类型 | 配置入口大概在哪 | 通常要填什么 |
|---|---|---|
| 浏览器扩展 | 扩展详情 → 设置 / 高级设置 | 接口地址、密钥，有的还要手动选模型 |
| IDE 插件 | 编辑器设置里搜插件名 | 接口地址、密钥，部分只给「自定义模型」入口 |
| 桌面客户端 | 应用设置 → 模型服务 / 供应商 | 地址、密钥、模型名三项，常拆在不同页签 |
- 浏览器扩展从扩展商店或压缩包装好后，先在扩展详情里确认它申请了哪些站点权限；再打开扩展自己的设置页，找 API / 自定义接口 / 高级设置这一栏填地址和密钥。只登录账号不算配好，那只是它的自带通道。
- IDE 插件装完后去编辑器设置里搜插件名，一般有接口地址与密钥两个字段；有的插件只暴露一个「自定义模型」入口，需要你手填模型名。填完保存，重启一次窗口让配置生效。
- 桌面客户端进设置找模型服务或供应商，新增一个自定义供应商，分别填地址、密钥、模型名。不少客户端把地址和密钥拆在不同页签，漏填一项就会报鉴权失败。
- 通用收尾填完先截图把你写进去的三项值存下来。后面排查时不用在几个页面之间来回翻，也能一眼看出是不是自己手滑。
为什么装完插件还得自己填地址和密钥
插件是外壳不是通道。它负责把界面画出来、把请求组装好，但请求最终发到哪个域名、用谁的身份发出去，插件本身无从得知，只能由你告诉它。官方地址一般是写死在插件里的默认值，你要换通道，就得把这个默认值覆盖掉，这就是「自定义接口」这一栏存在的全部理由。
- 协议兼容不等于地址一样：很多中转站请求格式和官方一致，但入口域名和路径不同，只改域名不核对完整路径，照样返回找不到。
- 填错一位就鉴权失败：地址末尾多一个斜杠、少一段路径、密钥前后带空格，都足以让请求被拒，而且报错信息往往只说「失败」不说是哪一项。
- 模型名也要对得上：地址和密钥都对、模型名写错，依然会报错，这一步常被忽略。
- 什么情况下不用填：插件只做本地处理，或者你确实打算走官方登录通道，那就不需要自定义地址；只要你想换通道、控成本、用别的模型，这一步绕不掉。
地址到底该写成什么样子、常见拼错有哪些，站内已经单独整理过，可以到 /guides/openai-compatible-base-url-fix 核对，不用在这里猜。
装完怎么确认真的走通了
验证的关键不是「能用」，而是「确认它在用你填的配置」。下面这套顺序按代价从低到高排，五分钟内能走完，最后一步做不做取决于前面有没有报错。
- 发一句最短的提问比如让它回一个字。有返回，说明地址和密钥至少有一项是对的，先排除掉完全没配的情况。
- 故意改错密钥再发一次如果仍然正常返回，说明插件根本没在读你填的配置，这时候别急着调地址，先回去看设置有没有保存成功、有没有填在正确的那一栏。
- 切换一次模型名观察返回内容或报错有没有变化，以此确认配置确实被读取，而不是插件在用一个内置的预设。
- 换一个地方发同样的请求用同一个地址和密钥，在命令行或独立客户端里发一次。两边结果一致，说明通道没问题；只有插件报错而别处正常，问题就在插件侧。
- 量一个延迟基线顺手记一次响应时间，避免以后把慢当成不通。可以到 /tools/speed-test 做一次，留个参照。
如果你验证下来发现换个插件就能通，那多半是插件本身对自定义地址的支持不完整，这时候该换的是插件而不是继续调参数。配置项里每一项该填什么、常见填法怎么写，可以到 /guides 的相关条目里对照，别靠一次成功就下结论。
下一步把你实际填的地址和密钥拿去独立客户端再发一次请求，两边结果一致才算真的走通；如果你还在挑通道，站内的中转站可信度检测和价格追踪能帮你把候选缩小到两三个再动手配。→常见问题
装了插件之后提示 401，是插件坏了还是配置错了？
先按配置错处理。401 基本是身份没被认可：密钥填错、密钥前后带了空格、或者地址指向的入口压根不校验这个密钥。把密钥重新粘一遍，确认没有多余空格和换行，再看地址是否和密钥属于同一家。要是还不行，拿同一组值去别的客户端试一次，能区分是插件问题还是账号问题。
浏览器扩展、IDE 插件、桌面客户端，我该装哪一个？
看你在哪干活。在网页上做阅读和总结，装浏览器扩展；写代码要补全和改文件，装 IDE 插件；想要一个独立窗口长期挂着对话和切换模型，用桌面客户端。三者可以同时装，互不冲突，但配置要各填各的，不会自动同步。
插件里填的地址和密钥，会存在本地还是传出去？
多数插件把配置存在本机浏览器或编辑器的存储里，但也有插件会经过自己的服务器中转。判断办法是看它申请了哪些权限、设置页有没有「本地保存」的说明。涉及公司代码或敏感数据时，先确认请求是不是直连你填的地址，拿不准就换成能看清请求走向的客户端。
