anomalyco/opencode: coding agent 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
anomalyco/opencode là coding agent mã nguồn mở viết bằng TypeScript, hỗ trợ AI trong việc đọc, phân tích và phát triển code. Repo có agent build để làm việc toàn quyền và agent plan để khám phá mã nguồn an toàn hơn. Cài đặt khá đơn giản qua script, npm, Homebrew hoặc ứng dụng desktop; README chưa nêu yêu cầu API key cụ thể.
anomalyco/opencode là một coding agent mã nguồn mở, giúp bạn làm việc với dự án phần mềm bằng AI ngay trong môi trường phát triển. Công cụ có thể hỗ trợ đọc code, tìm kiếm nhiều bước, lập kế hoạch thay đổi và thực hiện công việc phát triển theo agent bạn chọn.
Repo phù hợp với lập trình viên mới muốn có trợ lý khi làm quen codebase, lập trình viên cần duy trì dự án lớn, hoặc nhóm muốn thử một coding agent có mã nguồn mở và giấy phép MIT. Điểm đáng giá nhất là OpenCode có sẵn hai cách làm việc rõ ràng: build để phát triển với quyền truy cập đầy đủ và plan để phân tích, khám phá code theo hướng chỉ đọc.
README cung cấp nhiều cách cài đặt, gồm script cài nhanh, npm, Homebrew, Arch Linux, Nix và ứng dụng desktop beta cho Windows, macOS, Linux. Repo hiện có khoảng 226580 sao và 30675 fork; dự án vẫn còn được cập nhật.
anomalyco/opencode
Coding agent mã nguồn mở giúp bạn khám phá, lập kế hoạch và phát triển dự án bằng AI.
I.OpenCode làm được gì
A.Hỗ trợ phát triển phần mềm bằng AI
OpenCode được giới thiệu là một coding agent mã nguồn mở. Bạn có thể dùng nó như trợ lý khi làm việc trong một dự án: đọc cấu trúc, phân tích vấn đề, tìm kiếm thông tin liên quan và hỗ trợ công việc phát triển.
Lợi ích thực tế là bạn không phải tự đọc toàn bộ codebase trước khi đặt câu hỏi. Với một dự án lạ, agent có thể giúp bạn bắt đầu từ việc hiểu các phần chính rồi mới đi vào thay đổi cụ thể.
B.Có agent build cho công việc phát triển
build là agent mặc định và có quyền truy cập đầy đủ cho công việc phát triển. Đây là lựa chọn phù hợp khi bạn muốn OpenCode hỗ trợ trực tiếp trong quá trình sửa hoặc xây dựng tính năng.
Quyền truy cập đầy đủ cũng có nghĩa bạn nên xem kỹ yêu cầu mà mình gửi và kiểm tra thay đổi trước khi dùng trong dự án thật. Với mã nguồn quan trọng, hãy bắt đầu bằng việc đọc và lập kế hoạch trước.
C.Có agent plan để đọc và phân tích an toàn hơn
plan là agent chỉ đọc, phù hợp để phân tích và khám phá code. Agent này mặc định từ chối chỉnh sửa file và sẽ hỏi quyền trước khi chạy lệnh bash.
Cách này hữu ích khi bạn mới nhận một codebase, muốn tìm nguyên nhân lỗi hoặc cần lập kế hoạch thay đổi nhưng chưa muốn công cụ tác động vào file. Bạn có thể chuyển giữa hai agent bằng phím Tab.
D.Có subagent general cho tìm kiếm phức tạp
OpenCode đi kèm một subagent tên general, được dùng nội bộ cho các tìm kiếm phức tạp và công việc nhiều bước. Bạn có thể gọi subagent này trong tin nhắn bằng @general.
Ví dụ, khi cần tìm các phần liên quan trong nhiều thư mục hoặc xử lý một yêu cầu có nhiều bước, việc chỉ rõ @general giúp bạn yêu cầu đúng loại hỗ trợ mà README cung cấp.
E.Nhiều lựa chọn cài đặt
Bạn có thể cài bằng script, npm hoặc các trình quản lý gói phổ biến. Người dùng macOS và Linux có thể chọn Homebrew; Arch Linux có gói ổn định và gói beta; Nix có thể chạy trực tiếp từ GitHub.
Nếu không muốn làm việc chủ yếu trong terminal, OpenCode cũng có ứng dụng desktop beta. README liệt kê bộ cài cho Windows, macOS Apple Silicon, macOS Intel và Linux.
F.Mã nguồn mở và giấy phép MIT
Repo dùng TypeScript và có giấy phép MIT. Điều này phù hợp với cá nhân, nhóm kỹ thuật hoặc doanh nghiệp muốn xem xét một coding agent có mã nguồn và giấy phép rõ ràng.
Tuy nhiên, giấy phép mã nguồn mở không đồng nghĩa agent sẽ tự động phù hợp với mọi chính sách bảo mật nội bộ. Bạn vẫn cần kiểm tra quyền truy cập và cách tổ chức của mình cho phép công cụ làm việc với mã nguồn.
II.Cần chuẩn bị gì
Bạn cần chuẩn bị một hệ điều hành phù hợp với cách cài đặt đã chọn. README nêu các lựa chọn sau:
- macOS và Linux: có thể dùng Homebrew.
- Arch Linux: có thể dùng
pacmancho bản ổn định hoặcparucho bản beta từ AUR. - Windows: có ứng dụng desktop beta với file
.exe. - Linux: ứng dụng desktop có các định dạng
.deb,.rpmhoặc.AppImage. - macOS: ứng dụng desktop có bộ cài cho Apple Silicon và Intel.
- Bất kỳ hệ điều hành nào: README nêu
miselà một lựa chọn cài đặt. - Nix: có thể chạy bằng lệnh
nix run.
Nếu cài qua npm, bạn cần có npm trên máy. README cũng ghi có thể dùng bun, pnpm hoặc yarn thay cho npm, nhưng không nêu phiên bản cụ thể của các công cụ này.
README không nêu phiên bản Node.js, Python, GPU, tài khoản bắt buộc hoặc API key cụ thể. Vì vậy, không nên tự suy đoán các yêu cầu này chỉ từ repo. Nếu môi trường của bạn cần cấu hình thêm, hãy xem tài liệu cấu hình của OpenCode trong repo hoặc tài liệu dự án.
Nếu đang dùng một phiên bản OpenCode cũ hơn 0.1.x, README khuyên xóa phiên bản cũ trước khi cài bản mới. README không cung cấp lệnh xóa cụ thể, nên bạn cần xử lý theo cách đã dùng để cài phiên bản cũ.
III.Cài đặt từng bước
- Chọn cách càiChọn script, npm, Homebrew, trình quản lý gói hoặc desktop app
- Gỡ bản cũXóa phiên bản cũ hơn 0.1.x nếu máy đang có
- Cài OpenCodeChạy đúng lệnh của phương thức đã chọn
- Mở công cụKhởi động OpenCode từ môi trường đã cài
- Chọn agentDùng Tab để chuyển giữa build và plan
A.Chọn một phương thức cài đặt
Bạn không cần chạy tất cả lệnh bên dưới. Hãy chọn một cách phù hợp với hệ điều hành và thói quen của mình. Nếu muốn cài nhanh bằng terminal, script hoặc npm là hai lựa chọn dễ bắt đầu. Nếu đang dùng macOS hoặc Linux và đã có Homebrew, README khuyến nghị công thức anomalyco/tap/opencode-v2 vì luôn được cập nhật.
Nếu máy đang có bản OpenCode cũ hơn 0.1.x, hãy gỡ bản đó trước. README chỉ đưa ra lưu ý này, không ghi lệnh gỡ tương ứng cho từng phương thức.
B.Cài bằng script
README cung cấp script cài nhanh như sau:
curl -fsSL https://opencode.ai/v2/install | bashLệnh này tải script cài đặt từ địa chỉ của OpenCode rồi chuyển cho bash thực thi. Hãy mở terminal trước khi chạy và kiểm tra bạn đang dùng tài khoản có quyền cài phần mềm cần thiết.
Theo README, script cài OpenCode vào thư mục $HOME/.opencode/bin. Nếu sau khi cài terminal không nhận OpenCode, có thể thư mục này chưa được thêm vào biến môi trường PATH. README không ghi lệnh cấu hình PATH cụ thể, nên hãy xem hướng dẫn cài đặt trong repo hoặc tài liệu dự án.
C.Cài bằng npm hoặc trình quản lý gói JavaScript
Lệnh npm chính xác trong README là:
npm i -g @opencode/cli@latestREADME ghi bạn có thể dùng bun, pnpm hoặc yarn thay cho npm. Lệnh được cung cấp trực tiếp là lệnh npm ở trên; với các trình quản lý còn lại, README không chép cú pháp cụ thể.
Cờ -g yêu cầu cài gói ở phạm vi toàn cục, để công cụ có thể được gọi từ nhiều thư mục. Nếu terminal báo không có npm, bạn cần cài hoặc dùng một phương thức khác đã được README hỗ trợ.
D.Cài bằng Homebrew
Với macOS hoặc Linux, README khuyến nghị công thức sau:
brew install anomalyco/tap/opencode-v2README cũng nêu công thức chính thức nhưng cập nhật ít hơn:
brew install opencodeChỉ nên chọn một trong hai lệnh Homebrew. Nếu ưu tiên bản luôn được cập nhật theo khuyến nghị của README, dùng công thức đầu tiên. Homebrew cần có sẵn trên máy; README không hướng dẫn cài Homebrew.
E.Cài trên Arch Linux hoặc qua Nix
Với Arch Linux, README đưa ra hai lựa chọn:
sudo pacman -S opencodeLệnh trên cài bản ổn định. Nếu muốn bản mới nhất từ AUR, README nêu:
paru -S opencode-betaREADME cũng hỗ trợ Nix:
nix run github:anomalyco/opencodeCác lệnh này cần đúng công cụ tương ứng trên máy. Không nên chạy lệnh Arch Linux trên hệ điều hành khác.
F.Cài ứng dụng desktop beta
Nếu bạn dùng giao diện đồ họa, README cho biết OpenCode có ứng dụng desktop beta. Bộ cài được liệt kê theo nền tảng:
- 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 hướng dẫn tải ứng dụng từ trang download của OpenCode. Vì hệ thống tự chèn liên kết repo và tài nguyên, bạn có thể tìm mục download trên trang chủ dự án. Hãy chọn đúng bộ cài theo kiến trúc máy. Trên Windows, file .exe là lựa chọn được README liệt kê; trên macOS cần phân biệt Apple Silicon và Intel.
Nếu dùng macOS và đã có Homebrew, README cung cấp thêm lệnh cài desktop app:
brew install --cask opencode-desktopG.Mở OpenCode và chọn agent
Sau khi cài xong, mở OpenCode theo phương thức bạn đã chọn. README không đưa ra một lệnh khởi động riêng trong phần hướng dẫn, nên hãy dùng ứng dụng đã cài hoặc xem thông tin chạy trong tài liệu dự án.
Khi OpenCode đang mở, bạn có thể nhấn Tab để chuyển giữa hai agent tích hợp sẵn:
build: agent mặc định, có quyền truy cập đầy đủ cho công việc phát triển.plan: agent chỉ đọc, phù hợp để phân tích và khám phá code.
Nếu cần tìm kiếm phức tạp hoặc công việc nhiều bước, nhập @general trong tin nhắn để gọi subagent general.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra đầu tiên là mở được OpenCode sau khi cài bằng phương thức đã chọn. Với desktop app, dấu hiệu thành công là ứng dụng mở được từ bộ cài phù hợp với hệ điều hành. Với các phương thức terminal, hãy kiểm tra xem quá trình cài có hoàn tất mà không báo lỗi và công cụ có thể được mở theo hướng dẫn của dự án.
Khi giao diện làm việc đã mở, nhấn Tab. Nếu bạn chuyển được giữa build và plan, hai agent tích hợp đã sẵn sàng. Chọn plan để thử khám phá code theo chế độ chỉ đọc; agent này được thiết kế để 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.
Nếu cài bằng script, README cho biết file được đặt trong $HOME/.opencode/bin. Bạn có thể dùng thông tin này để kiểm tra thư mục cài đặt. Nếu công cụ chưa được nhận diện, xem lại PATH và hướng dẫn trong tài liệu dự án vì README không cung cấp lệnh cấu hình PATH cụ thể.
V.Dùng vào việc thật
A.Lập trình viên mới nhận một dự án lạ
Bạn vừa nhận một codebase nhưng chưa biết các thư mục chính nằm ở đâu. Hãy chọn agent plan bằng phím Tab, sau đó yêu cầu phân tích cấu trúc dự án và chỉ ra các phần liên quan đến tính năng bạn sắp làm.
Một câu yêu cầu có thể viết là: “Hãy khám phá codebase này theo chế độ chỉ đọc, giải thích các thư mục chính và tìm những file liên quan đến luồng đăng nhập.”
Kết quả mong đợi là một kế hoạch phân tích và danh sách phần liên quan, trong khi agent không tự ý sửa file. Đây là cách bắt đầu an toàn khi bạn chưa hiểu rõ dự án.
B.Dev cần lập kế hoạch sửa một lỗi nhiều bước
Một lỗi có thể liên quan đến nhiều module. Bạn có thể dùng plan để yêu cầu tìm nguyên nhân, lần theo các phần liên quan và đề xuất thứ tự thay đổi.
Ví dụ: “Hãy tìm các phần xử lý lỗi thanh toán, xác định nơi có thể phát sinh lỗi và lập kế hoạch sửa. Chưa chỉnh sửa file.”
Agent plan phù hợp với câu hỏi này vì nó được thiết kế cho phân tích, khám phá code và lập kế hoạch. Khi đã xem xét kế hoạch, bạn có thể chuyển sang build để thực hiện công việc phát triển nếu thấy phù hợp.
C.Nhóm kỹ thuật muốn hỗ trợ xây dựng tính năng
Khi bạn đã hiểu codebase và muốn agent hỗ trợ công việc phát triển, chuyển sang build bằng phím Tab. Hãy mô tả rõ tính năng, phạm vi file hoặc kết quả cần đạt.
Ví dụ: “Hãy triển khai phần kiểm tra dữ liệu đầu vào cho biểu mẫu đăng ký, giải thích các file sẽ thay đổi và thực hiện công việc trong phạm vi dự án.”
build là agent mặc định và có quyền truy cập đầy đủ cho công việc phát triển. Vì vậy, sau khi agent làm việc, bạn nên đọc diff hoặc kiểm tra các file đã thay đổi trước khi đưa vào sử dụng.
D.Tìm kiếm phức tạp trong codebase
Nếu cần một cuộc tìm kiếm nhiều bước, bạn có thể gọi subagent general bằng @general. Ví dụ: “@general hãy tìm tất cả luồng xử lý liên quan đến việc gửi email và tóm tắt mối liên hệ giữa chúng.”
README mô tả general là subagent dùng cho các tìm kiếm phức tạp và công việc nhiều bước. Hãy dùng nó khi yêu cầu vượt quá việc xem một file đơn lẻ.
Khi chưa hiểu codebase, hãy bắt đầu bằng một kế hoạch chỉ đọc rồi mới chuyển sang chỉnh sửa.
Ông T
build có quyền truy cập đầy đủ cho công việc phát triển. Hãy dùng plan khi chỉ muốn khám phá hoặc lập kế hoạch, kiểm tra yêu cầu trước khi cho phép thay đổi file và xem lại kết quả trước khi đưa vào dự án thật.
VI.Lỗi hay gặp và cách xử lý
A.Cài đè lên phiên bản quá cũ
README nhắc phải gỡ các phiên bản cũ hơn 0.1.x trước khi cài. Nếu cài mới nhưng gặp hành vi bất thường hoặc terminal vẫn gọi bản cũ, hãy kiểm tra và gỡ bản cũ theo phương thức đã dùng trước đó.
README không cung cấp lệnh gỡ chung, vì vậy không nên tự chạy một lệnh xóa không rõ phạm vi. Hãy xác định bạn đã cài bằng script, npm, Homebrew, Arch hay cách khác trước khi xử lý.
B.Terminal không nhận file sau khi cài bằng script
Script cài vào $HOME/.opencode/bin. Nếu OpenCode đã cài nhưng terminal không gọi được, thư mục cài có thể chưa nằm trong PATH.
Hãy kiểm tra thư mục này và xem hướng dẫn cấu hình trong tài liệu dự án. README được cung cấp chưa ghi câu lệnh thêm PATH, nên không nên bịa một lệnh cấu hình áp dụng cho mọi shell.
C.Chọn sai bộ cài desktop
macOS Apple Silicon và Intel có file khác nhau. Linux cũng có .deb, .rpm và .AppImage, còn Windows dùng file .exe theo danh sách trong README.
Hãy chọn đúng nền tảng và kiến trúc máy. Nếu dùng macOS, kiểm tra máy là Apple Silicon hay Intel trước khi tải bộ cài.
D.Dùng sai trình quản lý gói
brew, pacman, paru và nix phục vụ các môi trường khác nhau. Nếu lệnh không tồn tại, có thể bạn đang dùng sai phương thức cài cho hệ điều hành hiện tại.
Hãy quay lại chọn một phương thức phù hợp: npm hoặc script cho môi trường có terminal tương ứng, Homebrew cho macOS/Linux, pacman hoặc paru cho Arch Linux, và nix run cho môi trường Nix.
E.Cho agent quyền không phù hợp với công việc
Nếu bạn chỉ muốn đọc code nhưng lại dùng build, agent có quyền truy cập đầy đủ có thể không phù hợp với mục tiêu thận trọng của bạn. Hãy nhấn Tab chuyển sang plan.
plan 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. Đây là lựa chọn nên thử trước khi phân tích một codebase chưa quen.
VII.Có nên dùng không
OpenCode đáng thử nếu bạn muốn một coding agent mã nguồn mở, có nhiều cách cài đặt và có hai chế độ rõ ràng cho phân tích và phát triển. Agent plan hữu ích khi khám phá code an toàn hơn, còn build phù hợp khi đã sẵn sàng làm việc trực tiếp. Repo dùng TypeScript, có giấy phép MIT, có ứng dụng desktop beta và hỗ trợ nhiều hệ điều hành.
Điểm hạn chế là README chưa nêu chi tiết về phiên bản Node.js, cấu hình API key, mô hình AI, chi phí sử dụng, yêu cầu phần cứng hoặc quy trình cấu hình tài khoản. README cũng chưa đưa lệnh khởi động terminal cụ thể sau khi cài và chưa mô tả đầy đủ cách xử lý PATH sau khi dùng script. Vì vậy, người mới có thể cần đọc thêm tài liệu dự án trước khi dùng trong quy trình chính thức.
Bạn nên chọn OpenCode khi cần một trợ lý AI cho codebase và muốn kiểm soát rõ hơn giữa chế độ chỉ đọc với chế độ phát triển. Nếu nhóm cần tài liệu cấu hình doanh nghiệp, chính sách dữ liệu, tích hợp cụ thể hoặc yêu cầu vận hành đã được mô tả đầy đủ ngay trong README, hãy kiểm tra tài liệu của dự án và so sánh với công cụ khác trước khi triển khai rộng.
Câu hỏi thường gặp
OpenCode có miễn phí không?
README được cung cấp không nêu chính sách giá hoặc chi phí sử dụng. Repo có giấy phép MIT, nhưng điều đó chưa đủ để kết luận mọi dịch vụ hoặc mô hình liên quan đều miễn phí.
OpenCode có chạy 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 mô tả cách chạy bản terminal trên Windows.
Có cần GPU để dùng OpenCode không?
README không nêu yêu cầu GPU hay phần cứng đặc biệt. Vì vậy, chưa có đủ thông tin để kết luận về yêu cầu GPU cho từng cách dùng.
Có cần API key hoặc tài khoản riêng không?
README được cung cấp không nêu API key, tài khoản hay quy trình xác thực bắt buộc. Bạn cần xem thêm tài liệu cấu hình của dự án nếu muốn biết phần này.
OpenCode có thể tự sửa file không?
Agent `build` là agent mặc định và có quyền truy cập đầy đủ cho công việc phát triển. Agent `plan` chỉ đọc, mặc định từ chối chỉnh sửa file và hỏi quyền trước khi chạy lệnh bash.
Có thể dùng OpenCode để khám phá một codebase lạ không?
Có. README mô tả agent `plan` là lựa chọn lý tưởng để khám phá codebase và lập kế hoạch thay đổi. Bạn cũng có thể gọi subagent `general` bằng `@general` cho tìm kiếm phức tạp và công việc nhiều bước.
Cài OpenCode bằng cách nào dễ nhất?
README cung cấp script cài nhanh, npm, Homebrew, Arch Linux, Nix và desktop app. Cách phù hợp phụ thuộc hệ điều hành; README không yêu cầu bạn chạy tất cả lệnh cùng lúc.


