# Qwen Code: trợ lý lập trình AI mã nguồn mở ngay trong terminal — hướng dẫn cài đặt và dùng

> Qwen Code là một agent lập trình AI mã nguồn mở, chạy ngay trong terminal. Bạn mô tả việc cần làm bằng ngôn ngữ thường, nó đọc dự án và giúp bạn xử lý. Cài chỉ cần một dòng lệnh, nhưng bạn phải đăng nhập hoặc điền API key trước khi dùng.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-17 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/qwen-code-tro-ly-lap-trinh-ai-trong-terminal-huong-dan-cai-dat

Qwen Code là một agent lập trình AI mã nguồn mở sống trong terminal của bạn. Bạn mở nó trong thư mục dự án, gõ yêu cầu bằng lời thường, và nó đọc code, đề xuất thay đổi, rồi giúp bạn làm tiếp. Nó do nhóm Qwen phát triển, viết bằng TypeScript, giấy phép Apache-2.0. Hiện có khoảng 29.864 sao và 3.401 fork trên GitHub.

Repo này hợp với ai? Lập trình viên mới muốn có một trợ lý ngồi cạnh khi đọc dự án lạ. Dev lâu năm muốn một công cụ dòng lệnh không bị khoá vào một nhà cung cấp model. Người làm văn phòng hoặc kinh doanh có biết chút kỹ thuật cũng dùng được, nhất là khi nối nó với Telegram hoặc giao diện web. Cài đặt khá nhẹ: một dòng lệnh là xong, phần tốn công nhất là đăng nhập hoặc điền API key.

Điểm đáng giá nhất là tính mở. Cả khung chạy agent lẫn các model Qwen đều là mã nguồn mở. Nó hỗ trợ nhiều giao thức (OpenAI, Anthropic, Gemini, Qwen), nên bạn đổi model hoặc nhà cung cấp lúc đang dùng mà không phải đổi công cụ.

```repo
- repo | QwenLM/qwen-code
- kind | CLI
- desc | Qwen Code là agent lập trình AI mã nguồn mở chạy trong terminal: đọc dự án, sửa code, chạy lệnh, kết nối nhiều model và nhiều giao diện.
- stars | 30k
- lang | TypeScript
- license | Apache-2.0
```

## Qwen Code làm được gì

Dưới đây là các tính năng chính theo README, kèm lợi ích thực tế.

- **Agent làm được việc ngay khi cài.** Có sẵn Auto-Memory, Auto-Skills, SubAgents, Agent Teams và MCP. Bạn không phải dựng thêm gì để agent chia việc cho các agent con hoặc nhớ ngữ cảnh.
- **Kỹ năng tích hợp sẵn.** README liệt kê /review, /batch, /loop, /bugfix. Đây là những lệnh gõ trong phiên làm việc để làm các việc lặp đi lặp lại như xem xét code hay sửa lỗi.
- **Nhiều giao thức, nhiều model.** Dùng được API OpenAI, Anthropic, Gemini, Qwen, nhà cung cấp bên thứ ba, hoặc model chạy cục bộ (Ollama / vLLM). Lợi ích: bạn không bị trói vào một hãng, muốn tiết kiệm hay muốn dữ liệu ở lại máy mình đều có đường chọn.
- **Không chỉ terminal.** Có plugin cho VS Code, Zed, JetBrains; app Desktop cho macOS, Windows, Linux; Web UI (đang ở mức thử nghiệm); SDK cho TypeScript, Python, Java; và kết nối chat với Telegram, DingTalk, WeChat, Feishu.
- **Chế độ headless.** Chạy `qwen -p "..."` trong script, CI/CD hoặc xử lý hàng loạt, không cần ngồi tương tác.
- **Daemon mode.** Chạy Qwen Code như một dịch vụ chạy lâu dài để trình duyệt, editor, SDK dùng chung phiên làm việc. Phần này README ghi là thử nghiệm.
- **Agent Arena.** So sánh nhiều model cùng làm một việc. Tính năng này README ghi là chỉ Qwen Code có, Claude Code thì không.
- **Plan Mode, Hooks, Sandbox, Git Worktrees, LSP, Computer Use.** README xếp các tính năng này vào bảng so sánh ngang với Claude Code.

Về chất lượng, README cho biết trên SWE-bench Verified, bảy phiên bản Qwen Code dùng cùng model Qwen 3.7 Max đạt trung bình khoảng 76,40%–77,80% (500 tác vụ, ba lần thử mỗi phiên bản). Đây là số tác giả tự công bố, bạn nên xem như tham khảo.

## Cần chuẩn bị gì

Theo tư liệu, bạn cần:

- **Hệ điều hành:** Linux, macOS hoặc Windows. README có lệnh cài riêng cho từng loại.
- **Node.js 22 trở lên:** chỉ bắt buộc nếu bạn cài qua npm. Gói khai báo yêu cầu Node >=22.0.0. Cách cài bằng script một dòng ở dưới không nhắc đến Node.
- **Một cách đăng nhập:** hoặc tài khoản Qwen có gói đăng ký Plus/Pro, hoặc API key của một nhà cung cấp model.
- **Một terminal:** PowerShell trên Windows, Terminal trên macOS/Linux.

Tư liệu không nói gì về yêu cầu RAM hay GPU. Nếu bạn dùng model qua API thì máy thường không cần mạnh, còn nếu chạy model cục bộ thì phụ thuộc model bạn chọn. Phần đó chưa có thông tin cụ thể.

## Cài đặt từng bước

```steps
- Chọn cách cài | Script một dòng (Linux/macOS hoặc Windows), npm hoặc Homebrew
- Khởi động lại terminal | Để biến môi trường có hiệu lực
- Vào thư mục dự án | cd tới dự án rồi gõ qwen
- Đăng nhập | Gõ /auth trong phiên, chọn tài khoản Qwen hoặc điền API key
- Hỏi thử | Nhờ nó giải thích dự án để biết đã chạy
```

### Cài bằng script một dòng

Đây là cách README đặt đầu tiên. Trên Linux hoặc macOS, mở Terminal và chạy:

```bash
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
```

Trên Windows, mở PowerShell và chạy:

```powershell
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex
```

Cả hai lệnh đều tải một script từ máy chủ của tác giả về rồi chạy luôn. Nếu bạn muốn chắc ăn, hãy mở đường dẫn đó trong trình duyệt để đọc script trước khi chạy.

### Hoặc cài bằng npm hoặc Homebrew

Nếu bạn đã có Node.js 22 trở lên, dùng npm:

```bash
npm install -g @qwen-code/qwen-code@latest
```

Cờ `-g` nghĩa là cài toàn cục để gõ `qwen` ở bất kỳ thư mục nào. Trên macOS hoặc Linux có Homebrew:

```bash
brew install qwen-code
```

### Khởi động lại terminal

README dặn rõ: sau khi cài, hãy khởi động lại terminal để biến môi trường có hiệu lực. Đây là chỗ người mới hay vấp nhất. Cài xong gõ `qwen` mà báo không tìm thấy lệnh thường là do chưa đóng và mở lại cửa sổ terminal.

### Vào thư mục dự án và khởi động

Mở terminal ngay trong dự án của bạn rồi chạy `qwen`. Thay đường dẫn bằng thư mục thật của bạn:

```bash
cd /path/to/your-project
qwen
```

Bạn nên đứng trong thư mục dự án, không phải thư mục gốc ổ đĩa hay thư mục Documents chung, vì agent sẽ làm việc với những gì nó thấy ở đó.

### Đăng nhập

Trong phiên Qwen Code vừa mở, gõ:

```text
/auth
```

Sau đó 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. Chi tiết từng nhà cung cấp nằm trong Authentication Guide và Settings Reference của tài liệu chính thức (có ở trang chủ dự án). README không liệt kê tên biến môi trường cụ thể cho từng nhà cung cấp, nên bạn hãy xem tài liệu đó thay vì đoán.

```note
API key giống như mật khẩu: đừng dán vào chat, đừng đưa lên GitHub. Dùng API sẽ tính phí theo nhà cung cấp, nên hãy xem bảng giá của họ trước khi giao cho agent những việc dài.
```

## Kiểm tra đã chạy được chưa

Cách kiểm tra đơn giản nhất theo README là đưa cho nó một câu hỏi đầu tiên. Trong phiên, gõ:

```text
Explain this repository and show me where to start.
```

Nếu nó đọc dự án rồi trả lời bằng phần giải thích cấu trúc và gợi ý chỗ bắt đầu, nghĩa là cài đặt và đăng nhập đều ổn. Nếu thay vào đó nó báo lỗi xác thực, bạn quay lại bước `/auth`. README không mô tả cụ thể màn hình hay thông báo thành công nào khác, và cũng không ghi lệnh kiểm tra phiên bản.

## Dùng vào việc thật

### Dev mới nhận dự án lạ

Bạn vừa vào công ty, được giao một repo vài trăm file và không biết bắt đầu từ đâu. Mở terminal trong thư mục dự án, chạy `qwen`, rồi hỏi bằng chính câu mẫu của README: "Explain this repository and show me where to start." Bạn nhận lại phần giải thích cấu trúc và gợi ý nên đọc file nào trước. Bạn có thể hỏi tiếp theo kiểu hội thoại, ví dụ nhờ nó giải thích một thư mục cụ thể.

> Cài một dòng lệnh, đăng nhập một lần, rồi hỏi nó như hỏi một đồng nghiệp đã đọc hết dự án.
>
> — Ông T

### Chạy tự động trong script hoặc CI

Bạn có nhiệm vụ lặp lại, ví dụ mỗi lần đẩy code thì muốn có một bản tóm tắt cấu trúc. Chế độ headless cho phép gọi agent từ script, không cần ngồi tương tác:

```bash
qwen -p "Summarize the repository layout."
```

Cờ `-p` truyền thẳng câu lệnh vào. Kết quả in ra terminal, bạn có thể đưa vào script hoặc bước CI của mình. README ghi chế độ này dùng được trong script, CI/CD và batch job. Các cờ chi tiết khác README không nêu, hãy xem tài liệu chính thức.

### Nhúng vào ứng dụng Python bằng SDK

Nếu bạn làm nội bộ công ty và muốn một công cụ riêng gọi agent, README có sẵn ví dụ SDK Python. Đoạn mã dưới đây chép nguyên từ README. Thay `/path/to/project` bằng thư mục thật:

```python
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())
```

SDK gọi lại chương trình `qwen` đã cài trên máy, nên bạn cần cài Qwen Code trước. README không ghi tên gói để cài SDK Python bằng pip, nên phần cài SDK bạn cần xem trong tài liệu chính thức hoặc thư mục `packages/` của repo.

### Dùng chung qua trình duyệt hoặc chat

Nếu bạn muốn một giao diện web thay vì terminal thuần, chạy:

```bash
qwen serve --open
```

Lệnh này mở Web Shell trong trình duyệt, địa chỉ mặc định là `http://127.0.0.1:4170`. Muốn chạy nền và quản lý:

```bash
qwen daemon start
qwen daemon status
qwen daemon logs -f
qwen daemon stop
```

Với Telegram, DingTalk, WeChat hoặc Feishu, bạn làm theo hướng dẫn riêng của từng kênh trong tài liệu, rồi chạy `qwen channel start`. Kết quả là cả nhóm có thể giao việc cho agent qua một cuộc chat quen thuộc. Phần Web UI và daemon README ghi là thử nghiệm.

## Lỗi hay gặp và cách xử lý

### Gõ qwen báo không tìm thấy lệnh

Thường là do chưa khởi động lại terminal sau khi cài. Đóng hẳn cửa sổ terminal và mở lại, README dặn đúng bước này. Nếu cài bằng npm mà vẫn không được, kiểm tra xem lệnh cài toàn cục (`-g`) có chạy xong không báo lỗi.

### Cài bằng npm thất bại hoặc báo sai phiên bản

Gói yêu cầu Node.js từ phiên bản 22 trở lên. Nếu máy bạn đang dùng bản Node cũ, hãy nâng cấp Node, hoặc dùng cách cài bằng script một dòng, vì cách đó README không nhắc đến yêu cầu Node.

### Vào được qwen nhưng không trả lời, báo lỗi xác thực

Bạn chưa đăng nhập hoặc key sai. Gõ lại `/auth` trong phiên và chọn đúng cách đăng nhập. Nếu dùng API key, kiểm tra xem key còn hiệu lực và tài khoản nhà cung cấp còn hạn mức. Tên biến môi trường cụ thể xem trong Settings Reference chứ đừng tự đoán.

### Script PowerShell trên Windows không chạy được

Các máy công ty đôi khi chặn tải hoặc chạy script từ mạng. README không nói gì về lỗi này, nhưng nếu gặp, bạn thử cách cài bằng npm hoặc nhờ bộ phận IT cho phép. Đừng tắt hẳn các bảo vệ hệ thống chỉ để cài một công cụ.

### Daemon mở quyền quá rộng

Đây là cảnh báo có thật trong README. Mặc định daemon nghe trên địa chỉ nội bộ (loopback) và không yêu cầu mã xác thực. Bất kỳ tiến trình nào trên máy truy cập được vào nó đều dùng được toàn bộ API, kể cả chạy code. Trên máy dùng chung hoặc không đáng tin, hãy đặt `QWEN_SERVER_TOKEN` và dùng `--require-auth`. Chi tiết xem Daemon guide trong tài liệu.

## Có nên dùng không

**Điểm mạnh.** Cài nhanh, mã nguồn mở theo giấy phép Apache-2.0, không bị khoá vào một nhà cung cấp, và dùng được ở nhiều nơi: terminal, editor, desktop, web, chat. Repo còn được cập nhật trong vài tháng gần đây. README còn ghi rằng nhóm dùng chính agent này để tạo issue, gửi PR, review code và chạy test, nghĩa là họ tự dùng sản phẩm của mình.

**Giới hạn.** Một số phần như Web UI và daemon vẫn đang thử nghiệm. Tư liệu không nói rõ về yêu cầu phần cứng khi chạy model cục bộ. Cách cài mặc định tải script từ máy chủ của tác giả, nên ai thận trọng nên đọc script trước. Và vì đây là agent có thể chạy lệnh trên máy bạn, bạn nên thử trên dự án nhỏ, có sao lưu hoặc dùng Git, trước khi giao việc quan trọng.

**Khi nào chọn cách khác.** Nếu bạn không đụng đến code và chỉ cần một khung chat để hỏi đáp, một ứng dụng chat thông thường sẽ đơn giản hơn. Nếu công ty bạn bắt buộc dùng đúng một nhà cung cấp AI cụ thể, hãy kiểm tra xem nhà cung cấp đó có nằm trong các giao thức Qwen Code hỗ trợ không. Còn nếu bạn muốn một agent mở, đổi model tuỳ ý và dùng được cả trong terminal lẫn chat nhóm, Qwen Code đáng để thử.

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

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

Bản thân phần mềm là mã nguồn mở, giấy phép Apache-2.0, tải về dùng được. Tuy vậy, để agent trả lời bạn cần đăng nhập bằng tài khoản Qwen có gói Plus hoặc Pro, hoặc dùng API key của một nhà cung cấp model. README không nêu giá, nên chi phí phụ thuộc cách bạn chọn.

### Cài Qwen Code có cần Node.js không?

Nếu cài qua npm thì cần Node.js 22 trở lên. Cách cài bằng script một dòng và Homebrew, README không nhắc tới yêu cầu Node. Bạn chọn cách phù hợp với máy mình.

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

Được. README có lệnh cài riêng cho Windows bằng PowerShell, và app Desktop có bản cho macOS, Windows và Linux. Sau khi cài, nhớ khởi động lại terminal.

### Có cần GPU không?

Tư liệu không nói về yêu cầu GPU hay RAM. Nếu bạn dùng model qua API thì phần tính toán nằm ở phía nhà cung cấp. Nếu chạy model cục bộ qua Ollama hoặc vLLM thì phụ thuộc model, và phần này chưa có thông tin cụ thể.

### Dữ liệu và code của tôi có an toàn không?

README chỉ nhắc xem Terms of Service và Privacy Notice, gồm cả cách xử lý dữ liệu của tiện ích Chrome và Browser Use. Dữ liệu đi đâu còn phụ thuộc model bạn chọn: dùng model cục bộ thì khác dùng API đám mây. Ngoài ra, daemon mặc định không yêu cầu xác thực, nên trên máy dùng chung hãy đặt QWEN_SERVER_TOKEN và dùng --require-auth.

### Qwen Code khác gì Claude Code?

README so sánh trực tiếp và nói hai bên có nhiều tính năng giống nhau như SubAgents, MCP, Plan Mode, Hooks, SDK. Điểm Qwen Code ghi là có mà Claude Code không có gồm: mã nguồn mở cả model lẫn khung, đa giao thức, Agent Arena, Daemon Mode và các kênh chat. Bảng này do tác giả Qwen Code tự viết.

### Dùng với model khác ngoài Qwen được không?

Được. README nói Qwen Code hỗ trợ API OpenAI, Anthropic, Gemini, Qwen, các nhà cung cấp bên thứ ba và model cục bộ như Ollama hoặc vLLM, và có thể đổi lúc đang chạy. Cách cấu hình từng nhà cung cấp xem trong Authentication Guide của tài liệu chính thức.
