Tài liệu

Tài liệu

Qoder

Ứng dụng Qoder dành cho máy tính để bàn chạy độc lập chấp nhận Base URL bất kỳ trong Provider → Custom. Điền ba trường và nhập thủ công ID mô hình, rồi Qoder có thể truy cập Claude và GPT bằng một khóa duy nhất — dù các mô hình này không xuất hiện trong danh mục riêng của ứng dụng.

Qoder Settings → Models → + Add → Provider → Custom nhận Base URL tương thích OpenAI, API Key và Model IDs nhập thủ công — để ứng dụng Qoder desktop độc lập truy cập Claude và GPT, dù chúng không có trong catalog riêng.

Cài đặt Qoder → Mô hình → + Thêm → Nhà cung cấp → Tùy chỉnh
Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model
Đây là ứng dụng Qoder chạy độc lập, không phải Qoder IDE. “Qoder” là tên gọi chung cho một nhóm sản phẩm có tài liệu riêng; chỉ tài liệu của ứng dụng dành cho máy tính để bàn chạy độc lập mới mô tả việc sử dụng endpoint tùy ý. Trang mô hình tùy chỉnh của ứng dụng có các mục OpenAI Compatible và Anthropic Compatible trong Custom; ghi chú phát hành phiên bản 0.1.8 ngày 5 tháng 9 năm 2026 giới thiệu tính năng này với nội dung “BYOK trong gói Personal hiện hỗ trợ Base URL tùy chỉnh cho mọi dịch vụ mô hình tương thích với OpenAI hoặc Anthropic”. Trang mô hình tùy chỉnh của Qoder IDE chỉ liệt kê nhà cung cấp theo tên và không hề có chuỗi Base URL. Nếu bạn không thấy trường này trên màn hình, có lẽ bạn đang dùng một sản phẩm Qoder khác.
Base URL vẫn giữ hậu tố /v1. Trang của Qoder hướng dẫn “nhập Base URL chính xác do dịch vụ mô hình cung cấp” và đưa ra https://api.example.com/v1 làm định dạng ví dụ — vì vậy, với endpoint tương thích OpenAI, trường này cần đường dẫn gốc /v1, không phải origin trần. Điều này trái với các client theo kiểu Anthropic, vốn cần https://api.kunavo.com và tự nối đường dẫn của tuyến.
Qoder cũng có nhà cung cấp tùy chỉnh kiểu Anthropic Compatible; Kunavo cũng hỗ trợ /v1/messages. Tài liệu chỉ công bố một Base URL làm ví dụ, không nêu mỗi giao thức sẽ nối thêm tuyến nào, nên không xác định được kiểu này cần https://api.kunavo.com hay https://api.kunavo.com/v1. Với đường dẫn tương thích OpenAI ở trên, ví dụ của chính Qoder đã xác định được cách dùng; nếu chọn kiểu Anthropic, hãy thử cả hai dạng. Danh sách khắc phục sự cố của Qoder bắt đầu bằng đúng nội dung này — “Base URL đã đầy đủ chưa, và giao thức tương thích cùng loại API được chọn có khớp với endpoint không”.
Kunavo chưa chạy phiên nào bên trong Qoder. Nội dung ở đây không phải kết quả kiểm tra client khi chạy thực tế: các trường được chép từ trang chính thức của Qoder vào ngày ghi bên dưới, còn thông tin về endpoint dựa trên giao diện API đã công bố của Kunavo. Nút Xác thực và thêm mô hình của Qoder là bước thực sự kiểm tra cặp cấu hình này; thao tác đó chạy trên máy của bạn, không phải máy của chúng tôi.
Chưa có khóa? Tạo tài khoản Kunavo, tạo khóa (bắt đầu bằng sk-kn-) và nạp tín dụng từ $10 — các lệnh gọi được thanh toán từ số dư đó và các lệnh gọi thất bại không bị tính phí. Sau đó, bảng điều khiển mở tại phần thiết lập Qoder.

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ở Cài đặt Qoder, chọn Mô hình trong thanh điều hướng bên trái rồi nhấp + Thêm.
  3. Mở Nhà cung cấp rồi chọn OpenAI Compatible trong mục Tùy chỉnh — không chọn một trong các nhà cung cấp thiết lập sẵn ở phía trên. Sau đó chọn Chat Completions API làm loại API.
  4. Nhập Base URL, Khóa API và ít nhất một ID mô hình. Qoder không có chức năng tìm mô hình trong danh sách theo tài liệu, vì vậy hãy nhập ID; nhấp Thêm ID mô hình để thêm từng ID khác trên cùng endpoint.
  5. Nhấp Tiếp theo rồi đặt các khả năng mà Qoder không thể tự suy ra: Tên hiển thị, Các cửa sổ ngữ cảnh được hỗ trợ và Cửa sổ ngữ cảnh mặc định trong số các giá trị đó, cùng các tùy chọn Thị giác và Chế độ suy luận nếu mô hình hỗ trợ.
  6. Nhấp Xác thực và thêm mô hình. Trang bộ chọn mô hình của Qoder cho biết sau khi thêm, “mô hình sẽ khả dụng trong các bộ chọn mô hình cho tác vụ, Agent và tự động hóa”.

Đã kiểm tra đối chiếu với trang mô hình tùy chỉnh của ứng dụng Qoder độc lập 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.

Đây là phiên bản ngắn. Hướng dẫn đầy đủ — lựa chọn mô hình, chi phí của một phiên thực tế và các trường hợp lỗi — nằm trong Qoder và Claude Code — chọn Qoder nào, endpoint nào, hóa đơn nào.

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 Qoder.

# 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.

ID mô hìnhKunavo vào / raPhù hợp ở đâu trong Qoder
claude-sonnet-5$1.40 / $7.00mô hình hoạt động mặc định cho bộ chọn tác vụ và Agent
claude-opus-5$3.50 / $17.50tái cấu trúc quy mô lớn, khi lập kế hoạch sai tốn kém hơn token
claude-haiku-4-5$0.70 / $3.50chạy tự động hóa khối lượng lớn, khi số lượng chi phối chi phí
gpt-5-6-sol$2.00 / $12.00ý kiến thứ hai từ một họ mô hình khác, dùng cùng khóa và endpoint
Thanh toán theo token từ số dư trả trước, không có phí hàng tháng — xem trang Thanh toán. Với ngữ cảnh lặp lại — chiếm phần lớn dữ liệu mà trình chỉnh sửa hoặc ứng dụng trò chuyện gửi đi — bộ nhớ đệm prompt ảnh hưởng đến hóa đơn nhiều hơn lựa chọn mô hình.

Vì sao Qoder của bạn có thể không có trường Base URL

Tài liệu của ba phiên bản Qoder mô tả các quy tắc BYOK khác nhau, và chỉ một phiên bản cho phép chọn endpoint theo tài liệu. Đây là yếu tố duy nhất quyết định bạn có thể thực hiện thiết lập trên từ giao diện đang mở hay không; hãy kiểm tra trước khi sửa tệp cấu hình — trang CLI còn hướng dẫn rõ là không nên sửa tệp.

Giao diệnCó tài liệu hướng dẫn Base URL tùy chỉnh không?Nội dung tài liệu chính thức
Qoder (ứng dụng độc lập)CóOpenAI Compatible và Anthropic Compatible nằm trong danh sách Nhà cung cấp dưới mục Tùy chỉnh, cùng các trường Base URL, Khóa API và ID mô hình cần nhập thủ công. Trang này.
Qoder IDEKhôngTrang mô hình tùy chỉnh ghi “Áp dụng cho: Người dùng gói Individuals” và nêu tên nhà cung cấp — Alibaba Cloud Model Studio, DeepSeek, Z.ai, Kimi, MiniMax, Xiaomi MIMO. Không có chuỗi Base URL.
Qoder CLIKhông có trên trang tài liệuTrong /model có tab Tùy chỉnh với Add custom model..., nhưng trang này không ghi Base URL và cảnh báo “Không cấu hình BYOK thủ công trong settings.json”.

Qoder CLI gây nhầm lẫn vì ghi chú phát hành và tài liệu của chính sản phẩm này không thống nhất. Ghi chú phát hành phiên bản 1.1.50 ngày 11 tháng 9 năm 2026 nêu “Người dùng phiên bản Personal hiện có thể cấu hình và quản lý tập trung các mô hình BYOK với endpoint URL tùy chỉnh từ trang Custom”, trong khi trang mô hình tùy chỉnh vẫn còn mô tả một danh mục: “các nhà cung cấp, mô hình và trường thông tin xác thực khả dụng được xác định bởi danh mục BYOK dành cho tài khoản hiện tại”. Cả hai trang đó và trang IDE đều giới hạn tính năng này cho gói Individual. Vì vậy, khi tab Custom không xuất hiện hoặc không có trường endpoint, hãy kiểm tra gói của tài khoản và nội dung danh mục cung cấp cho tài khoản đó — không phải tệp cấu hình, vì trang CLI hướng dẫn không chỉnh sửa tệp này bằng tay và tệp vốn được tạo lại từ danh mục.

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

Làm cách nào để thêm nhà cung cấp tùy chỉnh vào Qoder?

Trong ứng dụng Qoder dành cho máy tính để bàn chạy độc lập: mở Cài đặt Qoder, chọn Mô hình trong thanh điều hướng bên trái, nhấp + Thêm, rồi mở Nhà cung cấp và chọn “OpenAI Compatible” hoặc “Anthropic Compatible” trong mục Tùy chỉnh. Với loại OpenAI, bạn cũng chọn Chat Completions API hoặc Responses API. Nhập Base URL, Khóa API và ít nhất một ID mô hình; dùng Thêm ID mô hình để thêm các mô hình khác trên cùng endpoint; nhấp Tiếp theo để đặt Tên hiển thị, Các cửa sổ ngữ cảnh được hỗ trợ, Cửa sổ ngữ cảnh mặc định, Thị giác và Chế độ suy luận; sau đó nhấp Xác thực và thêm mô hình. Qoder xác thực kết nối trước khi lưu.

Base URL của Qoder có cần kết thúc bằng /v1 không?

Với endpoint tương thích OpenAI thì có. Trang mô hình tùy chỉnh của Qoder hướng dẫn nhập Base URL chính xác do dịch vụ mô hình cung cấp và đưa ra https://api.example.com/v1 làm định dạng ví dụ; vì vậy, trường này cần đường dẫn gốc /v1 thay vì origin trần — với Kunavo là https://api.kunavo.com/v1. Đối với kiểu Anthropic Compatible, trang không đưa ví dụ riêng và không nêu tuyến nào sẽ được nối thêm; tài liệu cũng không xác định trường hợp này, nên hãy thử đường dẫn gốc /v1 trước, rồi thử origin trần nếu việc kiểm tra tính hợp lệ thất bại.

Vì sao Qoder của tôi không có tab Custom hoặc trường Base URL?

Vì ba phiên bản Qoder có quy tắc BYOK khác nhau. Chỉ ứng dụng Qoder dành cho máy tính để bàn chạy độc lập có tài liệu hướng dẫn dùng Base URL tùy ý. Trang mô hình tùy chỉnh của Qoder IDE liệt kê các nhà cung cấp cụ thể nhưng không đề cập Base URL; trang của Qoder CLI cho biết nhà cung cấp, mô hình và trường thông tin xác thực khả dụng được xác định bởi danh mục BYOK dành cho tài khoản hiện tại. Trang IDE và CLI đều giới hạn tính năng này cho gói Individual. Nếu thiếu trường này, hãy kiểm tra bạn đang mở sản phẩm Qoder nào và gói cùng danh mục của tài khoản cho phép những gì — trang CLI đặc biệt cảnh báo không cấu hình BYOK thủ công trong settings.json.

Qoder có thể dùng mô hình Claude mà không cần tài khoản Anthropic không?

Có, thông qua nhà cung cấp tùy chỉnh — còn danh mục tích hợp sẵn của Qoder là chuyện khác. Trang bộ chọn mô hình của Qoder liệt kê các mô hình Qwen, DeepSeek, GLM, Kimi và MiniMax nhưng không nêu Claude, GPT hay Gemini; do đó, dùng khóa riêng là cách được tài liệu hướng dẫn để truy cập các mô hình này. “OpenAI Compatible” ở đây là lựa chọn giao thức truyền dữ liệu, không phải lựa chọn nhà cung cấp: ID mô hình bạn nhập sẽ được phân giải tại Base URL đã cấu hình. Vì vậy, ID Claude sẽ hoạt động miễn là endpoint cung cấp ID đó; thông tin xác thực bạn dùng thuộc về endpoint ấy, không phải Anthropic.

Mô hình tùy chỉnh trong Qoder có tiếp tục dùng Qoder Credits không?

Trang mô hình tùy chỉnh của Qoder nêu rằng phí dùng mô hình tùy chỉnh được tính trực tiếp vào tài khoản API của nhà cung cấp và không dùng Qoder Credits; ngoại lệ là Repo Wiki, vì tính năng này dùng một mô hình cố định và được tính phí riêng, kèm lời nhắc khi tạo. Phần Kunavo trong hóa đơn được tính theo từng token từ số dư trả trước, không có phí hàng tháng. Cũng lưu ý rằng thao tác Edit trên mô hình tùy chỉnh đã lưu trong Qoder chỉ cập nhật khóa API — muốn đổi Base URL, bạn cần xóa mục đó rồi thêm lại.

Kunavo đã kiểm tra thiết lập này bên trong Qoder chưa?

Chưa. Kunavo chưa chạy phiên nào trên bất kỳ phiên bản Qoder nào; trang này không phải báo cáo về khả năng tương thích khi chạy thực tế: tên trường và thứ tự của chúng được chép từ trang mô hình tùy chỉnh chính thức của Qoder vào ngày ghi bên dưới, còn thông tin về endpoint dựa trên API đã công bố của Kunavo. Bài kiểm tra cần thiết chạy trên máy của bạn — nút Xác thực và thêm mô hình của Qoder kiểm tra Base URL, khóa và ID mô hình cùng lúc trước khi lưu; lệnh curl thông thường dùng cùng Base URL và khóa sẽ giúp xác định lỗi nằm ở endpoint hay client.