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.

Tài liệu tham khảo

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