跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt

Use this file to discover all available pages before exploring further.

Cline 即原来的 Claude Dev,是目前 GitHub Star 数最高的开源 AI 编码 Agent 之一。它默认深度适配 Claude 模型,可直接读写多文件、执行终端命令、操控浏览器,是 Cursor / Claude Code 的开源替代方案。 本文带你从 0 开始,3 分钟内完成 Cline 安装并接入 AIhubmix,调用 Claude Opus 4.7 / Sonnet 4.6 与 GPT-5.5 等全部主流模型。

​
下载并安装 Cline 插件

​
官方下载渠道一览

平台下载地址适用 IDE
VS Code Marketplacehttps://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-devVS Code
Open VSX Registryhttps://open-vsx.org/extension/saoudrizwan/claude-devCursor、Windsurf、VSCodium
JetBrains Marketplacehttps://plugins.jetbrains.com/(搜索Cline)IntelliJ、PyCharm、WebStorm、GoLand 等
Cline 官网https://cline.bot/各平台入口聚合
GitHub Releaseshttps://github.com/cline/cline/releases手动下载 .vsix 离线安装
认准官方版:作者(Publisher)显示为 Cline / saoudrizwan,插件 ID 为 saoudrizwan.claude-dev,这是它从 Claude Dev 时代沿用至今的官方标识。

​
方式 A:在 VS Code 中安装(推荐)

  1. 打开 VS Code,左侧活动栏点击 Extensions 图标(或按 Cmd/Ctrl + Shift + X)。
  2. 搜索框中输入 Cline。
  3. 找到作者为 Cline 的插件(ID:saoudrizwan.claude-dev),点击 Install。
  4. 安装完成后,VS Code 左侧活动栏会新增一个 Cline 图标,点击即可打开侧边面板。

​
方式 B:在 Cursor / Windsurf 中安装

Cursor 与 Windsurf 兼容 VS Code 扩展协议,但默认使用 Open VSX 源:
  1. 打开内置 Extensions 面板,搜索 Cline。
  2. 安装作者为 saoudrizwan 的版本即可。
  3. 如搜索不到,可前往 Open VSX 下载 .vsix 后手动拖入安装。

​
方式 C:在 JetBrains 全家桶中安装

  1. 打开 Settings / Preferences → Plugins → Marketplace。
  2. 搜索 Cline,点击 Install。
  3. 重启 IDE 后,右侧工具栏可见 Cline 面板。

​
方式 D:离线安装(企业内网场景)

  1. 前往 GitHub Releases 下载最新版 .vsix 文件。
  2. VS Code 中按 Cmd/Ctrl + Shift + P 打开命令面板。
  3. 执行 Extensions: Install from VSIX...,选择刚下载的文件即可。

​
配置 AIHubMix Api Key

  • 下载插件，进入设置页面。
  • API Provider 一栏选择 OpenAl Compatible。
  • Base URL 一栏输入：
https://aihubmix.com/v1
  • API Key 一栏从本站的 Key中生成。
  • 输入模型名后保存设置即可使用。
  • 注：模型名称建议从本站设置页面复制粘贴。图片示例为 claude-3-5 模型，gpt-4o 也可以使用。
图片

​
首次运行测试

回到 Cline 主面板,在输入框中粘贴以下测试 Prompt: 列出当前项目根目录下的所有文件, 然后用一句话总结这是一个什么类型的项目。 如果配置正确,Cline 会:
  1. 调用 list_files 工具读取目录
  2. 在面板中展示文件树
  3. 由 Claude 生成项目描述
整个流程无报错,即代表接入成功,可以开始正式使用。

​
推荐的初始优化设置

​
1. 开启 Plan / Act 双模式

在面板底部模式切换按钮中:
  • Plan Mode:复杂任务先让 Claude 出方案,审阅后再执行
  • Act Mode:简单任务直接执行
养成”先 Plan 后 Act”的习惯,可显著减少返工。

​
2. 配置 .clinerules

在项目根目录创建 .clinerules 文件,写入项目规约,例如: 所有 API 路由必须用 Zod 校验入参 数据库操作走 Drizzle,禁止裸 SQL 提交前跑 pnpm typecheck && pnpm test 注释只写”为什么”,不写”是什么” Claude 会自动遵守这些规则,无需每次重复提醒。

​
3. 启用 Auto-Approve(可选)

熟悉 Cline 后,可在设置中勾选低风险操作自动审批(如 Read Files、List Directory),减少弹窗打断,但写文件与执行命令建议始终保持手动审批。

​
常见问题

​
Q1:为什么连接失败,提示 401 / 403?

  • 检查 API Key 是否完整复制(包含 sk- 前缀)
  • 检查 Base URL 末尾是否多了 /,正确格式是 https://aihubmix.com/v1
  • 确认 AIhubmix 账户有余额

​
Q2:模型名报错 “model not found”?

请从 AIhubmix 模型列表 复制完整 ID,不要手输或简写。

​
Q3:为什么 Cline 在我这里调用很慢?

  • 优先选 claude-sonnet-4-6,响应速度比 Opus 快 2-3 倍
  • 大型项目务必在 .clinerules 加 ignore 规则,屏蔽 node_modules、dist

​
Q4:可以同时配置多个 Provider 吗?

可以。Cline 支持配置多套 API,在面板顶部一键切换,适合做模型对比测试。

​
Q5:Cline 插件 ID 为什么还叫 claude-dev?

Cline 前身就是 Claude Dev,作者为保留社区评价与安装基数,沿用了原 Marketplace ID,这也是它”Claude 基因”的官方背书。 接入完成后,推荐尝试以下任务来熟悉 Cline 的能力上限:
  • 代码重构:“把这个项目的鉴权中间件从 JWT 换成 Session”
  • 批量改造:“为所有 API 路由补上 OpenAPI 注释”
  • 全栈生成:“用 Next.js + Drizzle 做一个待办应用,完成后跑通测试”
  • Bug 复现:“打开 localhost:3000,截图首页,告诉我为什么 Header 错位”
更多技巧、模型选型与企业级最佳实践,可参考我们的 Cline 完全指南 2026 长文版。
遇到问题?
文档更新日期：2026年5月12日