← Tài liệu

Kết nối OpenCode với LaRouter

Dùng một API key LaRouter cho các tài khoản được cấu hình. Mỗi tài khoản giữ hạn mức riêng.

Cách 1: Dùng nút Cấu hình

Đăng nhập, chọn tệp cấu hình trên máy rồi bấm Áp dụng LaRouter. Công cụ tự điền API key và model, sau đó ghi ngay vào tệp. Nút Đặt lại thiết lập mặc định cũng ghi trực tiếp. Nếu trình duyệt không hỗ trợ, hãy cấu hình thủ công.

Xem hướng dẫn thủ công

Vị trí tệp cấu hình

macOS
~/.config/opencode/opencode.json
Linux
~/.config/opencode/opencode.json
Windows
%USERPROFILE%\.config\opencode\opencode.json

Đây là đường dẫn mặc định. Nếu chạy công cụ trong WSL, dùng đường dẫn Linux bên trong WSL. Nếu đã đổi thư mục cấu hình, chọn tệp thực tế của công cụ. Trình duyệt chỉ đọc hoặc ghi tệp bạn chọn.

Cách 2: Cấu hình thủ công

Sao lưu tệp rồi thay các giá trị mẫu theo hướng dẫn. Riêng Codex đã có sẵn model gpt-5.6-sol. Tên model không dùng tiền tố định tuyến như cx/. Giữ phần định danh nhà cung cấp mà công cụ yêu cầu, chẳng hạn larouter/ nếu có trong mẫu, và giữ nguyên các thiết lập khác.

Trước khi bắt đầu

Lấy API key trên trang quản lý và kiểm tra đã có ít nhất một tài khoản được kết nối. Các ví dụ dùng Bash hoặc zsh trên macOS/Linux. Thay YOUR_API_KEY bằng API key của bạn, gọi /models rồi chọn ID model mà tài khoản hỗ trợ để thay YOUR_MODEL_ID.

Biến môi trường
export LAROUTER_API_KEY="YOUR_API_KEY"
Model có thể sử dụng
curl https://i-larouter.lapage.vn/v1/models \
  -H "Authorization: Bearer $LAROUTER_API_KEY"

Cấu hình thủ công

Cài công cụ, sao lưu tệp cấu hình rồi thêm các thiết lập dưới đây vào tệp. Thay YOUR_API_KEY và YOUR_MODEL_ID bằng thông tin của bạn. Giữ nguyên những thiết lập khác trong tệp.

~/.config/opencode/opencode.json
{
  "model": "larouter/YOUR_MODEL_ID",
  "provider": {
    "larouter": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://i-larouter.lapage.vn/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}
Mở công cụ
opencode

OpenCode dùng nhà cung cấp larouter và @ai-sdk/openai-compatible. Model được chọn theo dạng larouter/YOUR_MODEL_ID. Công cụ cấu hình chỉ sửa JSON thuần; nếu bạn dùng opencode.jsonc, hợp nhất ví dụ thủ công để giữ chú thích.

OpenCode | Hướng dẫn cấu hình LaRouter