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

> Dùng opencode.json để cấu hình OpenCode thành nhà cung cấp tương thích OpenAI, kết nối LLMoxy.

Trang web: [https://opencode.ai (nhấp để chuyển)](https://opencode.ai)

OpenCode là tác nhân mã nguồn mở cho terminal / trình soạn thảo. Nhà cung cấp tùy chỉnh dùng `@ai-sdk/openai-compatible`, đừng mượn tên nhà cung cấp tích hợp sẵn như `google`.

Trước khi bắt đầu, hãy chuẩn bị một [mã thông báo LLMoxy](https://vi.llmoxy.com/docs/get-started/get-token), nên dùng nhóm **auto**.

## Kết nối LLMoxy

Ghi vào thư mục gốc dự án hoặc `~/.config/opencode/opencode.json`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "llmoxy/grok-4.7",
  "provider": {
    "llmoxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LLMoxy",
      "options": {
        "baseURL": "https://llmoxy.com/v1",
        "apiKey": "API Key LLMoxy của bạn"
      },
      "models": {
        "grok-4.7": { "name": "Grok 4.7" },
        "claude-opus-5-5": { "name": "Claude Opus 5.5" }
      }
    }
  }
}
```

| Trường | Giải thích |
| --- | --- |
| `options.baseURL` | `https://llmoxy.com/v1`, không nối thêm `/chat/completions` |
| `options.apiKey` | Mã thông báo LLMoxy; cũng có thể đổi thành `{env:LLMOXY_API_KEY}` |
| key của `models` | Phải trùng khớp hoàn toàn với ID mô hình LLMoxy |
| `model` cấp cao nhất | `ID nhà cung cấp/ID mô hình`, ví dụ `llmoxy/grok-4.7` |

Sau khi khởi động OpenCode, dùng `/models` để chọn mô hình dưới `LLMoxy`.

> **💡 Mẹo**
> Nếu trước đó đã chạy `opencode auth login openai`, nhà cung cấp `openai` tích hợp sẵn có thể bị OAuth chiếm quyền. Nhà cung cấp tùy chỉnh hãy dùng ID riêng (như `llmoxy`), đừng dùng lại `openai`.

Đây là bản markdown của https://vi.llmoxy.com/docs/code-tutorials/opencode.
