Cách sử dụng Qwen Code: cài đặt, chọn tài khoản/mô hình và cấu hình API

Qwen Code là tác nhân lập trình AI mã nguồn mở (Apache-2.0) do nhóm Alibaba Qwen công khai. Cách sử dụng gồm bốn bước: “cài đặt → chạy qwen trong dự án → dùng /auth để cấu hình đích kết nối → yêu cầu tác vụ”. Tuy nhiên, gói Qwen OAuth miễn phí đã kết thúc vào ngày 15 tháng 4 năm 2026, nên đăng nhập theo hướng dẫn trước đó sẽ không còn hoạt động miễn phí. Và điểm người dùng tiếng Hàn cần biết trước: Qwen Code không có giao diện tiếng Hàn. Trang này lần lượt giải thích cách bắt đầu theo menu /auth hiện tại, thiết lập câu trả lời tiếng Hàn, cấu hình tùy chỉnh để dùng Claude và GPT, cùng các lệnh thường dùng. Phiên bản mới nhất là v0.24.7 được đưa lên npm vào ngày 29 tháng 9 năm 2026 và các bản phát hành xuất hiện ít nhất hằng tuần, vì vậy hãy kiểm tra phiên bản đã cài bằng qwen --version.

Cài đặt

Đây là lệnh trong README chính thức. Dùng tập lệnh cài đặt độc lập thì không cần tự chuẩn bị Node.js; chỉ khi cài bằng npm mới cần Node.js 22 trở lên.

# macOS / Linux (공식 단독 설치 스크립트)
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

# Windows (PowerShell)
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

# npm (Node.js 22 이상 필요)
npm install -g @qwen-code/qwen-code@latest

# Homebrew (macOS / Linux)
brew install qwen-code

Mở lại terminal sau khi cài để các biến môi trường có hiệu lực. Qwen Code ban đầu dựa trên Google Gemini CLI v0.8.2, nhưng từ v0.1 đã được phát triển độc lập và không còn đồng bộ với bản gốc. Cài đặt hoặc hạn mức miễn phí của Gemini CLI không được áp dụng nguyên trạng.

Chạy lần đầu và câu trả lời tiếng Hàn

cd /path/to/your-project
qwen

# 세션 안에서:
/language output Korean   # 모델 답변을 한국어로 (UI는 한국어 미지원)
/auth                     # 공급자와 API 키 설정

Các ngôn ngữ giao diện tích hợp chỉ gồm tiếng Trung giản thể, tiếng Anh, tiếng Nga, tiếng Đức, tiếng Nhật, tiếng Bồ Đào Nha Brazil, tiếng Pháp và tiếng Catalan; các tệp dịch giao diện trong kho cũng không có tiếng Hàn (kiểm tra ngày 1 tháng 10 năm 2026). Vì vậy menu hiển thị bằng tiếng Anh và trang này trích dẫn nguyên văn các cụm tiếng Anh trên màn hình. Ngôn ngữ câu trả lời của mô hình độc lập với giao diện, nên có thể cố định sang tiếng Hàn bằng /language output Korean.

Ngoài terminal còn có ứng dụng máy tính, giao diện web mở trong trình duyệt (qwen serve --open, tính năng thử nghiệm), tích hợp VS Code, Zed và JetBrains, cùng chế độ chạy không đầu cho tập lệnh và CI (qwen -p "..."). Tất cả đều nằm trong cùng kho miễn phí; chi phí suy luận được tính riêng.

Chọn đích kết nối bằng /auth

Khi mở /auth (bí danh /login), màn hình “Select authentication method:” xuất hiện và có ba lựa chọn cấp cao nhất. Nếu chọn Qwen OAuth, sẽ hiển thị thông báo “Discontinued — switch to Coding Plan or API Key”.

Ba lựa chọn của ModelStudio không phải là ba cách thanh toán cho cùng một hóa đơn. Tài liệu quy định endpoint và khóa riêng cho từng lựa chọn; chúng sẽ không hoạt động nếu loại khóa và baseUrl không khớp. Tính đến ngày 1 tháng 10 năm 2026, Coding Plan được ghi là “số lượng giới hạn, ai đến trước được phục vụ trước, bổ sung hằng ngày lúc 0:00 (UTC+8)”, nên có thể không đăng ký được tùy ngày. Trong Coding Plan, một tác vụ được tính qua nhiều lần gọi mô hình; Alibaba giải thích rằng các tác vụ đơn giản thường cần 5–10 lần, còn tác vụ phức tạp thường cần từ 10–30 lần trở lên. So sánh giá được trình bày chi tiết hơn trên trang tiếng Anh Qwen Code pricing.

Dùng Claude hoặc GPT: Custom Provider trong settings.json

Tài liệu xác thực Qwen Code khuyến nghị dùng modelProviders của ~/.qwen/settings.json để kết nối các dịch vụ bên thứ ba như OpenAI, Anthropic, Google, OpenRouter và endpoint riêng. Với Kunavo, cấu hình như sau.

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI 호환",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

# 키는 settings.json에 직접 쓰지 말고 .qwen/.env 나 환경 변수로
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

Bốn cách tiết kiệm thời gian gỡ lỗi:

• baseUrl chỉ đến /v1. Tài liệu tham chiếu nhà cung cấp mô hình nêu rõ: “hãy chỉ định gốc /v1 của API, không phải toàn bộ đường dẫn /v1/chat/completions, vì SDK sẽ thêm đường dẫn yêu cầu”. Nếu ghi cả đường dẫn, bạn sẽ gặp lỗi 404 chứ không phải lỗi xác thực.
• Nơi đặt khóa. Qwen Code đọc khóa từ biến môi trường có tên được ghi trong envKey. Thứ tự ưu tiên là shell export, tệp .env (.qwen/.env được khuyến nghị, chỉ dùng tệp đầu tiên tìm thấy), rồi settings.json với env; lựa chọn cuối cùng lưu dưới dạng văn bản thuần túy nên không được khuyến nghị.
• Tệp cấu hình thắng cờ CLI. Thứ tự quyết định là giá trị nhập /auth → mục modelProviders đã chọn → đối số CLI → biến môi trường → settings.json. Đây là lý do --openai-base-url có vẻ bị bỏ qua. security.auth.apiKey và security.auth.baseUrl xuất hiện trong các mô tả cũ đang chuẩn bị ngừng hỗ trợ.
• Ban đầu hãy dùng Chat Completions. Nếu bỏ qua wireApi, định dạng sẽ là Chat Completions. Nếu chuyển sang "responses", sẽ không có tự động nhận diện endpoint hoặc tự động chuyển đổi khi thất bại. Việc sửa modelProviders được áp dụng ngay cả cho phiên đang chạy (/model sẽ hiển thị sau khi mở lại).

Danh mục Kunavo không có mô hình văn bản Qwen. Đây không phải cách dùng Qwen giá rẻ, mà là cách dùng Claude và GPT trong Qwen Code bằng một số dư trả trước duy nhất. Ngoài ra, Kunavo chưa xác minh Qwen Code chạy thực tế với endpoint riêng của mình. Cấu hình được viết dựa trên tài liệu chính thức, tương tự trang cài đặt Qwen Code bằng tiếng Anh. Hãy thử nghiệm trong khi vẫn giữ lại tuyến đang sử dụng.

Tác vụ đầu tiên và các lệnh thường dùng

Yêu cầu đầu tiên được README nêu ví dụ là: “hãy giải thích kho lưu trữ này và cho biết nên bắt đầu từ đâu”. Cách này kiểm tra việc đọc tệp và gọi công cụ trong một lần. Chỉ chào hỏi sẽ không phát hiện được vấn đề kết nối.

Các chế độ tự động phê duyệt như yolo được chính tài liệu cảnh báo là “chỉ sử dụng trong môi trường đáng tin cậy, có sandbox hoặc có thể bỏ đi”. Chi phí ước tính của /stats model là phép tính của Qwen Code, không phải số tiền bị tính. Hãy kiểm tra số tiền thực tế trong lịch sử sử dụng của nhà cung cấp đã kết nối.

Các hạn chế cần biết

• web_search tích hợp được bật hoặc tắt tùy theo đích kết nối. Vì sử dụng tính năng tìm kiếm phía máy chủ DashScope, nó được bật với ModelStudio Standard API Key, Token Plan và các mục trỏ đến máy chủ DashScope được nhận diện; bị tắt trong Coding Plan (chưa được xác minh trên endpoint đó), cũng như bị tắt với endpoint tùy chỉnh của bên thứ ba hoặc máy chủ khác (tài liệu web_search). Nếu cần, hãy kết nối máy chủ tìm kiếm MCP.
• Tuyến Kunavo chỉ hỗ trợ trò chuyện. Kunavo không có mô hình embedding, tổng hợp giọng nói hoặc nhận dạng giọng nói. Live Voice của Qwen Code bắt buộc dùng endpoint DashScope, vì vậy dù mô hình trò chuyện được chạy ở đâu, tính năng này vẫn dùng khóa riêng.

Thanh toán khi thử nghiệm với Kunavo

Kunavo là hình thức nạp tiền trả trước, không có phí hàng tháng và số dư được trừ theo token. Mức nạp tối thiểu là $10; tại trang thanh toán Stripe, bạn có thể dùng thẻ (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay và Link. Nếu trang thanh toán hiển thị bằng won Hàn Quốc, bạn cũng có thể chọn Kakao Pay, Naver Pay, PAYCO, Samsung Pay và các thẻ nội địa không hỗ trợ thanh toán quốc tế (phí quy đổi tiền tệ Stripe 2–4% được áp dụng khi quy đổi sang won; có thể tránh bằng cách thanh toán bằng đô la). Không có Toss Pay. Hãy xem Hướng dẫn thanh toán, tạo tài khoản và cấp khóa. Sau yêu cầu đầu tiên, cách chắc chắn nhất là kiểm tra số tiền thực tế trong Lịch sử sử dụng.

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

Kiểm tra ngày 1 tháng 10 năm 2026: README Qwen Code, tài liệu xác thực, nhà cung cấp mô hình, lệnh và web_search (nhánh main), danh sách tệp dịch giao diện trong kho, @qwen-code/qwen-code 0.24.7 trên npm, cùng các trang Coding Plan và Token Plan của Alibaba Cloud. Kunavo chưa chạy Qwen Code với endpoint riêng của mình.