anomalyco/opencode: trợ lý lập trình AI mã nguồn mở — hướng dẫn cài đặt và dùng
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 →

Tóm tắt nhanh
OpenCode là coding agent AI mã nguồn mở viết bằng TypeScript, hỗ trợ khám phá code, lập kế hoạch và thực hiện công việc phát triển phần mềm. Repo có nhiều cách cài qua script, npm, Homebrew, Nix hoặc ứng dụng desktop; Windows có bản desktop, còn cách cài CLI trên Windows chưa được README mô tả.
OpenCode là một coding agent AI mã nguồn mở, được thiết kế để hỗ trợ bạn làm việc trực tiếp với code và dự án phần mềm. Công cụ có agent build để phát triển với quyền truy cập đầy đủ, agent plan để chỉ đọc và phân tích, cùng subagent general cho các tìm kiếm phức tạp hoặc tác vụ nhiều bước.
Repo phù hợp với lập trình viên mới, nhóm phát triển nhỏ, nhân viên kỹ thuật và người muốn có một trợ lý AI trong quy trình viết phần mềm. Điểm đáng giá là bạn có thể chuyển đổi giữa chế độ thực hiện và chế độ lập kế hoạch bằng phím Tab, đồng thời dùng chế độ chỉ đọc để khám phá một codebase lạ trước khi cho phép chỉnh sửa.
Dự án dùng TypeScript, giấy phép MIT và vẫn còn được cập nhật. Repo hiện có khoảng 226580 sao và 30675 fork. README cung cấp nhiều lựa chọn cài đặt, từ npm, Homebrew, Nix đến ứng dụng desktop beta.
anomalyco/opencode
OpenCode là coding agent AI mã nguồn mở, hỗ trợ phân tích, lập kế hoạch và phát triển phần mềm trong nhiều loại dự án.
I.OpenCode làm được gì
OpenCode tập trung vào việc hỗ trợ bạn xử lý công việc lập trình trong một dự án. README không mô tả từng lệnh nghiệp vụ cụ thể, nhưng các agent và cách dùng được công bố cho thấy những khả năng chính sau.
Phát triển với agent build:
buildlà agent mặc định và có quyền truy cập đầy đủ để hỗ trợ công việc phát triển. Đây là lựa chọn phù hợp khi bạn muốn agent tham gia trực tiếp vào quá trình làm phần mềm.Phân tích code an toàn hơn với agent plan:
planlà agent chỉ đọc. Agent này mặc định từ chối chỉnh sửa file và hỏi quyền trước khi chạy lệnh bash. Bạn có thể dùng nó để làm quen một repo, tìm luồng xử lý hoặc lập kế hoạch thay đổi trước khi thực hiện.Chuyển agent nhanh bằng phím Tab: OpenCode cho phép chuyển giữa hai agent tích hợp bằng phím
Tab. Điều này hữu ích khi bạn muốn đi từ giai đoạn tìm hiểu sang triển khai mà không phải bắt đầu lại phiên làm việc.Tìm kiếm nhiều bước với subagent general: Repo có thêm subagent
generalcho các tìm kiếm phức tạp và tác vụ nhiều bước. README cho biết có thể gọi subagent này bằng@generaltrong tin nhắn.Làm việc với codebase chưa quen: Chế độ
planđược giới thiệu là phù hợp để khám phá các codebase xa lạ hoặc lập kế hoạch thay đổi. Người mới có thể bắt đầu bằng việc đọc và hỏi, sau đó mới chuyển sang agent có quyền phát triển.Cài đặt theo nhiều môi trường: Bạn có thể cài bằng script, npm, Bun, pnpm, Yarn, Homebrew, pacman, AUR, mise hoặc Nix. Cách này giúp chọn phương án gần với công cụ bạn đang dùng.
Dùng ứng dụng desktop: OpenCode có ứng dụng desktop beta cho macOS, Windows và Linux. Đây là lựa chọn dễ tiếp cận hơn nếu bạn không muốn bắt đầu bằng việc cấu hình CLI.
II.Cần chuẩn bị gì
Bạn cần xác định trước mình muốn dùng bản dòng lệnh hay bản desktop. README liệt kê các gói cài đặt cho macOS, Linux, Arch Linux, Nix và nhiều trình quản lý package. README cũng liệt kê file cài desktop cho Windows.
Nếu dùng CLI, bạn cần một môi trường có thể chạy một trong các phương án được README hỗ trợ: script cài đặt, npm, Bun, pnpm, Yarn, Homebrew, pacman, paru, mise hoặc Nix. README không nêu phiên bản Node.js, Bun, pnpm, Yarn hay hệ điều hành tối thiểu cụ thể.
Nếu dùng desktop, README cung cấp các lựa chọn cho macOS Apple Silicon, macOS Intel, Windows và Linux. Bản desktop được đánh dấu là beta.
README không nêu yêu cầu GPU, dung lượng RAM, tài khoản bắt buộc, API key hay nhà cung cấp mô hình cụ thể. Vì vậy, không nên tự suy đoán các yêu cầu này chỉ từ phần README.
Trước khi cài, README khuyên bạn gỡ các phiên bản OpenCode cũ hơn 0.1.x. Đây là lưu ý quan trọng nếu máy đã từng cài OpenCode.
README không nêu chi tiết API key, cấu hình nhà cung cấp mô hình hoặc cách xử lý dữ liệu. Nếu công việc của bạn chứa code riêng tư, hãy đọc thêm tài liệu cấu hình và chính sách bảo mật của dự án trước khi đưa code vào agent.
III.Cài đặt từng bước
- Chọn cách càiChọn CLI hoặc ứng dụng desktop phù hợp với hệ điều hành
- Gỡ bản cũXóa các phiên bản OpenCode cũ hơn 0.1.x nếu máy đã có
- Cài OpenCodeDùng script, npm, Homebrew, Nix hoặc bộ cài desktop
- Mở tài liệuXem tài liệu chính thức để cấu hình và dùng agent
- Chọn agentDùng plan để đọc và lập kế hoạch, build để phát triển
A.Chọn bản dòng lệnh hoặc desktop
Nếu bạn quen terminal và muốn OpenCode nằm trong quy trình phát triển, hãy chọn CLI. Nếu bạn dùng Windows hoặc muốn bắt đầu bằng giao diện ứng dụng, README có bản desktop beta.
README cung cấp bộ cài desktop cho các nền tảng sau:
- macOS Apple Silicon:
opencode-desktop-mac-arm64.dmg - macOS Intel:
opencode-desktop-mac-x64.dmg - Windows:
opencode-desktop-win-x64.exe - Linux:
.deb,.rpmhoặc.AppImage
README không ghi lệnh cài CLI dành riêng cho Windows. Vì vậy, người dùng Windows nên ưu tiên bộ cài desktop được README liệt kê, hoặc đọc tài liệu của dự án trước khi thử một cách cài CLI khác.
B.Gỡ phiên bản cũ
Nếu bạn đã từng cài OpenCode, hãy kiểm tra và gỡ phiên bản cũ hơn 0.1.x trước khi cài bản mới. README chỉ đưa ra cảnh báo này, không ghi một lệnh gỡ chung cho mọi hệ điều hành.
Bạn không nên chạy một lệnh gỡ ngẫu nhiên khi chưa biết OpenCode được cài bằng cách nào. Nếu cài qua Homebrew, npm, Nix hoặc một trình quản lý khác, hãy dùng đúng cách gỡ của công cụ đó.
C.Cài bằng script
Đây là phương án YOLO được README cung cấp. Mở terminal, dán nguyên lệnh sau rồi chạy:
curl -fsSL https://opencode.ai/v2/install | bashLệnh dùng curl để tải script cài đặt từ địa chỉ của OpenCode rồi chuyển nội dung cho bash thực thi. Bạn cần mở terminal có sẵn curl và bash.
README cho biết script cài OpenCode vào thư mục $HOME/.opencode/bin. Nếu shell chưa nhận được lệnh sau khi cài, hãy kiểm tra thư mục này và phần cấu hình PATH theo hướng dẫn của dự án. README không ghi lệnh PATH cụ thể, nên không nên tự thêm một cấu hình chưa được kiểm chứng.
D.Cài bằng npm hoặc trình quản lý package
README đưa ra lệnh npm sau:
npm i -g @opencode/cli@latestLệnh cài gói CLI toàn cục và lấy bản latest. README cũng nói có thể dùng Bun, pnpm hoặc Yarn thay cho npm, nhưng không chép lệnh riêng cho từng công cụ. Vì vậy, nếu bạn chưa quen, hãy dùng đúng lệnh npm ở trên khi môi trường đã có npm.
Nếu dùng macOS hoặc Linux, README khuyến nghị Homebrew với lệnh:
brew install anomalyco/tap/opencode-v2README cũng cung cấp công thức Homebrew chính thức khác:
brew install opencodeTheo README, công thức anomalyco/tap/opencode-v2 luôn được cập nhật và được khuyến nghị, còn công thức opencode chính thức cập nhật chậm hơn.
Với Arch Linux, README ghi:
sudo pacman -S opencodeNếu muốn lấy bản mới nhất từ AUR, README ghi:
paru -S opencode-betaBạn cần có quyền phù hợp khi dùng sudo. Với paru, máy phải có công cụ này trước; README không hướng dẫn cài paru.
E.Cài bằng mise hoặc Nix
README hỗ trợ mise trên mọi hệ điều hành:
mise use -g opencodeTùy chọn -g cho biết OpenCode được chọn ở phạm vi toàn cục theo cách của mise. Bạn cần cài mise trước, nhưng README không hướng dẫn bước đó.
README cũng cung cấp cách chạy qua Nix:
nix run github:anomalyco/opencodeLệnh này chạy OpenCode từ GitHub thông qua Nix. Bạn cần có Nix trước; README không mô tả cách cài Nix hoặc cách cấu hình môi trường.
F.Cài ứng dụng desktop
Nếu chọn desktop, hãy tải đúng file theo nền tảng của bạn từ trang tải xuống của OpenCode rồi cài như một ứng dụng thông thường. README liệt kê bản Windows .exe, bản macOS .dmg và các định dạng Linux .deb, .rpm, .AppImage.
Với macOS dùng Homebrew, README có thêm lệnh:
brew install --cask opencode-desktopREADME gọi ứng dụng desktop là beta. Vì vậy, nếu dùng cho công việc quan trọng, bạn nên thử trên một dự án an toàn trước.
G.Mở tài liệu cấu hình
README hướng người dùng xem tài liệu của OpenCode để biết thêm về cấu hình và agent. README không chép các biến môi trường, API key hoặc file cấu hình cụ thể. Bạn không nên tự tạo tên biến hoặc đường dẫn cấu hình dựa trên phỏng đoán.
Nếu bạn đang ở một repo có sẵn và muốn agent hỗ trợ dự án đó, hãy mở OpenCode từ thư mục dự án theo cách phù hợp với bản bạn đã cài. README được cung cấp không ghi lệnh khởi động cụ thể, nên phần này cần xem trong tài liệu của dự án.
IV.Kiểm tra đã chạy được chưa
README không cung cấp một lệnh kiểm tra phiên bản, một màn hình mẫu hay một kết quả terminal cụ thể sau khi cài. Vì vậy, không thể khẳng định một lệnh kiểm tra riêng chỉ dựa trên nội dung README.
Bạn có thể kiểm tra theo các dấu hiệu mà tư liệu có nêu:
- Với script cài đặt, kiểm tra xem OpenCode đã được cài vào
$HOME/.opencode/binchưa. - Với desktop, kiểm tra bộ cài đúng nền tảng đã cài thành công và ứng dụng có thể mở được.
- Với Homebrew, npm, pacman, mise hoặc Nix, xem công cụ quản lý package có báo cài đặt hoàn tất hay không.
- Khi đã mở được OpenCode, kiểm tra xem bạn có thể chuyển giữa
buildvàplanbằng phímTabhay không. - Trong phần nhập tin nhắn, thử gọi
@generalđể xác nhận subagentgeneralđược nhận diện. README cho biết đây là cú pháp gọi subagent, nhưng không mô tả màn hình kết quả cụ thể.
Nếu chưa biết cách mở CLI sau khi cài, hãy xem tài liệu OpenCode. README chỉ nêu thư mục cài của script và các agent tích hợp, không ghi câu lệnh chạy chính thức.
V.Dùng vào việc thật
A.Chủ shop cần chỉnh một trang bán hàng
Một chủ shop có website bán hàng và muốn hiểu phần code liên quan đến trang sản phẩm. Có thể bắt đầu bằng agent plan để yêu cầu giải thích cấu trúc trang, các file liên quan và các bước nên làm.
Ví dụ yêu cầu:
Hãy đọc codebase này và lập kế hoạch cải thiện trang sản phẩm. Chỉ phân tích, chưa sửa file. Hãy chỉ ra các file liên quan và thứ tự thay đổi đề xuất.Agent plan phù hợp vì README mô tả đây là agent chỉ đọc, từ chối chỉnh sửa file theo mặc định và hỏi quyền trước khi chạy lệnh bash. Kết quả mong đợi là một phân tích hoặc kế hoạch; README không quy định mẫu đầu ra cụ thể.
B.Nhân viên văn phòng muốn tự động hóa một script nội bộ
Một nhân viên có sẵn một repo nhỏ và cần hiểu script đang làm gì trước khi nhờ chỉnh sửa. Họ có thể dùng plan để hỏi về luồng xử lý, điểm vào của chương trình và các phần có thể thay đổi.
Ví dụ yêu cầu:
Hãy khám phá codebase này như một người mới tiếp nhận dự án. Giải thích luồng xử lý chính và lập danh sách câu hỏi cần làm rõ trước khi sửa.Cách này tận dụng đúng mục đích README nêu cho plan: khám phá codebase lạ và lập kế hoạch thay đổi. Khi đã hiểu đủ, người dùng có thể chuyển agent bằng phím Tab để tiếp tục công việc phát triển.
C.Lập trình viên muốn triển khai một thay đổi nhiều file
Một dev đã có kế hoạch rõ ràng và muốn agent hỗ trợ công việc phát triển. Họ có thể chuyển sang agent build, là agent mặc định và có quyền truy cập đầy đủ cho công việc development.
Ví dụ yêu cầu:
Hãy thực hiện kế hoạch đã thống nhất: cập nhật phần xử lý đăng nhập và các file liên quan. Trước mỗi thay đổi lớn, hãy giải thích file nào sẽ được sửa.README chỉ xác nhận build là agent full-access cho development. Vì vậy, quyền thay đổi thực tế còn phụ thuộc vào cấu hình và môi trường của bạn. Nên rà soát yêu cầu trước khi cho agent làm việc trên code quan trọng.
D.Dev cần tìm kiếm vấn đề phức tạp trong repo
Khi câu hỏi cần tìm qua nhiều file hoặc có nhiều bước, bạn có thể gọi subagent general bằng @general trong tin nhắn.
Ví dụ:
@general Hãy tìm tất cả phần liên quan đến cơ chế xác thực, nối các luồng xử lý từ đầu đến cuối và nêu những điểm cần kiểm tra thêm.Theo README, general dành cho các tìm kiếm phức tạp và tác vụ nhiều bước. README không mô tả giới hạn, thời gian chạy hay định dạng kết quả, nên hãy xem đây là một cách yêu cầu hỗ trợ tìm kiếm chứ không phải cam kết về một báo cáo cố định.
Đọc trước, lập kế hoạch rõ, rồi mới giao agent quyền phát triển.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Cài đè lên phiên bản quá cũ
README khuyên gỡ các phiên bản cũ hơn 0.1.x trước khi cài. Nếu bạn bỏ qua bước này, có thể gặp tình trạng nhiều bản cài cùng tồn tại hoặc shell gọi nhầm bản.
Cách xử lý an toàn là xác định bạn đã cài bằng npm, Homebrew, pacman, mise, Nix hay script nào, rồi dùng đúng công cụ đó để gỡ bản cũ. README không có lệnh gỡ chung nên không nên chạy lệnh xóa tùy ý.
B.Terminal không nhận OpenCode sau khi chạy script
Script cài vào $HOME/.opencode/bin. Nếu terminal chưa nhận lệnh, có thể thư mục này chưa nằm trong PATH của shell hiện tại.
Hãy kiểm tra thư mục cài và đọc hướng dẫn cấu hình trong tài liệu OpenCode. README được cung cấp không ghi lệnh thêm PATH, vì vậy không nên sao chép một cấu hình không rõ nguồn.
C.Chọn nhầm công thức Homebrew
README có hai lệnh Homebrew. anomalyco/tap/opencode-v2 được khuyến nghị và luôn cập nhật, còn brew install opencode là công thức chính thức nhưng cập nhật chậm hơn.
Nếu bạn muốn theo lựa chọn được README khuyến nghị, dùng đúng lệnh tap anomalyco/tap/opencode-v2. Nếu đang dùng công thức opencode, hãy nhớ rằng README mô tả tốc độ cập nhật của nó khác với bản v2.
D.Dùng agent build khi chỉ muốn đọc code
build là agent có quyền truy cập đầy đủ cho development. Nếu bạn chỉ muốn hiểu repo hoặc lập kế hoạch, hãy chuyển sang plan bằng phím Tab trước khi gửi yêu cầu.
Agent plan được README mô tả là chỉ đọc, từ chối chỉnh sửa file theo mặc định và hỏi quyền trước khi chạy bash. Đây là lựa chọn phù hợp hơn khi bạn chưa chắc yêu cầu của mình.
E.Không biết cách cấu hình API key hoặc nhà cung cấp mô hình
README không nêu API key, biến môi trường hay cấu hình nhà cung cấp mô hình. Nếu OpenCode yêu cầu cấu hình trong môi trường của bạn, hãy xem tài liệu dự án thay vì tự đoán tên biến.
Với code riêng tư hoặc dữ liệu nội bộ, hãy kiểm tra kỹ chính sách bảo mật và quyền truy cập trước khi sử dụng agent.
VII.Có nên dùng không
OpenCode đáng cân nhắc nếu bạn muốn một coding agent mã nguồn mở, có nhiều lựa chọn cài đặt và có ranh giới tương đối rõ giữa phân tích với phát triển. Agent plan hữu ích cho việc khám phá codebase lạ, còn build phù hợp khi bạn đã sẵn sàng làm công việc phát triển. Subagent general cũng giúp xử lý các tìm kiếm phức tạp theo nhiều bước.
Dự án có giấy phép MIT, README đa ngôn ngữ và hỗ trợ cả CLI lẫn desktop beta. Repo hiện có khoảng 226580 sao và 30675 fork, đồng thời vẫn còn được cập nhật. Đây là những dấu hiệu cho thấy dự án được quan tâm, nhưng không thay thế cho việc kiểm tra tính phù hợp với quy trình và dữ liệu của bạn.
Giới hạn lớn nhất của phần README được cung cấp là thiếu hướng dẫn chi tiết về API key, cấu hình mô hình, lệnh khởi động CLI, yêu cầu phần cứng và quy trình kiểm tra sau cài. Người dùng Windows cũng chỉ được hướng dẫn rõ về bản desktop, chưa có quy trình CLI riêng.
Bạn nên chọn OpenCode nếu cần trợ lý AI hỗ trợ code và muốn tự kiểm soát lúc nào agent chỉ đọc, lúc nào agent được phát triển. Nếu cần tài liệu cấu hình đầy đủ ngay trong README, quy trình bảo mật doanh nghiệp rõ ràng hoặc hướng dẫn Windows CLI chi tiết, hãy đọc thêm tài liệu dự án hoặc cân nhắc công cụ có tài liệu phù hợp hơn.
Câu hỏi thường gặp
OpenCode là gì?
OpenCode là coding agent AI mã nguồn mở. Nó có agent `build` cho công việc phát triển, agent `plan` cho phân tích chỉ đọc và subagent `general` cho các tìm kiếm phức tạp.
OpenCode có miễn phí không?
README cho biết dự án dùng giấy phép MIT. Tuy nhiên, README không nêu chi phí sử dụng mô hình, API hoặc các dịch vụ liên quan, nên chưa thể kết luận toàn bộ quá trình sử dụng không phát sinh chi phí.
OpenCode có chạy được trên Windows không?
Có. README liệt kê ứng dụng desktop beta cho Windows với file `opencode-desktop-win-x64.exe`. README chưa ghi quy trình cài CLI riêng cho Windows.
Có cần GPU hoặc API key không?
README không nêu yêu cầu GPU, API key hay nhà cung cấp mô hình cụ thể. Bạn cần xem thêm tài liệu của dự án nếu muốn biết cấu hình đầy đủ.
OpenCode khác gì giữa agent build và plan?
`build` là agent mặc định, có quyền truy cập đầy đủ 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; nó phù hợp để khám phá codebase và lập kế hoạch.
Có thể dùng OpenCode để đọc một repo lạ không?
Có. README nói agent `plan` phù hợp để khám phá codebase chưa quen hoặc lập kế hoạch thay đổi. Bạn có thể chuyển agent bằng phím `Tab`.


