Cline 国内怎么用：三种装法对照与接国内模型完整步骤

我家大橘 技术创作者 2026-11-01 11 阅读

Cline 是一个开源 AI 编程 agent，可以作为 VS Code/JetBrains 扩展、终端 CLI 或桌面应用运行，本身不提供模型——模型调用全靠你自己接 API key。官网称已服务 1100 万+ 开发者，GitHub 仓库 71.2k stars、7.8k forks（截至 2026-11-01 抓取）。国内用户真正卡的不是 Cline 本身，而是两层网络问题：安装层（GitHub、扩展商店、npm）和调用层（模型 API 域名）。下面按这两层拆开讲，每个步骤都可以直接复制执行。

以下凡标注「我的推算」的都是我根据官方数字或文档算出来的，其余均出自官方原文。

国内卡的是两层，不是一层

Cline 官网首页列了四条安装入口：Desktop（官网标注 “Desktop New”，是近期新增的）、IDE 扩展、CLI、SDK。这四条的网络依赖各不相同，国内的卡点也分两层。

安装层：IDE 扩展要连 VS Code Marketplace 或 JetBrains Marketplace；CLI 要连 npm registry；桌面版安装包托管在 GitHub Releases。这三类域名在国内的连通性不一样，不能一概而论。

调用层：Cline 官网写的是”Every model, your choice”，支持 Claude、GPT、Gemini、本地 Ollama/LM Studio，或任何 OpenAI-compatible endpoint。Anthropic、OpenAI、Google 的 API 域名在国内直连不稳定——这是所有 AI 编程工具共同面对的问题，不是 Cline 独有。真正可行的路径是接 OpenAI-compatible endpoint，也就是国内云厂商的推理服务。

我的经验判断（不是官方说法）：如果你只解决了安装层，Cline 打开后会是”能用但每句话都卡”的状态；只解决调用层则没意义——工具都没装上。两层必须同时打通。

开始之前需要满足的前置条件只有三条，都可以立刻验证：

  1. Node.js 可用——终端执行 node -v，能输出版本号即通过（比如 v20.x.x）。如果报找不到命令，去 nodejs.org 下载 LTS 版安装包。
  2. VS Code 或 JetBrains IDE 已安装——打开应用能正常编辑文件即可。
  3. 至少有一个模型 API key——阿里云百炼、硅基流动等国内平台的 key 均可，后文以阿里云百炼为例。

三种装法怎么选

Cline 官方给了三种本地安装方式，网络要求完全不同。下表是对照整理，数据来自官网与 GitHub 仓库 README：

装法 官方命令/入口 网络依赖 国内适用场景
CLI npm i -g cline npm registry 可切 npmmirror 镜像，最稳
VS Code 扩展 VS Marketplace 搜 “Cline” marketplace.visualstudio.com 商店连不上时用 VSIX 直装
桌面版 GitHub Releases 下载 dmg/exe github.com Releases 有代理时最快，直连可能超时

选法建议：如果你日常用终端，CLI 是最省事的——npm 有成熟的国内镜像，切换一条命令就解决。如果你必须在 VS Code 里用，优先试内置商店，连不上再走 VSIX 直装（下面详述）。桌面版是官网新增入口，安装包直接托管在 GitHub Releases 上，国内直连不一定稳定，有代理时它是最快路径。

CLI 装法：npm 镜像加速

这是网络问题最少的一条路径。npm 官方 registry 在国内时快时慢，npmmirror 是国内维护的完整镜像，切换后速度通常稳定。

先确认 Node.js 环境可用：

node -v
npm -v

确认后，切镜像并安装：

npm config set registry https://registry.npmmirror.com
npm i -g cline

安装完成后验证：

cline --version

能输出版本号，说明 CLI 已经装好了。这一步和官方 README 里的 npm i -g cline 完全一致，只是前面多了一步切镜像。

一个需要注意的点：切了 npmmirror 后，你以后所有 npm 包都走这个镜像。如果你在某些场景需要走官方 registry（比如私有包），安装完 Cline 后可以用 npm config delete registry 恢复默认，或者用 --registry 参数只对这一次安装指定镜像。

VS Code 扩展：内置商店连不上时的两条备用路

VS Code 扩展的标准入口：打开 VS Code → 点左侧栏 Extensions（扩展）图标 → 搜索框输入 “Cline” → 找到作者为 Cline Bot Inc. 的条目 → 点 Install。

如果搜索后一直转圈或报”Failed to fetch”，说明 marketplace.visualstudio.com 连不上。这时有两条备用路径。

第一条：VSIX 直装。 VS Code 扩展的 VSIX 文件本质上是一个 zip 包，可以绕过商店直接装。从 OpenVSX（open-vsx.org，一个开源的 VS Code 扩展分发仓库）搜索 Cline，下载 .vsix 文件，然后在 VS Code 里按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P）打开命令面板，输入 “Install from VSIX”，选择刚下载的文件即可。

第二条：JetBrains Marketplace。 如果你用的是 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains IDE，走 Settings → Plugins → Marketplace → 搜索 “Cline” 安装。JetBrains Marketplace 的国内连通性通常好于 VS Code Marketplace。

桌面版安装包在 GitHub Releases 页面：https://github.com/cline/cline/releases 。找 tag 前缀为 desktop-v 的 release，里面有 macOS universal dmg、Windows x64 setup exe 和 Linux 版本。有代理时从这里下载是最快路径。

接模型：OpenAI Compatible 填国内 Base URL

装好工具后，打开 Cline，选择 API Provider。国内要接的就是 “OpenAI Compatible” 这一类。

以阿里云百炼为例（以下配置步骤来自阿里云官方帮助文档，页面时间戳 2026-10-11 更新；搜索索引给的 10-10 是发布日元数据，不取）：

  1. 在 VS Code 中安装并打开 Cline。
  2. 点击左侧边栏的 Cline 图标进入配置界面。
  3. 点击 “Bring my own API key”，API Provider 选 “OpenAI Compatible”。
  4. 按你的计费方案填入 Base URL 和 API Key。

阿里云百炼提供四种计费方案：Token Plan 个人版（按 token 消耗抵扣个人 Credits）、Token Plan 团队版（按坐席订阅）、Coding Plan（固定月费订阅，按模型调用次数计量）、随用随付（按实际调用量后付费）。

对于随用随付方案，Base URL 按地区不同：

  • 华北 2（北京）：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
  • 新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
  • 美国（弗吉尼亚）：https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1

把 {WorkspaceId} 替换成你在阿里云控制台的业务空间 ID。

如果你用 Qwen3（思考模式）或 QwQ 模型，还需要在 Cline 设置界面找到 MODEL CONFIGURATION，勾选 Enable R1 messages format（启用 R1 消息格式）—— 官方文档里这一项就叫这个名字，不是「Enable Thinking」。

另一个已验证的接入示例来自超算平台文档（scnet.cn，2026-09-20 更新）：Base URL 是 https://api.scnet.cn/api/llm/v1，API Key 以 sk-tp- 开头，Model ID 填可用模型名称。

关键一点：Model ID 必须和 provider 文档里列出的模型名完全一致——大小写、连接符都不能错。这是下面报错对照里的高频卡点。

报错对照：三条高频报错与解法

以下报错文案来自超算平台官方文档的常见问题章节，阿里云文档也有类似场景：

报错原文 原因 解法
Invalid API Key Key 不对或用错类型 确认用的是该方案的专属 Key（scnet.cn 的 Token Plan Key 必须 sk-tp- 开头；阿里云的 Key 在对应方案的控制台页面获取）
Model Not Found 模型名拼写不对 逐字对照 provider 文档里的模型 ID，检查大小写和连接符
连接异常 Base URL 不通或网络问题 先在浏览器访问 Base URL 看是否返回（哪怕 404 也说明域名通了），再检查填的 URL 是否和文档一致

如果你在终端执行 cline 时报找不到命令，说明全局 npm bin 目录不在 PATH 里。先运行 npm config get prefix 查看安装路径，把该路径下的 bin 子目录加到系统 PATH 环境变量，重启终端后再执行 cline --version 验证。

成功标志与延伸

CLI 装法成功的标志：终端执行 cline --version 输出版本号；执行 cline 进入交互界面后能正常发消息、收到模型回复（不是一直转圈）。

VS Code 扩展成功的标志：左侧栏出现 Cline 图标，点开后能看到 Provider 设置界面；配置完 Base URL 和 Key 后，输入一段代码相关问题，能收到完整的模型响应而不是报错。

桌面版成功的标志：应用启动后能看到模型管理界面，能配置 MCP server（MCP = Model Context Protocol，Cline 用来扩展外部工具的协议），能选择本地文件夹作为工作目录。

三层都装好了、模型也接上了，但如果每次对话都要等 10 秒以上才开始返回——说明网络通但延迟高，考虑把 Base URL 切到延迟更低的地区（阿里云百炼提供了北京、新加坡、弗吉尼亚三个选项）。

Cline 是 Apache-2.0 开源项目。遇到问题优先查 GitHub Issues（当前 946 条 open）和 GitHub Discussions。官方文档在 docs.cline.bot，changelog 在 GitHub Releases。

参考来源

# AI# 知识

评论区

0 条评论

登录后可评论。

我家大橘 11 阅读