> ## 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 > 在 Cline 中接入 AIHubMix：这款 VS Code / JetBrains AI 编码 Agent 用单个 API key 即可跨厂商调用模型。 > 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 Marketplace | [https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev) | VS Code | | Open VSX Registry | [https://open-vsx.org/extension/saoudrizwan/claude-dev](https://open-vsx.org/extension/saoudrizwan/claude-dev) | Cursor、Windsurf、VSCodium | | JetBrains Marketplace | [https://plugins.jetbrains.com/(搜索](https://plugins.jetbrains.com/\(搜索)`Cline`) | IntelliJ、PyCharm、WebStorm、GoLand 等 | | Cline 官网 | [https://cline.bot/](https://cline.bot/) | 各平台入口聚合 | | GitHub Releases | [https://github.com/cline/cline/releases](https://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](https://open-vsx.org/extension/saoudrizwan/claude-dev) 下载 `.vsix` 后手动拖入安装。 ### 方式 C:在 JetBrains 全家桶中安装 1. 打开 `Settings / Preferences → Plugins → Marketplace`。 2. 搜索 `Cline`,点击 **Install**。 3. 重启 IDE 后,右侧工具栏可见 Cline 面板。 ### 方式 D:离线安装(企业内网场景) 1. 前往 [GitHub Releases](https://github.com/cline/cline/releases) 下载最新版 `.vsix` 文件。 2. VS Code 中按 `Cmd/Ctrl + Shift + P` 打开命令面板。 3. 执行 `Extensions: Install from VSIX...`,选择刚下载的文件即可。 ## 配置 AIHubMix Api Key * 下载插件，进入设置页面。 * API Provider 一栏选择 OpenAl Compatible。 * Base URL 一栏输入： ```text theme={null} https://aihubmix.com/v1 ``` * API Key 一栏从[本站的 Key](https://aihubmix.com/token)中生成。 * 输入模型名后保存设置即可使用。 * **注：模型名称建议从本站设置页面复制粘贴。图片示例为 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 模型列表](https://aihubmix.com/models) 复制完整 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 基因"的官方背书。 *** ## MCP (Model Context Protocol) 支持 Cline 支持通过插件安装 MCP Client 服务。 > 支持的 MCP 可以通过 [Cline MCP-marketplace](https://cline.bot/mcp-marketplace) 查询 Cline 的 MCP 管理面板 *** ## 按开发阶段的模型选择建议 软件开发的不同阶段对 AI 能力的要求各不相同。选择合适的模型，可以在需求分析、编码、测试与部署的各个阶段提升效率。 ### 设计与架构阶段 该阶段更依赖模型的抽象推理、系统设计能力和领域知识，适合选择具备强推理与规划能力的模型。 * `o1` * `gemini-2.5-pro` ### 开发阶段 该阶段需要模型在代码生成、模式理解、函数补全、调试建议方面表现稳定，适合选择综合代码能力强的模型。 * `gemini-2.5-pro` * `claude-sonnet-4-5` * `gpt-5` * `coding-glm-4.6`（高性价比） * `qwen3-coder-plus` ### 测试阶段 该阶段更关注边界条件、稳健性、异常流程与用例生成，适合选择擅长代码分析与推理的模型。 * `claude-3-7-sonnet` * `o3` / `o4-mini` * `gpt-5` ### 部署与审查阶段 该阶段需要模型具备较大的上下文窗口，以理解完整代码库，从而进行审查、重构建议或部署验证。 * `gemini-2.5-pro` * `gpt-5` * `o3` / `o4-mini` *** 接入完成后,推荐尝试以下任务来熟悉 Cline 的能力上限: * **代码重构**:"把这个项目的鉴权中间件从 JWT 换成 Session" * **批量改造**:"为所有 API 路由补上 OpenAPI 注释" * **全栈生成**:"用 Next.js + Drizzle 做一个待办应用,完成后跑通测试" * **Bug 复现**:"打开 localhost:3000,截图首页,告诉我为什么 Header 错位" 更多技巧、模型选型与企业级最佳实践,可参考我们的 [Cline 完全指南 2026](https://aihubmix.com/blog/cline-guide) 长文版。 *** > **遇到问题?** > > * AIhubmix 用户支持:[support@aihubmix.com](mailto:support@aihubmix.com) > * Cline 官方仓库:\[github.com/cline/cline]\([https://github.com/](https://github.com/) 文档更新日期：2026年5月12日