Qwen Code

Qwen Code đọc endpoint từ modelProviders trong ~/.qwen/settings.json — một mục có baseUrl và envKey đưa Claude và GPT vào bộ chọn /model.

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

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Mở ~/.qwen/settings.json (tạo tệp nếu chưa có) và gộp bốn khối ở trên vào đó. Tài liệu khuyên khai báo modelProviders trong tệp phạm vi người dùng “để tránh xung đột khi gộp giữa cài đặt dự án và cài đặt người dùng”.
3. Nếu có thể, hãy đặt khóa ở nơi an toàn hơn env. Qwen Code đọc khóa từ process.env[envKey], và tài liệu xếp các nguồn theo thứ tự từ cao xuống thấp: biến export của shell, rồi đến tệp .env, sau đó là khối env trong settings.json — nơi được lưu ý là lưu trữ văn bản thuần. Khối env ở trên là cấu hình tối thiểu để chạy, chứ không phải nơi tốt nhất để lưu lâu dài.
4. Chạy qwen. Khi security.auth.selectedType được đặt thành openai và model.name khớp với một id mà bạn đã khai báo, bạn không cần thực hiện bước /auth tương tác — tài liệu nói rõ điều đó ngay sau ví dụ cấu hình trong một tệp.
5. Giao cho nó một tác vụ đọc và chỉnh sửa tệp, thay vì một lời chào. Qwen Code là một tác tử: gọi công cụ và truyền dữ liệu theo luồng là những gì lần chạy đầu tiên nên kiểm tra, đồng thời cũng là những thứ sẽ lỗi đầu tiên nếu endpoint chỉ tương thích một phần.
6. Thêm mục bên dưới modelProviders.openai để chuyển đổi mô hình khi chạy bằng /model. Các chỉnh sửa này được tải lại nóng trong phiên đang chạy; providerProtocol chỉ được đọc một lần khi khởi động và cần khởi động lại để áp dụng.

Đã kiểm tra đối chiếu với Trang xác thực của Qwen Code, Tùy chọn 4: Khóa API (linh hoạt) vào 21 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong Qwen Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

Ba điều tài liệu làm rõ mà nhiều người thường đoán sai

Các thông tin này đến từ trang xác thực và tài liệu tham khảo về nhà cung cấp mô hình được liên kết ở trên; mỗi giả định sai thay vì đọc kỹ đều khiến bạn mất thời gian gỡ lỗi thực sự.

1. Mục modelProviders có độ ưu tiên cao hơn các cờ CLI. Thứ tự được ghi trong tài liệu, từ cao xuống thấp, là: các tùy chỉnh qua /auth trong phiên đang chạy, sau đó là envKey của nhà cung cấp mô hình được chọn, rồi đến các đối số CLI như --openai-api-key, tiếp theo là biến môi trường, cuối cùng là security.auth.apiKey trong cài đặt. Hầu hết mọi người nghĩ rằng cờ sẽ được ưu tiên. Thực tế không phải vậy — đó là lý do --openai-base-url có thể trông như bị bỏ qua.
2. security.auth.apiKey và security.auth.baseUrl đã lỗi thời. Tài liệu tham khảo xác nhận điều này và khuyến nghị chuyển sang modelProviders. Nếu một hướng dẫn cũ yêu cầu bạn chỉnh sửa hai khóa đó, tức là nó đang chỉnh sửa tuyến cấu hình sắp bị loại bỏ.
3. wireApi chọn định dạng yêu cầu, và không có gì tự phát hiện trường hợp không khớp. Nếu bỏ qua, định dạng mặc định là Chat Completions, như khối ở trên sử dụng. Đặt "wireApi": "responses" đòi hỏi endpoint phải thực sự tương thích với Responses; tài liệu nói rõ rằng không có bước phát hiện endpoint và cũng không tự động chuyển phương án khi yêu cầu thất bại. Kunavo hỗ trợ cả /v1/responses lẫn /v1/chat/completions, nhưng trang này chưa thử nghiệm cặp kết hợp nào, vì vậy hãy bắt đầu với mặc định.

Nếu bạn đến đây để tìm hiểu về gói miễn phí

Nhiều nội dung hiện vẫn viết về Qwen Code mô tả cách đăng nhập Qwen OAuth với hạn mức miễn phí hằng ngày. Tùy chọn đó không còn nữa: tài liệu ghi nhận gói miễn phí đã ngừng hoạt động vào ngày 15 tháng 4 năm 2026, đồng thời cho biết Qwen OAuth không còn là lựa chọn trong hộp thoại /auth. Hiện tài liệu liệt kê ba lựa chọn: Alibaba ModelStudio — với Coding Plan, Token Plan và Standard API Key trong menu con — Third-party Providers và Custom Provider, được mô tả là kết nối “máy chủ cục bộ, proxy hoặc nhà cung cấp không được hỗ trợ”. Kunavo là lựa chọn thứ ba trong số đó. Cũng cần lưu ý rằng các mục trong menu con ModelStudio không phải là ba cách thanh toán cho cùng một hóa đơn: mỗi mục có máy chủ và khóa riêng, và khóa Coding Plan sẽ không hoạt động trên máy chủ Token Plan.