Tự động hoá · 8 phút đọc · 2026-11-13
Cách dùng Claude Code trong VSCode: cài extension, thao tác chính, dùng hiệu quả
Cài extension Claude Code for VS Code, đăng nhập và giao việc ngay cạnh trình soạn thảo. Bài đi qua các thao tác chính, thói quen dùng hiệu quả và câu hỏi gói Pro có dùng được không.
Cách dùng Claude Code trong VSCode gọn nhất là cài extension Claude Code for VS Code của Anthropic, đăng nhập bằng tài khoản Claude rồi giao việc ngay trong khung chat cạnh trình soạn thảo. Tài liệu chính thức gọi đây là "the recommended way to use Claude Code in VS Code": bạn có giao diện riêng, xem bản so sánh trước khi nhận sửa đổi, duyệt kế hoạch, và chỉ đúng những dòng mã đang bôi chọn. Bài dưới đây đi theo trang hướng dẫn VS Code của Claude Code, dùng phím tắt Windows.
Cần chuẩn bị gì trước khi cài
- VS Code đủ mới. Trang tài liệu ghi "VS Code 1.94.0 or later", còn phần Requirements trên trang Marketplace ghi "VS Code 1.98.0 or higher". Hai con số lệch nhau, nên an toàn nhất là cập nhật VS Code lên bản mới; xem bản đang dùng ở Help > About.
- Một tài khoản Claude trả phí (Pro, Max, Ultra, Team hoặc Enterprise) hoặc tài khoản Claude Console. Không cần API key.
- Quyền cài extension trên máy. Máy công ty đôi khi khoá việc này, khi đó bạn cần người quản trị cho phép.
- Một thư mục dự án bạn tin tưởng. Extension không chạy ở Restricted Mode, tức workspace chưa được đánh dấu tin cậy.
Cách dùng Claude Code trong VSCode từ lúc cài tới câu hỏi đầu tiên
- Mở VS Code và nhấn
Ctrl+Shift+Xđể mở Extensions view. Xong khi: cột bên trái hiện ô tìm extension.
Nếu hỏng: bấm liên kết "Install for VS Code" trên trang tài liệu, hoặc mở thẳng trang Marketplace ở trên.
- Gõ "Claude Code" vào ô tìm và chọn đúng extension của Anthropic, ID
anthropic.claude-code. Xong khi: trang chi tiết ghi tên "Claude Code for VS Code".
Nếu hỏng: nhiều kết quả na ná nhau thì đối chiếu ID, hoặc cài từ trang Marketplace. Nếu bạn dùng một bản fork của VS Code, extension cũng có trên Open VSX Registry.
- Bấm Install. Xong khi: extension nằm trong danh sách đã cài.
Nếu hỏng: cài xong mà không thấy extension thì khởi động lại VS Code, hoặc mở Command Palette bằng Ctrl+Shift+P và chạy Developer: Reload Window.
- Mở thư mục dự án bằng File > Open Folder. Xong khi: cây tệp của dự án hiện ở thanh bên.
Nếu hỏng: VS Code hỏi có tin tưởng thư mục không thì chỉ đồng ý với mã bạn biết nguồn; từ chối là extension không chạy.
- Mở một tệp bất kỳ trong dự án. Xong khi: góc trên phải trình soạn thảo hiện biểu tượng Spark của Claude Code.
Nếu hỏng: Spark ở đó chỉ hiện khi đang mở tệp. Bạn vẫn có thể bấm ✻ Claude Code ở góc dưới phải thanh trạng thái, hoặc dùng Spark ở Activity Bar bên trái.
- Bấm Spark để mở panel. Xong khi: panel Claude Code mở ra kèm màn hình đăng nhập.
Nếu hỏng: mở Command Palette, gõ "Claude Code" và chọn "Open in New Tab".
- Bấm Sign in rồi đăng nhập trên trình duyệt. Xong khi: panel hiện danh sách Learn Claude Code và ô nhập.
Nếu hỏng: thấy dòng Not logged in · Please run /login thì extension sẽ tự mở lại màn hình đăng nhập; không thấy thì chạy Developer: Reload Window.
- Gõ
/statusvào ô nhập. Xong khi: panel hiện phiên bản, tài khoản và mô hình đang dùng, chân ô nhập hiện chế độ quyền.
Nếu hỏng: sai tài khoản thì gõ /logout rồi /login để đăng nhập lại bằng tài khoản đúng.
- Gõ
/initđể Claude soạn tệp CLAUDE.md khởi đầu. Xong khi: Claude đề xuất một tệp gồm lệnh build, cách chạy test và quy ước tìm thấy trong mã.
Nếu hỏng: dự án đã có CLAUDE.md thì /init chỉ đề xuất sửa, không ghi đè. Đọc lại và cắt bớt cho gọn, theo trang memory.
- Bôi chọn một đoạn mã rồi hỏi Claude về đoạn đó. Xong khi: chân ô nhập báo số dòng đang chọn và câu trả lời bám đúng đoạn ấy.
Nếu hỏng: nhấn Alt+K để chèn tham chiếu có đường dẫn và số dòng, rồi hỏi lại.
Muốn đi một vòng có hướng dẫn, bấm Show me ở từng mục trong danh sách Learn Claude Code, hoặc chạy lệnh "Claude Code: Open Walkthrough" trong Command Palette.
Các thao tác chính trong panel
Đưa đúng ngữ cảnh cho Claude
Claude tự biết tệp bạn đang mở và đoạn đang bôi chọn. Muốn chỉ rõ hơn, Alt+K chèn một tham chiếu dạng @app.ts#5-10. Gõ @ rồi vài chữ của tên tệp để chọn tệp, ví dụ @auth; thư mục thì thêm dấu gạch chéo cuối, như @src/components/. Đầu ra của terminal được đưa vào bằng @terminal:name.
Ảnh chụp lỗi giao diện thì dán thẳng từ clipboard. Kéo tệp vào ô nhập thì giữ Shift trong lúc kéo. Nếu không muốn Claude tự đính kèm đoạn chọn hay tệp đang mở, tắt hai cài đặt Attach Selection và Attach Open File.
Bốn chế độ quyền
Chế độ đang dùng nằm ở chân ô nhập; bấm vào đó để đổi. Từ bản 2.1.283, Auto là chế độ mặc định khi mở phiên.
- Auto — một bộ phân loại xem xét phần lớn thao tác thay vì hỏi bạn — hợp khi việc nhỏ và bạn đã quen.
- Manual — hỏi trước khi sửa tệp và trước phần lớn lệnh shell — hợp khi mới dùng hoặc làm trên repo quan trọng.
- Plan — Claude tả việc sẽ làm rồi chờ duyệt; VS Code mở kế hoạch thành tài liệu Markdown để bạn góp ý ngay trong đó — hợp với việc lớn, nhiều tệp. Gõ
/plancũng chuyển sang chế độ này (cần bản 2.1.280 trở lên). - Edit automatically — sửa tệp mà không hỏi — chỉ nên bật khi bạn sẵn sàng rà lại toàn bộ thay đổi sau đó.
Duyệt thay đổi và tua lại
Ở Manual, Claude hiện bản gốc cạnh bản đề xuất rồi xin phép. Bạn chấp nhận, từ chối, hoặc bảo Claude làm cách khác. Từ bản 2.1.275, nút Accept this change và Reject this change cho duyệt từng chỗ; diff có hơn 100 thay đổi thì chỉ duyệt được cả tệp.
Đi sai hướng thì rê chuột lên một tin nhắn để hiện nút tua lại, chọn Fork conversation from here, Rewind code to here hoặc Fork conversation and rewind code. Checkpoint không khôi phục những tệp chỉ bị lệnh Bash đụng tới, nên vẫn dùng git song song.
Lịch sử, vị trí panel và phím tắt
Nút Session history ở đầu panel cho tìm lại cuộc trò chuyện theo từ khoá; phiên để yên 14 ngày sẽ chuyển vào Archived sessions. Panel kéo thả được sang Secondary sidebar bên phải, Primary sidebar bên trái, hoặc Editor area thành một tab. Đổi mô hình bằng /model hoặc bấm tên mô hình ở chân ô nhập.
Ctrl+Esc— chuyển qua lại giữa trình soạn thảo và ô nhập.Ctrl+Shift+Esc— mở cuộc trò chuyện mới ở tab mới.Ctrl+Shift+T— mở lại tab phiên vừa đóng.Shift+Enter— xuống dòng mà chưa gửi.
Chỉnh cài đặt của extension
Nhấn Ctrl+, rồi vào Extensions > Claude Code để xem cài đặt riêng của extension. Vài mục đáng biết: initialPermissionMode chọn chế độ quyền lúc mở phiên (nhận default, plan, acceptEdits hoặc bypassPermissions), preferredLocation chọn chỗ panel mở, autosave mặc định là true, và respectGitIgnore. Nếu bạn quen bắt đầu bằng kế hoạch, đặt initialPermissionMode thành plan là đỡ phải đổi tay mỗi lần.
Những cài đặt dùng chung với CLI thì nằm ở ~/.claude/settings.json, không nằm trong phần cài đặt của VS Code. Sửa ở tệp đó là cả panel lẫn terminal cùng nhận.
Extension và CLI khác nhau thế nào
Claude Code extension mang theo một bản CLI riêng chỉ để chạy khung chat, và không thêm `claude` vào PATH. Vì vậy cài extension xong mà gõ claude trong terminal báo không nhận lệnh là chuyện bình thường, không phải extension hỏng. Muốn dùng trong terminal, bạn cài thêm bản CLI độc lập; các bước cài trên Windows, lỗi PATH và cách cập nhật có trong bài cài Claude Code trên Windows.
Có CLI rồi thì mở terminal tích hợp bằng ` Ctrl+ ` và chạy claude; CLI tự kết nối với extension. Từ terminal ngoài VS Code thì gõ /ide`. Hai bên dùng chung lịch sử, nên cuộc trò chuyện bắt đầu trong panel có thể làm tiếp ở terminal:
claude --resumeExtension chỉ có một phần lệnh và skill của CLI, gõ / để xem những gì đang có. Phím tắt ! cho Bash và tính năng tab completion chỉ có ở CLI; MCP và checkpoint thì có ở cả hai.
Dùng Claude Code hiệu quả theo khuyến nghị của Anthropic
Trong phần lớn trường hợp, câu lệnh đầu tiên của một phiên mới đã chạy được mà không cần thiết lập thêm. Khác biệt nằm ở thói quen. Muốn dùng Claude Code hiệu quả, trang best practices khuyên mấy việc sau:
- Viết câu lệnh cụ thể. Nêu tệp, triệu chứng và thế nào là xong. Thay vì "sửa lỗi đăng nhập", hãy viết: người dùng báo không đăng nhập được sau khi phiên hết hạn, xem phần làm mới token trong
src/auth/, viết một test tái hiện lỗi rồi sửa. Cách đặt yêu cầu có ở bài cách viết prompt cho Claude. - Chỉ kể điều Claude không tự thấy. Quyết định trong cuộc họp, quy trình deploy, biến môi trường cho test. Thứ đọc mã là tìm ra thì không cần viết.
- Giữ CLAUDE.md ngắn. Tệp này được nạp vào mọi phiên. Chỉ giữ lệnh test, typecheck, lint chính xác, chỗ mã dễ hiểu lầm, và điều đã phải nhắc lại hai lần. Ý riêng không muốn đưa lên git thì để trong
CLAUDE.local.mdvà thêm vào.gitignore. - Chưa rõ mình muốn gì thì để Claude hỏi trước. Cho nó phỏng vấn bạn, viết ra SPEC.md, rồi mở phiên mới làm theo bản đó.
- Lập kế hoạch cho việc lớn. Chuyển sang Plan hoặc gõ
/plan, duyệt kế hoạch rồi mới cho sửa. - Cho Claude cách tự kiểm. Một bộ test, một đầu ra mong đợi, để nó bắt lỗi trước khi báo xong.
- Dọn ngữ cảnh. Dùng
/cleargiữa hai việc không liên quan. Khi gọn lại thì nói rõ cần giữ gì, ví dụ/compact keep the API changes and the test commands. - Kéo lại sớm. Theo dõi phút đầu, nhấn
Escngay khi Claude lệch hướng. Sửa hai lần vẫn hỏng thì/clearvà viết câu lệnh tốt hơn, đừng sửa lần thứ ba. - Chọn mô hình hợp việc. Theo trang chi phí, Sonnet làm tốt phần lớn việc lập trình và rẻ hơn Opus; để dành Opus cho quyết định kiến trúc phức tạp.
Menu lệnh (bấm hoặc gõ /) còn mục Customize để quản lý MCP servers, hooks, memory, Instructions và plugins. Nếu muốn đóng gói quy trình riêng cho Claude, xem bài agent skills trong Claude Code.
Claude Pro có dùng được Claude Code không?
Có. Câu hỏi "claude pro có dùng được claude code không" được trả lời ngay trên trang giá: dòng Claude Code ghi Free là No, còn Pro, Max, Ultra, Team và Enterprise đều là Yes. Bài hỗ trợ của Anthropic nói rõ gói Pro, Max hoặc Ultra dùng được Claude Code trong IDE, gồm VS Code, Cursor và các bản fork khác.
Giá đọc ngày 13/11/2026, chưa gồm thuế: Pro $17/tháng khi trả theo năm ($200 trả trước) hoặc $20 nếu trả theo tháng. Max $100/tháng, Ultra $200/tháng, hai gói này chỉ trả theo tháng.
Hạn mức của Pro gồm một khung 5 giờ cuộn và một hạn theo tuần, dùng chung giữa chat với Claude và Claude Code. Không có số tin nhắn cố định; lượng dùng tuỳ độ dài cuộc trò chuyện, mô hình và tính năng. Trang giá chỉ ghi Pro được "at least 5x more usage per 5-hour session than Free", còn Max gấp 5 lần Pro. Trong panel, gõ /usage để mở hộp Account & usage xem hạn mức phiên hiện tại và của tuần.
Khi chạm hạn giữa chừng, Claude Code có thể làm thêm một chút cho xong bước đang dở và hiện dòng "Usage limit reached · wrapping up". Với Pro, việc này chỉ áp dụng tối đa một lần mỗi kỳ hạn tuần, và tính năng đang mở dần nên tài khoản của bạn có thể chưa có.
Chạm hạn hẳn thì bạn chờ hạn đặt lại, bật usage credits, chuyển sang tài khoản Claude Console mua credit API, hoặc nâng lên Max. Một lưu ý về tiền: nếu máy có biến môi trường ANTHROPIC_API_KEY, Claude Code sẽ dùng key đó thay vì gói đăng ký, và bạn bị tính phí API.
Lỗi hay gặp và cách xử lý
- Extension won't install — kiểm bản VS Code, kiểm quyền cài extension, thử cài thẳng từ Marketplace.
- Spark icon not visible — mở một tệp, kiểm phiên bản ở Help > About, chạy Reload Window, tạm tắt extension AI khác như Cline hay Continue, và xem workspace đã được tin cậy chưa.
- Bị hỏi đăng nhập dù đã đặt API key — VS Code có thể chưa nhận biến môi trường của shell. Mở VS Code từ terminal bằng
code ., hoặc đăng nhập bằng tài khoản Claude. - Claude Code never responds — kiểm mạng, mở cuộc trò chuyện mới; nếu đã có CLI, chạy
claudetrong terminal để xem lỗi chi tiết.
Lỗi claude không chạy trong terminal tích hợp thuộc về bản CLI, xem cách sửa ở bài Claude Code trên Windows.
Gỡ extension khi không dùng nữa
- Nhấn
Ctrl+Shift+Xđể mở Extensions view. - Tìm "Claude Code" trong danh sách đã cài.
- Bấm Uninstall.
Muốn xoá luôn dữ liệu của extension trên Windows, chạy lệnh PowerShell sau:
Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"Lưu ý extension có thể tự cài lại khi bạn chạy /ide từ terminal ngoài. Chặn bằng autoInstallIdeExtension: false trong ~/.claude.json, hoặc tắt Auto-install IDE extension trong /config.
Kiểm lại
- Spark hiện ở góc trên phải khi mở tệp, panel mở được.
/statusđúng tài khoản và mô hình.- Chân ô nhập hiện chế độ quyền bạn chọn, với repo quan trọng là Manual hoặc Plan.
- Máy không có
ANTHROPIC_API_KEYngoài ý muốn, và/usagemở được hộp Account & usage.
Qua đủ bốn ý trên là bạn đã nắm cách dùng Claude Code trong VSCode ở mức đủ để giao việc thật hằng ngày.
- Tác giả
- Quản trị viên
- Đăng ngày
- 2026-11-13
- Cập nhật
- 2026-11-13
- Thời gian đọc
- 8 phút đọc
- Tất cả bài viết