This article is not yet available in English. You are reading the Traditional Chinese original. The English edition will appear here once it is translated.
Browse articles that do have an English edition安裝 Cursor：從下載到第一次 AI 輔助編輯
做完這篇你會得到：一個能開機的 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（工具呼叫）
More in Tools
- PaddleOCR in Practice: Extracting Hong Kong Stock Annual Report Financial Data in 83 Seconds
- Webb-Site: The Essential Hidden Treasure for Hong Kong Stock Research, a One-Click Tool to Get Annual Report PDFs for All Listed Companies
- Academic Research Skills Deep Technical Breakdown: How 45+ Agents Collaborate to Complete the Full Workflow from Literature Review to Peer Review
- AI Engineering from Scratch Deep Dive: 435 Lessons × 20 Stages