做完這篇你會得到：一個能開機的 Cursor、一個已登入的帳號、一個打開著的專案資料夾，以及你親眼確認過的一次 AI 輔助編輯（你看得到 diff，也學到怎麼接受或拒絕它）。最後一個步驟會多裝一個命令列版的 Cursor CLI，讓你能在 Terminal（終端機） 裡直接叫它做事。
動手做完大約 20 分鐘，其中下載與安裝佔掉一半（文章本身的閱讀時間見上方標示）。你不需要會寫程式，但需要會打開終端機並貼上指令 —— 這部分不熟的話，先讀 Terminal、Shell、CLI：三個詞的差別。
適用平台
官方 Quickstart 列出的支援範圍：
| 平台 | 需求與安裝形式 |
|---|---|
| macOS | macOS 12（Monterey）與之後；原生安裝檔 .dmg；Apple Silicon 與 Intel 都支援 |
| Windows | Windows 10 與之後；原生安裝檔 .exe |
| Linux | Debian／Ubuntu 走 apt（官方推薦）、RHEL／Fedora 走 dnf，另有可攜的 AppImage |
官方特別說明：apt 與 dnf 包裝比 AppImage 好，因為 AppImage 沒有桌面圖示、沒有自動更新、也不附命令列工具。
命令列版 Cursor CLI 另外支援 macOS、Linux、Windows（WSL）與 Windows 原生。
來源：cursor.com/docs/get-started/quickstart、cursor.com/docs/cli/installation。
前置需求
- 一個 Cursor 帳號。沒有的話，第一次啟動時照畫面註冊即可。
- 你會打開終端機、貼上指令、按 Enter。指令都屬於 CLI（命令列介面） 形式，跑在 Shell（殼層） 裡。
- Linux 路線需要
sudo：那幾行指令會寫入系統套件庫設定，也就是動到 PATH 與路徑 層級的東西。 - 一個練習用的專案資料夾。三個檔案的小專案就夠了，重點是你要能看出它改了什麼。
- 若你打算自帶模型金鑰而不是用 Cursor 帳號額度：先讀 API Key 與 環境變數與 .env。本文所有金鑰範例都寫成
sk-xxxxxxxx這種佔位符，不要把你的真金鑰貼進任何聊天視窗，也不要 commit 進 git。
步驟
步驟一：下載安裝檔
到官方下載頁 cursor.com/downloads，選你的平台。macOS 與 Windows 直接按下載按鈕；Linux 在終端機執行下面這組（Debian／Ubuntu）：
curl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg > /dev/null
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list > /dev/null
sudo apt update
sudo apt install cursor
RHEL／Fedora 則是先寫入 repo 檔再安裝：
sudo tee /etc/yum.repos.d/cursor.repo << 'EOF'
[cursor]
name=Cursor
baseurl=https://downloads.cursor.com/yumrepo
enabled=1
gpgcheck=1
gpgkey=https://downloads.cursor.com/keys/anysphere.asc
EOF
sudo dnf install cursor
預期輸出：macOS／Windows 是瀏覽器右下角出現一個下載完成的 .dmg 或 .exe。Linux 的 apt update 會列出它讀到的套件庫，其中要能看到 cursor 那一行；apt install cursor 結尾會印出 Setting up cursor ... 之類的完成訊息，然後把提示字元還給你。中途若問 Do you want to continue? [Y/n]，按 Y。
失敗長這樣：apt update 出現 NO_PUBKEY 或 Signature verification failed，代表第一行的 GPG 金鑰沒寫進去；sudo: command not found 代表你不在 Linux 的一般 shell 裡。
步驟二：安裝並第一次啟動
macOS：打開下載的 .dmg，照視窗上的指示把 Cursor 圖示拖進「應用程式」資料夾（這是 macOS 安裝 .dmg 的標準動作），然後從「應用程式」或 Spotlight 打開它。Windows：執行 .exe，照安裝精靈按下一步。Linux（apt／dnf）已經裝好，從應用程式選單啟動；若你用的是 AppImage：
chmod +x Cursor-*.AppImage
./Cursor-*.AppImage
預期輸出：Cursor 視窗打開，接著是初始設定流程（主題、是否從 VS Code 匯入設定與擴充功能、登入）。AppImage 這條路則會在終端機印出它啟動的訊息，視窗同時出現。
失敗長這樣：macOS 跳出「無法驗證開發者」類的警告時，到系統設定 → 隱私權與安全性，找關於 Cursor 的那一行並選擇仍要打開。這是 macOS 對所有非 App Store 軟體的通用行為，不是 Cursor 壞掉。
步驟三：登入帳號
在初始設定裡選登入方式，瀏覽器會被打開完成授權，然後自動跳回 Cursor。
預期輸出：瀏覽器出現授權頁，你確認後頁面顯示可以關閉；回到 Cursor，初始設定往下一步走，最後進入正常的編輯器畫面。之後左下角（或設定頁）能看到你的帳號。
失敗長這樣：瀏覽器沒有自動打開 —— 手動複製畫面上給的網址貼到瀏覽器。授權完成但 Cursor 沒反應 —— 把 Cursor 關掉重開一次，它會重讀登入狀態。
步驟四：打開一個專案資料夾
用「開啟資料夾」選你的練習專案。
預期輸出：左側檔案樹列出那個資料夾裡的檔案與子目錄，點任一檔案會在編輯器打開。第一次打開較大的專案時，Cursor 會開始建立程式碼索引，狀態列會出現進度；索引完成前，跟「整個程式庫」有關的回答品質會比較差。
失敗長這樣：檔案樹是空的 —— 你選到的是檔案而不是資料夾，或選到了上一層。
步驟五：第一次 AI 輔助編輯（Cmd+K）
在編輯器裡打開一個檔案，把游標放到某一行（或選取一段程式碼），按 Cmd+K（Windows／Linux 是 Ctrl+K），用一句話描述你要的改動，按 Enter 送出。
預期輸出：編輯器裡直接出現建議的變更，改動的地方以 diff 顏色標出。官方快速鍵表列的後續動作是：Cmd+Return／Ctrl+Enter 接受全部變更，Cmd+Shift+Backspace／Ctrl+Shift+Backspace 拒絕全部，Option+Return／Alt+Enter 改成問一個快速問題。
失敗長這樣：按了沒反應，通常是快速鍵被其他擴充功能或輸入法佔用。用 Cmd+Shift+P／Ctrl+Shift+P 打開命令面板，搜 Keyboard Shortcuts 打開快速鍵設定，重新綁定即可 —— 官方說明所有 Cursor 快速鍵都可以在那裡改。
步驟六：用 Agent 做跨檔案的改動（Cmd+I）
按 Cmd+I／Ctrl+I 打開側邊的 Agent 面板。官方 Quickstart 建議的第一句話是先讓它讀懂程式庫：
Explain this codebase. Point me to the main entry points, key modules, and anything I should read before making changes.
接著再要求一個小改動，例如請它列出三個安全的改進點並等你選一個。需要更大改動時，在輸入框按 Shift+Tab 切到 Plan Mode：它會先研究程式庫、問你問題、給出實作計畫，等你核准才動手。
預期輸出：面板上出現它正在搜尋與讀檔的動作清單，然後是文字總結；要求改動時會出現檔案清單與 diff 檢視。Plan Mode 下你會先看到一份計畫與核准按鈕，而不是立刻被改掉的程式碼。
失敗長這樣：面板一直轉圈沒回應 —— 檢查登入狀態與你的方案額度（額度與計費以 cursor.com/pricing 為準，本文不列金額）。
步驟七：裝命令列版 Cursor CLI
macOS、Linux、Windows（WSL）：
curl https://cursor.com/install -fsS | bash
Windows 原生用 PowerShell：
irm 'https://cursor.com/install?win32=true' | iex
官方文件接著要求把安裝目錄加進 PATH（zsh 使用者把 .bashrc 換成 .zshrc）：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
預期輸出：安裝程式印出下載與安裝進度後回到提示字元。之後執行 agent 就能啟動命令列版的 agent；官方說明它預設會自動更新，也可以用 agent update 手動更新。
怎麼確認你裝對了
在終端機執行官方給的驗證指令：
agent --version
預期輸出：印出一個版本號（形如 1.2.3 的三段數字，實際版號依你安裝當下的發行版而異）。只要有版號，就代表 CLI 裝好且在 PATH 上。
如果印出 command not found（或 Windows 的「不是內部或外部命令」）：CLI 本身可能裝好了，只是 ~/.local/bin 不在 PATH 上。重做步驟七的 PATH 那兩行，並確認你改的是自己實際在用的那個 shell 設定檔。
GUI 那半邊的驗證不需要指令：打開 Cursor → 開一個資料夾 → 按 Cmd+K／Ctrl+K 打一句話 → 畫面上出現 diff。看得到 diff，就代表登入、索引與模型連線三件事都通了。
常見錯誤與修法
| 症狀 | 原因 | 修法 |
|---|---|---|
agent: command not found | ~/.local/bin 不在 PATH | 照步驟七把該目錄加進 .bashrc 或 .zshrc，然後 source 一次；或重開終端機 |
Windows 上 irm 被報「不是內部或外部命令」 | 你在 CMD 裡貼了 PowerShell 指令 | 從開始功能表開 PowerShell 再貼一次。判別方式：PowerShell 的提示字元以 PS 開頭 |
| Linux 用 AppImage 之後沒有桌面圖示、不會自動更新、找不到命令列工具 | AppImage 是可攜格式，官方明說這些是 apt／dnf 包裝才有的 | 改用 apt 或 dnf 安裝 |
Cmd+K 或 Cmd+I 按了沒反應 | 快速鍵被其他擴充功能、輸入法或從 VS Code 匯入的設定佔用 | Cmd+Shift+P 搜 Keyboard Shortcuts，找到衝突的那個指令重新綁定 |
| Agent 面板送出後一直沒有回應 | 未登入、登入過期，或方案額度用盡 | 重新登入；額度與計費以官網方案頁為準 |
| 大型專案剛打開時回答品質很差 | 程式碼索引還在建立 | 等狀態列的索引進度跑完再問跟整個程式庫有關的問題 |
關於金鑰的一條紀律，值得在這裡重複：如果你在設定裡填了自己的 API Key，那把金鑰就等同密碼。不要貼進聊天視窗、不要寫進程式碼、不要 commit。範例裡一律寫 sk-xxxxxxxx。洩漏了就到供應商控制台撤銷並換發新的 —— 光刪檔案沒用，git 歷史裡還在。
下一步
- 想比價或換一個同類型的 AI IDE：安裝 Trae：IDE 模式與 SOLO 模式，以及 2026 年 AI 開發工具全景
- 想改成在終端機裡工作，不要 GUI：安裝 Claude Code 與 安裝 OpenAI Codex CLI
- Agent 能改你的檔案，就一定要有圍欄：Sandbox（沙箱）、Prompt Injection（提示詞注入），以及 AI 安全與紅隊測試
- 還不清楚這類工具背後是什麼：AI Agent 是什麼、AI Agent（代理）、Tool Call（工具呼叫）