Cursor 教學完整指南：從安裝到進階功能（2026 年 9 月版）

這份 Cursor 教學依 Cursor 官方文件、說明中心、定價頁與下載頁逐項核對後整理，涵蓋下載安裝、初始設定、第一次用 Agent 改程式碼、Plan Mode、@ 引用、Tab 補全、快捷鍵與方案價格。內容核對日期為 2026 年 9 月 30 日，當時官方下載頁標示的最新桌面版本為 3.22。

查看相關日報

Cursor 是什麼？先看官方怎麼定義

官方文件首頁對 Cursor 的定義是「a coding agent for building ambitious software」，可以用來理解程式碼庫、規劃與實作功能、修 bug、審查改動。介面沿用 VS Code 的操作邏輯（官方遷移文件寫明 Cursor 建立在 VS Code 的程式碼基礎上）。要理解 Cursor 怎麼用，先分清楚官方文件裡三個不同的東西：

Agent：官方文件的定義是「Cursor's assistant that can complete complex coding tasks independently, run terminal commands, and edit code」——能獨立完成較複雜的編碼任務、執行終端機指令、修改程式碼。它由三個部分組成：指令（system prompt 與 rules）、工具（檔案編輯、程式碼搜尋、終端機執行等），以及你選定的模型。

Tab：官方定義是「Cursor's AI-powered autocomplete」，依你最近的編輯、游標周圍的程式碼與 linter 錯誤提出建議。它可以一次修改多行、補上缺少的 import，也會預測跨檔案的連帶修改。

Composer：這個字在 2026 年的官方文件裡指的是模型名稱（目前列出的是 Composer 2.5），不是某個編輯功能。看到舊教學把 Composer 講成「多檔編輯模式」，那是過去的說法。

Cursor 如何找到你專案裡的程式碼

官方「Search」文件描述兩種機制：

• Instant Grep：做精確比對（函式名、變數、錯誤字串、regex），官方說法是在大型程式碼庫上「outperforms ripgrep」，且「runs automatically; no configuration needed」。索引在你自己的電腦上建立與查詢，官方明寫 Cursor 不會為了建索引上傳檔案路徑或程式碼，也不會儲存程式碼庫的 embeddings。不過 Agent 打開某個檔案後，該檔內容仍可能被放進送給模型的請求裡。
• Explore subagent：Agent 可以派出專門的子代理，在自己獨立的 context window 裡用較快的模型平行執行多組搜尋，只把整理過的結果帶回主對話。Agent 會自己判斷何時使用，你也可以直接要求，例如「use a subagent to find all the places we validate user input」。

事前準備：帳號與下載

官方說明中心列出的安裝前準備只有一項：一個 Cursor 帳號（可在 cursor.com 免費註冊）。

下載頁（cursor.com/download）目前提供的桌面版安裝檔如下：

• macOS：Mac (ARM64)、Mac (x64)、Mac Universal
• Windows：x64 與 ARM64，各分 System（系統層級）與 User（使用者層級）兩種
• Linux：.deb、RPM、AppImage，各有 ARM64 與 x64

下載頁同時保留 3.21、3.20、3.19、3.18 等先前版本。官方頁面沒有列出作業系統最低版本，也沒有記憶體、CPU 或磁碟的硬體需求。

Step 1：安裝與初始設定

安裝並登入（照著做）

以下步驟依官方說明中心「Download and install Cursor」整理：

1. 前往 cursor.com/download。
2. 點選你作業系統對應的下載按鈕。
3. 開啟下載的檔案，依作業系統完成安裝：

• Mac：把 Cursor 拖進「應用程式」（Applications）資料夾。
• Windows：執行安裝程式，依畫面提示完成。
• Linux：有套件管理器就用 apt 或 dnf 安裝；否則解開 AppImage 或壓縮檔後直接執行。

1. 從應用程式選單或桌面開啟 Cursor。
2. 出現提示時，用你的 Cursor 帳號登入。
3. 用 File > Open Folder 開一個專案資料夾，就可以開始了。

從 VS Code 匯入設定

如果你原本用 VS Code，官方提供一鍵匯入：

1. 開啟 Cursor Settings（⌘/Ctrl + Shift + J）。
2. 進入 General > Account。
3. 在「VS Code Import」下點 Import。

會一併帶過來的是 Extensions、Themes、Settings 與 Keybindings 四項。

若想更精確控制，或要在不同電腦之間搬設定，官方也提供手動搬 profile 的做法：在 VS Code 開啟命令面板（⌘/Ctrl + Shift + P）→ 搜尋「Preferences: Open Profiles (UI)」→ 在左側選定 profile → 三點選單 → Export Profile（可存本機或 GitHub Gist）；再到 Cursor 用同一個命令面板項目，在 New Profile 旁的下拉選單選 Import Profile，貼上 GitHub Gist 網址或用 Select File 上傳本機檔案，按 Import 儲存，最後在側欄選新的 profile、點勾勾圖示啟用。

另一個常見疑問：Cursor 的活動列（activity bar）預設是橫向的。想改回 VS Code 那種直向，官方做法是在命令面板開「Preferences: Open Settings (UI)」→ 搜尋 workbench.activityBar.orientation → 設為 vertical → 重新啟動 Cursor。

開啟 Privacy Mode

這是動手寫 code 之前最該先確認的一項。官方說明是「Privacy Mode ensures your code is never used for training by Cursor or other AI model providers」。

設定路徑：

1. 開啟 Cursor Settings（Mac 為 Cmd + Shift + J，Windows／Linux 為 Ctrl + Shift + J）。
2. 點左側的 General。
3. 把 Privacy Mode 切換為開啟。

團隊帳號的成員預設即為開啟，管理員可以在 cursor.com/dashboard 強制套用到整個組織，成員無法自行關閉。個人帳號則要自己確認開關狀態。

官方也列出例外：使用你自己的 API key 時不適用零資料保留（ZDR），資料處理改依該模型供應商的隱私政策。

調整 Tab 的行為

Tab 的設定在 Cursor Settings > Tab。此外，點編輯器右下角的 Tab 狀態指示器，可以直接暫時停用（snooze，自選時長）、全域停用，或針對特定副檔名（例如 Markdown、JSON）停用。

接受建議的按鍵可以改：到 Keyboard Shortcuts 設定搜尋 Accept Cursor Tab Suggestions 重新綁定即可。

Step 2：第一次用 Agent 改程式碼（照著做）

以下流程依官方 Quickstart 整理，目標是從開好資料夾到完成第一個有用的改動。

1. 開啟 Agent，請它先講解專案

開好資料夾後，按 Cmd + I（Windows／Linux 為 Ctrl + I）在側邊面板開啟 Agent。官方 Quickstart 建議的第一句提示詞是：

Explain this codebase. Point me to the main entry points, key modules, and anything I should read before making changes.

Agent 會搜尋你的 repo、讀相關檔案，整理出專案的整體結構。官方說這是熟悉陌生程式碼庫最快的方法之一。

2. 請它提改進方案，挑一個小的做

接著請它先提方案、不要急著改。官方範例提示詞：

Suggest three small, safe improvements in this codebase. Explain the tradeoffs and wait for me to choose one.

從中挑一個，再請它動手。官方建議第一個任務挑低風險的，例如改一段文案或修一個小的 UI 問題。如果你本來就知道要改什麼，直接講清楚你要的結果即可。

3. 看 diff，請它跑專案既有的檢查

Agent 工作時，diff 檢視會顯示它做的改動。完成後逐一看過 diff，再請 Agent 跑你專案原本就在用的檢查——測試、型別檢查、lint 或本機 build。

檢視改動時的鍵盤操作（Mac，依官方快捷鍵頁）：

• Cmd + Return（有待確認的改動時）：接受全部改動
• Cmd + Shift + Backspace（有待確認的改動時）：拒絕全部改動
• Cmd + Shift + Backspace（正在生成時）：取消生成

AI 產出的程式碼仍可能用到過時的套件或不符合專案慣例的寫法。逐檔看過 diff 再接受，是這個流程裡不能省的一步。

4. 改壞了就用 checkpoint 退回

Agent 在做重大改動前會自動建立 checkpoint，記錄所有被修改檔案的狀態。如果它走錯方向，在對話時間軸上點任一個 checkpoint 就能預覽當時的檔案，再按 restore 把所有檔案還原到那個狀態；也可以用先前請求上的 Restore Checkpoint 按鈕。

兩個要注意的地方：還原只會退回檔案，不會刪掉對話紀錄；checkpoint 存在本機、和 Git 分開，官方明講它只用來撤銷 Agent 的改動，正式的版本控制仍要用 Git。

Agent 工作時還能插話

Agent 還在跑的時候，你輸入新訊息按 Enter，訊息會排進佇列，等目前任務結束才處理；按 Cmd + Enter 則立刻送出、不排隊，用在要中途改方向的時候。想問旁支問題又不打斷主任務，可以在輸入框打 /side 或 /btw 開一個 side chat。

切換 Plan Mode

如果任務比較大——橫跨多個檔案、需要先研究、或要先確認做法才動工——官方建議先走 Plan Mode。流程是：

1. Agent 先問釐清問題，確認你的需求。
2. 研究程式碼庫，蒐集相關脈絡。
3. 產出一份詳細的實作計畫。
4. 你透過對話或直接改 markdown 檔來修改計畫。
5. 確認後點擊開始實作。

計畫預設存在你的家目錄；點「Save to workspace」可以移到專案裡，方便日後參考或與團隊分享。官方另外建議：Agent 做出來的東西不對時，與其一直追加指令修，不如退回改動、把計畫寫得更精確後重跑，通常更快、結果也更乾淨。

相對地，官方對 Agent Mode 的定位是「quick changes or tasks you've done many times before」——小改動或做過很多次的事。

切換方式有兩種：用 Agent 裡的 mode picker 下拉選單，或在輸入框按 Shift + Tab 輪換模式。輸入的內容看起來是複雜任務時，Cursor 也會主動建議切換到 Plan Mode。

Step 3：進階技巧

用 @ 帶入正確的上下文

在輸入框打 @，接著輸入文字，Cursor 會列出符合的建議。官方文件列出的 @ 引用類型如下：

• @auth.ts、@src/components/：指定檔案或資料夾（選了資料夾後再打 / 可以往下一層找）
• @Terminals：終端機輸出
• @Chats：先前某次對話的上下文
• @Commit（Diff of Working State）：尚未 commit 的改動
• @Branch（Diff with Main）：整個分支相對於 main 的 diff
• @Browser：內建瀏覽器裡的內容

官方的建議是：確定哪些檔案相關時才用 @；不確定就別加，Agent 會自己搜尋找到相關檔案。

另外，斜線 / 在輸入框裡是用來叫用 skills 的，不是搜尋檔案。

@Commit 與 @Branch 這兩項很適合做 code review：把未提交的改動整份丟給 Agent，請它先講一遍這次改了什麼、有沒有漏掉的呼叫端。

附上截圖或用語音輸入

除了文字，輸入框也能直接拖放圖片，或用 Cmd + V 貼上剪貼簿裡的截圖，適合做 UI 實作、比對設計稿或貼錯誤訊息。點輸入框的麥克風圖示則可以語音輸入，送出前記得看一下轉出來的文字。

注意 context 用量

輸入框旁有一個 context 圓環，顯示這段對話已經用掉多少模型的上下文空間；點開可以看到依類別（system prompt、工具、rules、skills、MCP、對話內容等）拆分的 token 用量。快滿時，Cursor 會把較早的對話壓縮成摘要，騰出空間。

把 Tab 用滿

Tab 不只補當前這一行。官方說明中心提到三種行為：多行同時修改（包含補上缺少的 import）、跨相關程式碼的連動編輯，以及跨檔案預測——「Tab predicts cross-file edits when changes in one file need updates in another」，此時編輯器底部會出現一個 portal 視窗。

操作上：

• 按 Tab 接受整段建議
• 按 Esc 或繼續打字即拒絕
• Mac 按 Cmd + →、Windows／Linux 按 Ctrl + → 逐字接受
• 接受之後再按一次 Tab，會跳到下一個預測的編輯位置（官方稱為 jump-in-file）

常用快捷鍵

官方快捷鍵頁以 Mac 鍵位呈現，並說明其鍵位以 VS Code 的 key bindings 為基準；說明中心另列出 Windows／Linux 對應鍵位（把 Cmd 換成 Ctrl）。想看完整清單，Mac 按 Cmd R 再按 Cmd S（Windows／Linux 為 Ctrl R 再 Ctrl S），或在命令面板搜尋 Keyboard Shortcuts。

• Cmd I／Cmd L：Toggle Sidepanel（未綁定為模式時）
• Cmd E：Toggle Agent layout
• Cmd .：Mode Menu（模式選單）
• Shift Tab：輪換 Agent 模式
• Cmd /：Loop between AI models（輪換模型）
• Cmd Shift J：Cursor settings
• Cmd ,：General settings
• Cmd Shift P：Command palette
• Cmd K：開啟 Inline Edit；在終端機裡則是開啟 terminal prompt bar
• Cmd N／Cmd R：New chat
• Cmd T：New chat tab
• Cmd [／Cmd ]：上一個／下一個對話
• Cmd W：關閉對話
• Cmd Shift L（已選取程式碼時）：把選取的程式碼加入 context
• Cmd Shift Space：Toggle Voice Mode

方案與價格

以下為 2026 年 9 月 30 日官方定價頁與「Models & Pricing」文件列出的內容：

• Hobby｜免費：官方列出「No credit card required」、「Limited Agent requests」、「Access to Composer」。
• Individual：分三檔——Pro US$20／月、Pro Plus US$60／月、Ultra US$200／月。定價頁列出的重點包括「Extended limits on Agent」、「Generous limits for Grok」、「Access to frontier models」、「MCPs, skills, and hooks」、「Cloud agents」，Bugbot 採用量計費。文件另寫明這三檔都包含不限次數的 Tab 補全。
• Teams：分兩種席次——Standard US$40／使用者／月、Premium US$120／使用者／月，Premium 的 Agent 額度是 Standard 的 5 倍。功能包括集中帳務與管理、團隊 marketplace（內部 rules／skills／plugins）、Bugbot 代理式 code review、使用分析、全團隊 privacy mode、SAML/OIDC SSO。
• Enterprise｜洽詢報價：共用額度（pooled usage）、發票／採購單付款、SCIM 席次管理，repo／模型／MCP 存取控制、稽核紀錄與服務帳號、AI code tracking API、優先支援。

關於免費版的實際額度：官方定價頁只寫「Limited Agent requests」，沒有公布具體次數。

付費版的額度怎麼算

Pro、Pro Plus、Ultra 都有兩個各自獨立、每個帳單週期重置的額度池：

• Cursor Models：Cursor 自家模型（Grok 4.7、Grok 4.6、Grok 4.5、Composer 2.5）用這一池，官方說明包含的用量明顯較多。
• Other Models：第三方模型用這一池，依該模型的 API 價格扣。

額度用完後，可以改用按量計費（同樣的 API 費率）繼續用，或升級方案。官方的用量參考：每天用 Tab 的人通常在包含的額度內；每天用 Agent 的人，總用量通常落在每月 US$60–100；同時跑多個 Agent 或自動化的重度使用者常超過 US$200。

可以用哪些模型

官方「Models & Pricing」頁把模型分成兩類，並以每百萬 token 標價：

• Cursor 自家模型：Grok 4.7、Grok 4.6、Grok 4.5、Composer 2.5，各自另有 Fast 版本。Composer 2.5 的標價為輸入 $0.5、快取讀取 $0.2、輸出 $2.5。
• 第三方模型：頁面列出 Anthropic 的 Claude Fable 5.1、Claude Opus 5.5、Claude Sonnet 5.5，Google 的 Gemini 3.1 Pro、Gemini 3.8 Flash，OpenAI 的 GPT-5.6 Luna／Sol／Terra，以及 Meta 的 Muse Spark 1.3。

在編輯器裡切換模型，可以用輸入框上方的 model picker 下拉選單，或按 Cmd + / 輪換；預設模型在 Cursor Settings > Models 設定。官方建議：快速修改與例行任務用較快的模型，複雜推理與多檔重構用能力較強的模型，同一段對話中途也可以換。

與其他 AI 程式工具比較

各家工具的功能名稱、定價與額度變動頻繁，跨產品的「誰比較好」多半取決於你的語言、專案規模與既有工作流。若要比對 Cursor 與 GitHub Copilot 的功能與定價細節，可參考：Cursor vs GitHub Copilot 完整比較。

常見問題 FAQ

Cursor 怎麼安裝？支援哪些平台？

到 cursor.com/download 下載對應作業系統的安裝檔：macOS 有 ARM64、x64 與 Universal；Windows 有 x64 與 ARM64（各分系統層級與使用者層級）；Linux 有 .deb、RPM 與 AppImage。Mac 拖進應用程式資料夾、Windows 執行安裝程式、Linux 用 apt 或 dnf 安裝，開啟後用 Cursor 帳號登入即可。

Cursor 免費嗎？免費版有什麼限制？

有免費方案 Hobby，無需信用卡。官方定價頁對它的限制只寫「Limited Agent requests」與「Access to Composer」，未公布具體次數上限。付費的 Individual 方案分 Pro（每月 US$20）、Pro Plus（US$60）、Ultra（US$200）。

Cursor 跟 VS Code 有什麼差別？

Cursor 建立在 VS Code 的程式碼基礎上，鍵位也以 VS Code 為基準，但把 AI 代理放進核心：Agent 能執行終端機指令並直接改檔案，Tab 會預測跨檔案的連帶修改。原有擴充套件、主題、設定與快捷鍵可一鍵匯入。

怎麼確保我的程式碼不會被拿去訓練？

開啟 Privacy Mode：Cursor Settings（Cmd/Ctrl+Shift+J）→ General → 切換開啟。官方說明為開啟後程式碼不會被 Cursor 或模型供應商用於訓練。團隊帳號預設開啟，管理員可強制套用。

@ 可以引用哪些東西？

官方列出檔案與資料夾（如 @auth.ts）、@Terminals（終端機輸出）、@Chats（先前對話）、@Commit（未提交的改動）、@Branch（分支相對 main 的 diff）與 @Browser（內建瀏覽器）。

Cursor 可以用哪些 AI 模型？

官方模型頁分兩類：自家的 Grok 4.7、Grok 4.6、Grok 4.5、Composer 2.5，以及第三方的 Anthropic Claude、Google Gemini、OpenAI GPT-5.6 系列與 Meta Muse Spark。編輯器內用 model picker 或 Cmd + / 切換。

Plan Mode 和 Agent Mode 差在哪？

Plan Mode 會先提出釐清問題、研究程式碼庫，產出一份你可以編輯的實作計畫，確認後才動工。Agent Mode 官方定位是「快速改動或你已做過很多次的任務」。用 mode picker 或 Shift + Tab 切換。

Agent 改壞了怎麼辦？

在對話時間軸上點 Agent 自動建立的 checkpoint，預覽後按 restore，就能把所有被改的檔案還原到當時的狀態。checkpoint 存在本機、和 Git 分開，只用來撤銷 Agent 的改動。

資料來源

本文事實依據以下 Cursor 官方頁面，核對日期 2026 年 9 月 30 日：

• 官方文件首頁：https://cursor.com/docs
• Quickstart：https://cursor.com/docs/get-started/quickstart
• 下載與安裝（說明中心）：https://cursor.com/help/getting-started/install
• Tab（說明中心）：https://cursor.com/help/ai-features/tab
• Agent 總覽（含 checkpoints）：https://cursor.com/docs/agent/overview
• Plan Mode：https://cursor.com/docs/agent/plan-mode
• 搜尋（Instant Grep／Explore）：https://cursor.com/docs/agent/tools/search
• 提示與 @ 引用：https://cursor.com/docs/agent/prompting
• 快捷鍵：https://cursor.com/docs/reference/keyboard-shortcuts
• 快捷鍵（說明中心，含 Windows／Linux）：https://cursor.com/help/customization/keyboard-shortcuts
• VS Code 遷移：https://cursor.com/docs/configuration/migrations/vscode
• 隱私與資料：https://cursor.com/help/security-and-privacy/privacy
• 模型與計價：https://cursor.com/docs/models-and-pricing
• 定價：https://cursor.com/pricing
• 下載與版本：https://cursor.com/download

價格、額度與模型清單由 Cursor 官方隨時調整，實際內容請以上列頁面當下顯示為準。