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

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 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), viết bằng TypeScript. Nó có hai chế độ: build để làm việc toàn quyền và plan để chỉ đọc, phân tích. Cài khá dễ: chỉ cần một dòng lệnh, hoặc tải bản ứng dụng desktop (đang BETA).

opencode là một agent lập trình AI mã nguồn mở. Nó là trợ lý AI đọc code của bạn, trả lời câu hỏi về dự án và hỗ trợ sửa code. Tác giả mô tả ngắn gọn là «The open source coding agent». Hiện repo có khoảng 226.506 sao và 30.658 fork trên GitHub, giấy phép MIT, nên dùng cá nhân hay đi làm đều không vướng.

Bạn nên thử nếu là lập trình viên mới, người tự làm website hoặc công cụ nội bộ, hay nhân viên văn phòng có chút kỹ thuật. Bạn không muốn copy từng đoạn code qua lại giữa trình duyệt và trình soạn thảo. Thay vào đó, bạn mở agent ngay trong thư mục dự án và nói chuyện với nó.

Điểm đáng giá nhất là hai chế độ có sẵn. Chế độ build có toàn quyền làm việc. Chế độ plan chỉ đọc, mặc định không sửa file và hỏi bạn trước khi chạy lệnh. Bạn có thể khám phá một dự án lạ mà không sợ nó lỡ tay sửa gì. Bài này mình đi từ cài đặt đến vài tình huống dùng thật.

Agent

anomalyco/opencode

opencode là agent lập trình AI mã nguồn mở, giúp đọc, giải thích và sửa code qua hai chế độ build (toàn quyền) và plan (chỉ đọc).

★ 227kTypeScriptMIT
Xem repo trên GitHub

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

A.Hai chế độ làm việc, đổi bằng phím Tab

opencode có sẵn hai agent và bạn đổi qua lại bằng phím Tab:

  • buildchế độ 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 làm gì.
  • planchế độ 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 quyền trước khi chạy lệnh bash. Rất hợp khi bạn vừa nhận một dự án lạ, hoặc muốn có kế hoạch trước khi bắt tay sửa.

Lợi ích thực tế: bạn có một «lớp an toàn». Cứ để plan đọc và đề xuất, thấy ổn rồi mới chuyển sang build.

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

Ngoài hai agent chính còn có agent phụ general, dùng cho các tìm kiếm phức tạp và nhiệm vụ 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. Ví dụ khi cần lần theo một chức năng rải ở nhiều file, bạn nhờ general tìm giúp.

C.Nhiều cách cài, nhiều hệ điều hành

README liệt kê khá nhiều cách cài: script một dòng, npm/bun/pnpm/yarn, Homebrew, Arch Linux, mise, Nix. Ngoài ra còn có ứng dụng desktop bản BETA cho macOS, Windows và Linux. Bạn chọn cách quen tay nhất.

D.Mã nguồn mở và có tài liệu riêng

Vì là mã nguồn mở, bạn đọc được nó chạy thế nào, và cộng đồng có thể đóng góp. Cách cấu hình chi tiết nằm ở trang tài liệu chính thức của dự án (opencode.ai/docs). Repo còn được cập nhật trong 3 tháng gần đây nên chưa phải dự án bỏ hoang.

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

Tư liệu README không ghi nhiều yêu cầu. Mình chỉ nêu những gì có trong đó:

  • Hệ điều hànhREADME nhắc macOS, Linux (kể cả Arch Linux), và gói desktop cho Windows. Cách cài bằng dòng lệnh dưới đây được ghi cho macOS/Linux hoặc qua trình quản lý gói. README chưa ghi rõ có chạy script curl trên Windows hay không.
  • Phiên bản Node/PythonREADME chưa nêu yêu cầu phiên bản cụ thể.
  • Tài khoản, API key, phần cứngREADME chưa nói gì về việc phải có tài khoản hay API key, cũng không đề cập GPU. Cách kết nối mô hình AI nằm trong tài liệu cấu hình, bạn xem ở trang docs của dự án.
  • Dọn bản cũREADME có một lưu ý: nếu bạn đang có phiên bản cũ hơn 0.1.x thì hãy gỡ đi trước khi cài.
  • Biết dùng terminal cơ bảnbạn cần biết mở terminal và cd vào thư mục dự án.

README chưa nói chi phí hay việc cần key. Khi bạn kết nối một dịch vụ mô hình AI ở bước cấu hình, hãy tự kiểm tra cách tính tiền của dịch vụ đó. Đừng dán key vào chỗ công khai, đừng đưa key vào file mà bạn sẽ đẩy lên GitHub.

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

  1. Gỡ bản cũNếu đang có bản cũ hơn 0.1.x thì gỡ trước
  2. Chọn cách càiScript một dòng, npm, hoặc trình quản lý gói như brew
  3. Chạy lệnh càiDán lệnh vào terminal và đợi xong
  4. Mở dự áncd vào thư mục dự án của bạn rồi chạy opencode
  5. Hoặc dùng bản desktopTải file cài đặt cho hệ điều hành của bạn

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

README dặ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. README không ghi lệnh gỡ riêng, nên nếu cần gỡ, bạn dùng đúng trình quản lý gói mà lúc trước bạn đã dùng để cài.

B.Cách nhanh nhất: script một dòng

README ghi chú đùa là «YOLO», nghĩa là cài nhanh, không cần nghĩ nhiều. Bạn mở terminal rồi dán:

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

Lệnh này tải script cài đặt từ trang của dự án rồi chạy luôn. Script cài opencode vào thư mục $HOME/.opencode/bin. Người mới hay vấp ở chỗ này: nếu sau khi cài, gõ opencode mà báo không tìm thấy lệnh, hãy đóng terminal mở lại. Nếu vẫn không được, có thể thư mục trên chưa nằm trong PATH của bạn.

Vì script chạy thẳng trên máy, bạn nên chỉ chạy nó khi đã tin nguồn. Ở đây là trang chính của dự án.

C.Cài bằng npm, bun, pnpm hoặc yarn

Nếu bạn đã quen npm, README ghi:

Terminal
npm i -g @opencode/cli@latest      # or bun/pnpm/yarn

Lệnh này cài gói ở chế độ toàn cục (-g), nên gõ tên lệnh ở bất kỳ thư mục nào cũng dùng được. Phần chú thích cuối dòng cho biết bạn có thể thay bằng bun, pnpm hoặc yarn.

D.Cài bằng trình quản lý gói khác

README liệt kê các lệnh sau, chọn đúng dòng cho hệ của bạn:

Terminal
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:

  • Hai dòng brew dành cho macOS và Linux. README khuyên dùng dòng đầu vì luôn mới nhất. Dòng thứ hai là gói chính thức của Homebrew, được cập nhật ít hơn.
  • pacman và paru dành cho Arch Linux. paru lấy bản mới nhất từ AUR.
  • mise chạy trên mọi hệ điều hành, nếu bạn đã dùng mise.
  • nix run dành cho người dùng Nix.

E.Hoặc dùng ứng dụng desktop (BETA)

Nếu bạn không thích terminal, opencode có bản ứng dụng desktop, đang ở giai đoạn BETA. Tải ở trang opencode.ai/download. README liệt kê các file như sau:

  • macOS chip Apple Silicon: opencode-desktop-mac-arm64.dmg
  • macOS chip 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

Vì là bản BETA, bạn nên chuẩn bị tinh thần là có thể còn lỗi nhỏ. Người dùng Windows muốn thử nhanh có thể bắt đầu từ file .exe này.

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

README không có mục «kiểm tra cài đặt» riêng và không ghi lệnh kiểm tra phiên bản. Cách kiểm tra mình gợi ý, dựa trên những gì README mô tả:

  1. Mở terminal mới, dùng lệnh cd để vào thư mục một dự án nhỏ của bạn. Nếu chưa biết đường dẫn, cứ kéo thả thư mục vào cửa sổ terminal.
  2. Gõ tên lệnh opencode rồi nhấn Enter.
  3. Nếu giao diện của opencode hiện ra, bạn cài thành công. Lúc này thử nhấn Tab để chuyển giữa hai agent build và plan.

Nếu máy báo không tìm thấy lệnh, xem phần lỗi thường gặp bên dưới. Với bản desktop, chỉ cần mở ứng dụng lên là biết chạy được hay chưa.

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

Các tình huống dưới đây chỉ dựa vào những khả năng có trong README: hai chế độ build và plan, đổi bằng Tab, và gọi @general. Câu lệnh mẫu là gợi ý để bạn bắt đầu, bạn cứ viết lại theo dự án của mình.

A.Chủ shop nhận lại website cũ từ người làm trước

Bạn có một website bán hàng do người khác dựng, giờ muốn hiểu nó được tổ chức thế nào. Trước hết, mở terminal ở thư mục website, chạy opencode, nhấn Tab để sang chế độ plan. Rồi nhập câu như:

text
Hãy đọc dự án này và giải thích bằng tiếng Việt đơn giản: trang nào nằm ở file nào, và phần giỏ hàng được xử lý ở đâu.

Vì plan chỉ đọc nên không có chuyện nó tự ý sửa file. Kết quả bạn nhận được là một bản mô tả cấu trúc dự án, đủ để bạn trao đổi với thợ lập trình hoặc tự quyết định sửa chỗ nào.

Cứ để plan đọc và đề xuất trước, thấy hợp lý rồi mới bật build cho nó làm.

Ông T

B.Lập trình viên mới đọc một repo lạ

Bạn vừa vào công ty và được giao một repo chưa từng thấy. Ở chế độ plan, bạn hỏi:

text
Dự án này chạy bằng cách nào? File nào là điểm bắt đầu? Liệt kê các thư mục chính và vai trò của từng thư mục.

Nếu câu hỏi cần lục nhiều file, bạn có thể gọi agent phụ bằng @general, ví dụ: @general tìm giúp mình mọi chỗ gọi tới hàm gửi email. Bạn nhận lại danh sách các chỗ liên quan, tiết kiệm công tự mở từng file. README mô tả general dùng cho «tìm kiếm phức tạp và nhiệm vụ nhiều bước», nên đây là đúng chỗ dùng nó.

C.Lên kế hoạch trước khi sửa một chức năng

Bạn muốn thêm chức năng mới, ví dụ thêm ô «ghi chú đơn hàng» vào form đặt hàng, nhưng ngại sửa lung tung. Cách làm: ở chế độ plan, mô tả yêu cầu và xin một kế hoạch từng bước:

text
Mình muốn thêm ô ghi chú đơn hàng vào form đặt hàng. Hãy đề xuất kế hoạch: cần sửa những file nào và theo thứ tự nào. Chưa sửa gì cả.

Khi đọc kế hoạch thấy ổn, bạn nhấn Tab sang build và bảo nó làm theo. Kết quả là bạn kiểm soát được từng giai đoạn: đọc trước, hiểu rồi mới cho sửa.

D.Nhờ trợ lý làm việc vặt trong dự án cá nhân

Bạn đang làm một công cụ nhỏ cho văn phòng, ví dụ trang tổng hợp báo cáo. Ở chế độ build, bạn giao việc cụ thể:

text
Đọc file báo cáo hiện tại và thêm một hàm tính tổng doanh thu theo tháng. Giải thích ngắn bạn đã sửa gì.

Build có toàn quyền nên nó có thể sửa file thật. Thói quen tốt là bạn giữ dự án trong Git và xem lại thay đổi trước khi dùng. Như vậy lỡ có chỗ không ưng, bạn quay lại bản trước được.

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

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

Thường là terminal chưa nhận lệnh mới. Hãy đóng terminal rồi mở lại. Nếu bạn cài bằng script, README cho biết nó được cài vào $HOME/.opencode/bin. Kiểm tra xem thư mục đó có tồn tại không và đã nằm trong PATH của bạn chưa. Nếu bạn chưa quen sửa PATH, cài lại bằng npm hoặc brew sẽ đỡ rắc rối hơn.

B.Cài bản mới nhưng vẫn ra bản cũ

README dặn gỡ phiên bản cũ hơn 0.1.x trước khi cài. Nếu bạn từng cài opencode theo nhiều cách (ví dụ cả brew lẫn npm), máy có thể chạy nhầm bản cũ. Hãy gỡ các bản trùng, chỉ giữ một cách cài rồi thử lại.

C.Lỗi quyền khi cài npm toàn cục

Lệnh npm i -g đôi khi báo lỗi quyền (permission) trên máy dùng nhiều tài khoản. Đừng vội dùng quyền quản trị cho mọi thứ. Hãy thử một cách cài khác trong README, như script một dòng hoặc brew. README không hướng dẫn sửa lỗi này nên mình không đưa lệnh cụ thể.

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

Chế độ build có toàn quyền, nên nó có thể sửa file mà bạn chưa muốn. Cách phòng: dùng Git và lưu lại trước khi nhờ nó sửa, hoặc đổi sang plan để chỉ xem đề xuất. Với dự án quan trọng, hãy đọc kỹ thay đổi trước khi dùng.

E.Nhầm với các dự án khác có tên «opencode»

README nhắc: những dự án có «opencode» trong tên (như opencode-dashboard hay opencode-mobile) không phải do nhóm opencode làm và không liên kết với họ. Khi tìm công cụ bổ sung, bạn hãy kiểm tra kỹ nguồn trước khi cài.

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

Điểm mạnh. opencode miễn phí theo giấy phép MIT và là mã nguồn mở. Hai chế độ build/plan rất dễ hiểu và cho bạn một đường vào an toàn: đọc trước, sửa sau. Có nhiều cách cài, kể cả bản desktop cho người ngại terminal. Dự án đông người theo dõi (khoảng 226 nghìn sao) và còn được cập nhật gần đây.

Giới hạn. README rất ngắn. Phần cấu hình, kết nối mô hình AI và chi phí đều phải đọc thêm ở trang tài liệu chính thức, vì README chưa nói. Bản desktop vẫn là BETA. README cũng chưa ghi yêu cầu cụ thể về phiên bản Node hay hướng dẫn riêng cho Windows ở cách cài bằng dòng lệnh. Lệnh cài bằng npm trong README dùng tên gói @opencode/cli, còn thông tin của repo ghi tên gói npm là opencode, nên bạn hãy đối chiếu lại với trang chính thức trước khi cài.

Khi nào chọn cách khác. Nếu bạn hoàn toàn không đụng tới terminal và không muốn thử bản BETA, một trợ lý AI dạng web có thể dễ hơn cho việc hỏi đáp thông thường. Nếu bạn cần cam kết về dữ liệu hay bảo mật cho dự án của công ty, hãy đọc kỹ SECURITY.md trong repo và tài liệu chính thức trước khi đưa code thật vào. Còn nếu bạn muốn một trợ lý đọc code, lên kế hoạch và sửa ngay trong dự án, mã nguồn mở, cài nhanh, thì opencode đáng để thử.

4.8/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 repo là mã nguồn mở với giấy phép MIT nên dùng tự do. Tuy nhiên README chưa nói gì về chi phí của dịch vụ mô hình AI mà bạn có thể kết nối. Phần này bạn cần xem thêm ở trang tài liệu chính thức của dự án.

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

README có liệt kê file cài đặt ứng dụng desktop cho Windows là opencode-desktop-win-x64.exe, hiện đang BETA. Các lệnh cài bằng dòng lệnh trong README chủ yếu ghi cho macOS và Linux, riêng mise được ghi là chạy trên mọi hệ điều hành. Việc script curl có chạy trên Windows hay không, README chưa nói.

opencode có cần GPU hay máy cấu hình mạnh không?

Tư liệu README không đề cập yêu cầu phần cứng hay GPU, nên chưa có thông tin chính thức về việc này. Bạn nên xem thêm ở trang docs của dự án.

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

Build là agent mặc định, 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 quyền trước khi chạy lệnh bash. Bạn đổi giữa hai chế độ bằng phím Tab.

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

README không có phần nào nói về cách xử lý dữ liệu. Repo có file SECURITY.md ở thư mục gốc, bạn nên đọc nó. Với dự án quan trọng, hãy dùng chế độ plan để chỉ đọc và tự đánh giá rủi ro trước khi cho phép sửa hay chạy lệnh.

@general là gì và dùng khi nào?

General là agent phụ dành cho tìm kiếm phức tạp và các nhiệm vụ 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.

Tôi nên cài bằng cách nào cho dễ nhất?

Cách ngắn nhất là chạy một dòng lệnh curl của script cài đặt. Nếu bạn đã quen npm hoặc Homebrew thì dùng luôn các lệnh tương ứng trong README. Người không thích terminal có thể tải ứng dụng desktop bản BETA ở trang tải về của dự án.

Chuyển nhanh tới mục

  1. I.opencode làm được gì
    1. A.Hai chế độ làm việc, đổi bằng phím Tab
    2. B.Agent phụ general cho việc tìm kiếm phức tạp
    3. C.Nhiều cách cài, nhiều hệ điều hành
    4. D.Mã nguồn mở và có tài liệu 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.Cách nhanh nhất: script một dòng
    3. C.Cài bằng npm, bun, pnpm hoặc yarn
    4. D.Cài bằng trình quản lý gói khác
    5. E.Hoặc dùng ứng dụng desktop (BETA)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop nhận lại website cũ từ người làm trước
    2. B.Lập trình viên mới đọc một repo lạ
    3. C.Lên kế hoạch trước khi sửa một chức năng
    4. D.Nhờ trợ lý làm việc vặt trong dự án cá nhân
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Gõ opencode báo «không tìm thấy lệnh»
    2. B.Cài bản mới nhưng vẫn ra bản cũ
    3. C.Lỗi quyền khi cài npm toàn cục
    4. D.Agent sửa file ngoài ý muốn
    5. E.Nhầm với các dự án khác có tên «opencode»
  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ỏ.