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

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

11 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 trong terminal — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

opencode (anomalyco/opencode) là một AI coding agent mã nguồn mở, giấy phép MIT, viết bằng TypeScript. Nó giúp bạn khám phá, lên kế hoạch và sửa code bằng ngôn ngữ tự nhiên. Cài khá dễ: một dòng lệnh, một trình quản lý gói, hoặc tải bản desktop (BETA).

opencode là một AI coding agent mã nguồn mở: bạn nhờ nó đọc code, giải thích, lên kế hoạch và sửa file bằng tiếng người, thay vì tự mò từng dòng. Repo này viết bằng TypeScript, dùng giấy phép MIT, hiện có khoảng 226.506 sao và 30.658 fork trên GitHub. Con số đó cho thấy rất nhiều người đang dùng và theo dõi nó.

Repo này hợp với ba nhóm người. Nhóm đầu là lập trình viên mới, cần một người hướng dẫn đọc hiểu dự án lạ. Nhóm hai là dân kinh doanh, văn phòng hay tự làm website, file tự động hoá nhỏ, muốn có trợ lý chỉnh code hộ. Nhóm ba là dev đã có kinh nghiệm, muốn một coding agent mã nguồn mở thay vì công cụ đóng.

Điểm đáng giá nhất là cách chia vai rất rõ. Có agent build được toàn quyền để làm việc, và agent plan chỉ đọc để phân tích, mặc định không cho sửa file. Bạn bấm phím Tab để đổi qua lại. Nhờ vậy bạn có thể cho AI xem xét trước, rồi mới cho nó bắt tay vào sửa.

Agent

anomalyco/opencode

opencode là coding agent mã nguồn mở: đọc code, sửa file, chạy lệnh giúp bạn, có chế độ plan chỉ-đọc an toàn và cả bản ứng dụng desktop.

★ 227kTypeScriptMIT
Xem repo trên GitHub

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

Tư liệu repo nói ngắn gọn, nên mình chỉ kể những gì có thật trong README.

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

  • build là agent mặc định, có đầy đủ quyền cho việc phát triển. Dùng khi bạn đã biết mình muốn gì và cho phép nó sửa code.
  • plan là agent chỉ đọc, dành cho phân tích và khám phá code. Nó từ chối sửa file theo mặc định, và hỏi bạn trước khi chạy lệnh bash. Đây là chế độ rất hợp khi bạn mới nhận một dự án lạ, hoặc muốn xem AI định làm gì trước khi cho nó động vào file.

Lợi ích thực tế: bạn có một lớp an toàn có sẵn. Cứ để plan trả lời câu hỏi, đến khi yên tâm thì chuyển sang build.

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. README ghi nó chủ yếu được dùng nội bộ, nhưng bạn có thể gọi trực tiếp bằng @general trong tin nhắn. Hợp với những câu như tìm xem một chức năng nằm ở đâu trong dự án lớn.

C.Nhiều cách cài, nhiều nền tảng

Bạn có thể cài bằng script một dòng, bằng npm, Homebrew, pacman (Arch Linux), mise, hoặc chạy qua Nix. Ngoài ra có bản ứng dụng desktop (BETA) cho macOS, Windows và Linux, nên người ngại gõ lệnh vẫn có lối vào.

D.Mã nguồn mở, có cộng đồng

Giấy phép MIT, repo còn được cập nhật trong 3 tháng gần đây. README có nhiều bản dịch, trong đó có tiếng Việt (README.vi.md). Tác giả cũng có Discord và tài khoản X để hỏi đáp.

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

Phần này mình chỉ nêu những gì tư liệu nói. Cái nào không có thì mình ghi rõ là chưa có thông tin.

  • Hệ điều hành: bản desktop có file cho macOS (Apple Silicon và Intel), Windows (opencode-desktop-win-x64.exe) và Linux (.deb, .rpm, .AppImage). Các cách cài bằng dòng lệnh được ghi cho macOS, Linux (Arch Linux, Nix) và mise (mọi hệ điều hành).
  • Trình quản lý gói: tuỳ cách cài bạn chọn, cần npm (hoặc bun/pnpm/yarn), Homebrew, pacman, paru, mise hoặc Nix. Cài bằng script curl thì không cần trình quản lý nào trong danh sách này.
  • Dọn bản cũ: README khuyên gỡ các phiên bản cũ hơn 0.1.x trước khi cài.
  • Tài khoản, API key, phần cứng, phiên bản Node: README chưa nói. Nghĩa là mình không có thông tin để khẳng định bạn cần hay không cần. Phần cấu hình nằm ở trang tài liệu https://opencode.ai/docs, bạn mở xem trước khi dùng thật.

Một coding agent có thể sửa file và chạy lệnh trên máy bạn. Lần đầu hãy thử trên một thư mục dự án có bản sao lưu (hoặc đã commit bằng git), và ưu tiên chế độ plan để xem nó định làm gì. Về key hay chi phí khi kết nối dịch vụ AI, README không nói gì, bạn đọc trang docs trước khi dán key vào.

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

  1. Gỡ bản cũXoá các phiên bản cũ hơn 0.1.x nếu máy bạn đã từng cài
  2. Chọn cách càiScript một dòng, npm, Homebrew, pacman, mise hoặc Nix
  3. Chạy lệnh càiDán đúng lệnh của cách bạn chọn vào terminal
  4. Mở terminal ở thư mục dự áncd vào thư mục bạn muốn AI làm việc cùng
  5. Xem tài liệu cấu hìnhMở opencode.ai/docs để làm theo phần thiết lập

A.Gỡ bản cũ nếu có

README ghi chú: hãy gỡ các phiên bản cũ hơn 0.1.x trước khi cài. Nếu bạn chưa từng cài opencode thì bỏ qua bước này. README không ghi lệnh gỡ cụ thể, nên bạn gỡ theo đúng cách mình đã dùng để cài trước đó (ví dụ qua npm hay Homebrew).

B.Chọn một cách cài và chạy lệnh

Mở terminal (trên macOS là Terminal, trên Linux là cửa sổ terminal, trên Windows bạn cần một môi trường chạy được lệnh tương ứng, README không nói rõ chi tiết nên bản desktop sẽ dễ hơn). Dưới đây là toàn bộ các cách cài mà README liệt kê. Chỉ chọn một dòng phù hợp với máy bạn, đừng chạy hết cả khối.

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 để bạn chọn cho đúng:

  • curl ... | bash (README gọi vui là YOLO): tải script cài về và chạy ngay. Nhanh nhất, nhưng bạn đang chạy một script từ mạng mà chưa đọc nó. Ai cẩn thận thì chọn cách khác. Script này cài opencode vào $HOME/.opencode/bin.
  • npm i -g @opencode/cli@latest: cài toàn cục bằng npm, README ghi thêm là dùng được bun, pnpm hoặc yarn. Lưu ý tên gói ở đây là @opencode/cli, hãy chép đúng.
  • brew install anomalyco/tap/opencode-v2: README đánh dấu là cách được khuyên dùng trên macOS và Linux, luôn cập nhật mới nhất.
  • brew install opencode: formula chính thức của Homebrew, nhưng được cập nhật ít hơn.
  • sudo pacman -S opencode và paru -S opencode-beta: dành cho Arch Linux, bản ổn định và bản mới nhất từ AUR.
  • mise use -g opencode: dùng trên mọi hệ điều hành nếu bạn đã có mise.
  • nix run github:anomalyco/opencode: chạy trực tiếp qua Nix.

Chỗ người mới hay vấp: lệnh sudo sẽ hỏi mật khẩu máy, và khi bạn gõ mật khẩu thì màn hình không hiện ký tự nào. Đó là bình thường.

C.Hoặc cài bản desktop (BETA)

Nếu không muốn dùng terminal, tải bản ứng dụng tại https://opencode.ai/download. Các file theo README:

Nền tảng 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ản desktop bằng Homebrew:

Terminal
brew install --cask opencode-desktop

Bản desktop đang ở giai đoạn BETA, nên có thể còn lỗi vặt.

D.Mở terminal ở thư mục dự án và xem tài liệu

Lệnh dưới đây chỉ là cách mở thư mục dự án, bạn thay đường dẫn bằng thư mục của mình:

Terminal
cd ten-thu-muc-du-an

README chưa ghi rõ lệnh khởi chạy sau khi cài. Gói tên là opencode nên thông thường bạn sẽ gõ opencode trong thư mục dự án, nhưng bạn hãy đối chiếu với trang https://opencode.ai/docs để chắc chắn. Mọi phần cấu hình (kết nối mô hình AI, tuỳ chỉnh agent) cũng nằm ở đó, README chỉ trỏ sang tài liệu chứ không chép lại.

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

README không có mục kiểm tra riêng, nên mình đưa ra những dấu hiệu hợp lý, bạn đối chiếu thêm với docs:

  • Với bản cài bằng dòng lệnh: sau khi cài xong, mở một cửa sổ terminal mới và thử gọi lệnh opencode trong thư mục dự án. Nếu máy báo không tìm thấy lệnh, xem phần lỗi bên dưới.
  • Với script curl: file được đặt ở $HOME/.opencode/bin. Bạn có thể vào thư mục đó xem đã có file hay chưa.
  • Với bản desktop: mở ứng dụng lên, thấy giao diện hiện ra là đã cài xong.
  • Kiểm tra chế độ agent: khi đã vào được giao diện, bấm Tab để chuyển giữa build và plan. Thấy đổi được là bạn đang chạy đúng opencode.

README chưa mô tả màn hình hay thông báo kết quả cụ thể. Nếu giao diện hiện ra nhưng không trả lời được, nhiều khả năng bạn chưa thiết lập xong phần kết nối mô hình AI. Xem trang docs.

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

Các tình huống dưới đây bám đúng khả năng README mô tả: đọc và phân tích code (plan), sửa code (build), tìm kiếm nhiều bước (@general). Câu lệnh mẫu là gợi ý để bạn bắt chước, không phải cú pháp bắt buộc.

A.Nhân viên mới tiếp nhận một dự án lạ

Bối cảnh: bạn vừa vào công ty, được giao một thư mục code mà người cũ để lại, không có tài liệu. Bạn mở terminal trong thư mục đó, chạy opencode và để ở chế độ plan (chỉ đọc). Sau đó hỏi:

text
Dự án này làm gì? Các thư mục chính nằm ở đâu và mỗi thư mục để làm gì?

Kết quả: bạn nhận được bản tóm tắt cấu trúc dự án bằng tiếng người, mà không sợ AI lỡ tay sửa file nào, vì plan từ chối sửa file theo mặc định.

Cứ để AI đọc trước, hiểu rồi mới cho nó sửa. Chế độ chỉ-đọc rẻ hơn rất nhiều so với một lần sửa sai.

Ông T

B.Chủ shop sửa một lỗi nhỏ trên website

Bối cảnh: bạn có website bán hàng do người khác làm, giờ nút đặt hàng hiển thị sai chữ. Bạn không rành code. Bạn bắt đầu ở plan để nhờ nó chỉ ra file chứa đoạn chữ đó, rồi bấm Tab sang build. Bạn nhắn:

text
Đổi chữ trên nút đặt hàng thành "Đặt mua ngay" và cho mình xem bạn đã sửa những file nào.

Kết quả: agent tìm đúng chỗ và sửa. Nếu thư mục dự án đã được commit bằng git thì bạn xem lại được phần thay đổi và hoàn tác dễ dàng. Hãy sao lưu trước khi cho build chạy.

C.Dev lên kế hoạch trước khi sửa lớn

Bối cảnh: bạn định đổi cách xử lý đăng nhập trong một dự án lớn. Ở chế độ plan, bạn yêu cầu:

text
@general Tìm tất cả chỗ trong dự án đang xử lý đăng nhập và liệt kê giúp mình.

Sau đó nhờ plan đề xuất các bước thay đổi. Khi plan cần chạy lệnh bash thì nó sẽ hỏi quyền bạn trước. Kết quả là một danh sách việc cần làm rõ ràng, bạn duyệt xong mới chuyển sang build.

D.Tự học đọc code của một repo mã nguồn mở

Bối cảnh: bạn là người mới học lập trình, tải một repo mẫu về để học. Dùng git clone https://github.com/<repo>.git (thay <repo> bằng repo bạn chọn), cd vào thư mục, mở opencode ở chế độ plan và hỏi từng phần: file này làm gì, hàm kia gọi hàm nào. Kết quả: bạn có một người giải thích riêng cho từng đoạn code, và không có nguy cơ làm hỏng bản gốc.

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

Mấy lỗi dưới đây README không nhắc, nhưng rất dễ xảy ra với loại công cụ cài bằng dòng lệnh. Mình nêu theo kinh nghiệm chung, bạn đối chiếu thêm với docs.

A.Gõ lệnh báo không tìm thấy (command not found)

Thường do terminal chưa nạp lại đường dẫn sau khi cài. Hãy đóng cửa sổ terminal, mở cái mới rồi thử lại. Nếu cài bằng script, file nằm ở $HOME/.opencode/bin, kiểm tra xem thư mục đó có tồn tại và đã nằm trong biến PATH của bạn chưa.

B.Cài nhầm tên gói

README có nhiều tên gần giống nhau: opencode, opencode-v2, opencode-beta, @opencode/cli, opencode-desktop. Mỗi cách cài dùng một tên riêng, hãy chép đúng dòng ứng với cách bạn chọn, đừng trộn lẫn. Nếu hai cách cài chồng lên nhau, gỡ cái cũ đi theo đúng cách đã cài.

C.Máy còn bản cũ hơn 0.1.x

README khuyên gỡ các bản này trước khi cài. Nếu gặp hành vi lạ sau khi cài, kiểm tra xem máy còn bản cũ nằm sót hay không.

D.Vào được giao diện nhưng AI không trả lời

Khả năng cao là chưa thiết lập kết nối tới mô hình AI. README không ghi các bước này, bạn làm theo trang https://opencode.ai/docs. Khi điền key, chỉ dán vào đúng chỗ cấu hình mà tài liệu chỉ, không dán vào khung chat, không gửi cho người khác.

E.AI sửa file ngoài ý muốn

Đây là rủi ro của mọi coding agent. Cách phòng: dùng git để commit trước khi cho build chạy, chạy plan trước, và đọc kỹ các lần nó hỏi quyền chạy lệnh. Nếu lỡ sửa sai, quay về bản commit trước đó.

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

Điểm mạnh. Mã nguồn mở, giấy phép MIT, repo được cập nhật liên tục. Có nhiều cách cài và có cả bản desktop. Cách chia build và plan rất dễ hiểu, giúp người mới dùng AI sửa code mà bớt sợ. Cộng đồng đông, tài liệu và README có cả tiếng Việt.

Giới hạn. README rất ngắn: không giải thích cách kết nối mô hình AI, không nói rõ yêu cầu hệ thống, không có phần kiểm tra cài đặt. Bạn buộc phải đọc thêm trang docs. Bản desktop còn BETA. Các dòng lệnh cài đặt có nhiều tên khác nhau nên dễ nhầm. Cuối cùng, mình chưa có thông tin về chi phí hay chuyện dữ liệu code của bạn được gửi đi đâu, vì phụ thuộc vào cách bạn cấu hình, nên cần đọc docs trước khi dùng với code nhạy cảm.

Khi nào nên chọn cách khác. Nếu bạn chỉ cần hỏi đáp chung chung về lập trình thì một khung chat AI thông thường là đủ. Nếu công ty bạn có quy định chặt về đưa mã nguồn cho dịch vụ bên ngoài, hãy hỏi bộ phận IT trước. Còn nếu bạn muốn một agent mở, tự kiểm soát, có chế độ chỉ-đọc để thử an toàn, thì opencode đáng để bạn cài thử trên một dự án nhỏ trước.

4.0/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ở, giấy phép MIT, nên bạn tải và dùng phần mềm mà không phải trả tiền cho repo. README không nói gì về chi phí khi kết nối tới dịch vụ AI bên ngoài, nên chưa có thông tin chắc chắn. Bạn xem trang https://opencode.ai/docs để biết cách cấu hình và chi phí liên quan.

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

README có file desktop cho Windows là opencode-desktop-win-x64.exe (bản BETA), tải tại opencode.ai/download. Với các lệnh cài bằng terminal, README chỉ ghi rõ macOS, Linux và mise (mọi hệ điều hành). Nó không nói rõ cách làm trên Windows, nên bạn xem thêm trang docs.

Có cần GPU hay máy cấu hình 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 để khẳng định. Bạn xem trang tài liệu của dự án để biết chi tiết.

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

build là agent mặc định, có đầy đủ quyền 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. Bạn bấm phím Tab để chuyển qua lại. plan hợp để khám phá code lạ hoặc lên kế hoạch thay đổi.

Cài bằng cách nào là tốt nhất?

README ghi rõ trên macOS và Linux, cách brew install anomalyco/tap/opencode-v2 được khuyên dùng vì luôn cập nhật mới nhất. Nếu ngại gõ lệnh, bạn có thể tải bản desktop (BETA). Cách curl một dòng thì nhanh nhưng bạn nên cân nhắc vì nó chạy script tải từ mạng.

Script cài đặt đặt opencode ở đâu trên máy?

Theo README, script cài đặt đặt opencode vào thư mục $HOME/.opencode/bin. Các cách cài khác (npm, Homebrew, pacman, mise, Nix) do trình quản lý gói tương ứng tự đặt vị trí.

opencode khác gì các công cụ coding agent khác?

Theo mô tả của tác giả, đây là coding agent mã nguồn mở, có hai agent dựng sẵn (build và plan) và subagent general. README không so sánh trực tiếp với công cụ nào khác, nên chưa có thông tin để nói hơn kém ra sao.

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, nhiều nền tảng
    4. D.Mã nguồn mở, có cộng đồng
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Gỡ bản cũ nếu có
    2. B.Chọn một cách cài và chạy lệnh
    3. C.Hoặc cài bản desktop (BETA)
    4. D.Mở terminal ở thư mục dự án và xem tài liệu
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Nhân viên mới tiếp nhận một dự án lạ
    2. B.Chủ shop sửa một lỗi nhỏ trên website
    3. C.Dev lên kế hoạch trước khi sửa lớn
    4. D.Tự học đọc code của một repo mã nguồn mở
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Gõ lệnh báo không tìm thấy (command not found)
    2. B.Cài nhầm tên gói
    3. C.Máy còn bản cũ hơn 0.1.x
    4. D.Vào được giao diện nhưng AI không trả lời
    5. E.AI sửa file ngoài ý muốn
  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ỏ.