Hướng dẫn cài đặt OpenCode

Tổng quan

OpenCode đọc danh sách nhà cung cấp từ một tệp cấu hình JSON. Thêm UnoRouter làm nhà cung cấp tùy chỉnh với bộ chuyển đổi tương thích OpenAI, sau đó bạn có thể chọn bất kỳ mô hình UnoRouter nào làm mô hình đang hoạt động.

Cấu hình nhanh

Dán các giá trị này vào ứng dụng. Khoá của bạn sẽ tự điền khi bạn đã đăng nhập.

URL cơ sở: https://api.unorouter.com/v1
Khoá API: YOUR_API_KEY

Tương thích

Thiết lập từng bước

1. 1
   Mở tệp cấu hình OpenCode

   Nhấn Ctrl + O trong OpenCode và dán đường dẫn. Trên Windows, thay YOUR_USER bằng tên người dùng Windows của bạn.

   text

   C:/Users/YOUR_USER/.config/opencode/opencode.json

   Đăng nhập để tự động điền API key

2. 2
   Thay thế nội dung tệp

   Xoá sạch tệp và dán khối nhà cung cấp UnoRouter. Điền khoá API UnoRouter của bạn và chọn bất kỳ mô hình nào từ danh mục.

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "unorouter": {
         "name": "UnoRouter",
         "npm": "@ai-sdk/openai-compatible",
         "discoverModels": true,
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.unorouter.com/v1"
         }
       }
     }
   }

   Đăng nhập để tự động điền API key

3. 3
   Lưu và tải lại

   Nhấn Ctrl + S để lưu, sau đó Ctrl + Shift + P và chạy lệnh Developer: Reload Window. OpenCode sẽ nhận nhà cung cấp mới khi tải lại.

4. 4
   Chọn một mô hình

   Mở trình chọn mô hình trong OpenCode và chuyển sang mô hình bạn đã thêm. Bộ chuyển đổi tương thích OpenAI tự động xử lý truyền phát và gọi công cụ.

Mô hình đề xuất

Các mô hình miễn phí hoạt động tốt ở đây. Dán bất kỳ id mô hình nào vào ứng dụng.

Lưu ý

• !Với "discoverModels": true, OpenCode tự động tải toàn bộ danh mục UnoRouter từ /v1/models khi khởi động, nên mọi mô hình (kể cả mô hình mới) đều xuất hiện trong bộ chọn mà không cần liệt kê thủ công.
• !Nếu Developer: Reload Window không hiển thị nhà cung cấp của bạn, hãy kiểm tra lại rằng JSON đã được lưu mà không có dấu phẩy ở cuối.
• !Sử dụng đúng ID mô hình từ danh mục UnoRouter. Xoá tiền tố nhà cung cấp ở đầu nếu thao tác sao chép đã thêm vào.
• !Trên OpenCode cũ không có tự động phát hiện, hãy thêm khối "models" liệt kê đúng các id bạn cần (ví dụ {"gemini-3.1-flash-lite": {}}) rồi khởi động lại.