Cài extension DuanAPI cho VS Code — Hướng dẫn từng bước
Extension này giúp bạn hỏi AI ngay trong VS Code và để AI tự sửa code giúp bạn. Bạn không cần biết lập trình sâu — chỉ cần làm theo 4 bước bên dưới là dùng được.
Extension này làm được gì?
Sau khi cài, bạn có thể mở một khung chat ngay trong VS Code và nói chuyện với AI bằng tiếng Việt (hoặc tiếng Anh). AI sẽ trả lời, viết code, sửa lỗi, và thậm chí tự sửa file trong dự án của bạn — bạn chỉ cần duyệt xem có đồng ý không.
Hỏi đáp
Hỏi bất cứ điều gì
- Giải thích một đoạn code bạn không hiểu
- Viết hàm, viết lớp, viết hàm kiểm thử
- Dịch tài liệu, viết README, viết email
Sửa code tự động
AI làm thay bạn
- Tìm và sửa lỗi trong dự án
- Thêm chức năng mới vào code cũ
- Tối ưu và viết comment cho từng dòng
Gợi ý khi bạn gõ
Không cần hỏi gì cả
- AI tự hiện gợi ý đoạn code tiếp theo
- Bấm Tab là nhận, không muốn thì bỏ qua
- Tiết kiệm thời gian gõ phím
Trước khi cài, bạn cần có 2 thứ
Một tài khoản DuanAPI
Đăng ký miễn phí
- Bấm Đăng ký ở góc trên — chỉ mất vài giây
- Đăng nhập bằng Google, không cần tạo mật khẩu
Tiền trong tài khoản
Nạp tối thiểu 1 credit
- Nạp tại trang Nạp tiền (quét QR ngân hàng)
- 1 credit = 26.000 đ — nạp nhiều cũng được
- Số dư không hết hạn, dùng đến bao giờ cũng được
📥 Cài đặt chỉ 4 bước
Làm đúng thứ tự là xong — mất khoảng 3 phút.
Mở VS Code và vào phần Extensions
Nếu chưa có VS Code, tải miễn phí tại code.visualstudio.com và cài như một ứng dụng bình thường.
Cách mở phần Extensions: bấm chuột vào biểu tượng ô vuông xếp ô ở thanh bên trái. Hoặc bấm tổ hợp phím Ctrl + Shift + X (trên Mac là ⌘ + ⇧ + X).
Tìm "DuanAPI" trong ô tìm kiếm
Ở thanh tìm kiếm phía trên khung Extensions, gõ DuanAPI. Kết quả đầu tiên sẽ là extension của chúng tôi (tên tác giả: DuanAPI-AIcodeagent).
⚠️ Nếu bạn thấy nhiều kết quả, hãy chọn đúng kết quả có tên tác giả DuanAPI-AIcodeagent và có biểu tượng logo màu tím.
Bấm nút "Install" (Cài đặt)
Bấm nút Install màu xanh. VS Code tự tải và cài xong trong vài giây — bạn không cần tải file thủ công, cũng không cần cài thêm gì khác.
Sau khi cài xong, nút Install sẽ đổi thành Installed (hoặc Uninstall nếu bạn muốn gỡ).
Khởi động lại VS Code một lần
Bấm nút Reload Window (Tải lại cửa sổ) ở góc trên bên phải, hoặc tắt hẳn VS Code rồi mở lại. Đây là bước bắt buộc để thanh bên DuanAPI xuất hiện.
Sau khi làm bước này, ở thanh bên trái (Activity Bar) sẽ có thêm một biểu tượng DuanAPI (logo tia sét). Bấm vào đó là mở khung chat.
1.104 trở lên.
Nếu VS Code của bạn cũ hơn, hãy cập nhật lên phiên bản mới nhất (miễn phí).
🔑 Nhập API key (bắt buộc)
API key giống như mật khẩu để extension được phép dùng tài khoản của bạn. Bạn cần lấy key ở trang Quản lý API Keys rồi dán vào extension.
Lấy key trên web
Vào /user/api-keys → bấm nút Tạo API key → đặt một cái tên (ví dụ "Máy của tôi") → bấm Tạo.
⚠️ Key chỉ hiện đúng 1 lần duy nhất ngay sau khi tạo. Hãy copy ngay và lưu lại, không lấy được thì chỉ cần tạo key mới.
Dán key vào VS Code
Bấm Ctrl + Shift + P (Mac: ⌘ + ⇧ + P) để mở Command Palette — một ô nhập lệnh ở trên cùng.
Gõ Update DuanAPI API Key rồi bấm Enter. Dán key vừa copy (Ctrl + V) vào ô trống → bấm Save.
Nếu không biết Command Palette là gì: cứ gõ DuanAPI vào đó, danh sách các lệnh sẽ hiện ra — bạn chỉ cần chọn đúng tên lệnh.
Kiểm tra đã kết nối được chưa
Bấm biểu tượng DuanAPI ở thanh bên trái để mở khung chat. Ở thanh trên cùng của khung chat, chọn một model (tên của AI bạn muốn dùng).
Gõ thử một câu, ví dụ: "Xin chào, bạn là ai?" → bấm Enter.
✅ Nếu AI trả lời được → bạn đã cài xong hoàn toàn! ❌ Nếu báo lỗi → xem mục Xử lý sự cố ở cuối trang.
🎬 Thử 5 việc này để làm quen
Sau khi kết nối được, bạn có thể thử ngay những việc sau — chỉ cần gõ vào khung chat:
Giải thích đoạn code này bằng tiếng Việt
Viết cho tôi một hàm Python đọc file CSV và đếm số dòng
Tìm lỗi trong dự án này và sửa giúp tôi
Tạo file README.md giới thiệu dự án này
Thêm chức năng đăng nhập bằng Google vào backend hiện tại
🛠️ Chế độ Agent — để AI tự sửa file
Mặc định AI chỉ trả lời bằng lời, không đụng vào file của bạn. Khi bật chế độ Agent, AI được phép đọc, tạo, sửa và xoá file trong thư mục bạn đang mở.
Chế độ Chat
Mặc định — chỉ nói chuyện
- AI trả lời bằng chữ
- Không thay đổi file nào
- An toàn tuyệt đối
Chế độ Agent
AI được sửa code
- AI đọc, tạo, sửa, xoá file trong thư mục bạn mở
- Mọi thay đổi hiện dạng diff để bạn xem
- Bấm đồng ý mới áp dụng — hoặc bấm Esc để bỏ
⌨️ Phím tắt hay dùng
| Phím tắt | Windows | Mac | Dùng để làm gì |
|---|---|---|---|
Ctrl + L | Ctrl + L | ⌘ + L | Mở khung chat DuanAPI |
Ctrl + Shift + L | Ctrl + Shift + L | ⌘ + ⇧ + L | Gửi phần đang bôi đen vào chat để hỏi về nó |
Ctrl + I | Ctrl + I | ⌘ + I | Bật chế độ sửa nhanh (AI viết lại đoạn đang chọn) |
Ctrl + Shift + Enter | Ctrl + Shift + Enter | ⌘ + ⇧ + ↵ | Đồng ý với thay đổi AI đề xuất |
Esc | Esc | Esc | Từ chối / thoát, không áp dụng thay đổi |
Ctrl + Alt + Space | Ctrl + Alt + Space | ⌃ + ⌥ + Space | Ép hiện gợi ý AI khi đang gõ code |
Ctrl + Shift + P | Ctrl + Shift + P | ⌘ + ⇧ + P | Mở ô gõ lệnh nhanh (dùng để nhập API key) |
Ctrl + Shift + X | Ctrl + Shift + X | ⌘ + ⇧ + X | Mở phần Extensions |
🛠 Gặp lỗi? Thử các cách sau
Đây là những lỗi hay gặp nhất, và cách xử lý.
Không thấy biểu tượng DuanAPI ở thanh bên trái
Cách 1 (nhanh nhất): bấm Ctrl + Shift + P,
gõ DuanAPI, chọn Focus DuanAPI Chat.
Cách 2: mở Extensions → tìm DuanAPI → bấm
Reload Window (hoặc Enable nếu extension đang bị tắt).
AI không trả lời / báo "Unauthorized" (401)
API key sai hoặc chưa nhập. Vào /user/api-keys để kiểm tra,
rồi nhập lại key: Ctrl + Shift + P →
DuanAPI: Update DuanAPI API Key → dán key mới → Save.
Báo "Insufficient quota" (402) — hết tiền
Tài khoản chưa có credit. Nạp thêm tại /user/billing. Nạp tối thiểu 1 credit là dùng được ngay.
Báo lỗi "model not found" (400)
Tên model đang chọn không tồn tại. Ở thanh trên cùng của khung chat, bấm vào ô chọn model rồi chọn một model khác — danh sách model được tự động lấy từ máy chủ nên luôn mới nhất.
Chat bị treo, không có phản hồi
Kiểm tra kết nối mạng của bạn, rồi thử đổi sang một model nhẹ hơn. Nếu yêu cầu của bạn quá dài, hãy chia nhỏ thành 2–3 câu hỏi.
Gợi ý khi gõ không hiện
Kiểm tra bạn đang đặt con trỏ trong file code và file đó thuộc thư mục đang mở. Thử bấm Ctrl + Alt + Space để ép hiện gợi ý.
Không tìm thấy extension khi tìm kiếm
Thử tải trực tiếp từ trang Marketplace. Nếu mạng của công ty/trường chặn truy cập Marketplace, hãy xem mục Dành cho developer bên dưới.
🧑💻 Dành cho developer
Nếu bạn đã quen VS Code và muốn cài nhanh bằng dòng lệnh, hoặc cần cấu hình chi tiết — các phần dưới đây là dành cho bạn.
Cài bằng dòng lệnh
Mở terminal trong VS Code (Ctrl + `) và chạy:
code --install-extension DuanAPI-AIcodeagent.duanapi
Các thông tin kỹ thuật
- Base URL —
https://thuehay.com/v1(đã đặt sẵn trong extension, không cần khai báo) - API Key — key dạng
sk-duan-..., lấy tại /user/api-keys - Danh sách model —
GET https://thuehay.com/v1/modelshoặc xem tại /pricing - Số dư & lịch sử dùng —
GET https://thuehay.com/v1/usagehoặc /user/billing - Yêu cầu — VS Code
1.104trở lên. Không cần Node.js hay công cụ build nào.
Các lệnh của DuanAPI
Mở Command Palette (Ctrl + Shift + P) và gõ DuanAPI để xem đầy đủ.
| Lệnh | Mô tả |
|---|---|
DuanAPI: Update DuanAPI API Key | Dán và lưu API key vào kho bí mật của VS Code |
DuanAPI: Open DuanAPI API Key Settings | Mở trang cấu hình API key trong extension |
DuanAPI: Focus DuanAPI Chat | Mở khung chat DuanAPI |
DuanAPI: New Session | Bắt đầu cuộc trò chuyện mới (chat cũ vẫn nằm trong lịch sử) |
DuanAPI: View History | Mở lại bất kỳ cuộc trò chuyện cũ nào |
DuanAPI: Open Settings | Mở bảng cấu hình của extension |
DuanAPI: Select Files as Context | Chọn file trong explorer để dùng làm ngữ cảnh cho AI |
DuanAPI: Add to Chat | Thêm vùng đang chọn (hoặc file hiện tại) vào khung chat |
DuanAPI: Add to Edit | Thêm vùng đang chọn vào chế độ Edit nhanh |
DuanAPI: Apply code from chat | Đưa code trong khung chat vào file |
DuanAPI: Accept Diff / Reject Diff | Chấp nhận hoặc từ chối thay đổi do AI đề xuất |
DuanAPI: Write Comments for this Code | Thêm comment cho đoạn code đang chọn |
DuanAPI: Write a Docstring for this Code | Sinh docstring cho hàm/class đang chọn |
DuanAPI: Fix this Code | Sửa lỗi đoạn code đang chọn |
DuanAPI: Optimize this Code | Tối ưu đoạn code đang chọn |
DuanAPI: Fix Grammar / Spelling | Sửa ngữ pháp chính tả |
DuanAPI: Toggle Autocomplete Enabled | Bật/tắt gợi ý autocomplete |
DuanAPI: Rebuild codebase index / Docs Force Re-Index | Lập lại chỉ mục codebase / tài liệu |
DuanAPI: Share Current Chat Session as Markdown | Xuất cuộc trò chuyện ra file Markdown |
DuanAPI: View Logs / Clear Console | Xem log và xóa console của extension |
DuanAPI: Debug Terminal | Mở terminal nội bộ để chẩn đoán |
Cấu hình nâng cao
Mở DuanAPI: Open Settings để mở bảng cấu hình. Các mục chính:
- Models — xem và chọn model cho từng vai trò (chat, edit, apply, autocomplete).
- API Key — kiểm tra trạng thái key, cập nhật key mới.
- Rules — thêm quy tắc riêng cho dự án (system prompt theo phạm vi workspace).
- Tools — bật/tắt nhóm tool cho AI (đọc file, tìm kiếm, chạy lệnh, MCP server…).
- Indexing — bật/tắt lập chỉ mục codebase và tài liệu.
- Settings — telemetry, gợi ý nhanh, hành vi mặc định.