Qwen Code cho người làm web: cài đặt, chọn mô hình đám mây hoặc tự host và giao việc an toàn

Cập nhật tháng 10/2026. Qwen Code phát hành bản mới rất dày, tên mô hình, gói và lệnh có thể thay đổi; hãy đối chiếu với kho GitHub và tài liệu chính thức trước khi áp dụng cho dự án thật.

Sau bài chạy Qwen cục bộ cho tài liệu nội bộ, bài này giới thiệu Qwen Code: agent lập trình dòng lệnh mã nguồn mở của nhóm Qwen (Alibaba), đọc kho mã, sửa tệp và chạy lệnh. Điểm đáng chú ý: bạn tự chọn mô hình, trên đám mây hay tự host.

1. Qwen Code là gì và khi nào nên dùng

Theo kho GitHub QwenLM/qwen-code, đây là agent lập trình giấy phép Apache-2.0, phát triển từ Gemini CLI của Google rồi tách thành dự án độc lập. Nó chạy trong terminal, hỗ trợ MCP, subagent, Plan Mode và chế độ không tương tác cho CI.

Qwen Code hợp khi đội bạn muốn kiểm soát chi phí, thử mô hình mã nguồn mở, hoặc cần mã không rời hạ tầng công ty.

Lưu ý quan trọng: trang xác thực chính thức ghi rõ gói miễn phí đăng nhập bằng tài khoản Qwen (Qwen OAuth) đã ngừng từ 15/4/2026.

2. Cài đặt

3. Xác thực và chọn mô hình

Trong thư mục dự án, gõ qwen để mở phiên, rồi gõ /auth để chọn nhà cung cấp và nhập khoá. Có ba hướng chính:

Cấu hình lâu dài nằm trong ~/.qwen/settings.json, khối modelProviders. Mỗi mô hình khai báo id, name, baseUrl và envKey, tức tên biến môi trường chứa khoá chứ không phải khoá thật. Khoá thật để trong .env. Trong phiên, gõ /model để chuyển giữa các mô hình đã khai báo, không cần khởi động lại.

Với mô hình tự host, phải đặt generationConfig.contextWindowSize khớp với độ dài ngữ cảnh máy chủ đang chạy. Chọn kích thước mô hình theo cấu hình máy như hướng dẫn ở bài Qwen chạy cục bộ.

4. Quyền và an toàn trước khi giao việc thật

Qwen Code có năm chế độ duyệt, chuyển vòng bằng Shift+Tab (trên Windows là Tab) hoặc lệnh /approval-mode <tên>:

• Plan (plan): chỉ đọc và phân tích, không sửa tệp, không chạy lệnh. Gõ /plan để vào, /plan exit để ra.
• Ask Permissions (default): mỗi lần sửa tệp hay chạy lệnh shell đều chờ bạn duyệt. Nên dùng khi mới làm quen.
• Auto-Edit (auto-edit): tự sửa tệp, lệnh shell vẫn phải duyệt.
• Auto (auto): một bộ phân loại bằng mô hình xét lệnh shell, truy cập mạng và sửa tệp ngoài workspace, cho qua việc an toàn, chặn việc rủi ro.
• YOLO (yolo): duyệt tất cả. Tài liệu cảnh báo agent có thể chạy mọi lệnh với quyền terminal của bạn; chỉ dùng với kho mã tin cậy, có git và bản sao lưu.

Chế độ mặc định lưu ở khoá tools.approvalMode, nên hãy xem thanh trạng thái trước khi giao việc. Lớp bảo vệ thứ hai là sandbox: chạy qwen --sandbox. Trên macOS dùng Seatbelt, chặn ghi ngoài thư mục dự án nhưng vẫn cho ra mạng; Linux, Windows cần Docker hoặc Podman. Khối permissions trong settings đặt quy tắc cho phép, hỏi, chặn; quy tắc chặn luôn ưu tiên.

5. Giao việc trên một dự án web nhỏ

6. Ba prompt mẫu

Mẫu 1: Lập kế hoạch trước khi sửa

Mẫu 2: Sửa lỗi có giới hạn phạm vi

Mẫu 3: Rà soát trước khi bàn giao cho khách

7. Ví dụ: studio web 4 người dùng mô hình tự chọn

Ví dụ minh hoạ: một studio web ở Đà Nẵng bảo trì website cho vài khách sạn. Họ khai báo hai mô hình: Qwen trên Model Studio cho lập kế hoạch và lỗi khó, một mô hình nhỏ chạy Ollama trên máy chủ văn phòng cho việc rà soát như Mẫu 3 và cho mã khách yêu cầu giữ kín.

Quy tắc nhóm: agent không deploy, không bật YOLO, mọi thay đổi qua nhánh riêng và được chạy thử trước khi gộp. Tệp quy ước đặt tên AGENTS.md để dùng chung, theo bài CLAUDE.md và AGENTS.md cho dự án web.

8. Lỗi thường gặp

• Làm theo hướng dẫn cũ về gói miễn phí: Qwen OAuth đã ngừng, cần chọn Model Studio, gói thuê bao hoặc mô hình tự host.
• Khoá và endpoint lệch vùng: khoá vùng quốc tế nhưng baseUrl trỏ vùng Trung Quốc (hoặc ngược lại) sẽ báo lỗi xác thực; khoá Coding Plan cũng có endpoint riêng.
• Mô hình cục bộ trả lời lạc đề, bỏ dở công cụ: thường do ngữ cảnh máy chủ quá ngắn hoặc mô hình quá nhỏ. Tăng độ dài ngữ cảnh ở Ollama, khai báo contextWindowSize khớp, hoặc dùng mô hình lớn hơn.
• Ghi khoá thật vào settings.json rồi commit: dùng envKey trỏ tới biến môi trường, thêm .env và .qwen/QWEN.local.md vào .gitignore.

9. Bài tập thực hành trong 1 buổi

1. Sao chép một landing page tĩnh, khởi tạo git và commit.
2. Cài Qwen Code, chạy qwen --version, mở phiên và cấu hình một mô hình bằng /auth.
3. Chạy /init, đọc và chỉnh QWEN.md, kiểm tra bằng /memory.
4. Chạy Mẫu 3 ở chế độ Plan, đối chiếu danh sách vấn đề với hiểu biết của bạn.
5. Chọn 1 vấn đề, giao sửa ở chế độ Ask Permissions, đọc git diff, chạy thử, rồi ghi lại lỗi agent mắc phải.

10. So sánh nhanh với Claude Code và Codex

Cách thực tế: giữ một tệp quy ước chung, thử cùng một việc trên hai công cụ, chọn theo chất lượng diff và chi phí.

Thuật ngữ cần biết

• Approval mode: chế độ quyết định agent được tự sửa tệp, chạy lệnh hay phải chờ bạn duyệt (tài liệu Qwen Code).
• Endpoint tương thích OpenAI: địa chỉ API nhận yêu cầu theo cùng định dạng với OpenAI, nhờ đó một công cụ dùng được nhiều nhà cung cấp mô hình (Model Providers).
• Sandbox: vùng giới hạn chỉ cho lệnh của agent ghi tệp trong phạm vi được phép, dùng Seatbelt trên macOS hoặc container Docker, Podman (Sandbox).
• Apache-2.0: giấy phép mã nguồn mở cho phép dùng, sửa, phân phối lại kể cả mục đích thương mại, kèm điều kiện giữ thông báo bản quyền (apache.org).

Tìm hiểu thêm

• Kho GitHub QwenLM/qwen-code
• Tài liệu chính thức Qwen Code
• Xác thực và các gói kết nối mô hình
• QWEN.md và bộ nhớ dự án
• Chế độ không tương tác cho script và CI
• Hướng dẫn Qwen Code trên Alibaba Cloud Model Studio
• Ollama: chạy mô hình trên máy riêng

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

Muốn đội của bạn dùng agent lập trình đúng quy trình, chọn mô hình hợp ngân sách và giữ an toàn mã nguồn khách hàng? Tham khảo chương trình đào tạo và triển khai AI của PDL.