# anomalyco/opencode: Trợ lý lập trình AI mã nguồn mở — hướng dẫn cài đặt và dùng

> anomalyco/opencode là coding agent AI mã nguồn mở viết bằng TypeScript, giúp bạn khám phá code, lập kế hoạch và thực hiện công việc phát triển phần mềm. Repo có CLI, ứng dụng desktop thử nghiệm và nhiều cách cài đặt; người dùng Windows có thể tải bản desktop.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-03 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/anomalyco-opencode-tro-ly-lap-trinh-ai

OpenCode là một coding agent AI mã nguồn mở, dùng để hỗ trợ bạn đọc, phân tích và phát triển phần mềm. Bạn có thể chạy OpenCode trong terminal hoặc dùng ứng dụng desktop thử nghiệm trên Windows, macOS và Linux.

Công cụ này phù hợp với lập trình viên mới muốn có trợ lý khi làm quen với một codebase, dev cần tìm kiếm nhiều bước trong dự án, hoặc nhóm muốn dùng một coding agent có mã nguồn mở và giấy phép MIT. Điểm đáng giá nhất là OpenCode có hai agent tích hợp sẵn: `build` để làm việc với đầy đủ quyền phát triển và `plan` để phân tích, khám phá code theo chế độ chỉ đọc.

```repo
- repo | anomalyco/opencode
- kind | Agent
- desc | OpenCode là coding agent AI mã nguồn mở, hỗ trợ đọc, phân tích và phát triển dự án ngay trong môi trường làm việc.
- stars | 227k
- lang | TypeScript
- license | MIT
```

## OpenCode làm được gì

### Hỗ trợ phát triển phần mềm

OpenCode là trợ lý AI dành cho công việc lập trình. Bạn có thể dùng nó khi cần tìm hiểu một dự án, phân tích cấu trúc code hoặc thực hiện công việc phát triển. Điều này hữu ích khi bạn mới nhận một codebase và chưa biết nên bắt đầu đọc từ đâu.

Agent `build` là agent mặc định và có đầy đủ quyền phục vụ công việc phát triển. Khi đã hiểu rõ yêu cầu, bạn có thể chuyển sang agent này để làm việc trực tiếp với dự án.

### Khám phá code theo chế độ chỉ đọc

Agent `plan` được thiết kế cho phân tích và khám phá code. Agent này mặc định từ chối chỉnh sửa file và hỏi quyền trước khi chạy lệnh bash.

Đây là lựa chọn phù hợp khi bạn muốn hỏi “dự án này xử lý luồng đăng nhập ở đâu?”, “thay đổi này có thể ảnh hưởng đến module nào?” hoặc “nên triển khai tính năng này theo hướng nào?” mà chưa muốn công cụ tự sửa code.

### Chuyển đổi agent nhanh

OpenCode cho phép chuyển giữa hai agent tích hợp bằng phím `Tab`. Bạn có thể bắt đầu ở `plan` để hiểu dự án, sau đó chuyển sang `build` khi đã sẵn sàng triển khai.

Cách làm này giúp tách hai giai đoạn thường bị trộn lẫn: suy nghĩ và thay đổi code. Với người mới, đây cũng là cách an toàn hơn để kiểm tra đề xuất trước khi cho agent thực hiện.

### Dùng subagent cho việc tìm kiếm phức tạp

OpenCode có thêm subagent `general` dành cho các tìm kiếm phức tạp và công việc nhiều bước. Bạn có thể gọi subagent này bằng `@general` trong tin nhắn.

Ví dụ, khi cần rà soát nhiều thư mục để tìm toàn bộ nơi một API được gọi, bạn có thể yêu cầu `@general` hỗ trợ tìm kiếm. README không mô tả chi tiết cú pháp prompt ngoài cách gọi này, nên phần yêu cầu cụ thể cần điều chỉnh theo kết quả OpenCode trả về.

### Chạy bằng terminal hoặc ứng dụng desktop

OpenCode có các lựa chọn cài đặt qua script, npm, Bun, pnpm, Yarn, Homebrew, Arch Linux, mise và Nix. Ngoài CLI, dự án còn có ứng dụng desktop đang ở trạng thái thử nghiệm.

Ứng dụng desktop có bản tải cho Windows, macOS và Linux. Người dùng văn phòng hoặc người không quen terminal có thể bắt đầu bằng bản Windows `.exe`; lập trình viên thích làm việc trong terminal có thể dùng CLI.

### Mã nguồn mở và có thể đóng góp

Repo dùng giấy phép MIT và có cấu trúc dành cho phát triển, đóng góp và xây dựng trên OpenCode. Nếu bạn muốn gửi pull request, README yêu cầu đọc tài liệu đóng góp trước.

Repo hiện có khoảng 226580 sao và 30675 fork. Dự án vẫn còn được cập nhật. Những con số này cho thấy OpenCode đang nhận được nhiều sự quan tâm, nhưng không thay thế cho việc kiểm tra tính phù hợp với quy trình và dữ liệu của bạn.

## Cần chuẩn bị gì

Bạn cần một máy tính có môi trường phù hợp với cách cài đã chọn. README ghi rõ các gói Homebrew hoạt động trên macOS và Linux, Arch Linux có gói riêng, còn Nix có thể chạy trực tiếp từ GitHub. README không nêu phiên bản Node.js, Python hay yêu cầu GPU cụ thể.

Nếu cài bằng npm, Bun, pnpm hoặc Yarn, bạn cần có trình quản lý gói tương ứng. README chỉ ghi tên các trình quản lý gói được hỗ trợ, không ghi phiên bản bắt buộc.

Nếu dùng Windows, README cung cấp ứng dụng desktop dạng `opencode-desktop-win-x64.exe`. Tư liệu không nói CLI cài trên Windows bằng script hoặc npm có được hỗ trợ theo cách nào, nên người dùng Windows nên ưu tiên bản desktop được cung cấp.

Nếu muốn chạy agent có khả năng đọc hoặc chỉnh sửa dự án, bạn cần mở OpenCode trong thư mục code cần làm việc. README không nêu yêu cầu tài khoản, API key, nhà cung cấp mô hình hoặc cấu hình chi phí. Vì vậy, không nên tự suy đoán các biến môi trường hay key cần thiết từ phần tư liệu này.

```note
OpenCode có agent build với đầy đủ quyền phát triển. Hãy bắt đầu bằng agent plan khi bạn chỉ muốn phân tích code, và kiểm tra quyền truy cập trước khi cho agent thực hiện thay đổi.
```

## Cài đặt từng bước

```steps
- Chọn cách cài | Chọn CLI, trình quản lý gói hoặc ứng dụng desktop phù hợp với hệ điều hành
- Cài OpenCode | Chạy đúng lệnh trong README hoặc tải ứng dụng desktop
- Mở dự án | Khởi động OpenCode trong thư mục code cần làm việc
- Chọn agent | Dùng plan để phân tích hoặc build để phát triển
- Kiểm tra hoạt động | Gửi yêu cầu đọc code và kiểm tra phản hồi
```

### Chọn cách cài phù hợp

Nếu bạn dùng macOS hoặc Linux và muốn làm việc trong terminal, README khuyến nghị Homebrew với lệnh `brew install anomalyco/tap/opencode-v2`. Nếu muốn dùng npm, lệnh được README cung cấp là `npm i -g @opencode/cli@latest`.

README cũng ghi các lựa chọn khác. Bạn chỉ nên chọn lệnh tương ứng với công cụ đã có trên máy. Không cần cài tất cả các cách cùng lúc.

### Cài CLI bằng script hoặc trình quản lý gói

Với cách cài bằng script, mở terminal rồi chạy đúng lệnh sau:

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

Lệnh này tải script cài đặt từ địa chỉ của OpenCode và chạy bằng Bash. Cách này phù hợp với môi trường có `curl` và `bash`. README cho biết script cài OpenCode vào `$HOME/.opencode/bin`.

Bạn cũng có thể cài bằng npm:

```bash
npm i -g @opencode/cli@latest
```

Lệnh `-g` cài gói ở phạm vi toàn cục để lệnh OpenCode có thể được gọi từ terminal. README ghi thêm có thể dùng Bun, pnpm hoặc Yarn, nhưng không đưa lệnh cụ thể cho từng công cụ.

Trên macOS hoặc Linux, cách được README khuyến nghị là:

```bash
brew install anomalyco/tap/opencode-v2
```

README cũng cung cấp công thức Homebrew chính thức, nhưng được cập nhật chậm hơn:

```bash
brew install opencode
```

Các lựa chọn khác được ghi trong README gồm:

```bash
sudo pacman -S opencode
paru -S opencode-beta
mise use -g opencode
nix run github:anomalyco/opencode
```

`sudo pacman -S opencode` dành cho Arch Linux bản ổn định. `paru -S opencode-beta` cài bản mới nhất từ AUR. `mise use -g opencode` dùng mise trên bất kỳ hệ điều hành nào theo tư liệu. `nix run github:anomalyco/opencode` dùng Nix để chạy OpenCode.

README có lưu ý phải gỡ các phiên bản cũ hơn `0.1.x` trước khi cài. Tư liệu không đưa lệnh gỡ cụ thể, nên bạn cần dùng cách gỡ tương ứng với phương thức đã cài trước đó.

### Cài ứng dụng desktop trên Windows

OpenCode có ứng dụng desktop đang ở trạng thái thử nghiệm. Bản dành cho Windows là file `opencode-desktop-win-x64.exe`. README chỉ đường dẫn trang tải là `opencode.ai/download`, nhưng không mô tả thêm các bước cài trong Windows.

Sau khi tải file, mở file `.exe` và làm theo trình cài đặt hiển thị trên màn hình. Đây là cách phù hợp nhất nếu bạn đang dùng Windows và muốn bắt đầu bằng giao diện desktop. README không nêu yêu cầu phần cứng, tài khoản hay API key cho bản desktop.

Trên macOS, README có thêm lệnh cài desktop bằng Homebrew:

```bash
brew install --cask opencode-desktop
```

README không cung cấp lệnh tương đương cho Windows hoặc Linux.

### Mở OpenCode trong dự án

Sau khi cài CLI, mở terminal tại thư mục dự án bạn muốn làm việc. Nếu bạn cần lấy một repo GitHub để thử, có thể dùng lệnh phổ thông sau, rồi thay đường dẫn thư mục theo repo của bạn:

```bash
git clone https://github.com/<repo>.git
cd <repo>
```

`git clone` tải mã nguồn về máy. `cd` chuyển terminal vào thư mục dự án. Phần `<repo>` là chỗ giữ nguyên tên repo GitHub bạn muốn lấy; README của OpenCode không đưa một repo mẫu cụ thể.

README không ghi lệnh khởi động CLI cụ thể trong phần được cung cấp. Vì vậy, không nên tự thêm một lệnh chạy OpenCode mà chưa được tư liệu xác nhận. Nếu lệnh cài đặt không tạo lệnh sử dụng được, hãy kiểm tra tài liệu trong repo và phần tài liệu cấu hình mà README hướng tới.

### Chọn agent trước khi làm việc

Khi OpenCode đã mở, dùng phím `Tab` để chuyển giữa hai agent tích hợp. Chọn `plan` nếu bạn muốn phân tích và khám phá code. Chọn `build` khi bạn muốn thực hiện công việc phát triển.

Agent `plan` từ chối chỉnh sửa file theo mặc định và hỏi quyền trước khi chạy bash. Đây là hành vi có chủ đích, không phải lỗi cài đặt. Agent `build` là agent mặc định và có đầy đủ quyền phát triển, vì vậy hãy đọc kỹ yêu cầu trước khi xác nhận các thao tác thay đổi.

## Kiểm tra đã chạy được chưa

Cách kiểm tra thực tế là mở OpenCode trong một dự án và gửi yêu cầu phân tích đơn giản khi đang dùng agent `plan`. Ví dụ, bạn có thể yêu cầu công cụ mô tả cấu trúc dự án hoặc tìm file chứa một chức năng. Kết quả mong đợi là OpenCode đọc code và trả lời phân tích mà không tự sửa file.

Tiếp theo, nhấn `Tab` để chuyển sang agent `build`. Việc chuyển agent thành công cho thấy hai agent tích hợp đang sẵn sàng. Khi dùng `build`, hãy kiểm tra kỹ các quyền và yêu cầu xác nhận trước khi cho phép công cụ thực hiện thay đổi.

Nếu bạn cài bằng script, README cho biết thư mục cài đặt là `$HOME/.opencode/bin`. Nếu terminal không nhận diện OpenCode, hãy kiểm tra thư mục này có nằm trong PATH hay chưa. README không cung cấp lệnh cập nhật PATH cụ thể.

Nếu dùng desktop trên Windows, màn hình ứng dụng mở được và cho phép bạn chọn hoặc mở dự án là dấu hiệu cài đặt ban đầu thành công. README không mô tả màn hình kiểm tra cụ thể hoặc kết quả phiên bản cần đối chiếu.

## Dùng vào việc thật

### Chủ shop cần sửa nhanh trang quản trị

Một chủ shop có dự án quản lý đơn hàng nhưng không biết phần danh sách đơn nằm ở đâu. Bạn mở dự án trong OpenCode, chọn agent `plan`, rồi yêu cầu:

```text
Hãy tìm phần hiển thị danh sách đơn hàng, mô tả các file liên quan và giải thích dữ liệu đi từ đâu đến giao diện.
```

OpenCode có thể hỗ trợ khám phá code và trả về phân tích. Bạn giữ nguyên file trong lúc khảo sát, sau đó mới chuyển sang `build` nếu muốn bắt đầu thay đổi.

### Nhân viên văn phòng muốn hiểu một công cụ nội bộ

Một nhân viên không chuyên lập trình được giao kiểm tra một dự án nội bộ. Họ có thể dùng agent `plan` để hỏi các câu ngắn như:

```text
Hãy giải thích cấu trúc dự án này bằng ngôn ngữ dễ hiểu và chỉ ra file chính của mỗi phần.
```

Cách này giúp người mới có bản đồ ban đầu của dự án trước khi nhờ lập trình viên xử lý. Vì `plan` là chế độ chỉ đọc theo mặc định, nó phù hợp cho giai đoạn tìm hiểu.

### Dev mới nhận codebase lớn

Một dev mới vào nhóm cần tìm toàn bộ nơi gọi một hàm hoặc API. Có thể gọi subagent `general` trong yêu cầu:

```text
@general Hãy tìm tất cả nơi trong dự án gọi API đăng nhập và nhóm kết quả theo từng chức năng.
```

README xác nhận `general` dành cho tìm kiếm phức tạp và công việc nhiều bước. Kết quả cụ thể còn phụ thuộc vào codebase và yêu cầu bạn đưa ra.

### Dev muốn lập kế hoạch trước khi sửa

Khi nhận một yêu cầu tính năng, bạn có thể bắt đầu bằng `plan`:

```text
Hãy phân tích cách thêm tính năng xuất báo cáo, chỉ ra các module có thể phải thay đổi và đề xuất thứ tự thực hiện. Chưa chỉnh sửa file.
```

Sau khi xem kế hoạch, nhấn `Tab` để chuyển sang `build` và tiếp tục công việc phát triển nếu thấy phù hợp. Cách này tạo một điểm kiểm tra rõ ràng trước khi agent có quyền thay đổi dự án.

> Công việc tốt với coding agent bắt đầu từ việc hiểu code, rồi mới cho phép thay đổi.
>
> — Ông T

## Lỗi hay gặp và cách xử lý

### Terminal không tìm thấy OpenCode sau khi cài

Nếu dùng script, README cho biết OpenCode được cài vào `$HOME/.opencode/bin`. Terminal có thể chưa nhận thư mục này trong PATH. Hãy kiểm tra lại thư mục cài đặt và tài liệu cấu hình của dự án; README được cung cấp chưa ghi lệnh sửa PATH cụ thể.

### Cài đè lên phiên bản quá cũ

README yêu cầu gỡ các phiên bản cũ hơn `0.1.x` trước khi cài. Nếu bạn từng cài OpenCode, hãy xác định phương thức cài cũ rồi gỡ phiên bản đó bằng công cụ tương ứng trước khi chạy lệnh cài mới.

### Dùng sai lệnh theo hệ điều hành

Các lệnh Homebrew trong README dành cho macOS và Linux. Lệnh `sudo pacman` và `paru` dành cho Arch Linux. Không nên chạy các lệnh này trên Windows. Với Windows, hãy dùng bản desktop `opencode-desktop-win-x64.exe` được README cung cấp.

### Agent plan không sửa file

Đây là hành vi đúng thiết kế. Agent `plan` từ chối chỉnh sửa file theo mặc định vì nó dành cho phân tích và khám phá code. Nếu cần thực hiện công việc phát triển, chuyển sang agent `build` bằng phím `Tab` sau khi đã kiểm tra kế hoạch.

### Agent yêu cầu quyền trước khi chạy lệnh

Agent `plan` hỏi quyền trước khi chạy bash. Hãy đọc lệnh và xác nhận chỉ khi bạn hiểu tác động của nó. Nếu chỉ muốn phân tích tĩnh, có thể tiếp tục yêu cầu agent tập trung vào việc đọc và giải thích code.

## Có nên dùng không

OpenCode đáng thử nếu bạn cần một coding agent mã nguồn mở, muốn có chế độ lập kế hoạch chỉ đọc, hoặc muốn dùng cả CLI và desktop. Repo có giấy phép MIT, nhiều lựa chọn cài đặt, agent `build`, agent `plan` và subagent `general` cho tìm kiếm nhiều bước.

Công cụ đặc biệt phù hợp với dev mới nhận dự án vì có thể bắt đầu bằng việc khám phá code trước. Người dùng Windows cũng có lựa chọn desktop riêng, còn người dùng macOS và Linux có nhiều phương án cài CLI.

Giới hạn chính của tư liệu là README không nêu phiên bản Node.js, yêu cầu API key, nhà cung cấp mô hình, chi phí sử dụng, cấu hình bảo mật chi tiết hoặc lệnh khởi động CLI cụ thể. README cũng đánh dấu desktop là bản thử nghiệm. Bạn nên kiểm tra tài liệu cấu hình trong repo và tài liệu OpenCode trước khi đưa code nhạy cảm hoặc cấp quyền rộng cho agent.

Nếu bạn chỉ cần một trình soạn thảo code thông thường, không muốn agent đọc hoặc thay đổi file, hoặc cần một quy trình đã có yêu cầu triển khai và bảo mật rất cụ thể, hãy cân nhắc cách khác. OpenCode phù hợp nhất khi bạn muốn trợ lý AI tham gia vào việc hiểu và phát triển code, đồng thời vẫn có thể bắt đầu bằng chế độ chỉ đọc.

## Câu hỏi thường gặp

### OpenCode có miễn phí không?

README được cung cấp không nêu giá, gói miễn phí hay chi phí sử dụng. Repo dùng giấy phép MIT, nhưng điều đó không đủ để kết luận mọi dịch vụ hoặc mô hình liên quan đều miễn phí.

### Windows có chạy được OpenCode không?

Có bản ứng dụng desktop cho Windows với file `opencode-desktop-win-x64.exe`. README không mô tả cách cài CLI trên Windows bằng script hoặc npm, nên bản desktop là lựa chọn được tư liệu nêu rõ.

### Có cần GPU không?

README không nêu yêu cầu GPU. Tư liệu cũng không đưa yêu cầu phần cứng cụ thể nào khác.

### Có cần API key hoặc tài khoản không?

README được cung cấp không nói về tài khoản, API key hay biến môi trường cần thiết. Vì vậy chưa có đủ thông tin để khẳng định có hoặc không.

### Agent plan và build khác nhau thế nào?

`build` là agent mặc định, có đầy đủ quyền cho công việc phát triển. `plan` dành cho phân tích và khám phá code, mặc định từ chối sửa file và hỏi quyền trước khi chạy bash.

### OpenCode có chỉnh sửa code tự động không?

Agent `build` có đầy đủ quyền phát triển nên được thiết kế cho công việc có thể bao gồm thay đổi code. Agent `plan` thì từ chối chỉnh sửa file theo mặc định, phù hợp để kiểm tra trước.

### OpenCode có bản desktop không?

Có. Desktop app đang ở trạng thái thử nghiệm và có bản cho macOS Apple Silicon, macOS Intel, Windows và Linux; README cũng ghi lệnh Homebrew để cài bản desktop trên macOS.
