Thiết lập Qwen Code: cài đặt, nhà cung cấp, giao diện tiếng Đức và API

Qwen Code là tác nhân lập trình AI mã nguồn mở (Apache-2.0) của nhóm Qwen thuộc Alibaba. Việc thiết lập gồm bốn bước: cài đặt, khởi chạy qwen trong dự án, chọn nhà cung cấp bằng /auth, rồi đặt một tác vụ. Điều quan trọng cần biết trước: hạn mức Qwen OAuth miễn phí kết thúc vào ngày 15 tháng 4 năm 2026 — nếu làm theo hướng dẫn cũ, bạn sẽ không thể tiếp tục miễn phí. Trang này đi theo menu /auth hiện tại, trình bày cách chuyển sang tiếng Đức, thiết lập endpoint riêng cho Claude hoặc GPT và các lệnh quan trọng nhất. Phiên bản mới nhất là v0.24.7, phát hành trên npm ngày 29 tháng 9 năm 2026; các bản phát hành xuất hiện ít nhất mỗi tuần, hãy kiểm tra phiên bản bằng qwen --version.

Cài đặt

Các lệnh lấy từ README chính thức. Với trình cài đặt độc lập, bạn không cần tự cung cấp Node.js; chỉ npm mới bắt buộc Node.js 22 trở lên.

# macOS / Linux (offizieller Standalone-Installer)
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 (benötigt Node.js 22 oder neuer)
npm install -g @qwen-code/qwen-code@latest

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

Sau đó 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 đã được phát triển độc lập và không còn đồng bộ với bản gốc. Các thiết lập và hạn mức của Gemini CLI không áp dụng ở đây.

Khởi động lần đầu và giao diện tiếng Đức

cd /pfad/zu/ihrem-projekt
qwen

# in der Sitzung:
/language ui de-DE        # Oberfläche auf Deutsch
/language output German   # Antworten des Modells auf Deutsch
/auth                     # Anbieter und API-Key einrichten

Sau /language ui de-DE, Qwen Code hiển thị các nhãn tiếng Đức riêng, chẳng hạn “Chọn phương thức xác thực” hoặc “Chế độ phê duyệt công cụ”; trang này dùng chính các thuật ngữ đó. Ngôn ngữ trả lời là tùy chọn riêng và được đặt bằng /language output German.

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

Chọn nhà cung cấp bằng /auth

/auth (bí danh /login) mở “Chọn phương thức xác thực” với ba tùy chọn ở cấp cao nhất. Nếu vẫn muốn chọn Qwen OAuth, bạn sẽ thấy: “Đã ngừng — hãy chuyển sang Coding Plan hoặc API Key”.

Ba phương thức ModelStudio không phải là ba phương thức thanh toán cho cùng một hóa đơn: tài liệu cung cấp cho mỗi phương thức một endpoint riêng và một key riêng, đồng thời loại key và baseUrl phải khớp nhau. Vào ngày 1 tháng 10 năm 2026, Coding Plan được ghi là “có giới hạn, ai đến trước được phục vụ trước, nạp lại hằng ngày lúc 0:00 (UTC+8)” — vì vậy có thể có ngày bạn không đăng ký được. Một tác vụ sử dụng nhiều lệnh gọi mô hình trong Coding Plan; Alibaba thường nêu 5–10 lệnh gọi cho tác vụ đơn giản và 10–30 hoặc hơn cho tác vụ phức tạp. Trang tiếng Anh Qwen Code pricing trình bày chi tiết phần so sánh chi phí.

Sử dụng Claude hoặc GPT: Custom Provider trong settings.json

Tài liệu xác thực khuyến nghị sử dụng khối modelProviders trong ~/.qwen/settings.json cho các nhà cung cấp bên thứ ba như OpenAI, Anthropic, Google, OpenRouter hoặc 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-kompatibel",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

# Den Key nicht in settings.json schreiben, sondern in .qwen/.env oder die Umgebung
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

Bốn điểm giúp tiết kiệm thời gian xử lý sự cố:

• baseUrl kết thúc tại /v1. Tham chiếu về Model Providers nêu rõ: đặt tại gốc API /v1, không phải tại /v1/chat/completions — SDK tự thêm đường dẫn. Nếu có đường dẫn, bạn sẽ nhận 404 chứ không phải lỗi xác thực.
• Key nằm ở đâu. Qwen Code đọc key từ biến môi trường mà envKey nêu. Thứ tự ưu tiên: Shell-export, sau đó là tệp .env (khuyến nghị .qwen/.env; chỉ tệp đầu tiên được tìm thấy có hiệu lực), cuối cùng là env trong settings.json — tại đó key được lưu dưới dạng văn bản thuần.
• Tệp có ưu tiên cao hơn tùy chọn CLI. Thứ tự: giá trị từ /auth → mục modelProviders được chọn → đối số CLI → biến môi trường → settings.json. Vì vậy --openai-base-url đôi khi có vẻ không có tác dụng. security.auth.apiKey và security.auth.baseUrl trong các hướng dẫn cũ đã lỗi thời.
• Bắt đầu với Chat Completions. Nếu không có wireApi, Chat Completions sẽ được sử dụng. Với "responses", không có cơ chế nhận diện endpoint hay chuyển dự phòng tự động. Các thay đổi trong modelProviders cũng có hiệu lực trong phiên đang chạy (mở lại /model).

Danh mục Kunavo không có mô hình văn bản Qwen. Vì vậy đây không phải là cách rẻ hơn để dùng Qwen, mà là cách sử dụng Claude hoặc GPT trong Qwen Code bằng số dư trả trước. Kunavo cũng chưa tự chạy Qwen Code với endpoint của mình; cấu hình này, giống như trang thiết lập Qwen Code bằng tiếng Anh, lấy từ tài liệu chính thức. Hãy giữ lại một tuyến đang hoạt động trong khi thử nghiệm.

Tác vụ đầu tiên và các lệnh quan trọng

README đề xuất đại ý yêu cầu đầu tiên: “Hãy giải thích repository này và cho tôi biết nên bắt đầu từ đâu.” Việc này kiểm tra đồng thời quyền truy cập tệp và các lệnh gọi công cụ — chỉ một câu “Xin chào” sẽ không phát hiện được vấn đề kết nối.

Đối với yolo và các chế độ tự động khác, chính tài liệu cũng cảnh báo: chỉ sử dụng trong môi trường đáng tin cậy, cô lập hoặc có thể loại bỏ. Chi phí ước tính trong /stats model được Qwen Code tự tính; số tiền thực tế nằm trong nhật ký sử dụng của nhà cung cấp.

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

• Tính năng tìm kiếm web tích hợp phụ thuộc vào host. Tính năng này sử dụng tìm kiếm phía máy chủ của DashScope: bật với ModelStudio Standard API Key và Token Plan cũng như các mục trên host DashScope được nhận diện, tắt với Coding Plan (chưa được xác minh ở đó), và tắt với nhà cung cấp bên thứ ba và endpoint riêng trên các host khác (tài liệu về web_search). Lựa chọn thay thế: máy chủ tìm kiếm MCP.
• Kunavo chỉ cung cấp Chat. Kunavo không cung cấp 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 vốn đã yêu cầu endpoint DashScope và vẫn sử dụng key riêng của nó, bất kể mô hình Chat trỏ đến đâu.

Thanh toán khi dùng thử Kunavo

Kunavo hoạt động với số dư trả trước, không có gói đăng ký và tính phí theo token. Mức nạp tối thiểu là $10; tại trang thanh toán Stripe có thẻ (Visa, Mastercard, American Express), Apple Pay, Google Pay và Link, còn tại Áo có thêm EPS — hiện chưa cung cấp ghi nợ SEPA. Stripe chỉ cung cấp Pay by Bank cho người mua ở Vương quốc Anh, Ireland và Phần Lan; tại Đức, phương thức này hiện chỉ ở dạng bản xem trước giới hạn (tài liệu Stripe, tính đến ngày 3 tháng 10 năm 2026). Xem chi tiết trong Thông tin thanh toán; hãy tạo key bằng tài khoản. Sau tác vụ đầu tiên, nhật ký sử dụng hiển thị số tiền thực tế.

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, tài liệu về xác thực, Model Providers, lệnh và web_search (nhánh main), các văn bản giao diện tiếng Đức (packages/cli/src/i18n/locales/de.js), @qwen-code/qwen-code 0.24.7 trên npm, cùng các trang của Alibaba Cloud về Coding Plan và Token Plan. Kunavo chưa chạy Qwen Code với endpoint của mình.