Cline 集成

在 VS Code 中通过 Cline 扩展使用 QCode.cc API

Cline 集成 ¶

Cline 是一款 VS Code AI 编程扩展（500 万+ 安装量），支持任意 AI 模型和自定义 API 端点。通过 Cline 配合 QCode.cc API，你可以在 VS Code 中以低成本使用 Claude 模型。

为什么选择 Cline？¶

零加价：不对模型费用加价，你只需支付 QCode.cc API 费用
VS Code 深度集成：侧边栏面板、内联代码操作、文件编辑预览
完全开源：代码透明，社区活跃
CLI 2.0：支持终端模式和并行代理

安装与配置 ¶

步骤 1：安装 Cline 扩展 ¶

在 VS Code 中：

打开扩展面板（Ctrl+Shift+X / Cmd+Shift+X）
搜索 "Cline"
点击安装

步骤 2：配置 QCode.cc API ¶

安装完成后，在 VS Code 侧边栏点击 Cline 图标
在 API Provider 下拉菜单中选择 "OpenAI Compatible"
填入以下信息：

配置项	值
Base URL	`http://103.236.53.153/claude/v1`（国内）或 `https://api.qcode.cc/claude/v1`（海外）
API Key	你的 QCode.cc API 密钥（`cr_` 开头）
Model ID	`claude-sonnet-4-6`（推荐）或 `claude-opus-4-6`

步骤 3：验证连接 ¶

在 Cline 聊天框中输入一条简单消息（如 "Hello"），如果收到回复则配置成功。

备用节点 ¶

如主节点连接不稳定，可切换 Base URL：

节点	Base URL
深圳直连（推荐国内）	`http://103.236.53.153/claude/v1`
香港	`http://103.218.243.5/claude/v1`
深圳	`http://103.236.53.153/claude/v1`

使用技巧 ¶

1. 模型选择建议 ¶

场景	推荐模型	说明
日常编码	`claude-sonnet-4-6`	速度快、性价比高
复杂架构设计	`claude-opus-4-6`	最强推理能力
轻量任务	`claude-haiku-4-5-20251001`	费用最低

2. 与 Claude Code CLI 配合 ¶

Cline 和 Claude Code CLI 各有优势，推荐配合使用：

场景	推荐工具
VS Code 内快速编辑	Cline
复杂项目分析	Claude Code CLI
多文件重构	Cline
Git 操作、代码审查	Claude Code CLI
CI/CD 自动化	Claude Code CLI（headless 模式）

3. 共享配额 ¶

Cline 和 Claude Code CLI 使用同一个 QCode.cc API 密钥，共享套餐配额。

常见问题 ¶

连接失败？¶

确认 Base URL 末尾没有多余的 /
检查 API 密钥是否正确
尝试切换备用节点
确认网络可以访问 QCode.cc 服务

模型列表为空？¶

手动在 Model ID 输入框中填写模型名称（如 claude-sonnet-4-6），不需要从列表选择。

下一步 ¶

查看 Aider 集成了解另一个兼容 QCode.cc 的开源工具
查看 VS Code 集成使用 Claude Code 官方扩展
查看计费说明了解定价详情

高级用法 ¶

自定义系统提示词 ¶

在 Cline 设置中可以添加自定义 System Prompt，定制 AI 行为：

你是一个资深全栈开发工程师。

- 使用中文回答
- 代码注释用英文
- 遵循项目已有的代码风格
- 修改代码前先解释思路

文件上下文管理 ¶

Cline 支持自动附加文件上下文： 1. 在聊天框中输入 @ 可以引用特定文件 2. 使用 @folder 引用整个目录 3. 使用 @terminal 引用终端输出

批量操作 ¶

Cline 2.0 支持并行代理模式：

> 将 src/components/ 下所有 .jsx 文件转换为 .tsx，添加类型注解

Cline 会同时处理多个文件，显著提升效率。

安全提示 ¶

Cline 可能会读取和修改你的项目文件，请在有 Git 的项目中使用
建议开启 Cline 的"确认修改"功能，在 AI 修改文件前先审查
API Key 存储在 VS Code 设置中（本地加密），不会上传到第三方