# OpenCode

Nguồn: https://docs.aicentos.com/vi/clients/opencode

Language: vi

> Dùng aicentos trong OpenCode —— kết nối provider tùy chỉnh qua file cấu hình

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ị

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)

Trang tải chính thức của Node.js là: [https://nodejs.org/en/download](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:

```bash
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:

```bash
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 đặt

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

```bash
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 Key

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

```bash
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ụ:

```bash
export OPENAI_API_KEY="your_api_key_here"
```

## Cấu hình opencode.json

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:

```json
{
  "$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 tra

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 ý

* 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](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 quan

* Trang web chính thức: [https://opencode.ai/](https://opencode.ai/)