Bỏ qua tới nội dung
Ông T.vn

opencode: trợ lý lập trình AI mã nguồn mở chạy ngay trong terminal — hướng dẫn cài đặt và dùng

10 phút đọcCập nhật

Bài này là một góc nhìn khác về anomalyco/opencode — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: opencode: trợ lý lập trình AI mã nguồn mở chạy trong terminal — hướng dẫn cài đặt và dùng →

opencode: trợ lý lập trình AI mã nguồn mở chạy ngay trong terminal — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

OpenCode (repo anomalyco/opencode) là một coding agent AI mã nguồn mở, giấy phép MIT, viết bằng TypeScript. Nó giúp bạn đọc hiểu, phân tích và sửa code bằng ngôn ngữ tự nhiên. Cài khá dễ: một dòng curl, một lệnh npm/brew, hoặc tải app desktop bản beta.

OpenCode là một coding agent AI mã nguồn mở: một trợ lý đọc, hiểu và sửa code theo yêu cầu bạn gõ bằng ngôn ngữ thường. Tác giả mô tả ngắn gọn repo là "the open source coding agent". Repo hiện có khoảng 226.506 sao và 30.658 fork, giấy phép MIT, viết chủ yếu bằng TypeScript, và vẫn được cập nhật trong vài tháng gần đây.

Nếu bạn là lập trình viên mới, OpenCode giúp bạn khám phá một dự án lạ mà không sợ lỡ tay làm hỏng file. Nếu làm kinh doanh hoặc văn phòng và đôi khi phải chỉnh một đoạn code, một file cấu hình hay một script nhỏ, bạn có thể nhờ nó giải thích và sửa thay mình.

Điểm đáng giá nhất là hai chế độ làm việc tách bạch. Chế độ build có toàn quyền để làm việc. Chế độ plan chỉ đọc, mặc định không cho sửa file. Bạn đổi giữa hai chế độ bằng phím Tab, nên có thể xem kỹ trước rồi mới cho phép sửa.

Agent

anomalyco/opencode

OpenCode là agent lập trình AI mã nguồn mở: có chế độ build để sửa code và chế độ plan chỉ đọc để phân tích dự án. Cài bằng một dòng lệnh hoặc app desktop.

★ 227kTypeScriptMIT
Xem repo trên GitHub

I.OpenCode làm được gì

A.Hai agent có sẵn, đổi bằng phím Tab

OpenCode có hai agent dựng sẵn. Bạn chuyển qua lại bằng phím Tab.

  • buildagent mặc định, toàn quyền, dùng cho việc phát triển thật. Bạn nhờ viết tính năng, sửa lỗi, đổi code thì chọn chế độ này.
  • planagent chỉ đọc, dùng để phân tích và khám phá code. Mặc định nó từ chối sửa file. Nó cũng hỏi quyền bạn trước khi chạy lệnh bash.

Lợi ích thực tế: khi nhận một dự án chưa quen, bạn bật plan để nhờ nó giải thích cấu trúc hoặc lập kế hoạch thay đổi. Chế độ này không tự sửa gì, nên bạn yên tâm hơn.

B.Subagent general cho việc tìm kiếm phức tạp

Ngoài hai agent trên còn có subagent general, dùng cho các tìm kiếm phức tạp và công việc nhiều bước. Hệ thống tự dùng nó ở bên trong. Bạn cũng có thể gọi trực tiếp bằng cách gõ @general trong tin nhắn. Nó hợp với những câu kiểu "tìm giúp mình mọi chỗ đang dùng chức năng này".

C.Nhiều cách cài, cả terminal lẫn app desktop

Bạn có thể cài bằng script, npm, Homebrew, pacman, mise hoặc Nix. Ngoài ra còn app desktop (đang BETA) cho macOS, Windows và Linux. Người không quen dòng lệnh có thể bắt đầu từ app desktop.

D.Mã nguồn mở, giấy phép MIT

Bạn xem được code, tự kiểm tra nó làm gì, và dùng theo giấy phép MIT. Repo có tài liệu cấu hình riêng trên trang dự án, và cộng đồng trên Discord, X.

II.Cần chuẩn bị gì

Tư liệu README khá ngắn nên phần này chỉ nêu những gì có thật:

  • Hệ điều hànhcác cách cài bằng dòng lệnh trong README nêu macOS, Linux (kể cả Arch Linux), Nix, và mise cho "mọi hệ điều hành". App desktop có bản cho macOS (Apple Silicon và Intel), Windows và Linux.
  • Gỡ bản cũREADME nhắc nên gỡ các phiên bản cũ hơn 0.1.x trước khi cài.
  • Node/npmchỉ cần nếu bạn chọn cách cài bằng npm (hoặc bun/pnpm/yarn).
  • Homebrewchỉ cần nếu chọn cách cài bằng brew.
  • Tài khoản, API key, phần cứngREADME chưa nói OpenCode cần tài khoản hay key nào, cũng không nêu yêu cầu phần cứng. Bạn xem thêm ở tài liệu trên trang opencode.ai/docs.

README chưa nói cách cấu hình mô hình AI hay khoá truy cập. Khi bạn được hỏi nhập key, hãy đọc kỹ tài liệu chính thức trước, không dán key vào chỗ lạ. Việc dùng dịch vụ AI bên thứ ba có thể phát sinh chi phí; hãy kiểm tra điều đó ở tài liệu trước khi dùng nhiều.

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

  1. Chọn cách càiChọn script, npm, brew hoặc app desktop tuỳ máy bạn
  2. Chạy lệnh càiDán đúng lệnh từ README vào terminal
  3. Mở thư mục dự ánDùng cd vào thư mục code cần làm việc
  4. Khởi chạyMở OpenCode trong thư mục đó
  5. Đổi agentNhấn Tab để chuyển giữa build và plan

A.Bước 1: Chọn cách cài phù hợp

README liệt kê nhiều cách. Gợi ý nhanh:

  • Dùng macOS hoặc Linux và có Homebrew: chọn brew. README ghi lệnh brew install anomalyco/tap/opencode-v2 là cách "recommended, always up to date".
  • Đã có Node: dùng npm.
  • Không thích dòng lệnh: tải app desktop ở bước riêng bên dưới.

B.Bước 2: Chạy lệnh cài

Mở terminal. Trên Windows là PowerShell hoặc Terminal, trên macOS là Terminal. Rồi dán một trong các lệnh sau. Mỗi dòng là một cách khác nhau, bạn chỉ cần chạy MỘT dòng phù hợp, đừng chạy hết.

Terminal
# YOLO
curl -fsSL https://opencode.ai/v2/install | bash

# Package managers
npm i -g @opencode/cli@latest      # or bun/pnpm/yarn
brew install anomalyco/tap/opencode-v2 # macOS and Linux (recommended, always up to date)
brew install opencode              # macOS and Linux (official brew formula, updated less)
sudo pacman -S opencode            # Arch Linux (Stable)
paru -S opencode-beta              # Arch Linux (Latest from AUR)
mise use -g opencode               # Any OS
nix run github:anomalyco/opencode  # Nix

Giải thích ngắn:

  • Dòng curl ... | bash là script cài tự động. README tự gọi nó là "YOLO", nghĩa là tải và chạy luôn mà bạn không đọc trước. Muốn chắc ăn, hãy mở địa chỉ script trong trình duyệt và đọc trước khi chạy.
  • Script cài OpenCode vào thư mục $HOME/.opencode/bin. Nếu sau khi cài mà terminal không nhận lệnh, nguyên nhân hay gặp là thư mục này chưa nằm trong PATH.
  • Lệnh npm i -g cài toàn cục. Chữ -g có nghĩa là cài cho cả máy chứ không chỉ một thư mục.
  • Hai lệnh brew cho kết quả khác nhau: bản anomalyco/tap/opencode-v2 luôn mới nhất, còn bản opencode chính thức của brew được cập nhật chậm hơn.
  • sudo pacman và paru dành cho Arch Linux. paru -S opencode-beta lấy bản mới nhất từ AUR.
  • Lệnh nix run chạy trực tiếp từ repo bằng Nix.
  • Trên Windows, README không có hướng dẫn riêng cho script curl hay npm. Cách chắc chắn nhất theo README là dùng app desktop, hoặc mise nếu bạn đã quen công cụ đó.

Lưu ý chỗ dễ vấp: README ghi gói npm là @opencode/cli, trong khi tên gói của repo là opencode. Hãy chép đúng như README, không tự sửa tên.

C.Bước 3 (tuỳ chọn): Cài app desktop

App desktop còn ở BETA. Tải tại trang opencode.ai/download. README liệt kê các file:

Hệ điều hành File tải
macOS (Apple Silicon) opencode-desktop-mac-arm64.dmg
macOS (Intel) opencode-desktop-mac-x64.dmg
Windows opencode-desktop-win-x64.exe
Linux .deb, .rpm hoặc .AppImage

Trên macOS bạn cũng có thể cài bằng Homebrew:

Terminal
brew install --cask opencode-desktop

Nếu bạn dùng Windows, chỉ cần tải file .exe và chạy như phần mềm thường. Máy Mac chip Apple chọn bản arm64, máy Mac đời cũ chip Intel chọn bản x64.

D.Bước 4: Mở thư mục dự án và khởi chạy

Trước hết cd vào thư mục chứa code của bạn. Nếu chưa có, bạn có thể tải một repo về. Ví dụ với chính repo này:

Terminal
git clone https://github.com/anomalyco/opencode.git
cd opencode

Sau đó mở OpenCode trong thư mục đó. README chưa ghi rõ lệnh khởi chạy. Vì tên gói là opencode, bạn có thể thử gõ opencode trong terminal. Nếu không chạy, hãy xem tài liệu ở opencode.ai/docs hoặc file CONTRIBUTING.md trong repo để biết cách mở đúng.

Mẹo cho người mới: luôn mở terminal ĐÚNG trong thư mục dự án cần làm. Mở sai thư mục thì agent sẽ nhìn nhầm chỗ.

E.Bước 5: Làm quen với phím Tab

Sau khi vào giao diện, nhấn Tab để đổi giữa build và plan. Cứ bắt đầu bằng plan khi bạn chưa chắc mình muốn làm gì.

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

README không mô tả một lệnh kiểm tra riêng hay một màn hình kết quả mong đợi. Bạn có thể tự kiểm tra theo các dấu hiệu sau:

  • Terminal nhận lệnh opencode mà không báo kiểu "command not found".
  • Giao diện mở ra và bạn đổi được agent bằng phím Tab (README nói phím này chuyển giữa build và plan).
  • Với app desktop: mở được ứng dụng sau khi cài.

Nếu terminal không nhận lệnh sau khi cài bằng script, hãy mở terminal mới. Các thay đổi PATH thường chỉ có hiệu lực ở cửa sổ mới.

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

README không đưa ví dụ prompt cụ thể. Các tình huống dưới đây chỉ bám vào những khả năng nó nêu: agent build, agent plan và subagent general. Câu lệnh mẫu là gợi ý của mình, bạn tự điều chỉnh.

A.Tình huống 1: Nhận một dự án lạ mà chưa dám sửa

Bạn là lập trình viên mới, vừa được giao một dự án do người khác viết. Bạn không muốn lỡ tay làm hỏng. Hãy mở OpenCode trong thư mục dự án, nhấn Tab sang agent plan, rồi hỏi:

text
Hãy giải thích dự án này làm gì và các thư mục chính dùng để làm gì.

Plan chỉ đọc và mặc định từ chối sửa file, nên bạn có thể hỏi thoải mái. Kết quả bạn nhận được là một bản tóm tắt cấu trúc dự án để mình đọc tiếp.

B.Tình huống 2: Lên kế hoạch trước khi đổi code

Bạn là dev, cần thêm một tính năng nhỏ nhưng chưa biết sửa ở đâu. Ở chế độ plan, hãy yêu cầu:

text
Mình muốn thêm tính năng X. Hãy chỉ ra những file nào cần sửa và đề xuất các bước làm.

Nếu plan cần chạy lệnh bash, nó sẽ hỏi quyền bạn trước. Khi bạn đồng ý với kế hoạch, nhấn Tab sang build để nhờ nó thực hiện.

Cứ để agent đọc trước, sửa sau: plan xem kỹ, build mới bắt tay làm.

Ông T

C.Tình huống 3: Tìm mọi chỗ dùng một chức năng trong dự án lớn

Bạn là nhân viên kỹ thuật ở công ty nhỏ, cần biết một hàm đang được gọi ở những đâu trước khi đổi tên. Hãy gọi subagent general để tìm giúp:

text
@general tìm tất cả chỗ trong dự án đang dùng hàm tinhGiaBan và liệt kê file cùng ý nghĩa.

README mô tả general dùng cho tìm kiếm phức tạp và việc nhiều bước. Kết quả là một danh sách để bạn kiểm tra trước khi sửa.

D.Tình huống 4: Chủ shop nhờ chỉnh một file cấu hình hay script nhỏ

Bạn có một website bán hàng hoặc script xử lý đơn mà người làm trước đã để lại. Bạn cần đổi một đoạn chữ hoặc một thiết lập. Ở chế độ build, hãy mô tả rõ yêu cầu:

text
Đổi tiêu đề trang chủ thành "Khuyến mãi tháng này" và cho mình xem phần đã sửa.

Build có toàn quyền nên nó sẽ sửa file thật. Trước khi nhờ, bạn nên sao lưu thư mục hoặc dùng git để có thể quay lại.

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

A.Terminal báo không tìm thấy lệnh sau khi cài

Thường do cửa sổ terminal chưa nạp lại PATH, hoặc thư mục cài chưa nằm trong PATH. Với script, OpenCode được cài vào $HOME/.opencode/bin. Hãy đóng và mở lại terminal, rồi kiểm tra thư mục đó có tồn tại không. Nếu vẫn lỗi, thử một cách cài khác trong README.

B.Cài đè lên bản cũ gây xung đột

README nhắc nên 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 bằng cách khác (ví dụ vừa npm vừa brew), hãy gỡ bản cũ rồi cài lại bằng một cách duy nhất cho gọn.

C.Nhầm hai lệnh brew

README có hai lệnh brew khác nhau: anomalyco/tap/opencode-v2 luôn mới nhất, còn opencode là bản chính thức nhưng cập nhật chậm hơn. Nếu thấy thiếu tính năng so với tài liệu, bạn có thể đang dùng bản chậm hơn.

D.Agent sửa file ngoài ý muốn

Ở chế độ build, agent có toàn quyền nên có thể sửa nhiều file. Cách an toàn: dùng git để theo dõi thay đổi, và dùng plan khi bạn chỉ muốn xem. Đừng chạy build trên thư mục chứa dữ liệu quan trọng chưa sao lưu.

E.Không biết cấu hình tài khoản hoặc mô hình AI ở đâu

README không giải thích phần này. Hãy xem tài liệu ở opencode.ai/docs, và hỏi ở Discord hoặc X của dự án nếu cần.

VII.Có nên dùng không

Điểm mạnh

  • Mã nguồn mở, giấy phép MIT, minh bạch.
  • Có hai chế độ rõ ràng: build để làm, plan chỉ đọc để phân tích. Rất hợp với người mới cần thận trọng.
  • Nhiều cách cài, có cả app desktop cho Windows, macOS, Linux.
  • Cộng đồng lớn: hiện có khoảng 226.506 sao và vẫn được cập nhật.

Giới hạn

  • README ngắn, chưa nói rõ cách cấu hình mô hình AI, key và chi phí. Bạn phải đọc thêm tài liệu chính thức.
  • App desktop đang ở BETA.
  • Trên Windows, README chưa có hướng dẫn riêng cho các lệnh cài; cách chắc nhất là app desktop.
  • Nó là công cụ cho việc code. Nếu bạn chỉ cần soạn văn bản hay xử lý bảng tính thông thường, các công cụ chuyên dụng sẽ hợp hơn.

Mình nghĩ OpenCode đáng thử nếu bạn đã quen dùng terminal và muốn một agent code mã nguồn mở. Nếu bạn muốn mọi thứ có hướng dẫn từng bước kèm màn hình, hãy bắt đầu bằng app desktop. Dù cách nào, hãy dùng plan trước, build sau, và luôn có bản sao lưu.

4.9/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

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

Bản thân OpenCode là mã nguồn mở theo giấy phép MIT nên bạn dùng được mà không phải trả tiền cho phần mềm. README không nói gì về chi phí của dịch vụ AI đi kèm, nên phần này chưa có thông tin. Hãy xem tài liệu ở opencode.ai/docs.

OpenCode chạy được trên Windows không?

Có app desktop (BETA) cho Windows với file opencode-desktop-win-x64.exe. README cũng nêu mise cho mọi hệ điều hành. Với script curl và npm, README không có hướng dẫn riêng cho Windows.

Cài OpenCode bằng cách nào dễ nhất?

Nếu bạn dùng macOS hoặc Linux và có Homebrew, README ghi lệnh brew install anomalyco/tap/opencode-v2 là cách được khuyến nghị. Nếu không quen dòng lệnh, hãy tải app desktop từ trang opencode.ai/download. Cả hai đều khá đơn giản.

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

Build là agent mặc định, toàn quyền dùng cho việc phát triển. Plan là agent chỉ đọc: mặc định từ chối sửa file và hỏi quyền trước khi chạy lệnh bash, hợp để khám phá code lạ hoặc lập kế hoạch. Bạn đổi giữa hai agent bằng phím Tab.

@general dùng để làm gì?

Đây là subagent dùng cho các tìm kiếm phức tạp và công việc nhiều bước. Hệ thống dùng nó ở bên trong, và bạn có thể gọi trực tiếp bằng cách gõ @general trong tin nhắn.

Có cần GPU hay máy mạnh không?

README không nêu yêu cầu phần cứng nào, nên chưa có thông tin về GPU hay cấu hình tối thiểu. Hãy xem tài liệu chính thức nếu bạn cần chi tiết.

Dữ liệu và code của mình có an toàn không?

README không nói về cách xử lý dữ liệu. Về quyền thao tác thì agent plan chỉ đọc, mặc định không sửa file và hỏi trước khi chạy bash. Repo có file SECURITY.md và mã nguồn mở nên bạn có thể tự kiểm tra thêm.

Chuyển nhanh tới mục

  1. I.OpenCode làm được gì
    1. A.Hai agent có sẵn, đổi bằng phím Tab
    2. B.Subagent general cho việc tìm kiếm phức tạp
    3. C.Nhiều cách cài, cả terminal lẫn app desktop
    4. D.Mã nguồn mở, giấy phép MIT
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Bước 1: Chọn cách cài phù hợp
    2. B.Bước 2: Chạy lệnh cài
    3. C.Bước 3 (tuỳ chọn): Cài app desktop
    4. D.Bước 4: Mở thư mục dự án và khởi chạy
    5. E.Bước 5: Làm quen với phím Tab
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Tình huống 1: Nhận một dự án lạ mà chưa dám sửa
    2. B.Tình huống 2: Lên kế hoạch trước khi đổi code
    3. C.Tình huống 3: Tìm mọi chỗ dùng một chức năng trong dự án lớn
    4. D.Tình huống 4: Chủ shop nhờ chỉnh một file cấu hình hay script nhỏ
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Terminal báo không tìm thấy lệnh sau khi cài
    2. B.Cài đè lên bản cũ gây xung đột
    3. C.Nhầm hai lệnh brew
    4. D.Agent sửa file ngoài ý muốn
    5. E.Không biết cấu hình tài khoản hoặc mô hình AI ở đâu
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.