Qwen Code: lập trình với AI ngay trong terminal — hướng dẫn cài đặt và dùng

Tóm tắt nhanh
Qwen Code là AI coding agent mã nguồn mở chạy trong terminal, có thể đọc repository, hỗ trợ viết mã, tự động hoá và kết nối nhiều giao diện. Repo dùng được với Qwen, OpenAI, Anthropic, Gemini hoặc model cục bộ; cài khá đơn giản nếu máy có Node.js 22 trở lên.
Qwen Code là một AI coding agent mã nguồn mở sống trong terminal, giúp bạn đọc repository, giải thích mã nguồn, lập kế hoạch và hỗ trợ thực hiện công việc lập trình. Bạn có thể dùng nó trong terminal, desktop, trình duyệt, IDE hoặc các kênh chat.
Repo này phù hợp với lập trình viên mới muốn có trợ lý hiểu cả dự án, đội phát triển cần tự động hoá việc lặp lại, và người làm kỹ thuật muốn thử nhiều nhà cung cấp mô hình. Điểm đáng giá là Qwen Code không bị khóa vào một giao thức hay một model duy nhất. Repo hỗ trợ API của Qwen, OpenAI, Anthropic và Gemini, đồng thời có thể kết nối nhà cung cấp bên thứ ba hoặc model cục bộ qua Ollama và vLLM.
Qwen Code hiện có khoảng 30082 sao và 3417 fork, dùng TypeScript, giấy phép Apache-2.0 và vẫn còn được cập nhật. README giới thiệu các khả năng như Auto-Memory, Auto-Skills, SubAgents, Agent Teams, MCP, chế độ headless, SDK và daemon dùng chung nhiều client.
QwenLM/qwen-code
Qwen Code là coding agent mã nguồn mở giúp đọc, giải thích, sửa và tự động hoá công việc lập trình ngay trong terminal.
I.Qwen Code làm được gì
Giải thích repository và mã nguồn: Bạn mở terminal tại thư mục dự án rồi yêu cầu Qwen Code mô tả cấu trúc, chỉ ra điểm bắt đầu hoặc giải thích một phần mã. Điều này hữu ích khi bạn mới nhận một dự án cũ hoặc chưa quen với công nghệ trong repo.
Hỗ trợ công việc lập trình theo kiểu agent: Qwen Code có thể làm việc theo quy trình nhiều bước thay vì chỉ trả lời một đoạn mã. README liệt kê Auto-Memory, Auto-Skills, SubAgents, Agent Teams và Dynamic Workflows. Nhờ đó, các nhiệm vụ lớn có thể được chia thành nhiều phần phù hợp hơn.
Có sẵn các workflow cho công việc thường gặp: Repo có các skill tích hợp như
/review,/batch,/loopvà/bugfix. Bạn có thể dùng chúng làm điểm bắt đầu cho việc xem xét mã, xử lý nhiều tác vụ, lặp lại một quy trình hoặc tìm lỗi.Kết nối MCP, Plan Mode và LSP: Qwen Code hỗ trợ MCP, chế độ lập kế hoạch và tích hợp LSP. Đây là nền tảng để agent làm việc với công cụ, lập kế hoạch trước khi sửa và hiểu thông tin do language server cung cấp.
Chọn nhiều model và nhà cung cấp: Bạn có thể dùng Qwen API, OpenAI, Anthropic, Gemini, nhà cung cấp bên thứ ba hoặc model cục bộ qua Ollama và vLLM. Việc chuyển nhà cung cấp có thể thực hiện trong lúc chạy, nên phù hợp khi bạn muốn thử nghiệm hoặc cần dùng hạ tầng sẵn có.
Làm việc ngoài terminal: Ngoài giao diện dòng lệnh, repo có desktop app cho macOS, Windows và Linux, Web UI thử nghiệm, plugin cho VS Code, Zed và JetBrains. Bạn cũng có thể kết nối Telegram, DingTalk, WeChat hoặc Feishu.
Chạy không tương tác trong script và CI/CD: Với headless mode, bạn có thể chạy
qwen -p "..."trong script, quy trình CI/CD hoặc các tác vụ hàng loạt. Cách này phù hợp khi cần lặp lại một yêu cầu theo quy trình tự động.Dùng như một dịch vụ dùng chung: Daemon mode cho phép browser, editor, SDK và automation client dùng chung các phiên agent mà không phải khởi động một tiến trình riêng cho từng client. Daemon có Web Shell tích hợp, API HTTP + SSE và hỗ trợ nhiều workspace.
Tích hợp bằng SDK: README đưa ví dụ SDK cho Python và cho biết có thể xây dựng với TypeScript, Python hoặc Java. Đây là lựa chọn phù hợp khi bạn muốn nhúng khả năng của Qwen Code vào một công cụ riêng.
Hỗ trợ computer use: Repo cho phép thiết lập native MCP tools hoặc Node REPL kết hợp SDK trong Qwen Code, Claude Code hoặc Codex để phục vụ tự động hoá máy tính.
II.Cần chuẩn bị gì
Máy chạy Linux, macOS hoặc Windows. README có lệnh cài độc lập cho Linux/macOS và Windows. Desktop app cũng được giới thiệu cho cả ba hệ điều hành.
Nếu cài bằng npm, máy cần Node.js 22 trở lên.
package.jsoncủa repo yêu cầu Node >=22.0.0.Cần một cách xác thực hoặc cung cấp model. Trong phiên Qwen Code, bạn chạy
/authrồi chọn Qwen Account with Subscription để đăng nhập bằng gói Plus hoặc Pro; hoặc cấu hình một nhà cung cấp bằng API key.Bạn có thể dùng Qwen API, OpenAI, Anthropic, Gemini, nhà cung cấp bên thứ ba hoặc model cục bộ qua Ollama/vLLM. Tư liệu được cung cấp không nói chi tiết biến môi trường, tên API key cụ thể hay cách cấu hình từng nhà cung cấp.
Nếu muốn chạy daemon có xác thực trên máy dùng chung hoặc máy không đáng tin cậy, README nêu biến
QWEN_SERVER_TOKENvà tuỳ chọn--require-auth. Với máy cá nhân, daemon mặc định chỉ lắng nghe trên loopback và không dùng bearer authentication.Tư liệu không yêu cầu GPU, cũng không nêu cấu hình CPU, RAM hay dung lượng ổ đĩa tối thiểu. Vì vậy chưa thể kết luận phần cứng cụ thể nào là bắt buộc.
III.Cài đặt từng bước
- Chọn cách càiDùng trình cài độc lập, npm hoặc Homebrew
- Cài Qwen CodeChạy lệnh phù hợp với hệ điều hành
- Khởi động trong dự ánMở terminal tại repository và chạy qwen
- Xác thực modelChạy /auth, dùng subscription hoặc cấu hình API key
- Gửi yêu cầu đầu tiênYêu cầu Qwen Code giải thích repository
A.Chọn cách cài phù hợp
Bạn có thể cài bằng trình cài độc lập, npm hoặc Homebrew. Nếu dùng Windows, README cung cấp lệnh PowerShell. Nếu dùng Linux hoặc macOS, bạn có thể dùng lệnh shell. npm phù hợp khi máy đã có Node.js 22 trở lên. Homebrew dành cho macOS hoặc Linux.
Nếu bạn muốn cài bản chính từ npm, hãy dùng đúng tên gói được README cung cấp. Repo cũng có Dockerfile, Makefile và package.json, nhưng phần README được cung cấp không đưa quy trình chạy bằng Docker hoặc Makefile cho người dùng cuối.
B.Cài trên Linux hoặc macOS
Mở terminal rồi chạy:
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bashLệnh này tải và chạy trình cài độc lập cho Linux hoặc macOS. Sau khi cài xong, hãy khởi động lại terminal để các biến môi trường có hiệu lực. Đây là chỗ người mới thường vấp: nếu vẫn dùng cửa sổ terminal cũ, lệnh qwen có thể chưa được nhận diện.
C.Cài trên Windows
Mở PowerShell rồi chạy:
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iexLệnh này tải và thực thi trình cài PowerShell. Khi hoàn tất, hãy đóng rồi mở lại PowerShell hoặc terminal mà bạn thường dùng. Nếu lệnh qwen chưa chạy được ngay, việc khởi động lại terminal là bước kiểm tra đầu tiên.
D.Cài bằng npm
Nếu máy đã có Node.js 22 trở lên, chạy:
npm install -g @qwen-code/qwen-code@latestTuỳ chọn -g cài gói ở phạm vi toàn hệ thống người dùng để lệnh qwen có thể được gọi từ nhiều thư mục. Tên gói và thẻ @latest phải được giữ đúng như README. Nếu npm báo lỗi liên quan phiên bản Node, hãy kiểm tra lại Node.js vì package.json yêu cầu Node >=22.0.0.
E.Cài bằng Homebrew
Trên macOS hoặc Linux đã có Homebrew, chạy:
brew install qwen-codeHomebrew sẽ cài công thức qwen-code. Sau khi cài, mở một terminal mới trước khi chuyển sang bước khởi động.
F.Khởi động trong thư mục dự án
Mở terminal tại thư mục repository bạn muốn Qwen Code đọc. README minh hoạ bằng:
cd /path/to/your-project
qwenThay /path/to/your-project bằng đường dẫn thật trên máy bạn. Không nên chạy từ một thư mục không liên quan nếu mục tiêu là để agent hiểu đúng dự án. Lệnh cd chuyển terminal vào thư mục dự án; lệnh qwen mở phiên làm việc tương tác.
G.Đăng nhập hoặc cấu hình nhà cung cấp
Sau khi phiên Qwen Code mở, nhập:
/authSau đó chọn Qwen Account with Subscription để đăng nhập bằng gói Plus hoặc Pro, hoặc cấu hình một provider bằng API key. README chỉ rõ có hai hướng này, nhưng phần tư liệu được cung cấp không ghi tên biến môi trường hay màn hình cấu hình chi tiết cho từng provider. Vì vậy bạn nên làm theo hướng dẫn xác thực và settings của dự án nếu cần cấu hình nâng cao.
H.Gửi yêu cầu đầu tiên
Trong phiên đang mở, nhập câu lệnh mẫu của README:
Explain this repository and show me where to start.Qwen Code sẽ dùng thư mục hiện tại làm ngữ cảnh để giải thích repository và gợi ý nơi bắt đầu. Với dự án có mã nguồn riêng, bạn nên đọc lại các đề xuất trước khi cho agent thực hiện thay đổi.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra cơ bản là mở terminal trong một repository rồi chạy qwen. Nếu phiên tương tác mở ra, bước cài CLI đã hoàn tất. Tiếp đó, nhập /auth; nếu bạn có thể chọn tài khoản subscription hoặc cấu hình provider, phần xác thực đã sẵn sàng.
Bạn có thể dùng yêu cầu sau để kiểm tra khả năng đọc dự án:
Explain this repository and show me where to start.Kết quả mong đợi là Qwen Code trả lời về cấu trúc repository và chỉ ra nơi nên bắt đầu. README cũng nêu Web UI thử nghiệm có thể mở bằng qwen serve --open; địa chỉ mặc định là http://127.0.0.1:4170. Nếu muốn kiểm tra daemon, các lệnh quản lý được cung cấp gồm qwen daemon start, qwen daemon status, qwen daemon logs -f và qwen daemon stop.
V.Dùng vào việc thật
A.Chủ shop cần hiểu phần mềm bán hàng
Một chủ shop thuê đội kỹ thuật xây website bán hàng có thể mở terminal trong thư mục dự án rồi chạy qwen. Sau khi xác thực, họ có thể yêu cầu:
Explain this repository in simple Vietnamese. Show me which folders handle products, orders, and customer accounts.Kết quả có thể giúp người không chuyên định vị các phần quan trọng trong dự án trước khi trao đổi với đội phát triển. Người dùng vẫn nên nhờ lập trình viên kiểm chứng vì Qwen Code đang phân tích mã nguồn, không thay thế việc kiểm tra nghiệp vụ.
B.Nhân viên văn phòng cần tự động hoá báo cáo
Một nhân viên có script nội bộ muốn hiểu cách chạy có thể mở terminal ở thư mục dự án và hỏi:
Explain how this project works, identify the command used to run it, and suggest a safe way to automate the report task.Nếu cần gọi từ quy trình tự động, README cho phép dùng headless mode với dạng:
qwen -p "..."Cách này phù hợp để đưa một yêu cầu vào script, CI/CD hoặc batch job. Người dùng cần thay phần ... bằng yêu cầu thật và kiểm tra quyền truy cập trước khi chạy trên dữ liệu nội bộ.
C.Lập trình viên mới tiếp nhận repository cũ
Một dev mới có thể bắt đầu bằng yêu cầu:
Summarize the repository layout, explain the main entry points, and list the first three files I should read.Qwen Code có thể giúp rút ngắn thời gian làm quen với cấu trúc dự án. Sau đó, dev có thể dùng workflow /review hoặc /bugfix được README liệt kê để hỗ trợ xem xét mã và tìm lỗi. Những thay đổi quan trọng vẫn cần chạy test và review theo quy trình của đội.
D.Nhóm phát triển muốn dùng nhiều client
Một nhóm có thể chạy daemon để browser, editor, SDK và automation client kết nối vào những phiên agent dùng chung. Chạy:
qwen serve --openWeb Shell sẽ mở cùng daemon. Khi muốn quản lý tiến trình nền, có thể dùng:
qwen daemon start
qwen daemon status
qwen daemon logs -f
qwen daemon stopREADME cảnh báo daemon mặc định cho phép mọi tiến trình cục bộ có thể truy cập dùng API đầy đủ, bao gồm thực thi mã. Trên máy dùng chung hoặc máy không đáng tin cậy, hãy đặt QWEN_SERVER_TOKEN và dùng --require-auth.
Một trợ lý AI hữu ích nhất khi nó hiểu đúng repository và nằm trong quy trình kiểm soát của đội.
Ông T
E.Dev muốn nhúng agent vào ứng dụng riêng
README có ví dụ SDK Python để gửi yêu cầu tóm tắt layout repository:
import asyncio
from qwen_code_sdk import is_sdk_result_message, query
async def main() -> None:
result = query(
"Summarize the repository layout.",
{
"cwd": "/path/to/project",
"path_to_qwen_executable": "qwen",
},
)
async for message in result:
if is_sdk_result_message(message):
print(message["result"])
asyncio.run(main())Đoạn mã tạo một truy vấn, chỉ định thư mục làm việc và đường dẫn đến executable qwen, sau đó in kết quả khi nhận được message phù hợp. README cho biết SDK còn có thể dùng với TypeScript và Java, nhưng tư liệu được cung cấp chỉ có ví dụ Python.
VI.Lỗi hay gặp và cách xử lý
A.Terminal không nhận lệnh qwen
Sau khi cài bằng script hoặc PowerShell, README yêu cầu khởi động lại terminal để biến môi trường có hiệu lực. Hãy đóng cửa sổ terminal hiện tại, mở cửa sổ mới rồi chạy lại qwen. Nếu vẫn lỗi, kiểm tra lại quá trình cài theo đúng hệ điều hành.
B.npm báo Node.js không phù hợp
Cài bằng npm yêu cầu Node.js 22 trở lên và package.json cũng khai báo Node >=22.0.0. Nếu máy đang dùng phiên bản thấp hơn, hãy nâng Node.js trước khi chạy lại lệnh npm. Tư liệu không cung cấp lệnh nâng cấp Node cụ thể.
C.Qwen Code chưa trả lời vì chưa xác thực
Sau khi chạy qwen, hãy nhập /auth. Bạn cần đăng nhập bằng Qwen Account with Subscription với gói Plus hoặc Pro, hoặc cấu hình một provider bằng API key. Nếu chưa có subscription hay thông tin provider, README chưa cung cấp một cách dùng không cần xác thực.
D.Web UI hoặc daemon bị truy cập ngoài ý muốn
Daemon mặc định lắng nghe trên loopback nhưng không có bearer authentication. Trên máy dùng chung hoặc máy không đáng tin cậy, hãy đặt QWEN_SERVER_TOKEN và dùng --require-auth, theo cảnh báo trong README. Không nên mở daemon ra môi trường khác khi chưa hiểu rõ quyền thực thi mã.
E.Agent hiểu sai hoặc đề xuất thay đổi không phù hợp
AI coding agent cần được cung cấp đúng thư mục dự án và yêu cầu rõ ràng. Hãy chạy qwen trong repository cần làm việc, bắt đầu bằng yêu cầu giải thích hoặc lập kế hoạch, rồi tự kiểm tra thay đổi trước khi chấp nhận. README không đảm một trang tin tức câu trả lời hay thay đổi đều chính xác tuyệt đối.
API key, phiên đăng nhập và quyền truy cập repository cần được bảo vệ.
Daemon có thể cho phép thực thi mã qua API; hãy bật xác thực trên máy dùng chung.
Chi phí subscription hoặc API phụ thuộc nhà cung cấp; README không nêu bảng giá.
VII.Có nên dùng không
Qwen Code đáng thử nếu bạn muốn một coding agent mã nguồn mở, chạy được ngay trong terminal và có nhiều lựa chọn model. Điểm mạnh là hỗ trợ nhiều giao thức, model cục bộ, MCP, SDK, headless mode, daemon, plugin IDE và kênh chat. Repo cũng có giấy phép Apache-2.0 và đang tiếp tục được cập nhật.
Công cụ phù hợp với dev muốn hiểu code nhanh hơn, đội kỹ thuật muốn tự động hoá tác vụ và người cần kết nối agent vào nhiều giao diện. Khả năng mở rộng qua SDK, MCP và daemon khiến Qwen Code phù hợp cả cho thử nghiệm cá nhân lẫn quy trình kỹ thuật lớn hơn.
Giới hạn cần lưu ý là một số giao diện như Web UI và daemon được README đánh dấu là thử nghiệm. Việc xác thực cần Qwen Account with Subscription hoặc provider có API key; tư liệu không nói rằng công cụ có thể dùng đầy đủ mà không cần tài khoản hay chi phí. README cũng không nêu yêu cầu GPU, cấu hình phần cứng, bảng giá, hay chi tiết cấu hình cho từng provider.
Nếu bạn chỉ cần một trình soạn thảo mã đơn giản, không muốn agent đọc cả repository hoặc không thể cho phép công cụ thực thi mã, nên chọn cách làm thủ công hoặc một công cụ có phạm vi quyền hẹp hơn. Nếu muốn một agent mã nguồn mở, đa giao thức và có thể chạy từ terminal đến IDE, Qwen Code là lựa chọn đáng cân nhắc.
Câu hỏi thường gặp
Qwen Code có miễn phí không?
Repo có giấy phép Apache-2.0 và là dự án mã nguồn mở. Tuy nhiên README yêu cầu đăng nhập bằng Qwen Account với gói Plus hoặc Pro, hoặc cấu hình provider bằng API key; tư liệu chưa nêu chi phí cụ thể.
Qwen Code có chạy được trên Windows không?
Có. README cung cấp lệnh cài bằng PowerShell cho Windows và giới thiệu desktop app cho macOS, Windows và Linux. Sau khi cài, cần khởi động lại terminal để biến môi trường có hiệu lực.
Có cần GPU để chạy Qwen Code không?
Tư liệu được cung cấp không nêu yêu cầu GPU, CPU hay RAM tối thiểu. Vì vậy chưa thể khẳng định cấu hình phần cứng cụ thể cần thiết.
Có cần API key không?
Bạn có thể đăng nhập bằng Qwen Account với gói Plus hoặc Pro, hoặc cấu hình một provider bằng API key. README chưa nêu chi tiết tên biến môi trường hay cách cấu hình API key cho từng nhà cung cấp.
Qwen Code dùng được với những model nào?
README cho biết công cụ hỗ trợ Qwen, OpenAI, Anthropic và Gemini, cùng nhà cung cấp bên thứ ba hoặc model cục bộ qua Ollama và vLLM. Có thể chuyển provider trong lúc chạy.
Dữ liệu và daemon có an toàn không?
README cảnh báo daemon mặc định không dùng bearer authentication; tiến trình cục bộ truy cập được có thể dùng toàn bộ API, gồm thực thi mã. Trên máy dùng chung hoặc không đáng tin cậy, cần đặt `QWEN_SERVER_TOKEN` và dùng `--require-auth`.
Qwen Code khác gì một chatbot hỏi đáp thông thường?
Qwen Code là AI coding agent chạy trong ngữ cảnh repository và hỗ trợ workflow, SubAgents, Agent Teams, MCP, headless mode, SDK cùng daemon. Tư liệu nhấn mạnh khả năng làm việc với mã nguồn và tích hợp vào terminal, IDE, desktop, web và kênh chat.


