Qwen Code là gì: agent lập trình của Alibaba cho Qwen3-Coder

Thử hình dung thế này. Phòng IT của anh vừa nhận bàn giao phần mềm quản lý kho viết từ nhiều năm trước. Người viết đã nghỉ, tài liệu thì mỏng như tờ lịch. Anh muốn nhờ một agent lập trình đọc giúp, nhưng công ty lại ngại phụ thuộc hẳn vào Claude hay Gemini.

Ngày 22/07/2025, Alibaba đưa ra thêm một lựa chọn: Qwen Code, agent lập trình chạy trong terminal, đi kèm model Qwen3-Coder công bố cùng ngày. Và điều thú vị là Qwen Code không viết lại từ đầu, mà được chỉnh từ Gemini CLI của Google.

Đọc nhanh trong 30 giây

• Qwen Code là agent lập trình mã nguồn mở (Apache 2.0) của nhóm Qwen thuộc Alibaba, chỉnh từ Gemini CLI, ra mắt ngày 22/07/2025.
• Nó chạy model Qwen3-Coder để đọc, sửa và tự động hóa việc trên codebase, kết nối qua API chuẩn OpenAI.
• Cài bằng npm install -g @qwen-code/qwen-code, khai báo ba biến môi trường, gõ qwen là chạy.
• Hợp với đội kỹ thuật muốn phương án ngoài Claude và Gemini. Công cụ còn rất mới, bản 0.0.1.

Qwen Code là gì, dùng vào việc gì?

Qwen Code là bản chỉnh sửa từ Gemini CLI, tối ưu riêng cho model Qwen3-Coder với bộ phân tích lệnh gọi công cụ và bộ công cụ được cải tiến, theo README. Nói nôm na, nhóm Qwen lấy phần "thân xe" của Gemini CLI rồi lắp "động cơ" Qwen3-Coder vào, chỉnh lại hộp số cho hai bên ăn khớp.

Phần chỉnh quan trọng nhất là parser, đoạn code đọc câu trả lời của model để biết model muốn gọi công cụ nào. Nó giống một người phiên dịch đứng giữa: mỗi họ model "nói" lệnh gọi công cụ theo giọng riêng, lấy nguyên phiên dịch của Gemini mà nghe Qwen thì dễ hiểu sai. Nhóm Qwen thay phiên dịch mới cho đúng giọng.

Qwen Code giữ khung Gemini CLI, thay parser và động cơ.

README ngày ra mắt liệt kê ba tính năng:

• Hiểu và sửa codebase lớn vượt giới hạn cửa sổ ngữ cảnh thông thường.
• Tự động hóa việc vận hành như xử lý pull request, rebase phức tạp.
• Parser chỉnh riêng cho model Qwen-Coder.

Nếu anh chị đã đọc bài Gemini CLI: hướng dẫn cài đặt và sử dụng, cách dùng Qwen Code gần như giống hệt.

Qwen3-Coder, động cơ bên trong, mạnh cỡ nào?

Qwen3-Coder-480B-A35B-Instruct là model lập trình kiểu Mixture-of-Experts của Alibaba, tổng 480 tỷ tham số nhưng mỗi lần chỉ dùng 35 tỷ. Giống một tòa soạn có 480 phóng viên, mỗi bài chỉ phân cho đúng nhóm 35 người rành mảng đó, nên làm nhanh mà vẫn giữ được kiến thức rộng.

Các con số do Alibaba tự công bố ngày 22/07/2025.

Cài Qwen Code trong 4 bước

Cần Node.js bản 20 trở lên. Phần còn lại chỉ là vài dòng lệnh.

Một lệnh cài, ba biến môi trường, một lệnh chạy.

1. Cài Node.js bản 20 trở lên.
2. Cài Qwen Code từ npm và kiểm tra:

npm install -g @qwen-code/qwen-code
qwen --version

3. Khai báo khóa API. Qwen Code dùng API chuẩn OpenAI nên cần ba biến môi trường. Với dịch vụ DashScope quốc tế của Alibaba Cloud, bài công bố ghi:

export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"

Người dùng ở Trung Quốc đại lục dùng địa chỉ https://dashscope.aliyuncs.com/compatible-mode/v1. Trong thư mục dự án, anh chị cũng có thể đặt ba biến này trong file .env.

4. Vào thư mục dự án và gõ:

qwen

Mẹo

Khi tạo khóa DashScope, hãy đặt hạn mức chi nhỏ ngay từ đầu. Agent đọc nhiều file mỗi lượt, vài ngày đầu chưa quen rất dễ tốn hơn dự tính.

Thử Qwen Code với việc thật

Việc 1: làm quen hệ thống cũ. Quay lại phần mềm quản lý kho ở đầu bài. Mở Qwen Code trong thư mục code và hỏi:

> What are the core business logic components?
> How does the data flow work?

Việc 2: viết test và tài liệu. Sau khi sửa một module, nhờ Qwen Code:

> Write unit tests for this component
> Add proper error handling and logging

Anh chị gõ tiếng Việt cũng được. README không cam kết chất lượng theo ngôn ngữ, nên thử trên vài việc nhỏ trước.

Việc 3: dùng Qwen3-Coder trong Claude Code. Bài công bố còn hướng dẫn hai cách cho người đã quen Claude Code: dùng proxy của DashScope, hoặc dùng claude-code-router kèm gói cấu hình @dashscope-js/claude-code-config.

Trước khi giao code công ty cho Qwen Code

Lưu ý

• Mục đích nghiên cứu. Bài công bố gọi Qwen Code là công cụ CLI cho mục đích nghiên cứu. Đây là phiên bản 0.0.1, mới ra trong ngày.
• Chi phí. Qwen Code miễn phí, nhưng gọi model qua DashScope tính tiền theo bảng giá Alibaba Cloud. Tài liệu ngày ra mắt không ghi giá.
• Dữ liệu. Code gửi tới máy chủ của nhà cung cấp API, với DashScope là hạ tầng Alibaba Cloud. Xem điều khoản trước khi đưa code của khách hàng vào.
• Tự chạy model. Trọng số mở, nhưng model 480 tỷ tham số cần hạ tầng GPU lớn. Doanh nghiệp nhỏ thực tế sẽ dùng qua API.

Nhận xét của chuyên gia

Qwen Code cho thấy một xu hướng rõ: hãng model không còn chỉ phát hành model, mà phát hành kèm luôn agent để model đó làm việc được ngay. Việc Alibaba chỉnh từ Gemini CLI thay vì viết lại từ đầu cũng là minh chứng đẹp cho lợi ích của mã nguồn mở: người đi sau đứng trên vai người đi trước.

Hợp với ai: đội kỹ thuật muốn phương án dự phòng ngoài Claude và Gemini; công ty cần model có trọng số mở để sau này tự triển khai trong mạng nội bộ; người muốn so nhiều model trên cùng một việc.

Chưa hợp với ai: người mới chưa quen terminal; doanh nghiệp có quy định không gửi dữ liệu ra hạ tầng nước ngoài; dự án cần công cụ ổn định lâu dài, vì bản 0.0.1 có thể đổi nhanh trong vài tuần.

Cách bắt đầu của tôi: tạo khóa DashScope với hạn mức chi nhỏ, chạy Qwen Code trên một repo thử, giao cùng một việc cho Qwen Code và công cụ đang dùng rồi so kết quả. Đừng chuyển cả đội sang trước khi có số so sánh của chính mình.

Một câu để nhớ: có thêm một agent tốt không phải để bỏ cái cũ, mà để không bao giờ phải đặt hết trứng vào một giỏ.

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

Qwen Code có miễn phí không?

Qwen Code là mã nguồn mở giấy phép Apache 2.0, cài miễn phí. Anh chị trả tiền cho nhà cung cấp API của model, ví dụ DashScope của Alibaba Cloud.

Qwen Code khác gì Gemini CLI?

Qwen Code được chỉnh từ Gemini CLI, khác chủ yếu ở parser và công cụ tối ưu cho Qwen3-Coder, cùng cách kết nối qua API chuẩn OpenAI thay vì đăng nhập Google.

Qwen Code dùng được model khác ngoài Qwen không?

Qwen Code đọc ba biến OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL, nên về cấu hình có thể trỏ tới dịch vụ khác có API chuẩn OpenAI. README chỉ nói tối ưu cho model Qwen-Coder.

Cần máy mạnh để chạy Qwen Code không?

Không, nếu dùng qua API. Qwen Code chỉ cần Node.js bản 20 trở lên, phần tính toán nặng chạy trên máy chủ của nhà cung cấp model.

Xem thêm các mốc khác trong chuỗi dòng thời gian AI.

Nguồn: Qwen, Qwen3-Coder: Agentic Coding in the World, 22/07/2025.