Dùng Claude Code trong VS Code: cài đặt, phím tắt & tối ưu (2026)

kiểm chứng lại theo tài liệu chính thức code.claude.com/docs/en/vs-code (truy cập 09/08/2026).

Làm rõ nhanh: "claude code vs code" nghĩa là gì?

Nếu bạn gõ "claude code vs code" và mong tìm bài so sánh Claude Code với một công cụ khác thì nhầm rồi. Ở đây "vs code" = Visual Studio Code, nên nhu cầu thật là dùng Claude Code tích hợp bên trong VS Code, không phải trận đối đầu. (Cần so kèo thật? Xem Claude Code là gì để nắm nền tảng trước.)

Một điểm dễ lẫn nữa: bài này nói về extension "Claude Code" chính chủ (publisher anthropic.claude-code, icon Spark ✱, có diff/plan/checkpoint), không phải extension "Claude AI" chat sidebar cũ mà nhiều bài Việt hay hướng dẫn. Hai thứ khác hẳn nhau về sản phẩm lẫn tính năng: extension chính chủ hiểu cả workspace, sửa nhiều file trong một lượt và trả về diff để bạn duyệt; còn các extension chat cũ chủ yếu là ô hỏi-đáp cạnh code. Nếu đang xem một hướng dẫn mà không thấy nhắc icon Spark, diff review hay plan mode, khả năng cao họ đang nói về sản phẩm khác.

Cần chuẩn bị gì? (điều kiện)

Trước khi cài, kiểm tra ba thứ để khỏi mất công:

• VS Code bản mới - theo tài liệu chính thức là phiên bản ≥ 1.94.0. Mở Help → About để xem, cũ quá thì cập nhật trước.
• Một gói Claude trả phí: Pro, Max, Team hoặc Enterprise (hoặc quyền qua Claude Console). Đây là điều kiện bắt buộc.
• Không cần API key, không có bản free. Extension đăng nhập bằng tài khoản Claude của bạn, không phải dán key như một số công cụ khác. Nếu chưa có gói nào, bạn sẽ không dùng được - đây là điểm khác biệt so với vài extension AI bên thứ ba cho phép cắm API key riêng.

Nói thẳng về giới hạn: vì phụ thuộc gói trả phí, đây không phải lựa chọn cho ai muốn xài chùa. Bù lại, bạn không phải tự quản lý hạn mức API hay lo hoá đơn token bất ngờ - mức dùng nằm trong gói thuê bao. Nếu đang phân vân giữa các gói, cân nhắc theo tần suất dùng: thử việc/học thì Pro là đủ, còn cày cả ngày thì Max đáng tiền hơn.

Chưa quen Claude Code là gì và làm được đến đâu? Đọc bài giới thiệu Claude Code rồi quay lại đây cài extension.

Cách cài Claude Code extension cho VS Code (từng bước)

Toàn bộ quy trình chỉ khoảng 2 phút. Làm theo bốn bước:

1. Mở tab Extensions bằng Ctrl+Shift+X (Windows/Linux) hoặc Cmd+Shift+X (macOS). Gõ "Claude Code" vào ô tìm kiếm, chọn extension của publisher Anthropic (đừng nhầm với các extension "Claude AI" khác), bấm Install.
2. Mở panel Claude Code bằng cách bấm icon Spark ✱. Icon này xuất hiện ở Editor Toolbar (góc trên phải khi đang mở một file), Activity Bar bên trái, hoặc Status Bar dưới đáy. Mẹo: phải đang mở ít nhất một file thì icon mới hiện rõ.
3. Đăng nhập: bấm Sign in, VS Code sẽ mở trình duyệt để bạn xác thực bằng tài khoản Claude. Xong thì quay lại VS Code, panel sẽ sẵn sàng.
4. Gửi prompt thử: gõ một yêu cầu đơn giản như "giải thích file này đang làm gì" để chắc chắn mọi thứ chạy. Nếu Claude trả lời và nhận đúng file đang mở, coi như cài thành công.

Mẹo nhỏ ngay từ đầu: sau khi cài, mở đúng thư mục dự án (không phải một file lẻ) để Claude thấy toàn bộ ngữ cảnh workspace. Trên Windows nếu bạn làm trong WSL, cứ mở dự án ở chế độ WSL của VS Code như thường lệ rồi mới bật panel - extension chạy tốt trong môi trường đó.

Extension này không chỉ chạy trên VS Code gốc - nó cài được cả trên Cursor, Kiro và các bản dựa trên Open VSX, cách cài tương tự. Nếu bạn muốn dùng luôn dòng lệnh claude ở terminal, xem thêm hướng dẫn cài đặt Claude Code CLI đầy đủ (extension và CLI bổ trợ cho nhau, mục dưới sẽ nói rõ).

Giao diện & tính năng lõi trong VS Code

So với gõ lệnh ở terminal, extension cho bạn một giao diện trực quan hơn hẳn. Đây là những tính năng đáng dùng:

• Diff review side-by-side: mỗi khi Claude sửa file, thay đổi hiện ở dạng diff cạnh nhau, xanh-đỏ rõ ràng. Bạn duyệt từng thay đổi một, accept/reject riêng lẻ, thậm chí sửa trực tiếp ngay trong diff trước khi chấp nhận. Khác hẳn cảm giác dán code từ chat rồi tự merge tay - bạn luôn thấy chính xác cái gì sắp đổi và có quyền chặn từng dòng. Đây là điểm mạnh nhất khi làm trong VS Code.
• Plan mode: ở chế độ Plan, Claude mở kế hoạch dạng Markdown để bạn đọc và comment inline trước khi nó bắt tay chỉnh code. Rất hợp khi làm task lớn: bạn duyệt hướng đi, chỉnh vài chỗ trong plan, rồi mới cho chạy - tránh cảnh AI lao vào sửa lung tung cả chục file. Nếu muốn hiểu sâu quy trình lập kế hoạch, xem thêm 10 bước bắt đầu cho người mới.
• @-mention để đưa ngữ cảnh vào prompt: @file#5-10 (chỉ lấy dòng 5-10), @folder/ (cả thư mục), @terminal:name (đưa output terminal vào), và @browser (điều khiển Chrome). Thay vì copy-paste, bạn trỏ thẳng vào thứ Claude cần thấy. Ví dụ khi debug, @file#40-72 để Claude tập trung đúng đoạn hàm lỗi thay vì đọc cả file nghìn dòng - vừa chính xác hơn vừa đỡ tốn token.
• Checkpoint / Rewind: tua lại các thay đổi file về trạng thái trước đó nếu Claude đi sai hướng - như một mạng lưới an toàn, đỡ phải trông cậy hoàn toàn vào git stash hay Ctrl+Z từng bước.
• Session history + nhiều tab: mở nhiều phiên song song, xem lại lịch sử hội thoại, hợp khi làm nhiều mạch việc cùng lúc - ví dụ một tab đang refactor, tab kia hỏi nhanh về một API.
• Permission mode: ngay trong ô nhập prompt, bạn chọn Manual (duyệt tay từng hành động), Plan (chỉ lập kế hoạch) hay Edit automatically (tự sửa). Vào repo lạ thì để chế độ thận trọng, quen rồi mới nới ra. Có thể đặt sẵn chế độ mặc định qua initialPermissionMode trong settings.

Bảng phím tắt Claude Code trong VS Code

Đây là bảng phím tắt đầy đủ (theo tài liệu chính thức) mà hầu hết bài hướng dẫn Việt bỏ sót:

Quên phím nào thì mở Command Palette (Ctrl/Cmd+Shift+P) gõ "Claude Code" để thấy toàn bộ lệnh. Muốn một bản in tổng hợp mọi lệnh, xem cheat sheet Claude Code.

Mẹo tối ưu Claude Code trong VS Code

Cài xong ai cũng làm được, nhưng dùng cho mượt thì cần vài mẹo. Đây là những cái mình dùng hằng ngày:

• Kéo panel sang secondary sidebar: để Claude nằm cạnh code thay vì che mất editor. Chỉ cần drag icon Spark sang cạnh phải - nhìn diff và code cùng lúc dễ hơn nhiều.
• Viết CLAUDE.md làm "bộ nhớ dự án": đây là mẹo tăng chất lượng output rõ rệt nhất. Ghi convention, stack, lệnh test... vào file này để Claude không đoán mò. Xem cách viết CLAUDE.md chuẩn.
• Dùng @terminal thay copy-paste lỗi: chạy lệnh bị lỗi trong terminal tích hợp rồi @terminal đưa nguyên output vào prompt - nhanh và đủ ngữ cảnh hơn dán tay.
• Bật/tắt useTerminal: nếu thích thao tác kiểu CLI, bật tùy chọn này trong settings; thích GUI thuần thì tắt đi.
• Cân nhắc autosave và respectGitIgnore: để diff sạch và tránh Claude đọc nhầm file rác/nhạy cảm.
• Theo dõi chi phí: gõ /usage xem mức dùng, và /compact để nén ngữ cảnh khi phiên chat đầy - giữ Claude tập trung, đỡ tốn token.
• Gọn statusline: tùy biến để thấy nhanh model/chi phí đang dùng, xem hướng dẫn tùy biến statusline.

Một thói quen đáng tập: trước khi giao task lớn, dành 30 giây mô tả rõ mục tiêu và ràng buộc trong prompt (hoặc để sẵn trong CLAUDE.md), rồi bật Plan mode duyệt hướng đi trước khi cho sửa. Cách này tốn thêm một nhịp nhưng cắt hẳn số lần Claude làm lệch ý, đỡ mất công rewind. Với repo lớn, kết hợp @folder/ cho module đang làm thay vì thả cả dự án - Claude tập trung đúng chỗ, kết quả sạch hơn và tốn ít token hơn.

Extension vs CLI - chọn cái nào?

Câu hỏi hay gặp: đã có extension thì còn cần CLI không? Bảng so sánh nhanh:

Lưu ý quan trọng: extension không tự thêm lệnh claude vào PATH, nên muốn gõ claude ở terminal tích hợp thì phải cài CLI standalone riêng. Lời khuyên thực tế: dùng cả hai - GUI để duyệt diff/plan, CLI cho các thao tác nhanh - và chúng chia sẻ chung lịch sử, bạn có thể claude --resume để nối lại phiên. Chi tiết cài CLI ở bài cài đặt Claude Code đầy đủ.

Lỗi thường gặp & cách xử lý

Vài lỗi hay gặp và cách xử lý nhanh:

• Cmd+Esc không ăn trên macOS Tahoe: phím này thường bị Game Overlay chiếm. Vào System Settings → Keyboard → Keyboard Shortcuts → Game Controllers bỏ tick mục chiếm phím, hoặc rebind lệnh Claude Code: Focus input sang tổ hợp khác trong VS Code Keyboard Shortcuts.
• Không thấy icon Spark ✱: kiểm tra theo thứ tự - đang mở ít nhất một file chưa? VS Code đã ≥ 1.94.0 chưa? Thử Reload Window (Command Palette), tắt tạm các extension AI khác đang xung đột, và bật workspace trust cho thư mục dự án.
• Báo "Please run /login": thử Reload Window, hoặc đóng VS Code rồi mở lại dự án bằng lệnh code . từ terminal để nó nhận đúng phiên đăng nhập.
• Claude không phản hồi: kiểm tra mạng, mở một session mới, hoặc thử chạy qua CLI để khoanh vùng lỗi ở extension hay ở tài khoản. Nếu phiên chat đã rất dài, gõ /compact để nén ngữ cảnh rồi thử lại.
• Diff không hiện hoặc apply nhầm: đảm bảo file đã lưu và không bị extension khác (formatter tự chạy khi save) sửa chồng lên. Bật autosave có kiểm soát và tạm tắt formatter on-save khi đang duyệt diff lớn.

Gặp lỗi ngoài danh sách này? Xem tổng hợp các lỗi Claude Code thường gặp và cách khắc phục.

Tăng sức mạnh bằng skills/subagents dựng sẵn

Extension mạnh hơn nhiều khi Claude Code của bạn có sẵn bộ skills, subagents và workflow thay vì tự dựng từ đầu. Nếu muốn đi nhanh, có thể tham khảo bộ kit AgentKit cho Claude Code - một tập skills/agents đóng gói sẵn cho việc dev và marketing; bạn có thể dùng thử AgentKit (giảm 20% qua link) để xem có hợp quy trình của mình không. Không bắt buộc: extension gốc vẫn đủ dùng, kit chỉ là lựa chọn tăng tốc.

Câu hỏi thường gặp (FAQ)

Claude Code trong VS Code có miễn phí không?

Không. Extension cài miễn phí nhưng để dùng phải có gói Claude trả phí (Pro, Max, Team hoặc Enterprise) hoặc quyền qua Claude Console. Không có bản free và không dùng được bằng API key.

Có cần gói Pro không?

Cần ít nhất một gói trả phí; Pro là mức thấp nhất phù hợp cho cá nhân. Max hợp khi bạn dùng nhiều, còn Team/Enterprise dành cho nhóm.

Khác gì extension "Claude AI"/Cline/Continue?

Extension "Claude Code" là bản chính chủ Anthropic (publisher anthropic.claude-code), có diff review, plan mode, checkpoint và @-mention gắn liền tài khoản Claude. Các extension như "Claude AI" chat cũ, Cline hay Continue là sản phẩm khác, cách hoạt động và tính năng không giống.

Dùng trong Cursor được không?

Được. Extension Claude Code cài được trên Cursor, Kiro và các trình dựa trên Open VSX, cách cài tương tự như trên VS Code.

Có cần cài CLI riêng không?

Không bắt buộc. Extension đã bundle sẵn CLI cho panel. Chỉ khi bạn muốn gõ lệnh claude ngay trong terminal tích hợp thì mới cần cài CLI standalone, vì extension không tự thêm claude vào PATH.

Chạy trên Windows/WSL được không?

Được. Extension chạy trên Windows, macOS và Linux; với WSL bạn mở dự án ở chế độ WSL của VS Code như bình thường rồi dùng panel Claude Code.

Kết luận & bước tiếp theo

Vậy là bạn đã có Claude Code chạy ngay trong VS Code: cài extension chính chủ, đăng nhập bằng gói trả phí, rồi tận dụng diff/plan/checkpoint, @-mention và bộ phím tắt để code nhanh hơn. Bước tiếp theo: nếu mới bắt đầu, đọc 10 bước bắt đầu cho người mới; muốn dùng cả dòng lệnh thì xem cài đặt Claude Code CLI đầy đủ. Chúc bạn code vui.