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

10 phút đọcCập nhật
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 là một coding agent (trợ lý lập trình AI) mã nguồn mở, giấy phép MIT, viết bằng TypeScript. Bạn cài nó, mở trong thư mục dự án rồi nhờ AI đọc, phân tích và sửa code. Cài khá dễ: có script một dòng, nhiều trình quản lý gói và cả ứng dụng desktop bản beta.

opencode là một agent lập trình AI mã nguồn mở: bạn mô tả việc cần làm bằng lời, nó đọc code trong dự án rồi giúp bạn phân tích, lên kế hoạch và sửa. Repo viết bằng TypeScript, dùng giấy phép MIT, và tác giả tóm gọn nó là “The open source coding agent”.

Bạn nên đọc bài này nếu là lập trình viên mới muốn có một trợ lý AI ngay trong máy, hoặc người làm văn phòng, kinh doanh có dính chút code (file tự động hoá, trang web nhỏ, script xử lý dữ liệu) và muốn có người “ngồi cạnh” chỉ chỗ. Hiện repo có khoảng 226.506 sao và 30.658 fork, nên cộng đồng dùng khá đông và repo vẫn được cập nhật trong 3 tháng gần đây.

Điểm đáng giá nhất theo mình: opencode có sẵn hai “vai” tách bạch. Một vai được phép sửa file (build), một vai chỉ đọc để phân tích (plan). Bạn có thể cho AI xem dự án lạ mà không lo nó tự ý sửa gì. Ngoài ra còn có bản ứng dụng desktop (đang beta) cho ai không thích gõ lệnh.

Agent

anomalyco/opencode

opencode là agent lập trình AI mã nguồn mở, có sẵn hai chế độ build và plan, cài bằng một dòng lệnh hoặc dùng bản desktop.

★ 227kTypeScriptMIT
Xem repo trên GitHub

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

Dưới đây là những điểm chính mà README nói tới, mình giải thích theo hướng dùng thực tế.

A.Hai agent có sẵn: build và plan

opencode có hai agent dựng sẵn, bạn đổi qua lại bằng phím Tab.

  • buildagent mặc định, toàn quyền cho công việc phát triển. Dùng khi bạn đã biết mình muốn gì và để AI làm thật.
  • planagent chỉ đọc, dùng để phân tích và khám phá code. Mặc định nó từ chối sửa file, và hỏi bạn trước khi chạy lệnh bash. Rất hợp khi bạn mở một dự án lạ, hoặc muốn AI đề xuất hướng làm trước khi động vào code.

Lợi ích: bạn kiểm soát được mức rủi ro. Chưa chắc thì để plan, chắc rồi mới chuyển sang build.

B.Subagent general

Ngoài hai agent trên còn có một subagent tên general, dùng cho các việc tìm kiếm phức tạp và tác vụ nhiều bước. README cho biết nó chủ yếu được dùng nội bộ, nhưng bạn có thể gọi thẳng bằng @general trong tin nhắn. Hợp khi bạn cần “đi tìm giúp mình chỗ nào trong dự án xử lý việc này”.

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

README liệt kê script một dòng, npm/bun/pnpm/yarn, Homebrew, Arch Linux (pacman, paru), mise và Nix. Bạn chọn cách quen tay nhất, không bị ép dùng một công cụ.

D.Có bản ứng dụng desktop (beta)

Ngoài bản dòng lệnh, có app desktop cho macOS (Apple Silicon và Intel), Windows và Linux. Ai ngại terminal có thể thử bản này.

E.Tài liệu cấu hình riêng

Phần cấu hình chi tiết (agent, nhà cung cấp mô hình AI…) nằm trong tài liệu chính thức ở trang opencode.ai/docs. README chỉ giới thiệu ngắn, nên khi cần tuỳ chỉnh sâu bạn sẽ phải đọc thêm ở đó.

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

README không có mục “yêu cầu hệ thống” riêng, nên mình chỉ nêu những gì có trong tư liệu:

  • Hệ điều hành: README liệt kê tải xuống cho macOS, Windows và Linux (bản desktop), cùng các cách cài cho macOS, Linux, Arch Linux, Nix, và mise (nói là chạy mọi hệ điều hành).
  • Một terminal nếu bạn dùng bản dòng lệnh: PowerShell/Terminal trên Windows, Terminal trên macOS, hoặc terminal bất kỳ trên Linux.
  • Trình quản lý gói tuỳ cách bạn chọn: npm (hoặc bun, pnpm, yarn), Homebrew, pacman/paru, mise hoặc Nix.
  • Gỡ bản cũ: README khuyên xoá các phiên bản cũ hơn 0.1.x trước khi cài.

Về tài khoản, API key hay phần cứng (GPU): README chưa nói gì. Cách kết nối với mô hình AI bạn nên xem trong tài liệu ở opencode.ai/docs.

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

  1. Gỡ bản cũXoá phiên bản cũ hơn 0.1.x nếu có
  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 lệnh tương ứng vào terminal
  4. Hoặc tải app desktopDành cho ai không muốn dùng terminal
  5. Đọc tài liệu cấu hìnhXem opencode.ai/docs để thiết lập

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

README ghi chú: nên 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.

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

Đây là khối lệnh nguyên văn trong README. Bạn chỉ chạy MỘT dòng phù hợp với máy mình, khô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 ngắn để bạn chọn:

  • Dòng curl (README đặt tên là “YOLO”)tải script cài đặt rồi chạy luôn. Nhanh nhất, nhưng bạn đang chạy một script từ internet mà chưa đọc nó. Nếu muốn cẩn thận, hãy mở địa chỉ script trong trình duyệt xem trước. Dòng này cần môi trường chạy được bash (macOS, Linux, hoặc Git Bash/WSL trên Windows).
  • npm i -gcài toàn cục bằng npm. README ghi bạn có thể thay bằng bun, pnpm hoặc yarn. Lưu ý: README viết tên gói là @opencode/cli, trong khi dữ liệu repo ghi tên gói npm là opencode. Nếu lệnh báo không tìm thấy gói, hãy đối chiếu lại với trang cài đặt ở opencode.ai.
  • brewcó hai công thức. README gọi anomalyco/tap/opencode-v2 là bản được khuyên dùng và luôn mới nhất, còn brew install opencode là bản chính thức nhưng cập nhật chậm hơn.
  • pacman / parudành cho Arch Linux. pacman cho bản ổn định, paru (AUR) cho bản mới nhất.
  • miseghi là chạy được trên mọi hệ điều hành, nhưng bạn cần cài sẵn mise.
  • nix runchạy trực tiếp từ GitHub qua Nix, cần có Nix.

Chỗ người mới hay vấp: các dòng có dấu # phía sau là chú thích, bạn không cần gõ phần đó.

Script cài đặt sẽ đặt opencode vào thư mục $HOME/.opencode/bin. Nếu sau khi cài mà terminal không nhận lệnh, có thể thư mục này chưa nằm trong PATH. README chưa hướng dẫn chi tiết chuyện này.

C.Hoặc dùng ứng dụng desktop (beta)

Tải ở trang 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ằng Homebrew:

Terminal
# macOS (Homebrew)
brew install --cask opencode-desktop

Vì là bản beta nên có thể còn lỗi vặt. Nếu gặp trục trặc, bạn thử bản dòng lệnh.

D.Đọc tài liệu để cấu hình

README chỉ gợi ý một điều: muốn cấu hình opencode thì xem tài liệu ở opencode.ai/docs. Phần kết nối mô hình AI, README không ghi, nên bạn làm theo tài liệu đó.

README không nói cần API key hay không, và không nói chi phí. Nếu bạn kết nối với một dịch vụ AI tính phí theo lượt dùng, hãy xem kỹ bảng giá của dịch vụ đó. Đừng dán key vào file đưa lên GitHub hay chia sẻ cho người khác.

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

README chưa ghi lệnh kiểm tra phiên bản hay màn hình mong đợi. Nên mình đưa ra cách kiểm tra dựa trên những gì chắc chắn:

  1. Mở một terminal mới (để PATH được nạp lại), rồi thử gọi lệnh opencode. Tên gói và tên công thức brew đều là opencode, nhưng chính README không ghi lệnh khởi chạy, nên nếu không chạy bạn xem tài liệu ở opencode.ai/docs.
  2. Nếu chạy, bạn sẽ vào giao diện của agent. Nhấn Tab thử: nếu agent đổi giữa build và plan thì mọi thứ đang ổn, vì đây chính là hành vi README mô tả.
  3. Với bản desktop: mở app lên và thấy giao diện làm việc là đã cài xong.

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

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

A.Làm quen một dự án lạ trước khi sửa

Bối cảnh: bạn là dev mới vào công ty, được giao một repo cũ mà chưa ai giải thích. Mở terminal trong thư mục dự án, khởi chạy opencode và để ở chế độ plan (chỉ đọc, không sửa file). Hỏi thử:

text
Dự án này làm gì? Liệt kê các thư mục chính và nói file nào là điểm bắt đầu.

Kết quả: bạn có bản tóm tắt cấu trúc dự án mà không có file nào bị đụng tới. README nói rõ plan hợp với việc khám phá code lạ.

Chưa hiểu dự án thì để AI đọc trước, đừng để nó sửa trước.

Ông T

B.Lên kế hoạch sửa lỗi rồi mới làm

Bối cảnh: trang web nhỏ của shop bạn bị lỗi giỏ hàng. Ở chế độ plan, bạn mô tả lỗi và nhờ AI chỉ ra đoạn code nghi ngờ cùng các bước sửa. Đọc kế hoạch, thấy hợp lý thì nhấn Tab để chuyển sang build và bảo nó thực hiện. Vì plan hỏi quyền trước khi chạy lệnh bash, bạn luôn biết nó định chạy gì.

C.Nhờ @general tìm giúp việc nhiều bước

Bối cảnh: dự án có hàng trăm file và bạn cần biết chỗ nào đang gửi email cho khách. Trong tin nhắn, bạn gọi:

text
@general tìm tất cả chỗ trong dự án có gửi email cho khách hàng và liệt kê theo file.

Kết quả mong đợi: một danh sách các vị trí liên quan. README mô tả general là subagent cho tìm kiếm phức tạp và tác vụ nhiều bước, nên đây là đúng sở trường.

D.Dùng bản desktop khi không quen terminal

Bối cảnh: bạn làm văn phòng, thỉnh thoảng cần chỉnh một script xử lý bảng tính. Cài bản desktop, mở thư mục chứa script và nhờ AI giải thích script đó làm gì. Muốn sửa thì mới chuyển sang agent build. Mức độ chi tiết của giao diện desktop thì README chưa nói, bạn cứ thử trực tiếp.

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

Dưới đây là những vấp phổ biến với loại công cụ này. Phần nào mình suy ra từ tình huống chứ README không ghi, mình sẽ nói rõ.

A.Gõ opencode mà terminal báo không tìm thấy lệnh

Thường do terminal chưa nạp lại PATH. Đóng terminal, mở cái mới rồi thử lại. Nếu bạn cài bằng script, README cho biết file được đặt ở $HOME/.opencode/bin, hãy kiểm tra thư mục này có nằm trong PATH không.

B.Chạy curl trên Windows bị lỗi

Dòng curl dùng bash, nên PowerShell thuần có thể không chạy được. Bạn có thể dùng Git Bash hoặc WSL, hoặc chọn cách cài khác như npm, mise, hoặc tải bản desktop .exe.

C.npm báo không thấy gói hoặc cài ra phiên bản lạ

README ghi @opencode/cli, còn dữ liệu repo ghi tên gói là opencode, nên có thể có chênh lệch. Đối chiếu với trang cài đặt ở opencode.ai. Nếu trước đó bạn có bản cũ hơn 0.1.x, hãy gỡ đi theo khuyến cáo của README rồi cài lại.

D.Cài nhầm bản brew cũ

Có hai công thức brew. README khuyên dùng anomalyco/tap/opencode-v2 vì luôn mới nhất; công thức opencode chính thức thì cập nhật chậm hơn. Nếu thấy thiếu tính năng, thử cái còn lại.

E.Chế độ plan không sửa file

Đây không phải lỗi. Plan chặn sửa file theo mặc định và hỏi quyền trước khi chạy lệnh bash. Muốn AI thực sự sửa, nhấn Tab để chuyển sang build, nhưng hãy chắc bạn đã đọc kế hoạch trước.

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

Điểm mạnh

  • Mã nguồn mở, giấy phép MIT, repo vẫn được cập nhật.
  • Hai chế độ build/plan giúp bạn kiểm soát rủi ro rất rõ ràng.
  • Nhiều cách cài, có cả bản desktop cho người ngại terminal.
  • Cộng đồng lớn (khoảng 226.506 sao), có Discord và X để hỏi.

Giới hạn

  • README ngắn: không nói về API key, chi phí, yêu cầu phần cứng hay ví dụ dùng. Bạn phải đọc thêm tài liệu chính thức.
  • Bản desktop còn là beta.
  • Dòng cài “YOLO” chạy script từ internet; người cẩn thận nên đọc script trước.
  • Chế độ build có toàn quyền, nên với dự án quan trọng hãy sao lưu hoặc dùng quản lý phiên bản (như git) để dễ quay lại.

Khi nào nên chọn cách khác: nếu bạn chỉ cần hỏi đáp nhanh về một đoạn code, một khung chat thông thường là đủ. Nếu công ty bạn có quy định riêng về công cụ AI, hãy hỏi bộ phận IT trước khi cài.

Nếu bạn muốn một trợ lý lập trình mở, tự cài được và có chế độ chỉ đọc để thử an toàn, opencode là lựa chọn đáng thử.

Lưu ý nhỏ: README nhắc rằng dự án nào dùng chữ “opencode” trong tên (ví dụ opencode-dashboard) thì nên ghi rõ không phải do nhóm opencode làm. Khi tìm công cụ liên quan, bạn nhớ phân biệt bản chính chủ với bản của bên thứ ba.

4.1/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. Tuy nhiên README không nói về chi phí khi kết nối với các dịch vụ AI bên ngoài, nên chưa có thông tin về việc dùng có mất phí hay không. Bạn xem thêm ở opencode.ai/docs.

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

Có bản desktop cho Windows (file opencode-desktop-win-x64.exe, đang beta). Với bản dòng lệnh, README liệt kê mise chạy trên mọi hệ điều hành và có dòng curl dùng bash. Nếu dùng dòng curl trên Windows, bạn nên chạy trong Git Bash hoặc WSL.

Có cần card đồ hoạ (GPU) không?

README không nhắc tới yêu cầu GPU hay phần cứng nào. Chưa có thông tin chính thức về chuyện này trong tư liệu.

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

build là agent mặc định, toàn quyền cho việc phát triển. plan 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 đổi qua lại bằng phím Tab.

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

Đó là subagent dành cho tìm kiếm phức tạp và tác vụ nhiều bước. README cho biết 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.

Dữ liệu và code của tôi có an toàn không?

README không mô tả chi tiết cách xử lý dữ liệu. Repo có file SECURITY.md trong thư mục gốc để bạn tham khảo chính sách bảo mật. Với dự án quan trọng, hãy dùng chế độ plan để xem trước và sao lưu code.

Có ứng dụng giao diện thay cho terminal không?

Có. opencode có bản desktop (BETA) cho macOS, Windows và Linux, tải ở opencode.ai/download. Trên macOS cũng có thể cài bằng lệnh brew install --cask opencode-desktop.

Chuyển nhanh tới mục

  1. I.opencode làm được gì
    1. A.Hai agent có sẵn: build và plan
    2. B.Subagent general
    3. C.Nhiều cách cài, nhiều nền tảng
    4. D.Có bản ứng dụng desktop (beta)
    5. E.Tài liệu cấu hình riê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 dùng ứng dụng desktop (beta)
    4. D.Đọc tài liệu để cấu hình
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Làm quen một dự án lạ trước khi sửa
    2. B.Lên kế hoạch sửa lỗi rồi mới làm
    3. C.Nhờ @general tìm giúp việc nhiều bước
    4. D.Dùng bản desktop khi không quen terminal
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Gõ opencode mà terminal báo không tìm thấy lệnh
    2. B.Chạy curl trên Windows bị lỗi
    3. C.npm báo không thấy gói hoặc cài ra phiên bản lạ
    4. D.Cài nhầm bản brew cũ
    5. E.Chế độ plan không sửa file
  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ỏ.