wbmeet

如何安裝並使用 Windsurf Cascade：安裝編輯器、登入與第一個倉庫任務

安裝獨立 Windsurf 編輯器、登入啟用 Cascade，再在自己的倉庫落地第一個可審查的 diff。

第一次用 Windsurf Cascade，卡住的通常不是提示詞，而是編輯器有沒有裝對、有沒有登入，以及倉庫裡第一件能審查的事。從官方下載獨立編輯器，登入後用快捷鍵打開 Cascade，再改一行你自己能回溯的程式。

檢索詞是 如何安裝並使用 Windsurf Cascade。下文對照官方入門與 Cascade 說明：windsurf.com、docs.devin.ai/windsurf。這是獨立桌面 IDE（VS Code 系）裡的代理，不是本站會議產品。要約短會對齊 diff，用 wbmeet 建房即可，步驟見 如何建立與加入房間。

安裝編輯器登入倉庫裡的第一件事

先核對你裝的是什麼

Windsurf 是獨立應用，不是必裝進現有 VS Code 的擴充。Cascade 在登入後才完整可用。免費檔可先試，額度與模型以官方定價頁為準。企業帳號可能有管理員限制。

3 OS
macOS / Windows / Linux
L
Cmd 或 Ctrl + L 打開 Cascade
1 次
登入啟用代理

第一次：安裝、登入、改一行能審查的程式

  1. 1

    從官網安裝編輯器

    打開 windsurf.com，選 macOS、Windows 或 Linux 安裝包，依系統完成安裝。不要從不明鏡像抓。首次啟動可匯入 VS Code 設定、快捷鍵與擴充。

  2. 2

    登入以啟用 Cascade

    用信箱、Google 或 GitHub 登入或註冊。跳過對話框後，命令面板搜尋 Sign in，或點狀態列帳號。未登入時 Cascade 面板常是空的或無法送出。

  3. 3

    打開自己的倉庫

    File → Open Folder，選你擁有、能回滾的專案。不要對生產密鑰目錄做第一次實驗。

  4. 4

    打開 Cascade 並給可審查任務

    Cmd+L（macOS）或 Ctrl+L（Windows/Linux），或側欄 Cascade 圖示。Write 會改檔，Chat 偏問答。先問「這個專案做什麼、入口在哪」，再：「給一個沒測試的輔助函式補單測，或給對外函式加輸入檢查。先出示 diff，等我 Accept。」不要把金鑰寫進提示。

# First hour · Windsurf Cascade · as of 2026-09
# 1. Download installer from https://windsurf.com
# 2. Sign in (email / Google / GitHub)
# 3. File → Open Folder → your repo
# 4. Cmd+L (macOS) or Ctrl+L (Windows/Linux)
# Write mode, then:
# "Add a unit test for one untested helper; show the diff and wait."

安裝、模式、常見坑

路徑官方怎麼寫第一次注意
獨立編輯器windsurf.com 安裝包不要從不明鏡像裝
登入帳號後 Cascade 才完整跳過登入等於代理關閉
Write / Chat改檔 vs 問答改程式先確認 Write
快捷鍵Cmd/Ctrl+L沒反應先查登入
擴充衝突VS Code 系可裝擴充關掉打架的 Copilot 補全
01

Cascade 沒反應

多半是未登入或權杖過期。登出再登入，重開編輯器。確認網路能連官方服務。

02

建議重複或互相打架

同時開著 GitHub Copilot 等補全時常見。先停掉競爭補全，只留 Cascade。

03

第一任務停在閒聊

問「專案做什麼」只是熱身。要有一條可審查改動，並在 Accept 前看 diff。

官方 Getting started 與 Cascade overview：先裝獨立編輯器並登入，再用 Cmd/Ctrl+L 打開 Cascade。指令與額度以官網為準。

編輯器 ≠ VS Code 外掛必裝
本頁寫獨立 Windsurf。外掛路徑能力較少，第一次請用官方編輯器。
Write 與 Chat
要改檔用 Write；只要解釋用 Chat，避免誤 Accept 一堆 diff。
教程頁不是會議說明書
只講 Cascade 第一次。短會白板見 wbmeet 與 對照筆記。

還想核對的問題

一定要付費才能用 Cascade 嗎？

官方提供可登入的免費檔試用。額度、模型與進階代理功能以當下定價與帳號類型為準，不要假設無限額度。

可以只在現有 VS Code 裡用嗎？

有外掛路徑，但官方把完整代理能力放在獨立 Windsurf。第一次請先裝編輯器，再考慮外掛。

快捷鍵沒打開 Cascade？

先確認已登入。再試側欄圖示或命令面板。快捷鍵可能被匯入的 VS Code 設定覆蓋。

第一個任務必須改正式環境程式嗎？

不必。先問專案做什麼，再做可回溯的小事（單測或檢查），並先看 diff。

免費開始開會