本地写代码时，插件默认只认官方账号，想换成中转站就得自己填接口地址和 Key。这一步踩坑的人不少：填了不通、通了但补全没反应、报错也看不出是 Key 错还是地址错。这篇按「选插件—填配置—验连通—排错」的顺序走一遍，给可直接照做的动作清单，不承诺一定能用。
本地写代码时，插件默认只认官方账号，想换成中转站就得自己填接口地址和 Key。这一步踩坑的人不少：填了不通、通了但补全没反应、报错也看不出是 Key 错还是地址错。下面按「选插件—填配置—验连通—排错」走一遍，给能直接照做的动作，不承诺一定能用。
先说明一点：中转站接进编辑器，本质是让插件把请求发到另一个地址，所以能不能接、接到什么程度，取决于插件留没留这个口子。先做判断，再动手填，能省掉大半来回试的时间。
先确认你的插件支不支持自定义接口
本地编辑器插件大致分两类。一类只绑官方账号、设置里根本没有填地址的地方，这种直接换掉，别花时间绕。另一类在设置里有 API Key、Base URL、自定义供应商之类的入口，才有可能接中转站。判断方法很直接：打开插件设置页，搜几个关键词。
- 找 Base URL、Endpoint、API Base、Custom Provider、OpenAI Compatible 这类字段，能找到基本说明留了自定义口子
- 看它要求哪套协议：多数插件按 OpenAI 格式发请求，少数按另一套格式，对不上就算地址填对也调不通
- 不确定选哪个，可先到 AI 编程工具（/ai-nav/category/ai-coding） 里横向看一遍同类插件的配置项差异
- 插件带自家云端账号体系的，本地改配置往往改不动，这类只能等它开放或直接换
| 插件表现 | 能不能接 | 建议动作 |
|---|---|---|
| 设置里只有登录官方账号入口 | 基本不能 | 换支持自定义接口的插件 |
| 有 API Key + Base URL 字段 | 可以试 | 按下一节逐项填，填完先验连通 |
| 只有 Key 字段、没有地址字段 | 通常不能 | 多半走厂商侧通道，换插件 |
| 支持自定义供应商 / 兼容模式 | 可以试 | 确认它按哪套协议发请求 |
什么情况下不适用
如果插件把补全或索引放在厂商自己的云端通道里跑，本地只改 Key 和地址是改不动的，这种情况只能等官方支持或换一个把请求交给你自己配置的插件。别把「补全没反应」当成配置填错，先确认请求到底走没走你填的地址。
配置项怎么填：地址、Key、模型名三处对齐
配置能不能通，取决于三样东西同时对上：地址写对、Key 有效、模型名是对方真正支持的标识。缺一个都不通，而且报错长得还不一样，所以填的时候逐项确认，别一次改一堆地方。
- 填 Base URL多数中转站要求写到带版本段的那一层，具体写到哪一层以插件说明和实际测试为准。拼错的典型表现是 404。不确定先用请求工具发一次再回填，可到 本地工具箱（/tools） 里找对应工具。
- 填模型名写中转站实际支持的标识，别照抄官方文档里的名字。中转站一般会给出自己可用的模型列表，可到 AI 模型库（/models） 核对大致口径，再回插件里填。
- 填 Key优先放环境变量或插件提供的密钥字段，不要写进随仓库提交的配置文件。多人共用一个 Key 时容易互相把额度打满，最好各人一份。
- 检查同步范围如果插件开了设置项云同步，确认同步列表里有没有把 Key 一起带出去，有就关掉这一项。
三处对不上的典型表现
| 哪里错了 | 常见提示 | 先查什么 |
|---|---|---|
| 地址错或路径重复 | 404、找不到路径 | 地址有没有多写斜杠或重复版本段 |
| Key 无效或过期 | 401、鉴权失败 | Key 是否复制完整、前后有无空格 |
| 模型名不对 | 模型不存在、参数错误 | 模型标识是否写的对方支持的 |
| 网络或中转侧排队 | 超时、连接中断 | 换网络、看对方状态页 |
填完先验连通，别直接当生产用
配置填完，先做最小验证，别马上依赖它写业务代码。让它回一句固定短语，能返回就说明链路通；再让它读一个本地文件、改一行代码，确认插件不只是个聊天框，而是真的接上了编辑器上下文。
- 最小连通：发一句固定短语，看能不能正常返回
- 上下文验证：让它读本地文件或改一行，确认插件把编辑器内容也带上了
- 对照测试：同一段提示词分别走插件和中转站自带页面各发一次，能快速判断问题在插件还是中转站
- 延迟基线：想先量个数字可到 接口测速（/tools/speed-test） 看当时的延迟表现
验证时该记录什么
每次发请求，顺手记下状态码和提示原文。同一个现象反复出现，这些记录就是找中转站支持时的证据，比只说「用不了」效率高得多。状态码是第一手线索，别只截图不记文字。
常见不通的排查顺序
排错最忌一次改几个地方，改完还是不通，等于白改。按固定顺序来：先看 Key，再看地址，再看网络，最后才怀疑插件本身。
- 第一步：查 Key看 Key 是否复制完整、前后有没有多出空格或换行。换行和尾空格是最高频的低级错误。
- 第二步：查地址看有没有重复的路径段、多写的斜杠、写错的版本段。对照插件说明和对方给的接入说明逐字比对。
- 第三步：查网络与代理看插件是否把请求走了系统代理，代理规则可能把请求拦掉。换个网络或关掉代理再试一次。
- 第四步：换工具对照换一个极简插件或直接命令行请求同一套地址和 Key。能通说明中转站没问题、原插件配置有问题；两边都不通基本是 Key 或地址错。
几种「看起来像接入问题、其实不是」的情况
- 只在大文件或长上下文时才失败：多半是请求体过大或上下文超限，先缩短再试，跟接入配置无关
- 偶发失败、重试就好：可能是中转侧排队或网络抖动，记录频率再看要不要换
- 补全不动但聊天窗口能通：插件的补全功能可能走了另一条通道，去设置里看有没有单独的补全开关
- 改了配置但行为没变：插件可能没重载，重启编辑器或重新加载窗口再试
常见问题
插件里填的 Base URL 和官方文档写的不一样，以哪个为准？
以中转站给的接入说明为准。它决定请求打到哪个入口，写错就是 404 或连不上，跟 Key 对不对没关系。填完先用一次最小请求验证，别写完一整个项目才发现地址是错的。
为什么在插件里能用，换个插件就不行了？
不同插件对协议和字段的要求不一样，有的只认 OpenAI 格式，有的还要求模型名严格匹配、流式开关对齐。同一套地址和 Key 在 A 插件通、B 插件不通，通常是格式差异，不是中转站坏了，按插件说明逐项对一遍即可。
把 Key 填进插件安全吗，团队里怎么管？
个人本机用问题不大，前提是别把配置文件提交进仓库。团队共用建议一人一份 Key、各自独立额度，出事能定位到人；共用一把 Key 时额度被谁用光、谁把并发打满都说不清。
