> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode

> Cấu hình 4096bytes trong OpenCode

OpenCode có thể kết nối với 4096bytes thông qua Provider tương thích OpenAI. Hãy ghi cấu hình `opencode.json` do bảng điều khiển tạo vào tệp cấu hình OpenCode.

Nên sao chép cấu hình từ hộp thoại **Use key** trong bảng điều khiển. Tab OpenCode sẽ chèn API Key, Base URL và tên mô hình hiện tại theo định dạng OpenCode.

## Điều kiện trước

* Bạn đã hoàn thành [Tạo tài khoản](/vi/quickstart/create-account).
* Bạn đã hoàn thành [Lấy API Key](/vi/quickstart/get-api-key).
* OpenCode đã được cài và `opencode --version` chạy được.
* Hộp thoại **Use key** đã mở cho API Key bạn muốn dùng.

<Warning>
  API Key trong `opencode.json` được lưu cục bộ dạng văn bản rõ. Không đưa tệp cấu hình, ảnh chụp hoặc đầu ra terminal có chứa API Key đầy đủ vào repository hoặc cuộc trò chuyện.
</Warning>

## Cài đặt

Nếu chưa cài OpenCode, xem hướng dẫn mới nhất trong [tài liệu OpenCode](https://opencode.ai/docs).

macOS hoặc Linux:

```bash theme={null}
curl -fsSL https://opencode.ai/install | bash
```

Nếu bạn dùng npm để quản lý CLI toàn cục:

```bash theme={null}
npm install -g opencode-ai
```

Sau khi cài, mở lại terminal và kiểm tra:

```bash theme={null}
opencode --version
```

## Sao chép cấu hình từ bảng điều khiển

<Steps>
  <Step title="Mở API Keys">
    Mở bảng điều khiển và vào **API Keys**.
  </Step>

  <Step title="Chọn OpenCode">
    Tìm key muốn dùng cho OpenCode, nhấn **Use key**, rồi chọn **OpenCode**.
  </Step>

  <Step title="Sao chép cấu hình">
    Sao chép nội dung `opencode.json` được tạo. Ví dụ chỉ để tham khảo. Hãy dùng Base URL, API Key và tên mô hình được hiển thị trong bảng điều khiển của bạn.
  </Step>

  <Step title="Ghi tệp cấu hình">
    Để dùng toàn cục, ghi vào `~/.config/opencode/opencode.json`. Để chỉ dùng trong dự án, ghi `opencode.json` ở thư mục gốc của dự án.
  </Step>
</Steps>

## Đường dẫn cấu hình

| Phạm vi           | Đường dẫn                          | Khi dùng                                    |
| ----------------- | ---------------------------------- | ------------------------------------------- |
| Cấu hình toàn cục | `~/.config/opencode/opencode.json` | Dùng 4096bytes mặc định trong mọi dự án.    |
| Cấu hình dự án    | `opencode.json`                    | Chỉ dùng cấu hình này trong dự án hiện tại. |

Nếu tệp chưa tồn tại, hãy tạo thủ công. Cấu hình dự án có độ ưu tiên cao hơn cấu hình toàn cục.

## Kiểm tra

Lưu cấu hình, vào thư mục một dự án và chạy:

```bash theme={null}
opencode
```

Sau khi OpenCode mở, hãy bắt đầu bằng một yêu cầu rủi ro thấp:

```text theme={null}
Mô tả mục đích của thư mục hiện tại trong một câu. Không sửa tệp.
```

Nếu OpenCode phản hồi mà không báo lỗi xác thực hoặc lỗi mô hình, cấu hình đã có hiệu lực.

## Vấn đề thường gặp

<AccordionGroup>
  <Accordion title="OpenCode báo lỗi xác thực">
    Kiểm tra `opencode.json` là JSON hợp lệ. Xác nhận `apiKey` không thiếu ký tự, không có xuống dòng hoặc khoảng trắng thừa.
  </Accordion>

  <Accordion title="OpenCode không tìm thấy mô hình">
    ID mô hình phải khớp với tên được hiển thị trong bảng điều khiển. Không sao chép từ ảnh của người khác.
  </Accordion>

  <Accordion title="Cấu hình không có hiệu lực">
    Xác nhận bạn đã sửa đúng tệp mà OpenCode đang đọc. `opencode.json` ở thư mục gốc dự án sẽ ghi đè các trường tương ứng trong cấu hình toàn cục.
  </Accordion>

  <Accordion title="Có thể cấu hình API Key bằng /connect không?">
    Có, nhưng `/connect` chỉ lưu thông tin xác thực. Provider, Base URL và danh sách mô hình vẫn nên lấy từ `opencode.json` do bảng điều khiển tạo.
  </Accordion>
</AccordionGroup>