網誌 · Cursor 使用指南 · 發佈

Cursor 怎麼開始用:下載、登入與第一個專案

按 Cursor 官方快速入門整理下載、登入與第一個專案的順序:各系統該取哪種安裝包、登入後要確認什麼、用 Cmd/Ctrl+I 開啟 Agent 先解釋程式碼庫,再做一個小改動、看 diff 並執行專案原有的檢查;任務跨多個檔案、需要先做調研或需要你先批准時,用 Plan Mode。文中給出下載對照表、Plan Mode 的適用判斷與卡住時的五步排查,並說明不建議使用第三方打包的安裝包。

第一次用 Cursor,按官方快速入門的順序走,步驟是清楚的:從下載頁取對應系統的安裝包,開啟應用程式登入,選一個資料夾,用 Cmd+I(macOS)或 Ctrl+I(Windows、Linux)開啟 Agent(智慧代理,能自己讀專案檔案、改程式碼的助手),先讓它解釋這個程式碼庫,再做一個小改動,最後看 diff(差異檢視,逐行標出新增、刪除與修改的行)並執行專案原本在用的檢查(Cursor 快速入門)。第一次不必從重寫整個模組開始,官方舉的低風險例子是改文案、修小介面這類改動;跨多個檔案、需要先做調研,或需要你先批准再寫程式碼時,適合先按 Shift+Tab 切到 Plan Mode(計畫模式)拿一份計畫。

一、下載:先按系統對一遍安裝包

官方把下載清單按系統分開,差別不只在安裝包副檔名:

系統 官方寫明的版本要求 安裝包形式 頁面另註明的資訊
macOS macOS 12(Monterey)及以上 原生安裝包(.dmg) Apple Silicon 與 Intel 都支援
Windows Windows 10 及以上 原生安裝包(.exe) 該頁未另列其他要求
Debian / Ubuntu 該頁未另列 apt 套件庫 頁面標註為推薦方式
RHEL / Fedora 該頁未另列 dnf 套件庫 用官方給出的套件庫檔案安裝
Linux 可攜版 該頁未另列 AppImage 先賦予執行權限再執行

原生安裝包(.dmg、.exe)是下載後雙擊、按系統提示裝好的常規方式,不經過軟體商店,也不需要額外的軟體來源。macOS 這一行只列了一個 .dmg,並註明兩種晶片都支援,所以不必再挑晶片版本。

Linux 那三行才需要做選擇。官方寫明 apt 與 yum 套件優先於 AppImage,理由是它們提供桌面圖示、自動更新與 CLI(命令列工具,能在終端機裡直接輸入命令呼叫 Cursor)。AppImage 按頁面標註是可攜版,下載後先用 chmod +x 加上執行權限,再直接執行;官方把自動更新這一條寫在 apt 與 yum 名下,沒有寫給 AppImage。

取得途徑也按這個分法:桌面安裝包從 cursor.com 的下載頁取,Linux 的套件庫位址在 downloads.cursor.com(Cursor 快速入門)。論壇、網路硬碟或教學附件裡的安裝包無法核對來源與改動,本篇不建議使用第三方打包的版本。

二、登入:官方只寫一步,你要確認兩件事

快速入門對登入只寫到「開啟應用程式並登入」這一步,然後就是選一個資料夾、從一個小任務開始。這一頁沒有再展開帳號類型、方案或計費;文件首頁把模型與定價收在 Models & Pricing 一欄,帳號與帳單問題則指向官方 Support 入口(Cursor 文件)。

所以第一次登入只需要確認兩件事:能進到應用程式主介面,能選中一個本機資料夾。這兩件都成立,就可以往下走;卡在這一步,先回官方下載頁核對系統版本,不建議改用第三方打包的安裝包。

介面和你看到的教學截圖對不上時,文件首頁另有 Changelog(更新記錄)入口,先去核對最近改了什麼,再判斷是不是自己點錯了。

三、第一個專案:先讓它講清楚,再讓它動手

選好資料夾後,用 Cmd+I 或 Ctrl+I 開啟 Agent。官方建議的第一個請求是讓它解釋這個程式碼庫:指出主要入口、關鍵模組,以及動手改之前應該先讀哪些檔案。它會搜尋儲存庫、讀取相關檔案,再把專案各部分怎麼拼起來總結給你。

有一個前提不能跳過:Agent 讀的是你選中的那個資料夾。目錄選錯,它講的就成了另一個專案,後面的改動也會落到錯誤的位置。所以第一步不是急著寫提示,而是先看專案欄裡的目錄名稱對不對。

提示用中文寫就行,把範圍、要它輸出什麼說清楚。官方給的兩個範例都是先說明要它做什麼,其中第二個還要求它說明取捨、並等你選擇之後再動手;下面這個範例另外加了一句「先不要改動檔案」,你可以按需要保留(假設示範,不是官方原話):

先不要改動任何檔案,通讀這個專案,告訴我入口在哪、核心模組有哪幾個、改程式碼之前必須先讀哪幾個檔案,無法確認的地方標出來。

四、第一個改動:小、能核對、能還原

看懂結構之後,讓它提幾個小而安全的改進並說明各自的取捨,你挑一個再讓它動手;如果你已經知道要什麼,就直接描述想要的結果。官方舉的低風險例子是改文案、修小的介面問題——範圍小,出問題時也好還原。

它動手時你會看到 diff,逐行標出新增、刪除和修改。官方在這一步的要求很具體:等它做完,先看 diff,再讓它執行專案本來就在用的檢查。這類檢查通常分四種,含義不一樣:

  • 測試:跑一遍既有測試案例,看有沒有改壞;
  • 型別檢查:看變數和資料的型別對不對得上;
  • lint:程式碼規範檢查,管格式和易錯寫法;
  • 本機建置:看專案能不能正常打包或啟動。

這一步把「看起來改對了」變成「跑過一遍」。diff 讓你看它到底動了哪幾行,檢查告訴你有沒有弄壞別的地方。兩樣都過,再談下一個任務;只過一樣,就先讓它解釋沒過的原因,別急著加需求。

五、任務變大:先切 Plan Mode 拿計畫

官方寫明 Plan Mode 適合三種任務:跨多個檔案、需要先做調研、或者要你先批准再寫程式碼。切換方式是在 Agent 輸入框按 Shift+Tab。進入後它不會馬上寫程式碼,而是按順序走:調研程式碼庫找出相關檔案,就需求提問,給出詳細的實施計畫,等你批准後再動手。

你手上的任務 建議模式 你會看到什麼 你要做什麼
改一句文案、調一處樣式 直接改 一份 diff 看 diff、跑專案已有的檢查
涉及多個檔案的新功能或重構 Plan Mode 相關檔案、提問、實施計畫 回答提問、批准計畫
需求自己也說不清 Plan Mode 它反過來問你 先把需求答清楚再批准

最直接的判斷是這次改動會不會同時動到好幾處;如果任務還需要先做調研,或者需要你先批准再寫程式碼,也同樣適合用 Plan Mode。

六、卡住時按這個順序排查

按順序走,每一步都能得到一個明確答案:

  1. 裝不上:先核對系統版本(macOS 12 起、Windows 10 起);Linux 優先使用 apt 或 dnf 套件庫;AppImage 要先賦予執行權限才能執行。
  2. 打不開 Agent:macOS 用 Cmd+I,Windows 與 Linux 用 Ctrl+I。
  3. 改完不確定對不對:開啟 diff 逐行看,再讓它執行專案已有的測試、型別檢查、lint 或本機建置。
  4. 越改越亂:先停手,切到 Plan Mode 要一份計畫,批准之後再讓它動手。
  5. 帳號、計費以及文件沒涵蓋的問題:走文件首頁的 Models & Pricing 與 Support 兩個入口。

順序的道理是:裝錯、按錯鍵這類原因自己能確認,先排除;帳號與帳單要官方入口才能查,放在後面。

七、熟悉之後,把反覆交代的事寫成規則

快速入門的下一步裡列了 Rules:為專案寫長期生效的指令,不必每次重複說明。這不是上手必需的一步,等你在同一個專案裡反覆交代同一件事時再寫。文件首頁把自訂相關內容收在 Customize(自訂)一欄,可連接的工作流程列了 GitHub、GitLab、Azure DevOps、Bitbucket、JetBrains、Slack、Linear 等,用到哪一項再去看對應頁(Cursor 文件)。

八、想比較付費方案時,再看這裡

Cursor 的下載、登入和基本用法到這裡就齊了。本篇只回答上手問題,不比較價格;帳號與計費問題按文件首頁指向的官方 Support 處理。

本站是第三方代充服務,與 OpenAI 無關聯,只處理 ChatGPT 會員相關訂單,Cursor 不在服務範圍內(充值服務條款)。如果你同時想按用量比較 ChatGPT 方案、判斷要不要付費,可以看訂閱費用總覽;在售方案與價格見 ChatGPT 充值套餐,每次只充 1 個月、不自動扣款,人民幣成交價與 OpenAI 官方美元定價不是同一計算基準,不宜直接換算比較。

Ken|充值貓 TopupCat 營運負責人

內容由充值貓內容團隊整理,Ken 以營運負責人身份署名。查看作者資料

相關閱讀

相關商品:ChatGPT Go · ChatGPT Plus · ChatGPT Pro · 充值教學 · 常見問題 · 自助排解