Chuyển đến nội dung chính
OpenCode (GitHub) là một agent lập trình AI terminal mã nguồn mở hoạt động với nhiều provider.
Giao thức: tương thích OpenAI
  • Base URL: https://api.orcarouter.ai/v1 (có chứa /v1)
Các model suy luận của Claude qua giao thức OpenAI từ chối temperature != 1 (400 temperature may only be set to 1 when thinking is enabled). Hãy dùng một model không suy luận, hoặc bật reasoningEffort — xem Bật thinking.

Cài đặt

npm install -g opencode-ai

Cấu hình

Tệp cấu hình: ~/.config/opencode/opencode.json.
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "orcarouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OrcaRouter",
      "options": { "baseURL": "https://api.orcarouter.ai/v1", "apiKey": "sk-orca-..." },
      "models": { "orcarouter/auto": { "name": "OrcaRouter Auto" } }
    }
  },
  "model": "orcarouter/orcarouter/auto"
}
Thay vào một model cụ thể nếu bạn thích, ví dụ google/gemini-2.5-flash hoặc anthropic/claude-opus-4.8. ID model luôn dùng định dạng vendor/model.

Chạy

opencode run "Reply with exactly: OK"
Kết quả mong đợi: OK.

Ghi chú

  • Base URL phải chứa /v1.
  • Tham chiếu model dùng định dạng provider/model. Vì provider được đặt tên là orcarouter và ID model cũng mang một tiền tố vendor, nên tham chiếu có ba phân đoạn: orcarouter/orcarouter/auto (hoặc orcarouter/anthropic/claude-opus-4.8 cho một model cụ thể).
Tiện ích mở rộng VS Code: Tiện ích mở rộng VS Code chính thức của OpenCode (sst-dev.opencode) chạy CLI bên trong trình soạn thảo và dùng chung cùng một opencode.json — không có cài đặt endpoint riêng trong trình soạn thảo. Hãy cấu hình một lần như trên và tiện ích mở rộng sẽ tự nhận.

Bật suy luận / thinking

Đặt reasoningEffort trong options của model:
"models": {
  "anthropic/claude-sonnet-4.6": {
    "name": "Sonnet 4.6",
    "options": { "reasoningEffort": "high" }
  }
}
Bật reasoningEffort cũng giúp tránh cảnh báo temperature ở trên — khi thinking được bật, temperature = 1 là hợp lệ, nên lỗi 400 biến mất. Để điều khiển kiểu Anthropic-native, provider @ai-sdk/anthropic chấp nhận thinking: { type: "enabled", budgetTokens: N }.