Phần 2 của 540% hoàn thành

Cài đặt và mở dự án đầu tiên

English title: Install Cursor and Open Your First Project

Bài 2 trong chuỗi 15 bài hướng dẫn Cursor. Bạn đã hiểu Cursor là AI IDE (bài 1); bước tiếp theo là cài đặt và mở dự án đầu tiên. Chỉ cần vài phút: tải Cursor, cài đặt, mở thư mục chứa code (Open Folder), và làm quen chỗ mở Chat, Composer (Cmd+I). Bài này hướng dẫn từng bước ngắn gọn.

Mở đầu: Lần đầu mở Cursor

"Lần đầu mở Cursor — 2 phút từ zero đến mở project." Bạn vào trang chủ Cursor, tải bản cài cho máy (macOS, Windows hoặc Linux), cài xong mở ứng dụng. Đăng nhập tài khoản (nếu Cursor yêu cầu). Tiếp theo: File > Open Folder — chọn thư mục gốc của một project (vd. repo bạn đã clone). Cursor sẽ index codebase; sau vài giây bạn có thể mở Chat hoặc nhấn Cmd+I (Mac) / Ctrl+I (Win/Linux) để mở Composer. Đó là first run.

1. Đi sâu: Tại sao Open Folder quan trọng

Tại sao chủ đề này quan trọng: Cursor làm việc theo thư mục dự án. Mọi thứ AI đọc (file, cấu trúc) đều nằm trong thư mục bạn mở. Mở sai thư mục (vd. thư mục cha chứa nhiều repo) hoặc không mở gì thì AI không có codebase để tham chiếu.

Hiểu sai thường gặp: Nhiều người mở Cursor rồi chỉ dùng Chat mà không Open Folder — khi đó Cursor không "thấy" project cụ thể, câu trả lời sẽ chung chung.

Bản chất đúng: Open Folder = bạn chọn root của project (thư mục chứa source code, thường là thư mục có package.json hoặc src/). Cursor index nội dung trong thư mục đó để AI có thể tìm file, đọc code, và gợi ý chính xác.

2. Khái niệm

Open Folder: Trong Cursor (và VS Code), File > Open Folder cho phép chọn một thư mục làm workspace. Toàn bộ file trong thư mục đó hiển thị ở sidebar và được Cursor dùng cho index/codebase.
Workspace: Thư mục bạn đã mở; mọi tính năng AI (Chat, Composer, Agent) đều dựa trên workspace hiện tại.
Index: Cursor quét và lưu thông tin về file trong workspace (tên, cấu trúc, nội dung) để AI có thể search và đọc nhanh.

3. Các bước thực hành

Bước 1 — Tải và cài: Vào cursor.com (hoặc trang download chính thức), chọn phiên bản cho hệ điều hành của bạn. Chạy file cài đặt; nếu đã dùng VS Code thì giao diện Cursor sẽ quen thuộc.

Bước 2 — Mở Cursor và đăng nhập: Mở ứng dụng Cursor; nếu được hỏi, đăng nhập tài khoản. Một số tính năng (vd. model cao cấp) có thể cần subscription.

Bước 3 — Open Folder: File > Open Folder (hoặc shortcut tương đương). Chọn thư mục gốc của project — ví dụ thư mục chứa package.json (Node) hoặc pyproject.toml (Python). Tránh chọn thư mục quá lớn (vd. cả ổ đĩa) lần đầu.

Bước 4 — Làm quen: Sidebar bên trái là cây thư mục; trên hoặc bên cạnh có Chat; Cmd+I (Mac) hoặc Ctrl+I (Win/Linux) mở Composer. Thử mở một file từ cây thư mục, rồi mở Composer và gõ một câu hỏi ngắn (vd. "file này làm gì?").

4. Workflow sau khi setup

Mỗi lần làm việc với một project: mở Cursor → File > Open Folder → chọn đúng thư mục project.
Đợi index xong (thường vài giây đến vài chục giây tùy kích thước repo).
Chat cho câu hỏi nhanh; Composer (Cmd+I) cho task sửa code hoặc nhiều bước.
Bài tiếp sẽ nói rõ khi nào dùng Chat, khi nào dùng Composer.

5. Ứng dụng

Setup xong, bạn đã có nền tảng để dùng toàn bộ chuỗi 15 bài: context @/# (bài 4), checkpoints (bài 5), Agent (bài 6), Plan mode (bài 7), Rules (bài 8), v.v. Đều dựa trên một workspace đã mở. Nếu làm nhiều project, mỗi lần chuyển project chỉ cần Open Folder lại; Cursor ghi nhớ workspace gần đây để mở nhanh.

Bài tiếp: Chat và Composer — hai cách tương tác (bài 3) — khi nào dùng Chat, khi nào dùng Composer.