如何在 VS Code 裡安裝並使用 Cline：市集安裝與第一次任務
從市集裝上 Cline，接通供應商，然後只下一件能檢查的倉庫任務。
VS Code 已經打開倉庫。你要一個會讀檔、改檔、跑命令的助手，而且每一步都要你點頭。官方擴充叫 Cline：從市集裝上，配好介面，再下一件能檢查的編碼任務。
可檢索的做法是 如何在 VS Code 裡安裝並使用 Cline：用擴充市集裝官方擴充，在面板設定裡選供應商並登入或貼上金鑰，然後在已開啟的 git 資料夾裡下一件有邊界的任務。安裝與授權以 docs.cline.bot 為準。
先裝擴充，再配供應商
市集安裝
按 Ctrl+Shift+X（Mac 用 ⌘⇧X）開啟擴充檢視，搜 Cline，按 Install。裝完用活動列圖示，或命令面板裡的 Cline: Open In New Tab。Windsurf / VSCodium 走 Open VSX，步驟相同。
供應商不是裝飾
面板裡點設定齒輪。API Provider 下拉框決定模型從哪來。沒配好時，對話發不出去，倉庫也不會被改。
| 路徑 | 你要準備什麼 | 適合誰 |
|---|---|---|
| Cline 記帳 | 用 Google / GitHub / 信箱登入，不必自己管金鑰 | 想少配一步、按用量付 |
| ClinePass | 選 ClinePass，登入，按提示訂閱 | 要固定月費的人 |
| 自備金鑰 | 選 Anthropic、OpenRouter、OpenAI、Gemini 等，貼上對應金鑰並選模型 | 已有雲端額度，或要跑本機 Ollama / LM Studio |
一遍走完：安裝、接入、第一次任務
- 01從市集安裝
確認裝的是 Cline 擴充。裝完打開 Cline 面板。若圖示沒出現，命令面板搜 Cline。
- 02配好供應商再說話
設定裡選 API Provider。走 Cline 記帳就 Sign In 完成 OAuth。走自備金鑰就把金鑰貼進對應欄位並選模型。本機執行時要先自己把服務拉起來。
- 03只下一件有邊界的編碼任務
在已經是 git 倉庫的資料夾裡寫清結果、目錄、怎樣算做成。Cline 會提議讀檔、寫檔或跑終端；每一步等你批准。不要把五件無關的活寫進同一條。
- 04審完再留
讀它改過的每個檔。拒絕越界的編輯和命令。測試自己跑。官方文件只保證工具迴路，不保證補丁一次正確。
在 src/auth/session.ts 加守衛：缺少 user id
時回傳 401。不要改 billing 目錄。跑既有的
session 單測，失敗就停。先列出要改的檔，
等我批准再寫盤。第一次任務常在哪裡斷
- 擴充裝了，面板是空的
- 多半是供應商沒配完。回設定完成登入或貼上金鑰，再選模型。
- 提示裡沒有邊界
- Cline 會讀得很寬。寫明目錄、測試、以及不許改的路徑。
- 把提議的命令全點批准
- 終端命令能改倉庫以外的東西。讀命令再點。方向錯了就停，不要在壞補丁上疊第二次。
先接通，再下一件任務，然後自己讀檔。批准按鈕不是審查。
金鑰和額度在你這邊
自備金鑰的費用走雲端廠商帳單。Cline 記帳和 ClinePass 的價格以 app.cline.bot 為準。本教程不保證某家模型一定接得上。
兩個人要對齊一次補丁再合入，把檔案清單攤在同一頁即可。用 oakmeet 開一間會過期的房：瀏覽器、空間碼、不用註冊。房間邊界見 八人、大約一小時。
Cline 和 Cursor Agent 是同一回事嗎？
不是。Cline 是 VS Code 市集裡的擴充，模型走你選的供應商。Cursor Agent 是 Cursor 編輯器自帶的迴路。兩邊都能改倉庫，安裝和帳單分開。
一定要付費嗎？
擴充本身從市集安裝。對話要接上模型：Cline 記帳、ClinePass，或你自己的金鑰 / 本機執行時。現行說明看 docs.cline.bot。本頁不販售方案。
金鑰存在哪？
貼進 Cline 設定的金鑰由 VS Code 金鑰儲存保管。官方排除寫過：清掉 IDE 金鑰會導致反覆重新登入。不要把金鑰寫進倉庫。
第一次任務寫多長？
一件能檢查的事就夠：一個檔或一個目錄、一條測試、一條禁止改動的路徑。做完再開下一件。