Cline 是一款用于智能编程的 VSCode 插件，您可以集成阿里云百炼提供的通义千问或 DeepSeek 模型，完成复杂的编程任务。
本文档仅适用于按量付费模式。如果您已订阅阿里云百炼 Coding Plan 并希望在 Cline 中使用，请参考 Coding Plan 说明文档 进行配置。
前提条件
使用步骤
1. 安装 Cline
打开 VSCode，在扩展商店搜索Cline并安装。
2. 配置模型与 API Key
安装完成后，您需要打开左侧边栏的
进入 Cline 的界面，单击 Bring my own API key，在弹出的界面中，请选择 API Provider ：
推荐：选择OpenAI Compatible，可以灵活使用包括最新模型在内的更广泛模型。
备选：选择Alibaba Qwen，配置步骤更简单，但可能不支持部分最新模型。
如果您之前使用过 Cline，请单击右上角的设置按钮后进行配置。
OpenAI Compatible
推荐使用此方式，支持更广泛的模型。详细配置如下：
单击Continue完成配置。 如果您之前使用过 Cline，请单击右上角的Done。 |
|
Alibaba Qwen
单击Continue完成配置。 如果您之前使用过 Cline，请单击右上角的Done。 |
|
3. 使用 Cline
您可以通过输入框上方的 Auto-approve 来对 Cline 的读、写、执行命令等权限进行配置。
打开这些权限可能导致 Token 消耗量的增加，建议您在充分了解 Cline 的功能特性后打开这些权限。
Cline 分为 Plan 和 Act 两种工作模式。
Plan 模式下，Cline 将主要负责收集信息、拆解问题并设计完成任务的详细计划，但不会对文件直接进行修改。
Act 模式下，Cline 将专注于制定方案并逐步完成具体操作，可以运行命令与修改文件。
您可以在对话框的下侧进行模式的切换。
Plan
以生成 Python 快速排序算法为例，在 Plan 模式下向 Cline 提问：“写一个 Python 的快速排序算法？直接把代码给我。”
在 Plan 模式下 Cline 不会直接进行代码文件的创建与修改。在 Act 模式下，Cline 会直接新建文件并将代码写入。
Act
您可以新开一个会话，切换到 Act 模式。以生成 Python 快速排序算法为例，向 Cline 提问：“写一个 Python 的快速排序算法？”
Cline 不仅生成了代码，还会将代码写进文件，并询问是否需要运行文件来测试效果，在您确认后 Cline 才会运行命令。
常见问题
Q：为什么报 401 Incorrect API key provided 错误？
A：可能有以下原因：
API Key 和 Base URL 的地域不匹配，请检查二者是否对应。
低版本 Cline 不支持选择 Alibaba Qwen 作为 API Provider。请升级 Cline，或将 API Provider 更换为 OpenAI Compatible。
Q：为什么 Token 消耗快？
A：Cline 会读取您本地的项目文件，并且多次调用API，这可能造成大量的 Token 消耗。如果您只需要简单的问答场景，请取消勾选输入框上方的 Auto-approve 并使用 Plan 模式。
Q：如何节省 Token？
A：
减少无关文件：为避免扫描不相关文件而造成 Token 消耗，建议在具体的项目目录中启动 Cline，同时仅保留必要的项目文件。
总结对话：Cline 会将历史对话内容作为上下文，可以点击Compact Task按钮或输入命令
/compact总结对话内容。
精确指令：模糊的请求会触发非必要的文件扫描，消耗更多的 Token。请在使用 Cline 时提出更明确、具体的问题或指令。
分解任务：在处理复杂任务时，可以将其分解为若干简单任务。
Q：使用 QwQ 模型报错400 <400> InternalError.Algo.InvalidParameter: An error during model pre-process？
A：请在设置界面单击MODEL CONFIGURATION，并勾选 Enable R1 messages format。