# Hướng dẫn cài đặt OpenCode trên Ubuntu

Bài viết này hướng dẫn cách cài đặt **OpenCode** trên hệ điều hành **Ubuntu** để sử dụng AI coding agent trực tiếp trong terminal.

OpenCode là một **AI coding agent mã nguồn mở** giúp bạn:

* Viết và chỉnh sửa code bằng AI
* Phân tích project code
* Chạy lệnh terminal tự động
* Tích hợp nhiều nhà cung cấp LLM

Dự án được phát triển và công khai trên **OpenCode**.

***

## 1. Yêu cầu hệ thống

Trước khi cài đặt cần đảm bảo:

* Ubuntu **20.04 trở lên**
* Terminal hiện đại (Kitty, Alacritty, WezTerm…)
* Internet
* API key của các nhà cung cấp LLM (OpenAI, Anthropic, v.v.)

***

## 2. Cài đặt nhanh (khuyến nghị)

Cách đơn giản nhất để cài OpenCode là dùng **install script chính thức**.

Chạy lệnh:

```
curl -fsSL https://opencode.ai/install | bash
```

Script sẽ:

* tải binary mới nhất
* cài vào thư mục người dùng
* tự thêm vào PATH

Phương pháp này hoạt động trên **Linux, macOS và WSL**.

***

## 3. Kiểm tra cài đặt

Sau khi cài xong, kiểm tra:

```
opencode --version
```

Hoặc:

```
opencode
```

Nếu giao diện terminal của OpenCode xuất hiện nghĩa là cài đặt thành công.

***

## 4. Cài đặt bằng Node.js (tuỳ chọn)

Nếu máy bạn đã có **Node.js**, có thể cài bằng npm:

```
npm install -g opencode-ai
```

Ngoài npm còn hỗ trợ:

```
pnpm install -g opencode-ai
yarn global add opencode-ai
bun install -g opencode-ai
```

Các package manager này đều cài **OpenCode CLI toàn cục**.

***

## 5. Cài đặt bằng Homebrew (Linux)

Nếu sử dụng **Homebrew trên Linux**:

```
brew install anomalyco/tap/opencode
```

Repository này thường có **phiên bản mới nhất** của OpenCode.

***

## 6. Chạy OpenCode

Sau khi cài đặt:

```
opencode
```

OpenCode sẽ mở **TUI (Terminal UI)** để bạn chat với AI và làm việc với project code.

Ví dụ:

```
Explain this repository
Refactor this code
Create a Dockerfile
```

***

## 7. Các agent trong OpenCode

OpenCode có sẵn **2 agent chính**:

#### build

* Agent mặc định
* Có quyền chỉnh sửa file
* Chạy lệnh bash

#### plan

* Agent chỉ đọc
* Phân tích code
* Không sửa file nếu chưa được phép

Bạn có thể chuyển agent bằng phím:

```
Tab
```

***

## 8. Một số lệnh CLI hữu ích

#### Xem provider đã đăng nhập

```
opencode auth list
```

#### Đăng xuất provider

```
opencode auth logout
```

#### Chạy web interface

```
opencode web
```

Lệnh này sẽ mở **OpenCode web UI** trên trình duyệt.

***

## 9. Gỡ cài đặt OpenCode

Để gỡ OpenCode:

```
opencode uninstall
```

Lệnh này sẽ xóa binary và các file cấu hình liên quan.

***

## 10. Mẹo sử dụng OpenCode

OpenCode hoạt động rất tốt với:

* Git repository
* Docker project
* DevOps script
* Backend development

Ví dụ prompt hiệu quả:

```
Explain this project structure
Fix this Python error
Create a Dockerfile for this app
Write unit tests
```

***

✅ Sau khi cài xong, bạn có thể sử dụng **OpenCode trực tiếp trong terminal để viết code bằng AI**, tương tự như Claude Code hoặc Cursor CLI.

{% code title="Tài liệu tham khảo" overflow="wrap" lineNumbers="true" %}

```markdown
- https://opencode.ai/
- https://github.com/anomalyco/opencode
- https://opencode.ai/docs
```

{% endcode %}