全部產品
Search
文件中心

Alibaba Cloud Model Studio:Cline

更新時間:Dec 02, 2025

Cline 是一款用於智能編程的 VSCode 外掛程式,您可以整合阿里雲百鍊提供的通義千問模型,完成複雜的編程任務。

前提條件

  • 您需要擷取與配置 API Key,並確保已開通阿里雲百鍊的模型服務;

  • 模型列表選擇您需要使用的通義千問模型。

    由於 Cline 的功能可能發生變化,模型的支援情況以實際效果為準。
  • 您需要下載並安裝 VSCode IDE。

使用步驟

1. 安裝 Cline

開啟 VSCode,在擴充商店搜尋Cline並安裝。

image.png

2. 配置模型與 API Key

安裝完成後,您需要開啟左側邊欄的image.png進入 Cline 的介面,單擊 Bring my own API key,在彈出的介面中,請選擇 API Provider

  • 推薦:選擇OpenAI Compatible,可以靈活使用包括最新模型在內的更廣泛模型。

  • 備選:選擇Alibaba Qwen,配置步驟更簡單,但可能不支援部分最新模型。

如果您之前使用過 Cline,請單擊右上方的設定按鈕後進行配置。

OpenAI Compatible

推薦使用此方式,支援更廣泛的模型。詳細配置如下:

配置項

說明

API Provider

選擇OpenAI Compatible

Base URL

  • 若使用國際(新加坡)地區模型,填入:https://dashscope-intl.aliyuncs.com/compatible-mode/v1

  • 若使用中國大陸(北京)地區模型,填入:https://dashscope.aliyuncs.com/compatible-mode/v1

API Key

根據使用模型的地區,填入中國大陸版或國際版的 API Key。

Model ID

填入您需要使用的模型名。建議您選擇編程能力較強的模型,如:

  • qwen3-coder-plus

  • qwen3-coder-480b-a35b-instruct

  • qwen3-235b-a22b

  • qwen3-max

其它

其它選項保持預設即可。更多功能請您根據需要進行探索。

說明

如果您使用 Qwen3(思考模式)或 QwQ 模型,請單擊MODEL CONFIGURATION,並勾選 Enable R1 messages format

單擊Continue完成配置。

如果您之前使用過 Cline,請單擊右上方的Done

image.png

Alibaba Qwen

配置項

說明

API Provider

選擇Alibaba Qwen

Alibaba API LIne

  • 若使用國際(新加坡)地區模型,選擇Internationl API

  • 若使用中國大陸(北京)地區模型,選擇China API

Qwen API Key

根據使用模型的地區,填入中國大陸版或國際版的 API Key。

Model ID

在下拉欄您需要使用的模型。建議您選擇編程能力較強的模型,如:

  • qwen3-coder-plus

  • qwen3-coder-480b-a35b-instruct

部分最新模型(如 qwen3-coder 系列)在中國大陸(北京)地區下可能無法選擇。如需使用這些模型,建議將 API Provider 更換為 OpenAI Compatible。

其他

其它選項保持預設即可。更多功能請您根據需要進行探索。

說明

模型的上下文參數與價格請參考模型列表

單擊Continue完成配置。

如果您之前使用過 Cline,請單擊右上方的Done

20251201174144

3. 使用 Cline

您可以通過輸入框上方的 Auto-approve 來對 Cline 的讀、寫、執行命令等許可權進行配置。

重要

開啟這些許可權可能導致 Token 消耗量的增加,建議您在充分瞭解 Cline 的功能特性後開啟這些許可權。

Cline 分為 PlanAct 兩種工作模式。

  • Plan 模式下,Cline 將主要負責收集資訊、拆解問題並設計完成任務的詳細計劃,但不會對檔案直接進行修改。

  • Act 模式下,Cline 將專註於制定方案並逐步完成具體操作,可以運行命令與修改檔案。

您可以在對話方塊的下側進行模式的切換。

Plan

以產生 Python 快速排序演算法為例,在 Plan 模式下向 Cline 提問:“寫一個 Python 的快速排序演算法?直接把代碼給我。”

20251127145130

在 Plan 模式下 Cline 不會直接進行代碼檔案的建立與修改。在 Act 模式下,Cline 會直接建立檔案並將代碼寫入。

Act

您可以新開一個會話,切換到 Act 模式。以產生 Python 快速排序演算法為例,向 Cline 提問:“寫一個 Python 的快速排序演算法?”

20251127151539

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:

  1. 減少無關檔案:為避免掃描不相關檔案而造成 Token 消耗,建議在具體的專案目錄中啟動 Cline,同時僅保留必要的專案檔。

  2. 總結對話:Cline 會將歷史對話內容作為上下文,可以點擊Compact Task按鈕或輸入命令/compact總結對話內容。

    20251127153230

  3. 精確指令:模糊的請求會觸發非必要的檔案掃描,消耗更多的 Token。請在使用 Cline 時提出更明確、具體的問題或指令。

  4. 分解任務:在處理複雜任務時,可以將其分解為若干簡單任務。

Q:使用 QwQ 模型報錯400 <400> InternalError.Algo.InvalidParameter: An error during model pre-process

A:請在設定介面單擊MODEL CONFIGURATION,並勾選 Enable R1 messages format。