OpenCode

OpenCode hỗ trợ provider tùy chỉnh, có thể kết nối đến dịch vụ Codex Proxy thông qua file cấu hình.

Chuẩn bịSao chép liên kết neo

Trang chủ OpenCode cung cấp script cài đặt chính thức, đồng thời có các cách cài npm, bun, brew...

• Nếu bạn dùng trực tiếp script cài đặt chính thức, thường không cần tự cấu hình npm trước
• Nếu bạn định cài qua npm, hãy cài Node.js và npm trước
• Nếu bạn định cài qua bun, thì cần cài bun trước

Cài Node.js (cách npm)Sao chép liên kết neo

Trang tải chính thức của Node.js là: https://nodejs.org/en/download

• macOS / Windows: tải và cài bản LTS
• Linux: cài theo cách của bản phân phối được hướng dẫn trên trang đó

Nếu trên macOS bạn đã cài Homebrew, cũng có thể chạy thẳng:

brew install node

Lệnh này cài đồng thời cả Node.js và npm.

Nên trước tiên xác nhận lệnh tương ứng khả dụng theo cách cài bạn chọn. Ví dụ với cách npm có thể kiểm tra trước:

node -v
npm -v

Lưu ý: Nếu bạn dùng môi trường dòng lệnh trên Windows, hiện trang chính thức khuyến nghị ưu tiên dùng trong WSL.

Cài đặtSao chép liên kết neo

Khuyến nghị dùng trực tiếp lệnh cài đặt do trang chủ OpenCode cung cấp:

curl -fsSL https://opencode.ai/install | bash

Trang chủ OpenCode đồng thời cung cấp các cách cài npm, bun, brew...

Thiết lập API KeySao chép liên kết neo

Dùng cách kết nối hoặc xác thực riêng của OpenCode:

opencode auth login

Hoặc chạy /connect trong giao diện tương tác, lưu dịch vụ này như một provider tùy chỉnh.

Nếu bạn quen dùng biến môi trường hơn, chỉ cần để opencode.json đọc tên biến chung chính thức, ví dụ:

export OPENAI_API_KEY="your_api_key_here"

Cấu hình opencode.jsonSao chép liên kết neo

Tạo opencode.json trong thư mục gốc của dự án hoặc thư mục cấu hình toàn cục:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aicentos": {
      "npm": "@ai-sdk/openai",
      "name": "aicentos",
      "options": {
        "baseURL": "https://aicentos.com/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-4o": {
          "name": "gpt-4o"
        }
      }
    }
  },
  "model": "aicentos/gpt-4o"
}

Kiểm traSao chép liên kết neo

Sau khi khởi động OpenCode, thực hiện:

/models

Thấy các mô hình dưới aicentos là được.

Lưu ýSao chép liên kết neo

• Thứ tự khuyến nghị: trước là cấu hình file thủ công (opencode.json), tiếp là biến môi trường, cuối cùng mới là công cụ cc-switch (https://github.com/farion1231/cc-switch/releases)
• Nếu bạn đi theo /v1/responses, tài liệu chính thức OpenCode khuyến nghị dùng @ai-sdk/openai
• Chỉ khi kết nối của bạn chỉ hỗ trợ /v1/chat/completions mới đổi sang @ai-sdk/openai-compatible
• Không cần định nghĩa thêm biến riêng của dự án như CODEX_PROXY_API_KEY

Liên kết liên quanSao chép liên kết neo

• Trang web chính thức: https://opencode.ai/