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

# OpenCode

> Cài OpenCode v2, đăng nhập nhà cung cấp model, chọn thiết lập trong CoClip và sửa các thông báo về phiên bản.

OpenCode là agent dòng lệnh mã nguồn mở, làm việc với nhà cung cấp model mà bạn chọn. Trong CoClip, OpenCode chạy trong một tab **OpenCode** của [AI dock](/docs/vi/ai-agents/ai-dock.md), kèm công cụ, skill và vai trò agent của CoClip cho riêng phiên đó.

## Phiên bản CoClip cần

CoClip cần OpenCode **v2**: từ **2.1.0** trở lên, dưới **3.0.0**.

* Với dòng v2, `opencode --version` in ra `opencode v2.x`.
* Dòng v1 cũ hơn dùng cùng lệnh `opencode` và bị từ chối. Hãy cài v2 để thay thế.

## Cài đặt và đăng nhập

CoClip không bao giờ cài hay cập nhật OpenCode. Lệnh cài do dự án OpenCode cung cấp; hãy xem [tài liệu OpenCode v2](https://opencode.ai/v2/docs) để có hướng dẫn mới nhất.

**1. Cài OpenCode v2**

> [tab] Windows
>
> Mở PowerShell và chạy:
>
> ```powershell theme={null}
> npm install -g @opencode/cli
> ```

> [tab] macOS
>
> Mở Terminal và chạy:
>
> ```bash theme={null}
> curl -fsSL https://opencode.ai/v2/install | bash
> ```

**2. Đăng nhập nhà cung cấp một lần**

Chạy `opencode` và đăng nhập nhà cung cấp model bạn muốn dùng. Thông tin đăng nhập nằm trên máy bạn.

**3. Mở tab OpenCode**

Trong CoClip, bấm **+** trong AI dock và chọn **OpenCode**.

## Chọn thiết lập

Mở **Settings** → **AI assistants** → **OpenCode**:

| Lựa chọn | OpenCode nạp những gì |
| - | - |
| **CoClip setup only (recommended)** | Chỉ công cụ, skill và agent của CoClip cho phiên đó. Giữ đăng nhập của bạn. Cấu hình OpenCode, MCP server, agent, plugin và skill cá nhân của bạn (kể cả `~/.agents/skills`) được tắt cho các phiên này. |
| **Use my own OpenCode setup** | Nạp thêm cấu hình riêng của bạn, kèm công cụ, skill và agent của CoClip chỉ cho phiên đó. |

Lựa chọn áp dụng cho phiên OpenCode tiếp theo mà AI dock mở. CoClip không bao giờ ghi vào cấu hình OpenCode của bạn.

## Thông báo và cách sửa

| Bạn thấy gì | Cách sửa |
| - | - |
| **OpenCode is not installed on this PC** (hoặc Mac) | Cài OpenCode v2 bằng lệnh cho hệ điều hành của bạn ở trên, chạy `opencode` một lần để đăng nhập nhà cung cấp, rồi bấm **Open OpenCode again**. |
| **This PC has OpenCode …, from the v1 line. CoClip needs OpenCode v2** | Cài OpenCode v2 bằng lệnh ở trên. Bản v2 thay cho lệnh `opencode` của v1. |
| **OpenCode … is too old for CoClip** | Cài bản OpenCode v2 mới nhất, rồi bấm **Open OpenCode again**. |
| **… which is newer than this version of CoClip knows** | OpenCode của bạn là bản 3.0.0 trở lên. Hãy cập nhật CoClip, hoặc cài lại OpenCode v2. |
| **CoClip could not read the OpenCode version** | Chạy `opencode --version` trong terminal. Nếu lệnh lỗi, hãy cài lại OpenCode v2. |
| **CoClip starts OpenCode's own opencode.exe, but only the npm launcher was found** (Windows) | Cài lại bằng `npm install -g @opencode/cli`, hoặc dùng liên kết **Standalone install** mà tab hiện ra và đặt `opencode.exe` vào một thư mục nằm trong PATH. |
| **OpenCode reads "\{env:" and "\{file:" in its settings…** | Đường dẫn thư mục dự án có chứa `{env:` hoặc `{file:`. Đổi tên hoặc chuyển thư mục để đường dẫn không còn hai chuỗi này, rồi mở lại tab. |
| **OpenCode support is incomplete in this build of CoClip** | Cài lại CoClip. Xem [Cài đặt](/docs/vi/get-started/install.md). |
| Đã cài mà vẫn không tìm thấy OpenCode | Khởi động lại CoClip. |
| **OpenCode 1 exited** | Bấm **Restart** để mở phiên mới, hoặc **Close** để đóng tab. |

## Trang liên quan

* [Dùng OpenCode bên ngoài editor](/docs/vi/ai-agents/outside-the-editor.md#opencode)
* [AI log và hoàn tác](/docs/vi/ai-agents/ai-log-and-undo.md)
* [Khắc phục sự cố](/docs/vi/reference/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.