Cách sử dụng Qwen Code: cài đặt, /auth, tiếng Nhật và cấu hình API

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

Cài đặt

Đây là quy trình trong README chính thức. Với trình cài đặt độc lập, bạn không cần tự chuẩn bị Node.js. Chỉ khi dù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

Sau khi cài đặt, hãy mở lại terminal để 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 đã ngừng đồng bộ với upstream và được phát triển độc lập. Cấu hình và hạn mức miễn phí của Gemini CLI không được áp dụng nguyên vẹn.

Khởi động lần đầu và chuyển sang tiếng Nhật

cd /path/to/your-project
qwen

# セッション内で：
/language ui ja-JP          # 画面表示を日本語に
/language output Japanese   # モデルの回答を日本語に
/auth                       # 接続先と API キーを設定

/language ui ja-JP sẽ chuyển giao diện sang tiếng Nhật; từ đó các màn hình sẽ hiển thị các cụm tiếng Nhật riêng của Qwen Code như “Chọn phương thức xác thực” và “Chế độ phê duyệt công cụ”. Trang này cũng dùng cùng cách diễn đạt. Ngôn ngữ trả lời độc lập với ngôn ngữ UI và được chỉ định bằng /language output Japanese.

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

Chọn endpoint bằng /auth

Mở /auth (còn gọi là /login) sẽ đưa bạn đến màn hình “Chọn phương thức xác thực”; có ba lựa chọn cấp cao nhất. Nếu cố chọn Qwen OAuth, màn hình sẽ hiển thị “Đã kết thúc — hãy chuyển sang Coding Plan hoặc API Key”.

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

Sử dụng Claude hoặc GPT: thiết lập Custom Provider trong settings.json

Tài liệu xác thực của Qwen Code khuyến nghị modelProviders trong ~/.qwen/settings.json để kết nối với các dịch vụ bên thứ ba như OpenAI, Anthropic, Google, OpenRouter và endpoint riêng. Với Kunavo, hãy làm 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

Có bốn điểm cần ghi nhớ.

• baseUrl chỉ đến /v1. Tài liệu tham khảo về nhà cung cấp model nêu rõ: chỉ định tuyến /v1 của API, “không phải /v1/chat/completions”; SDK sẽ tự thêm đường dẫn yêu cầu. Nếu ghi cả đường dẫn, bạn sẽ nhận lỗi 404 thay vì lỗi xác thực.
• Nơi lưu key. Qwen Code đọc từ môi trường bằng tên biến được chỉ định trong envKey. Thứ tự ưu tiên là export của shell, .env (.qwen/.env được khuyến nghị, chỉ dùng tệp đầu tiên tìm thấy), rồi env trong settings.json; lựa chọn cuối lưu dữ liệu dạng văn bản thuần nên không được khuyến nghị.
• Tệp cấu hình có ưu tiên cao hơn cờ CLI. Thứ tự phân giải là giá trị nhập trong /auth → modelProviders đang 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 trong các hướng dẫn cũ đã không còn được khuyến nghị.
• Trước tiên hãy dùng Chat Completions. Bỏ qua wireApi sẽ sử dụng định dạng Chat Completions. Khi dùng "responses", không có cơ chế tự động nhận diện endpoint hoặc dự phòng. Các chỉnh sửa trong modelProviders cũng được áp dụng ngay cho phiên đang chạy (sẽ xuất hiện khi mở lại /model).

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

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

Theo ví dụ trong README, trước tiên hãy bắt đầu bằng yêu cầu như “hãy giải thích repository này và cho tôi biết nên đọc từ đâu” để kiểm tra việc đọc tệp và gọi công cụ có hoạt động đầy đủ hay không. Chỉ gửi lời chào 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 rằng “chỉ được sử dụng trong môi trường đáng tin cậy, được sandbox hoặc dùng một lần”. Chi phí ước tính của /stats model được Qwen Code tính toán, không phải số tiền bị tính thực tế. Hãy kiểm tra số tiền thực tế trong nhật ký sử dụng của điểm kết nối.

Các giới hạn cần biết

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

Thanh toán khi dùng thử Kunavo

Kunavo hoạt động theo 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 đơn vị 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), Apple Pay, Google Pay và Link. Sau khi xem Giải thích về thanh toán, hãy 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ế được tính 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 của Qwen Code; các tài liệu về xác thực, nhà cung cấp model, lệnh và web_search (nhánh main); chuỗi giao diện tiếng Nhật (packages/cli/src/i18n/locales/ja.js); npm @qwen-code/qwen-code 0.24.7; các trang Coding Plan và Token Plan của Alibaba Cloud. Kunavo chưa chạy Qwen Code với endpoint của mình.