Cline 怎麼用：安裝、配置 API 與自定義模型、Plan / Act 模式、規則與 MCP 配置

本文根據 Cline 官方文檔整理，資料核對於 2026-10-11。Cline 是開源的編程智能體，產品介紹見本站 AI 應用目錄裏的 Cline 條目。

適用於誰

• 想在 VS Code 或 JetBrains 裏裝一個開源、能自己選模型的編程智能體的人；
• 搜「cline 怎麼用」「cline 配置 api」「cline 配置自定義模型」「cline mcp 配置」的人；
• 手裏有某家模型的 API Key，想接進編輯器裏用的人。

結論先說

1. Cline 有五種形態：桌面 App、IDE 擴展（VS Code、Cursor、JetBrains、Windsurf、VSCodium、Antigravity）、CLI、Kanban（預覽）、SDK。多數人從 IDE 擴展開始。
2. 模型接入三選一：Cline Provider（按量付費）、ClinePass（包月）、自帶提供方的 API Key。
3. 接「自定義模型」的關鍵是三項：Base URL、API Key、Model ID，在設定裏選 OpenAI Compatible。
4. 兩種模式：Plan（只讀，只討論不動手）和 Act（按計劃改文件、跑命令）。官方強烈建議先 Plan 再 Act。
5. 規則放在 .clinerules/ 或 .cline/rules/；Cline 還會自動識別 .cursorrules、.windsurfrules 和 AGENTS.md。
6. 是否每一步都問你，由 Auto Approve 的開關決定；「YOLO 模式」等於全部放行，慎用。

步驟一：安裝

VS Code 及同類編輯器：Ctrl/Cmd+Shift+X 打開擴展面板 → 搜尋 Cline → Install → 在側邊欄找到 Cline 圖標。Windsurf 和 VSCodium 走 Open VSX，流程相同。

JetBrains：Settings → Plugins → Marketplace 搜尋 Cline → Install → 重啟 IDE → View → Tool Windows → Cline。

CLI：需要 Node.js 20 及以上（官方推薦 22）：

bash
npm install -g cline
cline auth

桌面 App：從 cline.bot/desktop 下載，支持 macOS 和 Windows（Windows 目前為 beta）。官方說明 Cline Desktop 是面向開放權重模型的開源應用，需要你自己提供模型訪問。

步驟二：配置模型

裝好後在 Cline 設定裏（面板上的 ⚙️ 圖標）完成提供方設定。

用官方直連的提供方（以 DeepSeek 為例）

1. 到 DeepSeek 開放平台註冊登入，在 API keys 頁點「Create new API key」；
2. 立刻複製密鑰——官方提醒之後無法再次查看，要妥善儲存；
3. 在 Cline 設定的 API Provider 下拉里選 DeepSeek；
4. 把密鑰粘到 DeepSeek API Key 一欄，選擇模型。

官方文檔為 Anthropic、OpenAI、Google Gemini、OpenRouter、AWS Bedrock、Qwen、MiniMax、Z.ai 等都寫了同樣格式的配置頁，另有「30+ 其他提供方」的彙總。

用 OpenAI 兼容接口接「自定義模型」

任何提供 OpenAI 兼容接口的服務都可以這樣接：

本地模型（Ollama、LM Studio）也走這條路，官方有單獨的《Running Models Locally》說明。

關於密鑰：按官方的配置目錄說明，提供方配置和 API Key 儲存在本機的 ~/.cline/data/settings/providers.json。這個文件不要提交進倉庫，也不要在截圖裏露出來。只使用模型提供方官方發放的 Key。

步驟三：Plan 與 Act

Plan 模式：Cline 可以讀代碼庫、搜尋、和你討論方案，但不能改任何文件、不能執行命令。官方說這個限制是有意的——讓對話專注在理解和規劃上。

Act 模式：帶着規劃階段的完整上下文，開始改文件、跑命令。切換模式時對話歷史會保留，不用重講一遍。

官方的典型流程：

1. 在 Plan 模式描述你要做什麼；
2. 讓 Cline 探索相關文件、理解代碼庫；
3. 討論方案，想清邊界情況和潛在問題；
4. 有把握了，切到 Act；
5. Cline 按規劃實施。

複雜項目可以來回切：實施中遇到沒預料到的複雜情況，就回 Plan 重新想。兩種模式還可以分別指定不同的模型。

步驟四：寫規則

規則是 Markdown 文件，為所有對話提供常駐指令。

新建：點 Cline 面板底部、模型選擇器左邊的天平圖標 → New rule file... → 輸入文件名（會自動加 .md）。也可以用 /newrule 讓 Cline 交互式地幫你寫。

全局規則的預設目錄：Windows 為 Documents\Cline\Rules，macOS / Linux 為 ~/Documents/Cline/Rules。工作區規則和全局規則會合並，衝突時工作區優先。

每條規則都有獨立開關——比如做原型時臨時關掉嚴格的測試規則，而不用刪文件。建議一個文件只管一件事（編碼規範、測試要求、架構決定各一個）。

步驟五：Auto Approve 怎麼開

Auto Approve 按每次工具調用判斷，分類授權：

要特別注意官方的一句話：Cline 沒有固定的命令白名單，每條命令是「安全」還是「需要批准」，是模型自己根據命令和參數標記的——官方給的例子是示例而非保證：npm test、git status、ls 通常算安全，npm install、rm -rf 通常需要批准。

所以比較穩妥的組合是：開「讀項目文件」「編輯項目文件」「執行安全命令」，其餘保持關閉；不要開 Execute all commands 和 YOLO 模式，除非是在可以隨時丟棄的環境裏。

步驟六：配置 MCP

1. 在 Cline 面板頂部點 MCP Servers 圖標；
2. Configure 標籤頁 → Configure MCP Servers，會打開擴展使用的 MCP 設定 JSON，在 mcpServers 下增改條目；
3. 接遠程託管的伺服器更簡單：在 Remote Servers 標籤頁填 Server Name、Server URL，傳輸方式選 Streamable HTTP（推薦）或 SSE（舊），點 Add Server；
4. 配好憑據後，確認工具出現在列表裏，並試調一次。

配置結構和其他工具一致：本地伺服器用 command + args，遠程伺服器用 url。CLI 的 MCP 配置文件在 ~/.cline/data/settings/cline_mcp_settings.json。挑選與審查見《MCP 伺服器怎麼選》。

常見問題

Q：.clineignore 能保護敏感文件嗎？

不能當安全措施用。官方已標註它即將棄用，並明確說它只是過濾「自動加載」的內容，不是安全或訪問控制邊界——被忽略的文件仍可通過 @ 引用或 shell 命令讀到。官方給的替代方案是用 PreToolUse hook 真正攔截工具調用。

Q：改錯了能回退嗎？

Cline 有 Checkpoints（檢查點）功能可以回到之前的狀態；同時仍建議在 Git 管理下使用。

Q：全局配置和項目配置分別在哪？

全局在 ~/.cline/（對 IDE、CLI、SDK 都生效），項目在倉庫根目錄的 .cline/。

Q：Cline 和 Cursor、Claude Code 怎麼選？

Cline 的特點是開源、模型自選、裝進現有編輯器。它們的定位差異見《Cursor、Claude Code、Codex 有什麼區別》。

參考資料

• Installing Cline（官方）：https://docs.cline.bot/getting-started/installing-cline
• Config（官方）：https://docs.cline.bot/getting-started/config
• Plan & Act Mode（官方）：https://docs.cline.bot/core-workflows/plan-and-act
• Rules（官方）：https://docs.cline.bot/customization/cline-rules
• Auto Approve & YOLO Mode（官方）：https://docs.cline.bot/features/auto-approve
• MCP（官方）：https://docs.cline.bot/mcp/mcp-overview
• OpenAI Compatible（官方）：https://docs.cline.bot/provider-config/openai-compatible