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 là một agent lập trình AI mã nguồn mở (giấy phép MIT) giúp bạn đọc, phân tích và sửa code bằng ngôn ngữ tự nhiên. Có hai chế độ chính là build (toàn quyền) và plan (chỉ đọc), đổi qua lại bằng phím Tab. 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 agent lập trình AI mã nguồn mở: bạn mô tả việc cần làm bằng lời thường, nó đọc mã trong dự án rồi giúp bạn phân tích, lên kế hoạch hoặc sửa code. Repo do nhóm anomalyco phát triển, viết bằng TypeScript, giấy phép MIT. Hiện có khoảng 226.506 sao và 30.658 fork trên GitHub, và vẫn được cập nhật trong 3 tháng gần đây.

Bài này dành cho lập trình viên mới, người làm văn phòng hay kinh doanh có đụng đến code (sửa website, làm file tự động hoá, đọc dự án người khác để lại). Bạn không cần là chuyên gia. Chỉ cần biết mở terminal và gõ lệnh.

Điểm đáng giá nhất là cách chia hai chế độ rõ ràng. Chế độ plan chỉ đọc, không tự sửa file, rất hợp để khám phá dự án lạ. Chế độ build có toàn quyền để bắt tay làm. Bạn đổi qua lại bằng phím Tab nên khá yên tâm khi thử.

Agent

anomalyco/opencode

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

★ 227kTypeScriptMIT
Xem repo trên GitHub

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

Dưới đây là những điểm chính theo README, kèm lợi ích thực tế.

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

  • build là agent mặc định, có đầy đủ quyền cho công việc phát triển. Bạn dùng nó khi đã biết mình muốn gì và để nó bắt tay vào làm.
  • plan là agent chỉ đọc. Mặc định nó từ chối sửa file và hỏi bạn trước khi chạy lệnh bash. Nó hợp để xem một dự án lạ hoặc lên kế hoạch trước khi sửa, đỡ lo bị đổi nhầm file.

Bạn chuyển giữa hai agent bằng phím Tab.

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 dùng nó nội bộ, và bạn cũng có thể gọi trực tiếp bằng @general trong tin nhắn.

C.Nhiều cách cài, có cả bản desktop

Bạn có thể cài bằng script một dòng, npm, Homebrew, pacman, paru, mise hay Nix. Nếu ngại terminal, có bản ứng dụng desktop (đang ở dạng BETA) cho macOS, Windows và Linux.

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

Bạn đọc được toàn bộ mã, tự kiểm tra nó làm gì. Giấy phép MIT khá thoáng cho cả dùng cá nhân lẫn trong công ty.

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

Phần cấu hình chi tiết nằm ở trang tài liệu chính thức. README chỉ trỏ sang đó, nên bài này cũng không bịa thêm chi tiết cấu hình.

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

Tư liệu README chỉ nói những điều sau:

  • Hệ điều hành: bản desktop có file cho macOS (Apple Silicon và Intel), Windows (x64) và Linux (.deb, .rpm, .AppImage). Các lệnh cài qua terminal được ghi cho macOS, Linux, Arch Linux, Nix và mise (mise ghi là dùng được mọi hệ điều hành).
  • Terminal: bạn cần biết mở cửa sổ dòng lệnh để dùng cách cài bằng lệnh.
  • Gỡ bản cũ: README khuyên gỡ các phiên bản cũ hơn 0.1.x trước khi cài.
  • Trình quản lý gói: tuỳ cách cài, bạn cần npm (hoặc bun/pnpm/yarn), Homebrew, pacman, paru, mise hoặc Nix.

README chưa ghi yêu cầu về phiên bản Node, về phần cứng, về tài khoản hay API key. Nếu bạn cần kết nối một mô hình AI, hãy xem trang tài liệu tại opencode.ai/docs.

README không nói về chi phí hay API key. Nếu sau này bạn kết nối một dịch vụ AI tính phí, hãy đọc kỹ trang tài liệu và theo dõi mức sử dụng. Không dán key vào chỗ công khai, và không đưa key lên GitHub.

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

  1. Mở terminalMở cửa sổ dòng lệnh trên máy của bạn
  2. Gỡ bản cũXoá các phiên bản cũ hơn 0.1.x nếu có
  3. Chọn cách càiDùng script một dòng, npm, Homebrew hoặc trình quản lý gói khác
  4. Chạy lệnh càiDán đúng lệnh từ README vào terminal
  5. Hoặc tải bản desktopTải file cài từ trang tải xuống của dự án

A.Mở terminal

Trên macOS và Linux, bạn mở ứng dụng Terminal. Trên Windows, README chưa nói rõ nên dùng terminal nào cho các lệnh cài. Nếu bạn dùng Windows và thấy khó, cách dễ nhất là tải file opencode-desktop-win-x64.exe ở bước dưới.

B.Gỡ bản cũ

README dặn: gỡ các phiên bản cũ hơn 0.1.x trước khi cài. README không ghi cách gỡ, nên nếu bạn từng cài bản cũ, hãy gỡ theo đúng cách bạn đã cài (ví dụ cài bằng npm thì gỡ bằng npm).

C.Cách 1: script một dòng

Đây là cách nhanh nhất mà README gọi vui là "YOLO", nghĩa là cứ chạy luôn:

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

Lệnh này tải script từ trang chính thức rồi chạy bằng bash. Theo README, script cài OpenCode vào thư mục $HOME/.opencode/bin. Bạn nên mở thử địa chỉ script trong trình duyệt để đọc trước khi chạy nếu muốn chắc chắn.

D.Cách 2: qua trình quản lý gói

README liệt kê các lệnh sau. Bạn chọn một dòng hợp với máy của mình:

Terminal
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 npm cài toàn cục (-g). README ghi có thể thay bằng bun, pnpm hoặc yarn.
  • Hai dòng brew dành cho macOS và Linux. README khuyên dùng bản anomalyco/tap/opencode-v2 vì luôn mới nhất. Bản brew install opencode là công thức chính thức của Homebrew nhưng cập nhật chậm hơn.
  • pacman và paru dành cho Arch Linux. paru lấy bản mới nhất từ AUR.
  • mise chạy được trên mọi hệ điều hành.
  • nix run chạy trực tiếp từ GitHub bằng Nix.

Chỗ dễ vấp: tên gói ở dòng npm (@opencode/cli) khác với tên opencode ở các dòng còn lại, và hệ thống thông tin của repo ghi tên gói npm là opencode. Mình chỉ chép đúng README, nên nếu dòng npm báo lỗi, bạn thử các cách cài khác hoặc xem lại hướng dẫn chính thức tại opencode.ai/docs.

E.Cách 3: tải bản desktop (BETA)

Vào trang opencode.ai/download và chọn đúng file cho máy bạn:

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
brew install --cask opencode-desktop

Bản này đang ở dạng beta, nên có thể còn lỗi vặt.

F.Lấy mã nguồn về xem (tuỳ chọn)

Bạn không cần bước này để dùng OpenCode. Nó chỉ dành cho người muốn đọc mã hoặc đóng góp:

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

README không hướng dẫn build từ mã nguồn. Nếu muốn đóng góp, hãy đọc file CONTRIBUTING.md trong repo.

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

README chưa ghi lệnh kiểm tra phiên bản hay lệnh khởi chạy cụ thể. Bạn có thể làm như sau:

  1. Đóng terminal cũ rồi mở cửa sổ mới, để máy nhận đường dẫn cài đặt mới.
  2. Tên gói là opencode, nên bạn thử gõ opencode trong thư mục dự án của mình. Đây là suy đoán hợp lý từ tên gói chứ README không ghi rõ. Nếu máy báo không tìm thấy lệnh, hãy xem trang tài liệu.
  3. Nếu cài bằng script, README nói file được đặt ở $HOME/.opencode/bin. Bạn có thể kiểm tra xem thư mục này có tồn tại không.
  4. Nếu cài bản desktop, chỉ cần mở ứng dụng lên. Thấy giao diện hiện ra là đã chạy.

Khi giao diện đã mở, thử bấm Tab để chuyển giữa build và plan. README nói hai agent này đổi qua lại bằng phím đó. Đổi được là bạn đã chạy đúng.

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

Dưới đây là các tình huống bám theo khả năng có trong tư liệu (agent build/plan, subagent general). Câu lệnh mẫu là prompt tiếng Việt bạn gõ vào khung chat, không phải lệnh terminal.

A.Dev mới nhận một dự án lạ

Bạn vừa vào công ty và được giao một dự án chưa từng đọc. Bạn mở terminal trong thư mục dự án, khởi chạy OpenCode và để ở chế độ plan (chỉ đọc, an toàn). Rồi gõ:

text
Giải thích cấu trúc thư mục dự án này. File nào là điểm bắt đầu của ứng dụng?

Kết quả bạn nhận được là bản tóm tắt cấu trúc dự án, không file nào bị sửa. README nói rõ chế độ này hợp để khám phá mã lạ.

Hỏi ở chế độ plan trước, sửa ở chế độ build sau. Hai bước nhưng đỡ hối hận.

Ông T

B.Chủ shop muốn sửa nhỏ trên website

Bạn có một trang web bán hàng đơn giản do thợ làm trước đó và muốn đổi dòng chữ khuyến mãi ở đầu trang. Trước tiên, ở chế độ plan, bạn hỏi:

text
Dòng chữ khuyến mãi ở đầu trang nằm ở file nào? Đề xuất cách sửa.

Đọc kế hoạch xong và thấy hợp lý, bạn bấm Tab sang build, rồi gõ: "Làm theo kế hoạch vừa rồi." Kết quả là file được sửa đúng chỗ. Với dự án quan trọng, bạn nên sao lưu hoặc dùng Git để xem lại thay đổi.

C.Nhân viên văn phòng cần tìm thông tin trong nhiều file

Bạn có một thư mục với nhiều file script hoặc tài liệu mà không nhớ chỗ nào xử lý báo cáo doanh thu. README nói subagent general dùng cho tìm kiếm phức tạp và việc nhiều bước, gọi được bằng @general. Bạn gõ:

text
@general tìm trong dự án tất cả chỗ có xử lý báo cáo doanh thu và liệt kê tên file

Bạn nhận được danh sách các nơi liên quan để tự xem tiếp, thay vì mở từng file.

D.Dev lên kế hoạch trước khi đổi lớn

Bạn định đổi cách lưu dữ liệu trong ứng dụng và muốn biết sẽ ảnh hưởng đến những đâu. Dùng chế độ plan:

text
Nếu mình đổi cách lưu dữ liệu người dùng, những file nào sẽ bị ảnh hưởng? Lập kế hoạch từng bước, chưa sửa gì.

Vì plan hỏi lại trước khi chạy lệnh bash và từ chối sửa file theo mặc định, bạn có danh sách việc cần làm mà không lo bị đổi mã ngoài ý muốn.

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

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

Thường do cửa sổ terminal cũ chưa nhận đường dẫn mới. Hãy đóng hẳn terminal rồi mở lại. Nếu cài bằng script, README nói file nằm ở $HOME/.opencode/bin, nên bạn kiểm tra thư mục này có được thêm vào đường dẫn lệnh của máy hay chưa.

B.Dòng lệnh npm báo lỗi không tìm thấy gói

Tên gói npm trong README (@opencode/cli) khác với tên gói opencode ghi trong thông tin repo. Nếu báo lỗi, đừng cố sửa mò. Hãy thử cách cài khác trong danh sách (script, brew, mise…) hoặc xem trang tài liệu chính thức.

C.Cài chồng lên bản cũ gây xung đột

README dặn gỡ các phiên bản cũ hơn 0.1.x trước khi cài. Nếu gặp hành vi lạ sau khi cài, hãy kiểm tra xem máy có đang giữ hai bản cùng lúc không, rồi gỡ bản cũ theo đúng cách bạn đã cài nó.

D.Agent không chịu sửa file

Có thể bạn đang ở chế độ plan. Chế độ này từ chối sửa file theo mặc định. Hãy bấm Tab để sang build nếu bạn thật sự muốn nó sửa. Nhớ đọc kế hoạch kỹ trước khi chuyển.

E.Bản desktop gặp lỗi lặt vặt

Bản desktop ghi rõ là BETA. Nếu gặp lỗi, thử dùng bản dòng lệnh. Nếu vẫn gặp, tìm trên trang GitHub của dự án xem đã có ai báo cáo chưa, hoặc hỏi ở cộng đồng Discord mà README có nhắc.

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

Điểm mạnh

  • Mã nguồn mở, giấy phép MIT, ai cũng đọc và kiểm tra được.
  • Chia chế độ plan (chỉ đọc) và build (toàn quyền) rõ ràng, giúp người mới đỡ sợ.
  • Nhiều cách cài, có cả bản desktop nếu bạn ngại terminal.
  • Cộng đồng lớn (hiện có khoảng 226.506 sao) và repo còn được cập nhật đều.

Giới hạn

  • README khá ngắn: chưa nói rõ lệnh khởi chạy, yêu cầu phiên bản, cách nối mô hình AI hay chi phí. Bạn phải đọc thêm trang tài liệu.
  • Tên gói trong các dòng cài đặt chưa thống nhất (@opencode/cli, opencode, opencode-v2, opencode-beta), dễ gây rối cho người mới.
  • Bản desktop vẫn là beta.
  • Chưa có thông tin về cách xử lý dữ liệu và mã của bạn khi dùng với một dịch vụ AI bên ngoài. Hãy kiểm tra trong tài liệu trước khi dùng với mã nhạy cảm.

Khi nào 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 AI thông thường là đủ. Nếu bạn cần một công cụ được hỗ trợ thương mại với cam kết rõ ràng về dữ liệu, hãy xem kỹ điều khoản của công cụ đó. Còn nếu bạn muốn một trợ lý lập trình mã nguồn mở, có chế độ chỉ đọc để thử an toàn, OpenCode đáng để cài thử. Bạn có thể bắt đầu bằng chế độ plan trên một dự án nhỏ.

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ở với giấy phép MIT. README không nói gì 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 chắc chắn. Bạn nên xem trang tài liệu opencode.ai/docs trước khi dùng.

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

Có bản desktop cho Windows (file `opencode-desktop-win-x64.exe`), hiện ở dạng BETA. README không nói rõ các lệnh cài qua terminal có chạy trên Windows hay không, nên nếu dùng Windows bạn nên dùng bản desktop hoặc xem tài liệu chính thức.

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

README không ghi yêu cầu phần cứng, nên chưa có thông tin về việc này. Bạn xem thêm tại trang tài liệu của dự án.

Khác nhau giữa chế độ build và plan là gì?

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

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

README không nhắc đến API key hay tài khoản. Chưa có thông tin về việc này trong tư liệu. Cách cấu hình được dẫn sang trang tài liệu tại opencode.ai/docs.

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

Tư liệu không nói về cách xử lý dữ liệu. Điều README nói là chế độ plan hỏi quyền trước khi chạy lệnh bash và từ chối sửa file theo mặc định. Với mã nhạy cảm, bạn nên đọc kỹ tài liệu và file SECURITY.md trong repo.

Có bản giao diện đồ hoạ không, hay chỉ dùng terminal?

Có. OpenCode có bản ứng dụng desktop (BETA) cho macOS, Windows và Linux, tải tại opencode.ai/download. Trên macOS bạn 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 cho việc tìm kiếm phức tạp
    3. C.Nhiều cách cài, có cả bản desktop
    4. D.Mã nguồn mở, giấy phép MIT
    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.Mở terminal
    2. B.Gỡ bản cũ
    3. C.Cách 1: script một dòng
    4. D.Cách 2: qua trình quản lý gói
    5. E.Cách 3: tải bản desktop (BETA)
    6. F.Lấy mã nguồn về xem (tuỳ chọn)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev mới nhận một dự án lạ
    2. B.Chủ shop muốn sửa nhỏ trên website
    3. C.Nhân viên văn phòng cần tìm thông tin trong nhiều file
    4. D.Dev lên kế hoạch trước khi đổi lớn
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Máy báo không tìm thấy lệnh sau khi cài
    2. B.Dòng lệnh npm báo lỗi không tìm thấy gói
    3. C.Cài chồng lên bản cũ gây xung đột
    4. D.Agent không chịu sửa file
    5. E.Bản desktop gặp lỗi lặt vặt
  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ỏ.