Cursor AI 教學｜安裝與設定

系統需求

✓ macOS：12.0 Monterey 以上
✓ Windows：Windows 10 / 11（64 位元）
✓ Linux：Ubuntu 20.04 以上或相容發行版
✓ RAM：至少 8 GB，建議 16 GB 以上
✓ 網路：需要穩定的網路連線（AI 功能需要連線至雲端）
✓ 磁碟空間：至少 500 MB 可用空間

Cursor 目前不支援完全離線使用，AI 功能需要網路連線。程式碼編輯功能可離線使用。

下載安裝

前往 cursor.com 下載對應平台的安裝檔：

macOS

# 方法一：直接下載 .dmg 檔案
# 前往 cursor.com，點擊「Download for Mac」

# 方法二：使用 Homebrew
brew install --cask cursor

Windows

# 方法一：下載 .exe 安裝檔
# 前往 cursor.com，點擊「Download for Windows」
# 執行 CursorSetup.exe，依照指示安裝

# 方法二：使用 winget
winget install Anysphere.Cursor

Linux

# 下載 .AppImage 或 .deb 檔案
# 前往 cursor.com，選擇 Linux 版本

# 使用 AppImage
chmod +x cursor-*.AppImage
./cursor-*.AppImage

# 或使用 snap
snap install cursor --classic

首次啟動

安裝完成後，首次啟動 Cursor 會引導你完成以下設定步驟：

選擇語言與外觀：選擇介面語言（英文）與主題色（深色/淺色）
匯入 VS Code 設定（可選）：如果你原本使用 VS Code，可以一鍵匯入設定、擴充套件與快捷鍵
登入或建立帳號：使用 Email 或 Google 帳號建立 Cursor 帳號
選擇方案：選擇免費的 Hobby 方案或升級至 Pro
選擇預設 AI 模型：建議選擇 claude-3.5-sonnet 或 gpt-4o

建議在首次啟動時選擇匯入 VS Code 設定，這樣你熟悉的擴充套件、快捷鍵和主題都會自動遷移，幾乎零學習成本。

帳號與授權

Cursor 需要登入帳號才能使用 AI 功能。登入後：

免費帳號（Hobby）：每月 2000 次 Tab 補全 + 50 次進階模型慢速請求
Pro 帳號：解鎖無限 Tab 補全 + 500 次進階模型快速請求
如果超過免費額度，可以使用自己的 API 金鑰繼續使用

在 Cursor Settings → Account 頁面可以查看使用量與升級方案。

匯入 VS Code 設定

如果你已有 VS Code 設定，可以透過以下方式匯入：

# 方法一：首次啟動時選擇匯入
# 啟動畫面會提示「Import VS Code Settings」

# 方法二：之後透過指令匯入
# 開啟命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）
# 輸入：「Cursor: Import VS Code Settings」

# 方法三：手動複製設定檔
# macOS: ~/Library/Application Support/Code/User/settings.json
#        → ~/Library/Application Support/Cursor/User/settings.json
# Windows: %APPDATA%\Code\User\settings.json
#          → %APPDATA%\Cursor\User\settings.json

大多數 VS Code 擴充套件都與 Cursor 相容，因為 Cursor 使用相同的擴充套件 API。但少數特殊擴充套件可能需要手動重新安裝。

設定 API 金鑰（BYOK）

如果你希望使用自己的 API 金鑰（節省 Cursor 方案配額或使用更多模型），可以在設定中加入：

# 開啟 Cursor Settings（Ctrl+Shift+J 或 Cmd+Shift+J）
# 選擇「Models」標籤頁
# 在「OpenAI API Key」欄位輸入你的 OpenAI API Key
# 在「Anthropic API Key」欄位輸入你的 Anthropic API Key

# 或者在設定 JSON 中：
{
  "cursor.openaiApiKey": "sk-...",
  "cursor.anthropicApiKey": "sk-ant-..."
}

使用自己的 API 金鑰時，費用直接從你的 OpenAI 或 Anthropic 帳戶扣除，不會消耗 Cursor 方案的請求配額。

建議初始設定

以下是開始使用 Cursor 前建議調整的設定：

// settings.json 建議配置
{
  // 啟用自動補全
  "cursor.cpp.enablePartialAccepts": true,

  // Tab 補全觸發延遲（毫秒，降低延遲感）
  "editor.inlineSuggest.enabled": true,

  // 自動儲存（搭配 Agent 使用很方便）
  "files.autoSave": "afterDelay",
  "files.autoSaveDelay": 1000,

  // 顯示行號
  "editor.lineNumbers": "on",

  // 顯示空白字元（方便偵錯縮排問題）
  "editor.renderWhitespace": "boundary",

  // 預設格式化工具
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.formatOnSave": true
}

安裝與設定

系統需求

下載安裝

macOS

Windows

Linux

首次啟動

帳號與授權

匯入 VS Code 設定

設定 API 金鑰（BYOK）

建議初始設定

推薦擴充套件