官方教程中文版入門、安裝與模型
入門、安裝與模型
Cursor 入門層：產品定位、快速開始、安裝遷移、模型用量和外掛邊界。
這一組先解決 Cursor 的基礎層：它是什麼、怎麼裝、怎麼遷移、第一天怎麼做一個安全小改動、模型用量怎麼核驗、外掛和 Marketplace 怎麼控風險。
閱讀方式：不要跳過快速開始。Cursor 的後續 Agent、Rules、MCP、CLI、Cloud Agent 都建立在“低風險專案裡能解釋程式碼庫、做小改動、審 diff、跑檢查”這個閉環上。
學習路徑
flowchart TD
Start["入門層"] --> Position["產品定位"]
Position --> Quick["快速開始"]
Quick --> Install["安裝與遷移"]
Install --> Models["模型、價格與用量"]
Install --> Plugins["外掛與 Marketplace"]
Models --> Agent["進入 Agent 工作流"]
Plugins --> AgentCursor 產品定位
理解 Cursor 是 AI editor and coding agent，而不是普通 IDE 外掛。
快速開始
從安裝登入到解釋程式碼庫、小改動、review diff 和 Plan Mode。
安裝與遷移
從官方安裝、VS Code 遷移和 JetBrains 遷移文件梳理安全遷移路徑。
模型、價格與用量
理解 usage pools、Auto、Composer、API pool、Max Mode 和團隊計費邊界。
外掛與 Marketplace
區分 extensions 和 plugins，理解團隊 marketplace 與 required 外掛風險。
入門層驗收
讀完這一組，至少能做到：
- 解釋 Cursor 的兩層身份：AI editor 和 coding agent。
- 在低風險專案裡跑通 first useful change。
- 從 VS Code 或 JetBrains 遷移時不照搬高風險配置。
- 知道模型、價格、usage pools 和 Max Mode 去哪裡核驗。
- 區分 extension、plugin、team marketplace 和 required plugin。
建議練習
入門層不建議只讀頁面。找一個低風險 repo，按這個順序練：
- 讓 Cursor 解釋專案結構，不改檔案。
- 選擇一個小 bug 或文案改動，讓 Agent 先給 plan。
- 審查 plan 後再允許它修改。
- 看 diff，確認沒有 unrelated changes。
- 跑對應測試或手動檢查。
- 記錄哪些資訊應該寫進 Rules。
這一輪練習能把安裝、模型、上下文、diff、終端和驗證串起來。後續進入 Agent 工作流時，你就不是在“試功能”，而是在已有閉環上增加能力。
不要跳過的邊界
模型和用量頁面只給核驗方法，不替代官方價格頁。安裝遷移也不是把舊編輯器配置全搬過來，尤其是外掛、token、shell profile、代理和團隊策略。先用預設安全配置跑通，再逐步遷移高許可權能力。
入門階段的目標是建立安全預設值：低風險專案、可回退 diff、明確驗證命令、最少外掛、最少外部訪問。後面所有高階能力都應該在這個基礎上增加，而不是繞開它。
官方來源
- Cursor Documentation - 官方總覽和能力地圖。
- Cursor Quickstart - 官方第一天路徑。
- Cursor Help Center - 安裝、遷移、外掛和排障入口。
- Cursor llms.txt - 官方文件索引。