Theia IDE

Một mục trong ai-features.openAiCustom.customOpenAiModels — model, url và apiKey — đưa Kunavo vào Theia Coder, Architect và tính năng hoàn thành nội tuyến.

{
  "ai-features.openAiCustom.customOpenAiModels": [
    {
      "model": "claude-sonnet-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-sonnet-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    },
    {
      "model": "claude-haiku-4-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-haiku-4-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    }
  ]
}

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. Bật tính năng này: tài liệu Theia hướng dẫn vào Preferences và bật cài đặt “AI-features => AI Enable”. Các nội dung bên dưới sẽ không xuất hiện cho đến khi bạn thực hiện bước này.
3. Mở chế độ xem AI Configuration — Alt+A, hoặc chọn AI Configuration trong menu Manage (biểu tượng bánh răng) ở góc dưới bên trái, ngay bên dưới Settings. Các danh mục gồm General, Providers & Models, Model Aliases, Agents, Prompts & Skills, Variables, Tools, Token Usage và MCP Servers.
4. Thêm các mục ở trên. Tài liệu mô tả thao tác này là nhấp vào liên kết trong phần cài đặt dành cho OpenAI Compatible Models — tùy chọn này là một danh sách có cấu trúc, và Theia lưu ý rằng các cài đặt có cấu trúc không có trình chỉnh sửa riêng sẽ “chuyển sang settings.json”, tức tệp bạn được chuyển đến. Mỗi model id là một đối tượng; lặp lại url và apiKey.
5. Gán cấu hình cho một mục. Trong Agents, mỗi agent có bộ chọn Language Model; nhiều agent thay vào đó phân giải một bí danh model, vì vậy việc đặt default/code, default/universal, default/code-completion, default/summarize và default/fast trong Model Aliases sẽ thay đổi cấu hình của nhiều agent cùng lúc.
6. Gửi tin nhắn trò chuyện cho Theia Coder, rồi yêu cầu thực hiện việc gì đó có liên quan đến một tệp. Các agent trong IDE này dựa vào lệnh gọi công cụ và nội dung trong workspace, vì vậy lần chạy đầu tiên có đọc hoặc chỉnh sửa thứ gì đó sẽ cho bạn biết nhiều hơn lời chào — và Token Usage trong cùng chế độ xem cho thấy lượt đó tiêu tốn bao nhiêu token.

Đã kiểm tra đối chiếu với trang tính năng AI của Theia IDE, mục OpenAI Compatible Models 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 Theia IDE.

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

Nhà cung cấp này được Theia tuyên bố hỗ trợ những gì

Bảng LLM Providers Overview trên trang riêng của Theia đánh giá từng nhà cung cấp theo ba tiêu chí. Đây là tuyên bố của Theia về Theia, được chép từ bảng đó vào ngày nêu trên — không phải kết quả thử nghiệm của Kunavo; cột có tiêu đề “Điều đó đòi hỏi gì từ model id” là phần duy nhất của bảng này được viết ở đây.

Hai đoạn phía trên bảng đó, Theia đưa ra lưu ý riêng đáng được nhắc lại vì đây là cách diễn đạt trung thực cho toàn bộ trang này: không phải model nào cũng “có thể hoạt động ngay mà không cần cấu hình, vì chúng có thể cần tùy chỉnh hoặc tối ưu hóa riêng”.

Chi phí thực sự phát sinh từ đâu

Theia IDE là mã nguồn mở và tải xuống miễn phí; các tính năng AI không tự phát sinh phí — chi phí đến từ các lệnh gọi model, do bên nắm giữ key trong apiKey tính phí. Hai cài đặt ảnh hưởng đến hóa đơn nhiều hơn cả lựa chọn model, và cả hai đều có trong tài liệu:

1. Automatic Code Completion được bật theo mặc định; tài liệu mô tả tính năng này là liên tục gửi “các yêu cầu đến LLM nền trong khi lập trình”. Đây là agent chạy hàng nghìn lần mỗi ngày. Gán default/code-completion cho một id giá rẻ, hoặc chuyển agent sang chế độ thủ công trong 'AIFeatures'=>'CodeCompletion' rồi kích hoạt bằng Ctrl+Alt+Space.
2. Max Context Lines, trong cùng nhóm cài đặt, giới hạn lượng nội dung xung quanh trong tệp được đưa vào mỗi yêu cầu hoàn thành. Mỗi dòng đều bị tính phí đầu vào trong mỗi lệnh gọi được kích hoạt bởi thao tác gõ phím.

Các agent trò chuyện có đặc điểm ngược lại: ít lệnh gọi hơn, ngữ cảnh lớn hơn nhiều, và cùng các tệp trong workspace được gửi lại qua mỗi lượt. Đây chính là trường hợp bộ nhớ đệm lời nhắc được thiết kế để xử lý — xem /docs/caching — và cũng là lý do hai nửa của bảng model phía trên được chia theo tần suất agent chạy, thay vì theo mức độ thông minh.

Khi không kết nối được

1. 404 — sai url. Kunavo cung cấp /v1/chat/completions, vì vậy trường này cần phần gốc /v1; chỉ dùng origin hoặc dùng cả .../chat/completions đều không đúng.
2. 401 — sai key. Readme của Theia cho biết apiKey “sẽ được gửi dưới dạng Bearer Token trong yêu cầu ủy quyền”, đúng như cách key sk-kn- yêu cầu. Lưu ý giá trị mặc định được tài liệu ghi rõ: nếu hoàn toàn không có apiKey, Theia sẽ gửi no-key, vì vậy trường bị bỏ trống trông giống như key bị từ chối chứ không phải key bị thiếu. (true nghĩa là “dùng OpenAI API key toàn cục” — không phải lựa chọn bạn cần ở đây.)
3. Model id không có trong danh sách chọn — danh sách đó lấy từ các mục customOpenAiModels của bạn, chứ không lấy từ endpoint, vì vậy id bị thiếu nghĩa là thiếu đối tượng. Trường id là nội dung giao diện hiển thị; nếu bỏ qua, tên model sẽ được dùng thay thế.
4. Thông điệp hệ thống đầu tiên bị từ chối hoặc bỏ qua — đó là do developerMessageSettings. Mặc định là developer, một vai trò theo định dạng OpenAI; ví dụ riêng của Theia dành cho nhà cung cấp không phải OpenAI đặt system, đó là lý do khối ở trên cũng làm như vậy. user, mergeWithFollowingUserMessage và skip là các lựa chọn thay thế được tài liệu nêu.
5. Không có phản hồi ở bất cứ đâu — hãy kiểm tra Workspace Trust. Theia yêu cầu xác nhận này cho mọi tính năng AI; workspace không đáng tin cậy sẽ vô hiệu hóa ô nhập trò chuyện và tính năng hoàn thành trực tiếp trong dòng, đồng thời hiển thị thông báo Các tính năng AI bị hạn chế.