企业官网建设流程全解析

1. 为什么 VS Code 插件会跑到远程去运行

很多人第一次遇到这个问题，是在连上远程开发环境之后。你明明在本地装了某个 AI 补全插件，结果它要么不生效，要么提示「扩展在远程主机上运行」，要么补全请求绕了一大圈才回来。核心原因在于 VS Code 的扩展运行位置机制：它把扩展分成两类运行位置，一类跑在本地 UI 侧，一类跑在远程服务侧。默认情况下，很多扩展会被判定为「工作区扩展」，跟着远程环境走，于是你的本地配置、本地网络、本地模型服务全都用不上。

这个机制本身没错，远程开发时把重活放到远端能省本地资源。但问题出在 AI 编码插件这类工具上——它们往往需要访问你本地的模型服务、本地的 API Key、本地的网络出口。如果插件被丢到远程去跑，它读的是远程机器的环境变量和配置文件，你本地 settings.json 里写的东西它根本看不见。这就是「插件指定本地运行而非远程服务」这个需求的由来。

我试过在远程容器里调一个补全插件，本地明明配好了模型地址，插件却一直报连接超时，排查半天才发现它压根没在本地跑。后来把扩展运行位置强制到本地，问题立刻消失。所以这篇就围绕 settings.json 里的remote.extensionKind这个配置项，把「怎么让插件在本地跑」这件事讲透，顺带把 TaoToken 的接入配置一起理清楚，让你有一套可复制、可回退的基线。

你需要先理解一个概念：VS Code 扩展有两种 kind，ui表示在本地 UI 侧运行，workspace表示在工作区（可能是远程）侧运行。当两者冲突时，remote.extensionKind里的设置优先级最高，可以强制覆盖插件的默认行为。这就是我们做本地化指定的抓手。

适合谁看？如果你在用 VS Code 远程开发（SSH、容器、WSL 都算），同时又在用 AI 补全、代码对话这类需要本地模型服务的插件，那这篇就是给你写的。如果你只是纯本地开发，没有远程环境，那这个配置对你影响不大，但了解机制也没坏处。

2. TaoToken 前置准备与扩展运行位置的关系

在动手改 settings.json 之前，得先把 TaoToken 这边的准备工作做掉，否则你把插件强制到本地运行了，结果本地没有可用的模型服务地址和 Key，插件照样跑不起来。TaoToken 在这里扮演的角色，是给本地运行的插件提供一个统一的模型接入入口。官网入口在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api ，注意 API 这个地址不带任何查询参数，配置时直接填这个就行。

为什么要把 TaoToken 和扩展运行位置放在一起讲？因为这两件事是配套的。你把插件强制到本地运行，本质上是想让插件用本地的网络和本地的配置去发请求。那本地配置里最关键的就是 Base URL 和 API Key。TaoToken 提供的就是这个 Base URL 和对应的 Key，插件在本地跑，读本地 settings.json 里的这些值，请求发到 TaoToken 的 API 地址，再由它路由到具体模型。整条链路都在你本地可控范围内，不依赖远程机器的环境。

你需要准备三样东西：Base URL、API Key、Model ID。Base URL 就是 https://taotoken.net/api ，API Key 去控制台创建，Model ID 根据你要用的模型填。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API Key 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。创建 Key 的时候建议单独建一个给 VS Code 用的，方便后面回退和吊销。

这里有个容易踩的坑：很多人以为把插件强制到本地运行就万事大吉，结果本地 settings.json 里根本没配 Base URL，插件还是去连默认的远程服务。所以顺序应该是先配好 TaoToken 的接入信息，再改扩展运行位置，最后重启验证。另外，如果你用的是 Claude Code 这类工具，它的配置文件和 VS Code 的 settings.json 是两套东西，别混在一起。Claude Code 的接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，需要的话可以对照看。

还有一点要提醒：TaoToken 是模型接入服务，不是编辑器替代品，它不会帮你写代码，只是让你的插件能连上模型。插件本身的补全、对话能力还是插件自己的。理解这一点，后面配置的时候就不会有错误预期。

3. 可复制的 settings.json 配置片段与逐项说明

现在进入正题，打开 VS Code 的 settings.json。快捷键是 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入Preferences: Open Settings (JSON)，选中的是本地用户设置，不是远程设置。这一点很关键，你要改的是本地那份，因为我们要让插件在本地跑。

下面是一份可以直接复制的配置片段，我把它拆成两部分：扩展运行位置和 TaoToken 接入。你可以按需合并到自己的 settings.json 里。

{ "remote.extensionKind": { "Alibaba-Cloud.tongyi-lingma": ["ui"], "github.copilot": ["ui"], "anthropic.claude-code": ["ui"] }, "tongyi-lingma.apiBase": "https://taotoken.net/api", "tongyi-lingma.apiKey": "sk-你的TaoToken密钥", "tongyi-lingma.model": "claude-3-5-sonnet" }

逐项说明。remote.extensionKind是一个对象，key 是扩展的完整 ID，value 是一个数组，里面写"ui"就表示强制在本地 UI 侧运行。扩展 ID 怎么找？在扩展面板里点开某个扩展，右侧详情页会显示类似Alibaba-Cloud.tongyi-lingma这样的标识，或者你在扩展列表里右键复制扩展 ID。数组里也可以写"workspace"，那就是强制到远程，我们这里要的是本地，所以写"ui"。

tongyi-lingma.apiBase这一项，不同插件的配置键名可能不一样。通义灵码用的是tongyi-lingma.apiBase这类前缀，Copilot 用的是github.copilot.advanced下面的字段，Claude Code 插件又有自己的键。所以你不能照抄键名，得看你装的插件实际支持哪些配置项。通用做法是：在 settings.json 里输入插件 ID 的前缀，VS Code 会自动补全可用的配置键。如果插件本身不支持自定义 Base URL，那它可能只能走官方服务，这时候 TaoToken 就派不上用场，你需要换一个支持自定义端点的插件。

tongyi-lingma.apiKey填你在 TaoToken 控制台创建的 Key。注意不要把这个文件提交到 Git，settings.json 如果放在项目里，Key 会泄露。建议把 Key 放在本地用户设置里，或者用环境变量引用。VS Code 的 settings.json 支持${env:VAR_NAME}这种写法，你可以把 Key 存在系统环境变量里，配置里写"tongyi-lingma.apiKey": "${env:TAOTOKEN_API_KEY}"，这样更安全。

tongyi-lingma.model填 Model ID。TaoToken 支持的模型列表可以在模型对话页查看，地址是 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。填的时候注意大小写和连字符，写错了会报模型不存在。

如果你用的是 Cline 或者带 MCP 的插件，配置会复杂一些，通常需要在插件的独立配置文件里写 Base URL、Key、Model ID 三件套。Cline 的配置一般在插件设置界面里填，对应字段是 API Provider 选 OpenAI Compatible，Base URL 填 https://taotoken.net/api ，API Key 填你的 Key，Model ID 填具体模型。这三件套缺一不可，少一个就连不上。

配置改完保存，然后重启 VS Code。重启是必须的，因为扩展运行位置的变更需要重新加载扩展宿主进程。重启后你可以打开扩展面板，找到对应插件，看它的运行位置标识。如果显示「本地」或者「UI」，说明生效了。

4. 验证插件确实走本地而非远程服务

配置写完不代表生效，得验证。验证分两层：一层是确认扩展运行位置真的在本地，另一层是确认请求真的发到了 TaoToken 而不是别的地址。

第一层验证，打开命令面板，输入Developer: Show Running Extensions，这会列出当前所有运行中的扩展及其运行位置。找到你配置的那个插件，看它的Extension Kind是不是ui。如果是workspace，说明配置没生效，检查扩展 ID 有没有写错，或者 settings.json 是不是改到了远程那一份。

第二层验证，看请求走向。最直接的办法是打开 VS Code 的输出面板，选择对应插件的日志通道。很多 AI 插件会把请求的 Base URL 打到日志里。你触发一次补全或者对话，然后在日志里搜taotoken.net，如果能搜到，说明请求确实发到了 TaoToken。如果搜到的是别的域名，那说明插件没读你的配置，可能它不支持自定义端点，或者配置键名写错了。

还有一个办法是用网络抓包工具看本机发出的请求，但这个对小白不太友好，容易和系统代理混淆，这里不展开。更简单的办法是看插件的响应内容。如果你在 TaoToken 控制台能看到调用记录，那就说明请求确实到了。控制台的用量页面在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，触发几次补全后刷新看看有没有新增调用。

我实测下来，最容易出问题的是扩展 ID 写错。比如把Alibaba-Cloud.tongyi-lingma写成alibaba-cloud.tongyi-lingma，大小写不对就不生效。VS Code 的扩展 ID 是大小写敏感的，复制的时候别手打。另一个坑是 settings.json 里有重复的 key，JSON 不允许重复键，后面的会覆盖前面的，如果你在文件里已经有一份remote.extensionKind，再写一份就会冲突，需要合并到同一个对象里。

验证通过后，建议把这份配置备份一下，或者用 VS Code 的 Settings Sync 同步。这样换机器的时候不用重新配。如果你要回退，把remote.extensionKind里对应的条目删掉，重启即可，插件会回到默认的运行位置判定。

5. 本篇常见报错与排查对照

配置过程中会遇到几类典型报错，这里按现象、原因、解决三步走。

第一类，401 Unauthorized。现象是插件提示认证失败，日志里能看到 401。原因通常是 API Key 填错、Key 已失效、或者 Key 没有对应模型的权限。排查方法：去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 确认 Key 还在，复制的时候有没有多空格。然后确认 Model ID 是不是这个 Key 能访问的。如果 Key 没问题，检查 Base URL 是不是写成了https://taotoken.net/api/带了尾部斜杠，有些插件对尾部斜杠敏感，去掉试试。

第二类，local proxy failed 或者 connection refused。现象是插件报本地代理失败。这个报错通常和扩展运行位置有关。如果插件被判定为远程运行，它会在远程机器上找本地代理，自然找不到。解决办法就是本篇的核心：用remote.extensionKind强制到ui。另外检查一下本地有没有开系统代理，如果开了，插件的请求可能被代理拦截，关掉或者把 taotoken.net 加入直连列表。

第三类，reading choices 相关报错。现象是插件在解析响应时失败，提示读取 choices 字段出错。这多半是响应格式不匹配。TaoToken 的 API 是 OpenAI 兼容格式，响应里应该有choices数组。如果插件期望的是别的格式，就会报这个错。排查方法：确认插件的 API Provider 选的是 OpenAI Compatible，而不是 Anthropic 或者别的。如果插件只支持 Anthropic 格式，那需要换插件或者用支持转换的配置。

第四类，OAuth 相关报错。现象是插件弹窗要求登录，或者提示 OAuth 失败。这类插件通常走的是官方账号体系，不支持自定义 Base URL。遇到这种，remote.extensionKind改了也没用，因为它的认证不走你的配置。解决办法是换一个支持 API Key 直连的插件，或者看插件有没有「使用自定义端点」的高级选项。

第五类，配置不生效。现象是改了 settings.json 重启后，扩展运行位置还是 workspace。原因可能是你改的是远程的 settings.json，而不是本地的。VS Code 在远程模式下，设置面板会分「用户」「远程」两个 tab，你要改的是用户那一份。另一个原因是扩展 ID 写错，或者 JSON 语法错误导致整个文件没被解析。用 VS Code 的 JSON 校验功能检查一下有没有红色波浪线。

排查的时候有个通用技巧：打开命令面板，输入Developer: Toggle Developer Tools，在 Console 里看有没有报错。插件的加载错误、配置解析错误都会打在这里。比看插件自己的日志更底层。

6. 把配置基线固定下来并持续使用

配置调通之后，别就这么放着。建议做两件事：一是把这份 settings.json 的关键片段单独存一份，二是把 TaoToken 的 Key 管理起来。

存片段的意思是，你可以在项目里放一个vscode-settings-snippet.json，只放remote.extensionKind和插件接入那几行，不包含真实 Key。这样换项目或者换机器的时候，直接复制粘贴，Key 用环境变量注入。环境变量的设置方法：Windows 在系统属性里加，macOS 在~/.zshrc里 export，Linux 在~/.bashrc里 export。配置里写"${env:TAOTOKEN_API_KEY}"，VS Code 会自动读取。

Key 管理方面，建议按用途分 Key。一个 Key 给 VS Code 插件用，一个 Key 给 Claude Code 用，一个 Key 给脚本用。这样哪个 Key 出问题或者要吊销，不影响其他。TaoToken 的 API Key 页面可以创建多个 Key，每个 Key 可以单独命名。命名的时候写清楚用途，比如vscode-local-plugin，后面排查的时候一眼就能认出来。

如果你长期做编码和 Agent 类任务，可以考虑 Coding Plan，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。它适合需要持续调用模型的场景，比按次计费更划算。但如果你只是偶尔用用补全，按量付费就够了，不用急着上 Plan。

最后说一个实际经验：扩展运行位置这个配置，不是设一次就一劳永逸。VS Code 更新、插件更新、远程环境变化，都可能让运行位置判定回到默认。所以建议每隔一段时间用Developer: Show Running Extensions检查一下，确认关键插件还在本地跑。如果发现跑偏了，重新应用一下配置就行。这套基线建立起来之后，你在任何远程环境里都能让插件用本地的模型服务，不用再受远程机器网络和配置的限制。