Qwen Code và Qwen 3.7-max: thiết lập Token Plan

Tài liệu tham khảo của Ailoot: ailoot.ai/docs/.

Cập nhật 03.10.2026: Ba điều đã thay đổi kể từ khi bài viết được đăng. Alibaba đã ngừng bán Coding Plan cho khách hàng mới—gói Lite đã ngừng từ tháng 3, còn Pro đã bán hết. Token Plan chuyển từ hạn mức hàng tuần sang hàng tháng. Một mô hình mới hơn, Qwen3.8-max, đã được phát hành. Tôi cũng đã sửa lỗi trong phần mô tả khóa Token Plan—điều này liên quan đến chính lỗi 401 đó, và tôi giải thích bên dưới.

Qwen Code là gì, và vì sao nó không chỉ là một bản sao khác?#

Khi lần đầu nghe nói về Qwen Code, tôi nghĩ: “Lại thêm một bản sao Claude Code sẽ hỏng sau lời nhắc thứ hai.” Tôi đã nhầm. Alibaba không sao chép giao diện—họ tự xây dựng tác nhân CLI từ đầu, nhưng tương thích hoàn toàn với API OpenAI. Điều đó có nghĩa là bạn có thể chạy không chỉ các mô hình Qwen mà còn cả DeepSeek, GLM, Kimi và thậm chí Claude thông qua API Anthropic.

Đây là những gì công cụ thực sự có thể làm:

• Đọc cấu trúc dự án và hiểu ngữ cảnh (như Claude Code với CLAUDE.md)
• Chạy lệnh shell, chỉnh sửa tệp và tạo commits
• Hỗ trợ Skills và SubAgents
• Hoạt động trong VS Code thông qua terminal tích hợp hoặc tiện ích mở rộng
• Chuyển đổi giữa các mô hình bằng một lệnh /model

Có một nhược điểm, nhưng rất đáng lưu ý: gói miễn phí đã đóng vào ngày 15 tháng 4 năm 2026. Trước đây, Qwen OAuth cho phép 100 yêu cầu miễn phí mỗi ngày—giờ chỉ còn các lựa chọn trả phí. Nhưng ngay cả Qwen Code trả phí cũng rẻ hơn đáng kể so với gói đăng ký Claude Pro. Nếu bạn đang chọn giữa các công cụ, tôi đã tổng hợp mọi lựa chọn trong hướng dẫn “Nên viết mã bằng gì trong năm 2026: 8 công cụ AI”.

Chi phí bao nhiêu và nên chọn gói nào?#

Sự nhầm lẫn về các gói là vấn đề đau đầu nhất khi thiết lập Qwen Code. Alibaba gọi các gói bằng những tên khác nhau ở từng phần của bảng điều khiển, và ngay cả tiện ích mở rộng VS Code cũng hiển thị các lựa chọn không đúng. Đây là cách hoạt động thực tế (đã đối chiếu với tài liệu Alibaba Cloud, được cập nhật tại đó vào ngày 28.09.2026).

Theo trải nghiệm được tác giả mô tả, Token Plan được chọn vì một gói đăng ký cho phép truy cập Qwen 3.7-max (và Qwen3.8-max mới hơn), DeepSeek V4 Pro và GLM-5. Tất cả mô hình dùng chung một kho Credits. Chuyển đổi bằng lệnh /model—bạn không cần mua khóa riêng cho từng nhà cung cấp.

Quan trọng: Coding Plan và Token Plan là hai sản phẩm khác nhau với địa chỉ API khác nhau. Khóa Coding Plan có tiền tố sk-sp-. Khóa Token Plan hoàn toàn không có tiền tố—đó là cách tài liệu chính thức của Qwen Code mô tả. Nhầm lẫn địa chỉ hoặc khóa giữa hai sản phẩm sẽ khiến bạn gặp lỗi 401. Và vì Coding Plan đã ngừng bán cho khách hàng mới, hiện Token Plan là lựa chọn duy nhất còn hoạt động với phần lớn độc giả.

Cài đặt Qwen Code như thế nào?#

Kiểm tra phiên bản Node.js trước khi cài đặt:

node --version

Bạn cần phiên bản 22 trở lên. Nếu phiên bản cũ hơn, hãy cập nhật qua nodejs.org hoặc bằng nvm:

nvm install 22
nvm use 22

Tiếp theo, cài Qwen Code bằng một lệnh:

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

Hoặc dùng Homebrew trên macOS:

brew install qwen-code

Kiểm tra:

qwen --version

Nếu phiên bản được hiển thị, bạn đã sẵn sàng. Khởi chạy Qwen Code bằng lệnh qwen trong terminal. Trong VS Code, mở terminal tích hợp (Ctrl+) rồi nhập qwen`.

Ngoài ra còn có tiện ích mở rộng VS Code—Qwen Code Companion của QwenLM trên marketplace. Tiện ích này thêm thanh trò chuyện bên cạnh, giống GitHub Copilot. Tôi dùng tiện ích đó—nó tiện hơn terminal thông thường.

Tạo tài khoản và mua Token Plan như thế nào?#

Thực hiện lần lượt:

1. Truy cập modelstudio.console.alibabacloud.com
2. Nhấp Free Sign Up ở góc trên bên phải
3. Nhập email (Gmail dùng được) và xác nhận mã trong hộp thư đến
4. Thêm số điện thoại của bạn
5. Thêm thẻ được nhà cung cấp chấp nhận. Alibaba sẽ tính $1 để xác minh thẻ và hoàn lại trong 1–3 ngày.
6. Trong bảng điều khiển, tìm mục ModelStudio—tab Token Plan
7. Chọn gói Standard (mức tối thiểu để bắt đầu)
8. Xác nhận thanh toán

Sau khi mua, bạn sẽ đến trang My Subscriptions. Tại đó, bạn sẽ thấy:

• Standard Seat: 0/1—nghĩa là bạn đã mua một seat nhưng chưa gán cho mình
• Nhấp Assign—chọn tài khoản của bạn và xác nhận
• Trạng thái sẽ đổi thành 1/1

Khóa API sẽ không hoạt động nếu bạn chưa làm bước này. Theo trải nghiệm được tác giả mô tả, bước này mất 20 phút.

Lấy khóa API và địa chỉ chính xác ở đâu?#

Trên trang My Subscriptions, nhấp nút lớn màu tím Go to Management Platform. Một bảng điều khiển riêng sẽ mở ra.

Chọn Overview trong menu bên trái. Trên trang này, bạn sẽ thấy hai mục:

Plan-specific API Key—khóa cá nhân của bạn. Khóa được che bằng dấu hoa thị. Nhấp biểu tượng sao chép bên cạnh (đừng dùng chuột bôi đen—bạn sẽ sao chép cả dấu hoa thị). Khóa Token Plan không có tiền tố. Đây không phải lỗi đánh máy trong hướng dẫn; tài liệu chính thức của Qwen Code mô tả khóa như vậy. Nếu thấy sk-sp-, đó là khóa Coding Plan của một sản phẩm khác—bạn đã sao chép nhầm khóa.

Plan-specific Base URL—có hai lựa chọn:

• Dành cho công cụ tương thích OpenAI (Qwen Code): https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
• Dành cho công cụ tương thích Anthropic: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

Hãy nhớ: chỉ những địa chỉ này mới hoạt động với khóa Token Plan. Địa chỉ tiêu chuẩn dashscope-intl.aliyuncs.com dành cho khóa thông thường (trả theo mức sử dụng), còn coding-intl.dashscope.aliyuncs.com là địa chỉ Coding Plan. Dùng khóa Token Plan với một trong hai địa chỉ đó sẽ trả về lỗi 401.

Kết nối với VS Code như thế nào?#

Nếu bạn đã cài Qwen Code Companion từ marketplace của VS Code:

1. Mở bảng lệnh (Cmd+Shift+P)
2. Nhập Qwen Code: Choose Provider
3. Nếu thấy menu lựa chọn, đừng chọn Coding Plan (đó là sản phẩm khác). Hãy chọn Standard API Key
4. Dán khóa từ Management Platform—khóa Token Plan không có tiền tố cố định
5. Khu vực: Singapore
6. Mô hình: qwen3.7-max

Nếu gặp lỗi sau bước này, hãy cấu hình thủ công qua tệp. Đôi khi tiện ích mở rộng tự điền sai địa chỉ.

Mở hoặc tạo tệp ~/.qwen/settings.json rồi dán:

{
  "env": {
    "TOKEN_PLAN_API_KEY": "YOUR-KEY-FROM-MANAGEMENT-PLATFORM"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-max",
        "name": "qwen3.7-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 262144
        }
      },
      {
        "id": "qwen3.6-plus",
        "name": "qwen3.6-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 1000000
        }
      },
      {
        "id": "deepseek-v4-pro",
        "name": "deepseek-v4-pro",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 1000000
        }
      }
    ]
  },
  "security": {
    "auth": { "selectedType": "openai" }
  },
  "model": { "name": "qwen3.7-max" }
}

Thay YOUR-KEY-FROM-MANAGEMENT-PLATFORM bằng khóa của bạn từ Management Platform. Khởi động lại VS Code. Xong.

Vì sao xuất hiện lỗi 401 và cách khắc phục?#

Tác giả mô tả những lỗi gặp phải trong quá trình thiết lập. Đây là danh sách đầy đủ các nguyên nhân gây lỗi 401 và cách kiểm tra:

Kiểm tra nhanh khóa qua terminal:

curl -s -o /dev/null -w "%{http_code}" -X POST \
  "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.7-max","messages":[{"role":"user","content":"hi"}],"max_tokens":5}'

Nếu trả về 200, khóa hoạt động và vấn đề nằm ở cài đặt tiện ích mở rộng. Nếu trả về 401, khóa hoặc địa chỉ không đúng.

Có những mô hình nào và nên chọn mô hình nào?#

Đây là những mô hình thực sự hữu ích cho vibe coding:

Chuyển đổi mô hình bằng lệnh /model ngay trong phiên Qwen Code—không cần thay đổi cài đặt hay khởi động lại.

Tôi khuyên bạn bắt đầu với qwen3.6-plus. Nếu sau một tuần bạn thấy hạn mức hết quá nhanh, hãy dùng qwen3.6-flash cho công việc thường ngày và chỉ dùng qwen3.7-max cho tác vụ phức tạp.

Nên dùng Qwen Code hay Claude Code?#

Bài đánh giá mô tả một tháng tác giả làm việc với cả hai công cụ. Đây là phần so sánh dựa trên trải nghiệm đó:

| Tiện ích mở rộng VS Code | Có sẵn, ổn định | Có, nhưng còn thô—đôi khi gặp vấn đề với khóa |

Khi Qwen Code đáng tiền hơn:

• Bạn cần truy cập nhiều mô hình (DeepSeek cho toán học, Kimi cho ngữ cảnh dài)
• Bạn đang thử các cách tiếp cận khác nhau cho cùng một tác vụ
• Ngân sách hạn chế nhưng bạn viết mã mỗi ngày
• Bạn muốn một công cụ mã nguồn mở có thể tùy chỉnh

Khi Claude Code là không thể thiếu:

• Dự án quan trọng, nơi chất lượng mã tương đương tiền bạc
• Làm việc với dự án cũ quy mô lớn (Opus duy trì ngữ cảnh tốt hơn)—tôi đã viết riêng về cách không dùng hết giới hạn Claude Code
• Bạn cần tiện ích mở rộng VS Code ổn định mà không phải cấu hình thủ công

Cách kết hợp theo trải nghiệm được tác giả mô tả: Claude Code cho dự án chính, Qwen Code cho thử nghiệm và tác vụ song song, nơi bạn có thể nhanh chóng thử một ý tưởng với mô hình rẻ hơn. Để so sánh chi tiết với các công cụ khác, xem Cursor so với Claude Code và Codex so với Claude Code.

Ba lỗi thường gặp mà ai cũng mắc phải#

Lỗi 1: Token Plan ≠ Coding Plan

Alibaba gọi các sản phẩm này bằng tên khác nhau ở từng phần của bảng điều khiển. Tùy chọn “Coding Plan” trong tiện ích mở rộng VS Code không phải Token Plan. Hãy nhớ: tính đến 20.03.2026, Coding Plan Lite đã ngừng bán cho khách hàng mới, còn Pro đã bán hết—nếu chưa có gói, bạn chỉ có thể chọn Token Plan. Hai gói dùng địa chỉ API khác nhau:

• Token Plan: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
• Coding Plan: https://coding-intl.dashscope.aliyuncs.com/v1

Nếu bạn mua Token Plan nhưng cấu hình tiện ích mở rộng là Coding Plan, bạn sẽ gặp lỗi 401. Và ngược lại.

Lỗi 2: Tiện ích mở rộng VS Code tự tạo khóa

Khi thiết lập bằng giao diện GUI của tiện ích mở rộng (Cmd+Shift+P - Qwen Code: Choose Provider), đôi khi tiện ích tự tạo khóa riêng thông qua Alibaba Auth API. Khóa này có định dạng khác và không liên kết với gói đăng ký Token Plan của bạn.

Cách khắc phục: sau khi thiết lập bằng GUI, mở ~/.qwen/settings.json và đảm bảo khóa trong env trùng với khóa hiển thị trên Management Platform (Overview - Plan-specific API Key). Nếu không trùng, hãy thay thủ công.

Lỗi 3: Chưa gán Standard Seat

Sau khi mua Token Plan, bạn sẽ thấy Standard Seat: 0/1 trên trang My Subscriptions. Điều đó nghĩa là seat đã được mua nhưng chưa liên kết với tài khoản của bạn. Khóa API sẽ không hoạt động cho đến khi bạn nhấp Assign.

Theo trải nghiệm của tác giả, mất 20 phút để tìm lỗi 401 trước khi nhận ra dòng này.

Kiểm tra mọi thứ đã hoạt động chưa như thế nào?#

Bước 1. Kiểm tra khóa qua terminal:

curl -X POST \
  "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.6-plus","messages":[{"role":"user","content":"Hello"}]}'

Nếu phản hồi có văn bản từ mô hình, khóa và địa chỉ đang hoạt động.

Bước 2. Kiểm tra trong Qwen Code:

Mở VS Code—terminal tích hợp—nhập qwen. Nếu công cụ khởi chạy, hãy viết thử nội dung nào đó:

Dự án trong thư mục này là gì?

Qwen Code sẽ đọc cấu trúc và trả lời. Nếu có phản hồi, quá trình thiết lập đã hoàn tất.

Bước 3. Kiểm tra mức sử dụng Credits:

Năm phút sau những yêu cầu đầu tiên, vào Management Platform—Overview—Usage Consumption. Tỷ lệ phải lớn hơn không. Nếu sau hơn 10 yêu cầu vẫn là 0%, bạn đang dùng sai địa chỉ (các yêu cầu đi ra ngoài gói đăng ký, dùng hình thức trả theo mức sử dụng hoặc không đi đến đâu cả).

Tiếp theo là gì?#

Bạn đã cài Qwen Code và công cụ hoạt động. Bạn có thể mở bất kỳ dự án nào và bắt đầu xây dựng thông qua đối thoại với AI.

Câu hỏi tiếp theo là: vì sao cùng một lời nhắc trong Qwen Code lại cho kết quả tuyệt vời ở dự án này nhưng vô nghĩa ở dự án khác? Tất cả phụ thuộc vào ngữ cảnh. Nếu dự án có cấu trúc business/ với đối tượng khách hàng, sản phẩm và mục tiêu, AI sẽ làm việc như một cộng sự. Nếu thư mục trống, nó sẽ bịa ra thông tin.

Tiếp tục khám phá Ailoot tại ailoot.ai.