Claude Code trong VS Code: Cách sử dụng tiện ích mở rộng

Như tôi đã trình bày ở phần khả năng, plan mode hoạt động tốt cho các thay đổi lớn. Một chi tiết tôi bỏ qua ở đó: Claude cũng chạy các lệnh thăm dò trước và lưu toàn bộ kế hoạch vào một tệp. Hãy thêm nhận xét của bạn trước khi bất cứ thứ gì được ghi. Tôi thấy kế hoạch viết ra vẫn hữu ích ngay cả khi tôi thay đổi phần lớn nó.

Để thêm ngữ cảnh có mục tiêu, dùng @-mention kèm phạm vi dòng: @app.ts#5-10 sẽ tập trung Claude vào một vùng cụ thể. Giữ Shift trong khi kéo tệp vào ô prompt sẽ thêm chúng dưới dạng tệp đính kèm. Option+K trên Mac (hoặc Alt+K trên Windows và Linux) chèn trực tiếp một @-mention cho tệp và vùng chọn hiện tại của bạn.

Các phím tắt VS Code nên biết

Các phím tắt này lấy từ tài liệu tiện ích VS Code của Anthropic và bao gồm những tổ hợp tôi thường dùng nhất trong bảng.

Việc chuyển chế độ cấp quyền vẫn nằm trong CLI: nhấn Shift+Tab trong terminal tích hợp để chuyển giữa mặc định, plan và accept-edits. Với đầy đủ bộ slash-command, xem hướng dẫn slash commands của Claude Code.

Checkpoints theo dõi các chỉnh sửa tệp của Claude trong suốt phiên. Di chuột lên bất kỳ tin nhắn nào trong cuộc hội thoại để thấy nút tua lại. Các tùy chọn gồm: rẽ nhánh cuộc trò chuyện nhưng giữ thay đổi mã, tua lại mã nhưng giữ lịch sử trò chuyện, hoặc cả hai. Checkpoints tồn tại 30 ngày. Chúng không theo dõi các lệnh bash: rm, mv và cp nằm ngoài hệ thống checkpoint. Git vẫn là lưới an toàn đúng đắn cho mọi thao tác hủy hoại.

Claude Code trong VS Code cho gỡ lỗi và tái cấu trúc

Cả hai quy trình đều theo các bước giống nhau: cung cấp ngữ cảnh cho Claude, rà soát thay đổi được đề xuất, xác minh kết quả. Điểm khó là thu thập đúng ngữ cảnh.

Gỡ lỗi

Chia sẻ lỗi bằng cách dán trực tiếp, tham chiếu đầu ra terminal với @terminal:name, hoặc để Claude lấy từ bảng Problems qua mcp__ide__getDiagnostics. Claude lần theo nguyên nhân gốc, đề xuất bản vá dưới dạng diff, và bạn chạy test để xác minh.

Claude Code không tích hợp với trình gỡ lỗi gốc của VS Code: không breakpoint, không bước từng dòng, không biến trực tiếp. Con đường dán lỗi và chẩn đoán xử lý được hầu hết trường hợp. Nếu bạn cần debugger cụ thể, có một máy chủ MCP cộng đồng (claude-debugs-for-you trên GitHub) có thể bắc cầu, nhưng cần thiết lập riêng.

Với gỡ lỗi web trực tiếp, @browser kết nối Claude với Chrome qua tiện ích Claude trong Chrome (phiên bản 1.0.36 trở lên). Một prompt như @browser go to localhost:3000 and check the console for errors cho phép Claude kiểm tra trạng thái trình duyệt trực tiếp mà bạn không cần chuyển cửa sổ.

Tái cấu trúc

Claude xử lý tốt các thay đổi phối hợp trên nhiều tệp: đổi tên một hàm trong codebase lớn, di chuyển từ thư viện này sang thư viện khác. Bước xem xét diff là yếu tố giữ cho nó không làm ẩu.

Tệp CLAUDE.md có ý nghĩa ở đây hơn bất kỳ đâu trong bài. Không có các quy ước đặc thù dự án được nạp, Claude sẽ mặc định theo các mẫu suy ra từ codebase, có thể không khớp với ý bạn. Như tôi nói ở phần thiết lập, /init cho bạn một tệp khởi đầu; chỉnh lý nó trước một phiên tái cấu trúc lớn rất đáng 10 phút.

Nén ngữ cảnh là giới hạn thực tế cho các phiên dài. Khi cửa sổ ngữ cảnh đầy, Claude sẽ tự nén bằng cách tóm tắt hội thoại cũ. Sau đó, nó có thể quên các quyết định sớm hơn. Chạy /compact thủ công trước khi bắt đầu một giai đoạn mới cho kết quả dự đoán được hơn là đợi tự nén kích hoạt giữa tác vụ.

Claude Code trong VS Code so với quy trình trên Terminal

Tài liệu của Anthropic gọi tiện ích VS Code là "cách khuyến nghị để dùng Claude Code trong VS Code." Tiện ích bổ sung những thứ terminal không có: trình xem diff song song, xem xét kế hoạch trong tài liệu markdown có thể chỉnh sửa, nhiều cuộc trò chuyện ở các thẻ riêng, và @browser cho gỡ lỗi web trực tiếp.

Terminal lại thắng về khả năng. Phím tắt ! cho bash, tự động hoàn thành tab, bộ slash command đầy đủ, và quy trình dựa trên pipe như tail -200 app.log | claude -p "..." đều chỉ có trên CLI. Cấu hình máy chủ MCP cũng chỉ làm trên terminal. Từ tiện ích, bạn có thể quản lý các máy chủ hiện có với /mcp nhưng không thể thêm mới.

Hai cách không loại trừ nhau. Chạy claude trong terminal tích hợp của VS Code vẫn cho bạn tích hợp IDE: xem diff, chia sẻ ngữ cảnh vùng chọn và chia sẻ chẩn đoán đều hoạt động từ đó. Các phiên bắt đầu trong tiện ích có thể tiếp tục trong terminal với claude --resume. Chạy claude --ide từ terminal tích hợp khi bạn muốn buộc CLI kết nối với trình xem diff và cầu nối chẩn đoán của VS Code.

Hầu hết nhà phát triển chọn cả hai: VS Code cho công việc đa tệp và rà soát kỹ, terminal cho tác vụ nhanh và tự động hóa. Một số vẫn ở terminal cho mọi thứ, và thực sự vẫn ổn. Nếu bạn thích Cursor hơn VS Code, hướng dẫn Claude Code trong Cursor của chúng tôi mô tả cùng quy trình tiện ích ở đó. Quy trình đầy đủ với CLI cũng đáng biết trong mọi trường hợp.

Claude Code trong VS Code so với GitHub Copilot

Như tôi đã nói ở đầu, "Claude trong VS Code" có thể là tiện ích gốc, Claude truy cập qua bộ chọn mô hình của GitHub Copilot, hoặc CLI trong terminal tích hợp. Tiện ích gốc và Copilot dùng chung mô hình nhưng không chung sản phẩm, và cách vận hành rất khác nhau.

Qua Copilot, mô hình Claude chạy trong mô hình chat và hoàn thành của GitHub: không sandbox hệ điều hành cục bộ, không tích hợp MCP tùy biến, không lệnh terminal gốc. Qua tiện ích Claude Code, cùng mô hình đó chạy với cửa sổ ngữ cảnh tới 1M token, thực hiện tác vụ trên nhiều tệp và có quyền truy cập vào checkpoints, plan mode và máy chủ MCP.

Các công cụ được xây cho những việc khác nhau. Copilot cung cấp tự động hoàn thành nội tuyến như tính năng cốt lõi. Claude Code hoàn toàn không làm autocomplete. Chế độ agent của Copilot đã phát triển đáng kể, nhưng trong các bài đo cộng đồng nó thường chậm hơn ở các tác vụ trải rộng nhiều tệp. Không có công cụ nào tốt hơn tuyệt đối.

Tiện ích gốc và Copilot: cùng mô hình, trải nghiệm khác. Ảnh do Tác giả cung cấp.

Về giá: Copilot Pro là 10 USD/tháng với 300 yêu cầu cao cấp. Claude Code Pro là 20 USD/tháng. Mẫu phổ biến trong các nhà phát triển dùng cả hai là 10 USD cho Copilot (autocomplete khi gõ) và 20 USD cho Claude Code (tác vụ có chủ đích, quy mô lớn hơn). Hai sản phẩm bao phủ các phần khác nhau của quy trình mà ít chồng lấn. Anthropic cũng hợp tác với GitHub để đưa mô hình Claude vào Copilot, đảm nhiệm phần autocomplete.

Cân nhắc Bảo mật và Quyền riêng tư

Anthropic không dùng mã của bạn để huấn luyện các mô hình Claude. Người dùng Free, Pro và Max có thể chọn không ghi log dữ liệu trong cài đặt tài khoản; các gói Team, Enterprise và API mặc định được loại trừ. Với chế độ cấp quyền, máy chủ MCP và chi tiết sandbox ngoài bề mặt VS Code, xem hướng dẫn bảo mật Claude Code.

Một tập hợp đường dẫn cố định luôn được bảo vệ bất kể chế độ nào: .git, .vscode, .idea, .husky, và .claude (trừ các thư mục làm việc con của chính nó), cùng với .gitconfig, .gitmodules và một số tệp cấu hình shell/công cụ. Điều này đặc biệt quan trọng ở chế độ tự chấp nhận, nơi ghi mà không tạm dừng và có thể chạm tới settings.json và tasks.json. Hãy kiểm tra diff của git trước khi commit.

Sandbox cô lập lệnh bash trong thư mục làm việc của bạn và chặn truy cập mạng trái phép. Mặc định tắt; bật bằng /sandbox.

Chế độ Auto thay thế phê duyệt từng hành động bằng một bộ phân loại rà soát hành động trước khi chạy, chặn những việc như xóa hàng loạt tệp, gửi dữ liệu tới endpoint trái phép và force-push lên main. Anthropic mô tả đây là phương án an toàn hơn so với --dangerously-skip-permissions.

Bản ghi cục bộ được lưu dạng văn bản thuần tại ~/.claude/projects/ trong 30 ngày (cleanupPeriodDays có thể điều chỉnh). Thiết lập Enterprise trên Amazon Bedrock, Google Vertex AI hoặc Microsoft Foundry tuân theo điều khoản dữ liệu của các nhà cung cấp đó. Chế độ Auto không khả dụng trên các nhà cung cấp này; nó yêu cầu trực tiếp API của Anthropic.

Khắc phục sự cố phổ biến với tiện ích VS Code

Hầu hết vấn đề thiết lập rơi vào một danh sách ngắn. Tôi đã gặp tất cả ít nhất một lần.

• Thiếu biểu tượng Tia lửa: Mở một tệp dự án, không chỉ thư mục. Biểu tượng Tia lửa trên Thanh công cụ Editor chỉ hiện khi có tệp mở. Bạn cũng có thể bấm mục Tia lửa ở Thanh Trạng thái (góc dưới bên phải), hoạt động ngay cả khi không mở tệp, hoặc chạy Developer: Reload Window từ Command Palette.

• Xung đột tiện ích: Tạm thời vô hiệu hóa các tiện ích AI khác (Cline, Continue, v.v.) nếu Claude Code không kích hoạt.

• Chế độ Bị Hạn Chế: Claude Code không chạy trong Restricted Mode của VS Code. Hãy đánh dấu workspace là đáng tin cậy.

• Khóa tệp trên Windows: Thu gọn ngăn Explorer và tạm dừng các debugger đang chạy trước các phiên đa tệp lớn nếu ghi thất bại giữa chừng.

• Xung đột macOS Tahoe với Cmd+Esc: Game Overlay của hệ thống có thể chặn Cmd+Esc. Gán lại phím cho Claude Code: Focus input trong Keyboard Shortcuts của VS Code (Cmd+K Cmd+S) nếu chuyển tiêu điểm không hoạt động.

• Đăng nhập Bedrock hoặc Vertex thay vì Anthropic: Bạn có thể trỏ Claude Code tới endpoint của nhà cung cấp đám mây. Hướng dẫn thiết lập mô hình cục bộ và thay thế của chúng tôi trình bày các lối đi không cần đăng ký.

Anthropic duy trì một hướng dẫn khắc phục sự cố riêng nếu những cách trên không giải quyết được vấn đề của bạn.

Giới hạn và đánh đổi

Tiện ích là tập con của CLI. Như đã nói ở phần so sánh với terminal, tự động hoàn thành bằng tab, phím tắt ! cho bash và các quy trình dựa trên pipe đều chỉ có trên CLI, cũng như chế độ dontAsk cho pipeline CI.

Khả năng quan sát tác vụ nền bị hạn chế; với những gì cần theo dõi sát, terminal tích hợp minh bạch hơn.

Phê duyệt theo tệp, không theo hunk: nếu Claude làm đúng một hàm và sai hàm khác trong cùng tệp, bạn phải chấp nhận tất cả rồi hoàn nguyên thủ công phần không muốn.

Giới hạn sử dụng là điều khiến đa số người dùng Pro vướng phải sớm nhất. Giới hạn theo cửa sổ thời gian cuốn, không theo tin nhắn, và cạn nhanh hơn vào giờ cao điểm. Dùng thỉnh thoảng thì Pro ổn; cho cả ngày làm việc, Max 5x hoặc Max 20x thực tế hơn. Tôi không khuyến khích dựa vào ước tính cộng đồng; Anthropic không công bố con số chính xác và chúng thay đổi.

Trên Windows, khóa tệp giữa Explorer của VS Code và thao tác ghi của Claude gây lỗi thường xuyên hơn so với macOS hay Linux. Thu gọn ngăn explorer và tạm dừng debugger đang chạy trước các phiên đa tệp lớn thường giúp tránh lỗi.

Kết luận

Claude Code trong VS Code là một agent mã hóa hướng tác vụ với giao diện ưu tiên rà soát. Trình xem diff, plan mode và checkpoints tồn tại vì việc phát hiện chính xác những gì agent đã thay đổi quan trọng hơn là có bản nháp đầu nhanh.

Quy trình trên terminal sẽ không biến mất, và với công việc kịch bản hóa, tự động hoặc nặng CLI thì vẫn là bề mặt tốt hơn. Nhưng nếu bạn làm dạng công việc muốn đọc từng thay đổi được đề xuất trước khi nhập, trình soạn thảo là lựa chọn phù hợp hơn.

Claude Code cập nhật hằng tuần, nên một số phần trong bài sẽ nhanh lỗi thời. Các thực tiễn tốt nhất cho Claude Code và hướng dẫn Claude Code 2.1 là hai bài theo dõi tốt để cập nhật. Nhật ký thay đổi chính thức theo dõi các bản phát hành. Nếu có điều gì ở đây không khớp với những gì bạn thấy, hãy kiểm tra ở đó trước.

Nếu bạn muốn luyện tập có cấu trúc với các mô hình Claude và quy trình agent, tôi gợi ý khóa học Giới thiệu về các Mô hình Claude của chúng tôi.