Claude Code trong Cursor: Hướng dẫn Cài đặt và Quy trình làm việc

Cursor đã tích hợp sẵn một tác nhân AI của riêng mình. Nó có thể chỉnh sửa tệp, chạy lệnh và làm việc trên toàn bộ codebase của bạn. Vậy tại sao bạn lại cài thêm một tác nhân thứ hai trong cùng trình soạn thảo?

Claude Code là công cụ lập trình tác tử (agentic) của Anthropic: nó đọc codebase của bạn, lập kế hoạch thay đổi, chỉnh sửa tệp, chạy kiểm thử và trả lại cho bạn bản diff để xem xét. Tiện ích mở rộng VS Code đưa quy trình đó vào Cursor, vốn được xây dựng trên cùng nền tảng VS Code. Kết quả là hai hệ thống AI tách biệt cùng nằm trong một cửa sổ, mỗi hệ có ngữ cảnh riêng, tính phí riêng và cách làm việc riêng. Việc đó có hữu ích hay không còn tùy vào thứ bạn đang xây dựng.

Trước khi đi xa hơn: "Claude Code trong Cursor" hiện có thể mang hai nghĩa khác nhau. Một là tiện ích mở rộng Claude Code (bài viết này đề cập), hai là chọn các mô hình Claude thông qua bộ chọn mô hình tích hợp của Cursor (một sản phẩm hoàn toàn khác chỉ dùng Claude làm backend). Tôi sẽ quay lại phân biệt đó ở phần riêng. Nếu bạn muốn so sánh trực diện hai công cụ dưới dạng sản phẩm độc lập, chúng tôi có một bài Claude Code vs. Cursor riêng cho nội dung đó.

Claude Code trong Cursor là gì?

Claude Code là công cụ lập trình tác tử của Anthropic. Nó đọc codebase, chỉnh sửa tệp, chạy lệnh terminal, quản lý quy trình git và kết nối dịch vụ bên ngoài qua MCP (Model Context Protocol). Nó có sẵn dưới dạng CLI, tiện ích mở rộng VS Code, ứng dụng desktop và trên web.

Cursor được xây dựng trên môi trường phát sinh từ VS Code, và tiện ích mở rộng Claude Code cho VS Code được hỗ trợ chính thức. Tài liệu của Anthropic liệt kê "Install for Cursor" như một đường cài đặt trực tiếp, tách biệt với cài đặt VS Code tiêu chuẩn. Đây không phải mẹo do cộng đồng tự xoay sở.

Hai quy trình AI trong một trình soạn thảo. Hình do Tác giả cung cấp.

Điều dễ gây nhầm lẫn là: khi ai đó nói "Claude Code trong Cursor", họ có thể ám chỉ chạy chính tiện ích mở rộng hoặc CLI của Claude Code trong Cursor, mang đến toàn bộ quy trình tác tử của Anthropic với panel riêng, mô hình cấp quyền riêng và lịch sử phiên riêng. Hoặc họ có thể nói đến việc dùng các mô hình Claude làm backend cho AI gốc của Cursor. Chúng có liên quan, nhưng không phải cùng một sản phẩm và không hoạt động theo cùng cách.

Claude Code vs. Mô hình Claude trong Cursor

Cụ thể, mỗi lựa chọn có nghĩa như sau.

Mô hình Claude trong Cursor

Cursor có bộ chọn mô hình cho phép bạn chọn giữa Claude Sonnet, Claude Opus, GPT, Gemini và các mô hình khác. Ở chế độ "auto", Cursor tự động chọn mô hình. Khi bạn dùng Claude Sonnet trong chat hoặc agent của Cursor, bạn đang dùng sản phẩm của Cursor: UX, tính phí và quản lý ngữ cảnh của Cursor. Mô hình là Claude, nhưng trải nghiệm thuộc về Cursor.

Claude Code trong Cursor

Cài tiện ích mở rộng Claude Code trong Cursor mang đến panel riêng, cửa sổ ngữ cảnh riêng và tính phí gắn với gói Anthropic hoặc khóa API của bạn. Cả hai có thể chạy trong cùng cửa sổ trình soạn thảo, nhưng không chia sẻ ngữ cảnh. Claude Code không biết tác nhân gốc của Cursor đang làm gì.

Chọn "Claude Sonnet" trong bộ chọn mô hình của Cursor không giống với cài Claude Code. Nếu bạn muốn quy trình lập kế hoạch rồi thực thi của Claude Code và bộ nhớ dự án CLAUDE.md, bạn cần tiện ích mở rộng hoặc CLI. Một câu nói trong cộng đồng lập trình viên mô tả khác biệt khá rõ: "Cursor là một IDE có tính năng AI. Claude Code là một tác nhân AI có quyền truy cập IDE."

Cách thiết lập Claude Code trong Cursor

Thiết lập Claude Code trong Cursor có ba đường, và nên chọn đường nào tùy vào tình huống của bạn.

Trước hết: Claude Code yêu cầu gói trả phí của Anthropic. Tầng miễn phí trên Claude.ai không bao gồm nó. Mức tối thiểu là gói Pro giá $20 mỗi tháng. Bạn cũng cần Cursor chạy trên engine VS Code phiên bản 1.98.0 trở lên.

Ba đường gồm:

• Đường 1: Tiện ích mở rộng VS Code (chính thức, khuyến nghị cho hầu hết lập trình viên)
• Đường 2: Terminal tích hợp (ít vướng mắc nhất nếu Claude Code đã được cài)
• Đường 3: Máy chủ MCP (nâng cao, cho môi trường đội nhóm hoặc thiết lập đa công cụ)

Nếu Claude Code đã được cài trên máy của bạn, hãy chuyển thẳng đến Đường 2.

Đường 1: Tiện ích mở rộng VS Code (khuyến nghị)

Mở bảng Extensions của Cursor với Cmd+Shift+X trên Mac hoặc Ctrl+Shift+X trên Windows và Linux. Tìm "Claude Code" và cài tiện ích mở rộng do Anthropic phát hành. ID tiện ích là anthropic.claude-code.

Tìm Claude Code trong Cursor. Hình do Tác giả cung cấp.

Một điều nên biết trước: đôi khi tiện ích không xuất hiện trong kết quả tìm kiếm của marketplace Cursor. Việc này xảy ra đủ thường xuyên để bạn nên chuẩn bị sẵn. Nếu không thấy, tài liệu VS Code của Anthropic có nút "Install for Cursor" kích hoạt trực tiếp URI cursor:extension/anthropic.claude-code. Nếu vẫn thất bại, cùng trang đó có hướng dẫn cài VSIX thủ công.

Sau khi cài, biểu tượng Tia lửa sẽ xuất hiện trên thanh công cụ của trình soạn thảo khi bạn mở một tệp, không chỉ thư mục. Nó cũng xuất hiện ở Activity Bar bên trái và Status Bar góc dưới bên phải, cả hai đều hiển thị ngay cả khi chưa mở tệp. Bấm vào bất kỳ biểu tượng nào, sau đó bấm Sign in ở phiên đầu tiên để xác thực qua trình duyệt.

Một vài điều nên kiểm tra nếu có gì đó không ổn:

• Nếu biểu tượng không xuất hiện sau khi cài, chạy "Developer: Reload Window" từ Command Palette

• Nếu bạn đã đặt ANTHROPIC_API_KEY trong shell nhưng vẫn thấy lời nhắc đăng nhập, hãy khởi chạy Cursor từ terminal bằng cursor . để nó kế thừa biến môi trường của bạn

Đường 2: Terminal tích hợp (ít vướng mắc nhất)

Nếu Claude Code đã được cài trên máy của bạn, hãy bỏ qua tiện ích mở rộng. Mở terminal tích hợp của Cursor với `Ctrl+`` rồi gõ claude`. Claude Code chạy một phiên tương tác trong terminal trong khi trình soạn thảo vẫn mở cạnh bên. Cách này tránh hoàn toàn các vấn đề tương thích tiện ích.

Nếu Claude Code chưa được cài, trình cài gốc là phương pháp khuyến nghị. Nó tự chứa, không yêu cầu Node.js và tự động cập nhật nền:

# macOS, Linux, or WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell (requires Git for Windows)
irm https://claude.ai/install.ps1 | iex

Phương pháp npm (npm install -g @anthropic-ai/claude-code) vẫn hoạt động nhưng nay được coi là di sản.

Đường 3: Máy chủ MCP (nâng cao)

Nếu bạn thiết lập cho mục đích cá nhân, hãy bỏ qua phần này.

Với các đội nhóm xây dựng môi trường MCP đa công cụ, bạn có thể chạy Claude Code như một máy chủ MCP cục bộ và kết nối qua cài đặt MCP của Cursor bằng cách thêm mục này vào mcp.json:

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["--mcp"]
    }
  }
}

Cách này phơi bày các công cụ của Claude Code bên cạnh mọi máy chủ MCP khác bạn đã cấu hình. Nó hoạt động với Cursor. Hầu hết lập trình viên cá nhân sẽ không cần đến.

Bạn có thể làm gì với Claude Code trong Cursor

Claude Code xử lý phạm vi tác vụ rộng hơn những gì nhiều người kỳ vọng ở một công cụ dạng chat. Đây là những gì bạn có trong Cursor:

• Giải thích mã lạ hoặc mã legacy bằng cách đọc trực tiếp các tệp liên quan
• Lập kế hoạch và triển khai tính năng trên nhiều tệp, có bước xem xét trước khi thay đổi
• Gỡ lỗi từ thông báo lỗi hoặc stack trace, lần ngược vấn đề trong toàn bộ codebase
• Tạo kiểm thử, chạy kiểm thử và sửa lỗi cho đến khi qua
• Staging thay đổi, viết thông điệp commit, tạo nhánh và mở pull request

Cú pháp @-mention rất đáng biết. Gõ @ theo sau bằng tên tệp hoặc thư mục để đưa vào ngữ cảnh. Claude Code hỗ trợ khớp mờ, nên tên một phần cũng được. Nếu bạn chọn đoạn mã trong trình soạn thảo, Claude sẽ tự động thấy nó.