Cline 集成

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

Cline 集成¶

Cline 是一款 VS Code AI 编程扩展（数百万安装量），支持任意 AI 模型和自定义 API 端点。它内置 Plan / Act 双模式、文件编辑预览、终端执行和 MCP 工具调用。通过 Cline 配合 QCode.cc API，你可以在 VS Code 中以低成本使用 Claude、GPT 等模型。

为什么选择 Cline？¶

• 零加价：不对模型费用加价，你只需支付 QCode.cc API 费用

• 多模型灵活切换：同一个界面切换 claude-opus-4-8、claude-sonnet-4-6、gpt-5.x 等模型

• VS Code 深度集成：侧边栏面板、内联代码操作、文件编辑 diff 预览、自动审批

• Plan / Act 双模式：先规划再执行，复杂改动可控

• 完全开源：代码透明，社区活跃

• MCP 支持：通过 Model Context Protocol 接入数据库、浏览器、文档等外部工具

安装与配置¶

步骤 1：安装 Cline 扩展¶

在 VS Code 中：

1. 打开扩展面板（Ctrl+Shift+X / Cmd+Shift+X）

2. 搜索 "Cline"

3. 点击 安装

4. 安装后，左侧活动栏会出现 Cline 图标

Cline 也提供命令行版本（Cline CLI），同一套配置可在终端复用；本文以 VS Code 扩展为主。

步骤 2：配置 QCode.cc API¶

QCode.cc 同一把 API 密钥（cr_ 开头）同时兼容 Anthropic 协议和 OpenAI 协议。Cline 提供两种对接方式，任选其一即可：

方式 A：Anthropic 兼容（推荐用于 Claude 模型）¶

在 Cline 设置（齿轮图标）的 API Provider 下拉菜单中选择 "Anthropic"，然后填入：

SDK 会在 Base URL 之后自动追加 /v1/messages，因此 Base URL 填到 /api 即可，不要写成 /api/v1/messages，也不要带末尾斜杠。

方式 B：OpenAI 兼容¶

在 API Provider 下拉菜单中选择 "OpenAI Compatible"，然后填入：

OpenAI 兼容模式走 /chat/completions 接口，可在同一界面访问 Claude 与 GPT 全系列模型。

步骤 3：验证连接¶

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

你也可以在终端用 curl 自检（返回 401 说明路径正确、仅缺鉴权）：

# Anthropic 协议
curl -i https://api.qcode.cc/api/v1/messages \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'

# OpenAI 协议
curl -i https://api.qcode.cc/openai/v1/chat/completions \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","messages":[{"role":"user","content":"hi"}]}'

备用节点¶

同一把密钥可用于 4 个接入域名，互为备份。如主域名连接不稳定，把 Base URL 中的 api 换成下表对应的子域即可：

中国大陆用户建议优先使用 asia.qcode.cc，通常延迟最低。更多说明见 接入点与 API 格式。

Plan / Act 双模式¶

Cline 在聊天框下方提供 Plan 与 Act 两个模式切换：

• Plan（规划）：Cline 先阅读代码、提问、给出实现方案，但不修改文件。适合在动手前对齐需求。

• Act（执行）：Cline 实际创建/编辑文件、运行命令、调用工具，每步改动以 diff 形式展示，由你审批或自动批准。

典型工作流：先在 Plan 模式让模型梳理方案并确认，再切到 Act 模式逐步落地。复杂任务建议用推理更强的 claude-opus-4-8 做规划，再用性价比更高的 claude-sonnet-4-6 执行。

使用技巧¶

1. 模型选择建议¶

完整价格见 计费说明。

2. 配置 MCP 工具¶

Cline 支持 Model Context Protocol（MCP），可让模型调用外部工具（数据库查询、浏览器、文档检索等）。在 Cline 的 MCP Servers 面板中添加服务器配置：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}

MCP 服务器与上游模型解耦，无论你用 Anthropic 还是 OpenAI 协议接入 QCode.cc，工具调用都正常工作。具体服务器的安装与参数请以各工具官方文档为准。

3. 项目级自定义指令（.clinerules）¶

在项目根目录创建 .clinerules 文件，可为该仓库注入固定上下文，例如代码风格、技术栈约定、目录结构说明。Cline 每次对话都会带上这些规则，无需重复粘贴：

# .clinerules

- 全部使用 TypeScript，严格模式
- 优先复用 src/lib 下的工具函数
- 提交前运行 `pnpm test`

规则文件的字段与高级用法以 Cline 官方文档为准。

4. 图像输入（读图）¶

claude-opus-4-8、claude-sonnet-4-6 与 GPT-5.x 均支持视觉输入。你可以把界面截图、报错截图或架构图直接拖入 Cline 聊天框，让模型据图编码或排错。

注意：这里说的是让模型读图。如需生成图像，请使用 gpt-image-2 图像生成，模型名 gpt-image-2。

5. 自动审批与成本控制¶

• 在设置中可为「读文件」「写文件」「执行命令」分别开启 Auto-approve，减少打断；高风险操作建议保留人工确认。

• Cline 会显示每次请求的 token 用量与估算费用，便于控制开销。复杂任务用 Plan 先收敛范围，可避免无谓的来回。

• 对大型代码库，建议用 @（提及文件/文件夹/URL）精确投喂上下文，而不是让模型盲读整个工程，既省 token 又更聚焦。

6. 与 Claude Code CLI 配合¶

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

7. 共享配额¶

Cline 和 Claude Code CLI 使用同一个 QCode.cc API 密钥，共享套餐配额，无需为不同工具单独申请密钥。

常见问题¶

连接失败 / 401 / 404？¶

1. 确认 Base URL 末尾没有多余的 /

2. Anthropic 模式 Base URL 应填到 /api（SDK 自动补 /v1/messages），不要手动写全路径

3. OpenAI 模式 Base URL 应填到 /openai/v1

4. 检查 API 密钥是否以 cr_ 开头且复制完整

5. 尝试切换备用节点（如改用 asia.qcode.cc）

6. 确认网络可以访问 QCode.cc 服务

模型列表为空？¶

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

Plan 模式不改文件？¶

这是预期行为。Plan 模式只规划不落地，切换到 Act 模式后改动才会写入。

报错 401 但配置看起来正确？¶

401 通常表示路径正确、仅鉴权失败。请重新核对 API Key 是否完整、是否选对了 Provider 类型（Anthropic vs OpenAI Compatible）与对应 Base URL。

下一步¶

• 查看 接入点与 API 格式 了解全部协议与域名

• 查看 Aider 集成 了解另一个兼容 QCode.cc 的开源工具

• 查看 VS Code 集成 使用 Claude Code 官方扩展

• 查看 计费说明 了解定价详情

还没有 API 密钥？查看 QCode.cc 套餐与定价 →