1. 内网离线装机后，Cline MCP 为什么连不上模型
先说清楚这篇要解决的具体问题。VS Code 离线安装本身不复杂，下载VSCodeSetup-x64-*.exe一路下一步，再把插件.vsix用code --install-extension装进去就行。真正让人卡住的是装完之后：机器在内网、没有外网出口，Cline 这个 AI 编码插件默认会去连官方端点，结果就是转圈、超时、报local proxy failed或者干脆没有响应。你要做的是把 Cline 的 MCP 请求指向一个统一 Key 通道，也就是 TaoToken 的 API 地址，让离线机器也能正常调用模型。
Cline 的工作方式可以理解成：VS Code 里负责界面和文件操作，真正的推理请求通过 HTTP 发给一个兼容 OpenAI 协议的服务端。它支持自定义 Base URL，这就给了我们操作空间。只要把 Base URL 从默认地址改成https://taotoken.net/api，再把 API Key 和模型 ID 填对，请求就会走统一通道出去。对于内网机器来说，前提是这台机器能访问到该地址（通常由网络管理员放行域名或走内网出口），否则任何配置都无从谈起。
适合读这篇的人有三类：一是在隔离环境里做开发、只能用离线包装 VS Code 的工程师；二是公司内网统一管控、不允许随便连外部服务的团队；三是自己折腾离线装机、发现 Cline 装好却用不了的个人开发者。下面我会按「先备好 Key，再改配置，然后发一次请求验证，最后排错」的顺序走一遍，每一步都给可复制的片段。
需要提前说明一点：Cline 的配置入口在不同版本里位置略有差异，有的在插件设置面板里填 Base URL，有的直接写进 VS Code 的settings.json。两种方式本质一样，我下面以settings.json为主，因为它可复制、可版本管理，离线批量装机时最省事。
2. TaoToken 前置准备：拿到 Base URL、Key 和模型 ID
在改 Cline 配置之前，先把三样东西准备好，缺一个都会在验证阶段报错。这三样是 Base URL、API Key、Model ID，也就是常说的「三件套」。
Base URL 固定用https://taotoken.net/api。注意这里不要带任何多余路径，Cline 会自己在后面拼接/v1/chat/completions这类端点。如果你手滑写成https://taotoken.net/api/v1，很可能出现路径重复导致 404，这是很常见的坑。
API Key 需要到控制台里创建。打开 https://taotoken.net/console 登录后进入 API Keys 页面，新建一个 Key 并复制保存。Key 一般只完整显示一次，关掉页面就看不到了，所以复制后先存到安全的地方。离线机器上没法临时登录网页，所以这一步最好在有外网的机器上完成，再把 Key 通过内部渠道带过去。
模型 ID 取决于你要用哪个模型。在模型对话页面可以先试跑一下，确认某个模型可用，再把它对应的 ID 填进 Cline。模型 ID 是区分大小写的字符串，写错了会返回model not found之类的错误。如果你不确定该填什么，先去 https://taotoken.net/models 或模型对话页确认。
把这三样整理成一张表，后面配置时直接对照：
| 配置项 | 取值 | 说明 |
|---|---|---|
| Base URL | https://taotoken.net/api | 不带/v1，由客户端拼接 |
| API Key | 控制台新建的 Key | 只显示一次，注意保存 |
| Model ID | 例如某个具体模型标识 | 以模型对话页实际可用为准 |
如果你打算长期在离线环境里做编码和 Agent 任务，可以顺带了解一下 Coding Plan，它更适合高频调用场景：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。不过这篇的重点是先把单机连通性跑通，套餐的事可以后面再看。
3. 可复制配置：settings.json 里改 Base URL 与模型字段
现在进入正题。VS Code 的用户级settings.json路径按系统区分：Windows 一般在%APPDATA%\Code\User\settings.json，macOS 在~/Library/Application Support/Code/User/settings.json，Linux 在~/.config/Code/User/settings.json。离线装机后如果这个文件不存在，手动建一个空的{}也行。
Cline 的配置键名会随版本变化，常见的是cline.apiProvider、cline.apiKey、cline.baseUrl、cline.model这一组。下面给一份可直接粘贴的片段，你按自己版本微调键名即可：
{ "cline.apiProvider": "openai", "cline.baseUrl": "https://taotoken.net/api", "cline.apiKey": "sk-你的Key粘贴在这里", "cline.model": "你的模型ID", "cline.useCustomBaseUrl": true }几个字段逐个解释。apiProvider选openai是因为 TaoToken 的接口兼容 OpenAI 协议，Cline 会按这个协议发请求。baseUrl就是上面说的统一地址，千万别加/v1。apiKey填你从控制台复制的 Key。model填模型 ID。useCustomBaseUrl这个开关在部分版本里必须为true，否则 Cline 会忽略你填的 baseUrl 继续走默认地址，这是很多人改了没生效的原因。
如果你用的是 Cline 的 MCP 模式，配置可能落在 MCP 的 server 定义里，形如：
{ "mcpServers": { "cline": { "command": "npx", "args": ["-y", "cline-mcp"], "env": { "OPENAI_BASE_URL": "https://taotoken.net/api", "OPENAI_API_KEY": "sk-你的Key粘贴在这里", "OPENAI_MODEL": "你的模型ID" } } } }这种写法通过环境变量注入，适合 MCP 进程独立启动的场景。注意OPENAI_BASE_URL同样不带/v1。改完保存，重启 VS Code 让配置生效。离线环境下npx可能拉不到包，如果 MCP 进程起不来，需要提前把依赖包也离线装好，这一点在排错章节会细说。
配置写完后，建议用 VS Code 自带的 JSON 校验看一眼有没有多余逗号或引号错误，语法错误会导致整个 settings 文件被忽略，表现就是「改了跟没改一样」。
4. 验证请求：发一次调用看返回格式
配置改完不能只看界面，要真发一次请求确认链路通。最直接的办法是在 Cline 面板里发一句简单的话，比如「回复 ok 两个字」。如果配置正确，几秒内就能看到流式返回。但为了更清楚地定位问题，我更推荐先用命令行单独验证一次，把 Cline 这一层排除掉。
用 curl 发一个最小请求：
curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的Key" \ -H "Content-Type: application/json" \ -d '{ "model": "你的模型ID", "messages": [{"role": "user", "content": "回复 ok"}], "stream": false }'注意这里 curl 的 URL 是带/v1的，因为我们是直接调端点，而 Cline 配置里的 baseUrl 不带/v1，由客户端自己拼。这个区别要分清楚，否则会以为配置写错了。
正常返回是一个 JSON，结构大致如下：
{ "id": "chatcmpl-xxxx", "object": "chat.completion", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "ok" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } }看到choices[0].message.content里有内容，说明 Key、Base URL、模型三样都对。如果返回里choices是空数组，或者报reading choices相关错误，多半是模型 ID 不对或该模型没权限。命令行通了之后，再回到 Cline 里发消息，如果 Cline 还是不通，问题就出在插件配置层，而不是网络或 Key。
实测下来，命令行验证这一步能省掉大量来回猜的时间。很多人一上来就在插件里试，报错了也不知道是 Key 问题还是配置键名问题，分层验证会快很多。
5. 常见报错排查：401、local proxy failed、reading choices
这一节把离线场景下最容易撞到的几个错误列出来，对照着查。
401 Unauthorized。这个最直接，Key 不对或没带上。检查三处：Key 是否复制完整（有没有漏掉前缀或尾部字符）、Authorization头是不是Bearer加空格再加 Key、Key 是否已在控制台被删除或禁用。离线机器上如果 Key 是通过聊天工具转发的，很容易被自动换行截断，建议用文件传输。
local proxy failed。这个错误通常出现在 Cline 尝试走本地代理但代理没起来的时候。离线环境里如果你之前配过系统代理或插件代理，把它关掉，让请求直连。检查 VS Code 的http.proxy设置是否为空，以及环境变量HTTP_PROXY、HTTPS_PROXY是否指向了一个不存在的地址。清掉这些，重启 VS Code 再试。
reading choices 报错。一般是返回体结构不符合预期，常见原因是 Base URL 写成了带/v1的版本，导致实际请求路径变成/api/v1/v1/chat/completions，服务端返回了错误页而不是标准 JSON，客户端解析choices字段时就崩了。把配置里的 baseUrl 改回https://taotoken.net/api即可。
OAuth 相关报错。有些版本的 Cline 默认走 OAuth 登录流程，离线环境下无法完成授权。这时要在设置里切换到 API Key 模式，也就是把apiProvider设为openai并填自定义 baseUrl，绕开 OAuth。如果界面里找不到切换入口，直接改settings.json更可靠。
MCP 进程起不来。如果用的是 MCP 模式，npx在离线环境拉不到包会直接失败。解决办法是提前在有网机器上把依赖装好，把node_modules一起打包带过去，或者改用本地已安装的可执行文件路径。日志里如果看到command not found或网络超时，基本就是这个原因。
排查时养成看日志的习惯。Cline 面板一般有输出日志入口，curl 验证则直接看返回体。把错误信息和上面几条对照，大部分问题都能定位。
6. 把统一 Key 通道固定下来，后续接入更省事
单机跑通之后，建议把这套配置固化下来，方便离线批量装机时复用。做法是把settings.json里的 Cline 配置段单独抽成一个片段文件，装机脚本里直接合并进去，Key 和模型 ID 用占位符，部署时替换。这样新机器装完 VS Code 和插件，配置一贴就能用，不用每台都手填。
如果你后面还要接别的工具，比如 Claude Code 这类命令行编码助手，思路是一样的：找它的 Base URL 配置项，指向https://taotoken.net/api，填同一个 Key 和模型 ID。接入文档里有各客户端的详细字段说明，可以对照着改：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。Key 的管理统一在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，需要新增或吊销都在这里操作。
最后提醒一个实际经验：离线环境里最容易出问题的不是配置本身，而是网络放行和依赖包缺失。配置改对了但域名不通，表现和 Key 错误很像，都会超时。所以验证顺序永远是先确认网络可达，再确认 Key 有效，最后才怀疑配置键名。按这个顺序走，能少走很多弯路。
