Bỏ qua tới nội dung
Ông T.vn

anomalyco/opencode: Trợ lý lập trình AI mã nguồn mở — hướng dẫn cài đặt và dùng

13 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 →

anomalyco/opencode: Trợ lý lập trình AI mã nguồn mở — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

anomalyco/opencode là coding agent AI mã nguồn mở viết bằng TypeScript, giúp bạn 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ó CLI, ứng dụng desktop thử nghiệm và nhiều cách cài đặt; người dùng Windows có thể tải bản desktop.

OpenCode là một coding agent AI mã nguồn mở, dùng để hỗ trợ bạn đọc, phân tích và phát triển phần mềm. Bạn có thể chạy OpenCode trong terminal hoặc dùng ứng dụng desktop thử nghiệm trên Windows, macOS và Linux.

Công cụ này phù hợp với lập trình viên mới muốn có trợ lý khi làm quen với một codebase, dev cần tìm kiếm nhiều bước trong dự án, hoặc nhóm muốn dùng một coding agent có mã nguồn mở và giấy phép MIT. Điểm đáng giá nhất là OpenCode có hai agent tích hợp sẵn: build để làm việc với đầy đủ quyền phát triển và plan để phân tích, khám phá code theo chế độ chỉ đọc.

Agent

anomalyco/opencode

OpenCode là coding agent AI mã nguồn mở, hỗ trợ đọc, phân tích và phát triển dự án ngay trong môi trường làm việc.

★ 227kTypeScriptMIT
Xem repo trên GitHub

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

A.Hỗ trợ phát triển phần mềm

OpenCode là trợ lý AI dành cho công việc lập trình. Bạn có thể dùng nó khi cần tìm hiểu một dự án, phân tích cấu trúc code hoặc thực hiện công việc phát triển. Điều này hữu ích khi bạn mới nhận một codebase và chưa biết nên bắt đầu đọc từ đâu.

Agent build là agent mặc định và có đầy đủ quyền phục vụ công việc phát triển. Khi đã hiểu rõ yêu cầu, bạn có thể chuyển sang agent này để làm việc trực tiếp với dự án.

B.Khám phá code theo chế độ chỉ đọc

Agent plan được thiết kế cho phân tích và khám phá code. 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.

Đây là lựa chọn phù hợp khi bạn muốn hỏi “dự án này xử lý luồng đăng nhập ở đâu?”, “thay đổi này có thể ảnh hưởng đến module nào?” hoặc “nên triển khai tính năng này theo hướng nào?” mà chưa muốn công cụ tự sửa code.

C.Chuyển đổi agent nhanh

OpenCode cho phép chuyển giữa hai agent tích hợp bằng phím Tab. Bạn có thể bắt đầu ở plan để hiểu dự án, sau đó chuyển sang build khi đã sẵn sàng triển khai.

Cách làm này giúp tách hai giai đoạn thường bị trộn lẫn: suy nghĩ và thay đổi code. Với người mới, đây cũng là cách an toàn hơn để kiểm tra đề xuất trước khi cho agent thực hiện.

D.Dùng subagent cho việc tìm kiếm phức tạp

OpenCode có thêm subagent general dành 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 bằng @general trong tin nhắn.

Ví dụ, khi cần rà soát nhiều thư mục để tìm toàn bộ nơi một API được gọi, bạn có thể yêu cầu @general hỗ trợ tìm kiếm. README không mô tả chi tiết cú pháp prompt ngoài cách gọi này, nên phần yêu cầu cụ thể cần điều chỉnh theo kết quả OpenCode trả về.

E.Chạy bằng terminal hoặc ứng dụng desktop

OpenCode có các lựa chọn cài đặt qua script, npm, Bun, pnpm, Yarn, Homebrew, Arch Linux, mise và Nix. Ngoài CLI, dự án còn có ứng dụng desktop đang ở trạng thái thử nghiệm.

Ứng dụng desktop có bản tải cho Windows, macOS và Linux. Người dùng văn phòng hoặc người không quen terminal có thể bắt đầu bằng bản Windows .exe; lập trình viên thích làm việc trong terminal có thể dùng CLI.

F.Mã nguồn mở và có thể đóng góp

Repo dùng giấy phép MIT và có cấu trúc dành cho phát triển, đóng góp và xây dựng trên OpenCode. Nếu bạn muốn gửi pull request, README yêu cầu đọc tài liệu đóng góp trước.

Repo hiện có khoảng 226580 sao và 30675 fork. Dự án vẫn còn được cập nhật. Những con số này cho thấy OpenCode đang nhận được nhiều sự 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.

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

Bạn cần một máy tính có môi trường phù hợp với cách cài đã chọn. README ghi rõ các gói Homebrew hoạt động trên macOS và Linux, Arch Linux có gói riêng, còn Nix có thể chạy trực tiếp từ GitHub. README không nêu phiên bản Node.js, Python hay yêu cầu GPU cụ thể.

Nếu cài bằng npm, Bun, pnpm hoặc Yarn, bạn cần có trình quản lý gói tương ứng. README chỉ ghi tên các trình quản lý gói được hỗ trợ, không ghi phiên bản bắt buộc.

Nếu dùng Windows, README cung cấp ứng dụng desktop dạng opencode-desktop-win-x64.exe. Tư liệu không nói CLI cài trên Windows bằng script hoặc npm có được hỗ trợ theo cách nào, nên người dùng Windows nên ưu tiên bản desktop được cung cấp.

Nếu muốn chạy agent có khả năng đọc hoặc chỉnh sửa dự án, bạn cần mở OpenCode trong thư mục code cần làm việc. README không nêu yêu cầu tài khoản, API key, nhà cung cấp mô hình hoặc cấu hình chi phí. Vì vậy, không nên tự suy đoán các biến môi trường hay key cần thiết từ phần tư liệu này.

OpenCode có agent build với đầy đủ quyền phát triển. Hãy bắt đầu bằng agent plan khi bạn chỉ muốn phân tích code, và kiểm tra quyền truy cập trước khi cho agent thực hiện thay đổi.

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

  1. Chọn cách càiChọn CLI, trình quản lý gói hoặc ứng dụng desktop phù hợp với hệ điều hành
  2. Cài OpenCodeChạy đúng lệnh trong README hoặc tải ứng dụng desktop
  3. Mở dự ánKhởi động OpenCode trong thư mục code cần làm việc
  4. Chọn agentDùng plan để phân tích hoặc build để phát triển
  5. Kiểm tra hoạt độngGửi yêu cầu đọc code và kiểm tra phản hồi

A.Chọn cách cài phù hợp

Nếu bạn dùng macOS hoặc Linux và muốn làm việc trong terminal, README khuyến nghị Homebrew với lệnh brew install anomalyco/tap/opencode-v2. Nếu muốn dùng npm, lệnh được README cung cấp là npm i -g @opencode/cli@latest.

README cũng ghi các lựa chọn khác. Bạn chỉ nên chọn lệnh tương ứng với công cụ đã có trên máy. Không cần cài tất cả các cách cùng lúc.

B.Cài CLI bằng script hoặc trình quản lý gói

Với cách cài bằng script, mở terminal rồi chạy đúng lệnh sau:

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

Lệnh này tải script cài đặt từ địa chỉ của OpenCode và chạy bằng Bash. Cách này phù hợp với môi trường có curl và bash. README cho biết script cài OpenCode vào $HOME/.opencode/bin.

Bạn cũng có thể cài bằng npm:

Terminal
npm i -g @opencode/cli@latest

Lệnh -g cài gói ở phạm vi toàn cục để lệnh OpenCode có thể được gọi từ terminal. README ghi thêm có thể dùng Bun, pnpm hoặc Yarn, nhưng không đưa lệnh cụ thể cho từng công cụ.

Trên macOS hoặc Linux, cách được README khuyến nghị là:

Terminal
brew install anomalyco/tap/opencode-v2

README cũng cung cấp công thức Homebrew chính thức, nhưng được cập nhật chậm hơn:

Terminal
brew install opencode

Các lựa chọn khác được ghi trong README gồm:

Terminal
sudo pacman -S opencode
paru -S opencode-beta
mise use -g opencode
nix run github:anomalyco/opencode

sudo pacman -S opencode dành cho Arch Linux bản ổn định. paru -S opencode-beta cài bản mới nhất từ AUR. mise use -g opencode dùng mise trên bất kỳ hệ điều hành nào theo tư liệu. nix run github:anomalyco/opencode dùng Nix để chạy OpenCode.

README có lưu ý phải gỡ các phiên bản cũ hơn 0.1.x trước khi cài. Tư liệu không đưa lệnh gỡ cụ thể, nên bạn cần dùng cách gỡ tương ứng với phương thức đã cài trước đó.

C.Cài ứng dụng desktop trên Windows

OpenCode có ứng dụng desktop đang ở trạng thái thử nghiệm. Bản dành cho Windows là file opencode-desktop-win-x64.exe. README chỉ đường dẫn trang tải là opencode.ai/download, nhưng không mô tả thêm các bước cài trong Windows.

Sau khi tải file, mở file .exe và làm theo trình cài đặt hiển thị trên màn hình. Đây là cách phù hợp nhất nếu bạn đang dùng Windows và muốn bắt đầu bằng giao diện desktop. README không nêu yêu cầu phần cứng, tài khoản hay API key cho bản desktop.

Trên macOS, README có thêm lệnh cài desktop bằng Homebrew:

Terminal
brew install --cask opencode-desktop

README không cung cấp lệnh tương đương cho Windows hoặc Linux.

D.Mở OpenCode trong dự án

Sau khi cài CLI, mở terminal tại thư mục dự án bạn muốn làm việc. Nếu bạn cần lấy một repo GitHub để thử, có thể dùng lệnh phổ thông sau, rồi thay đường dẫn thư mục theo repo của bạn:

Terminal
git clone https://github.com/<repo>.git
cd <repo>

git clone tải mã nguồn về máy. cd chuyển terminal vào thư mục dự án. Phần <repo> là chỗ giữ nguyên tên repo GitHub bạn muốn lấy; README của OpenCode không đưa một repo mẫu cụ thể.

README không ghi lệnh khởi động CLI cụ thể trong phần được cung cấp. Vì vậy, không nên tự thêm một lệnh chạy OpenCode mà chưa được tư liệu xác nhận. Nếu lệnh cài đặt không tạo lệnh sử dụng được, hãy kiểm tra tài liệu trong repo và phần tài liệu cấu hình mà README hướng tới.

E.Chọn agent trước khi làm việc

Khi OpenCode đã mở, dùng phím Tab để chuyển giữa hai agent tích hợp. Chọn plan nếu bạn muốn phân tích và khám phá code. Chọn build khi bạn muốn thực hiện công việc phát triển.

Agent plan 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à hành vi có chủ đích, không phải lỗi cài đặt. Agent build là agent mặc định và có đầy đủ quyền phát triển, vì vậy hãy đọc kỹ yêu cầu trước khi xác nhận các thao tác thay đổi.

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

Cách kiểm tra thực tế là mở OpenCode trong một dự án và gửi yêu cầu phân tích đơn giản khi đang dùng agent plan. Ví dụ, bạn có thể yêu cầu công cụ mô tả cấu trúc dự án hoặc tìm file chứa một chức năng. Kết quả mong đợi là OpenCode đọc code và trả lời phân tích mà không tự sửa file.

Tiếp theo, nhấn Tab để chuyển sang agent build. Việc chuyển agent thành công cho thấy hai agent tích hợp đang sẵn sàng. Khi dùng build, hãy kiểm tra kỹ các quyền và yêu cầu xác nhận trước khi cho phép công cụ thực hiện thay đổi.

Nếu bạn cài bằng script, README cho biết thư mục cài đặt là $HOME/.opencode/bin. Nếu terminal không nhận diện OpenCode, hãy kiểm tra thư mục này có nằm trong PATH hay chưa. README không cung cấp lệnh cập nhật PATH cụ thể.

Nếu dùng desktop trên Windows, màn hình ứng dụng mở được và cho phép bạn chọn hoặc mở dự án là dấu hiệu cài đặt ban đầu thành công. README không mô tả màn hình kiểm tra cụ thể hoặc kết quả phiên bản cần đối chiếu.

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

A.Chủ shop cần sửa nhanh trang quản trị

Một chủ shop có dự án quản lý đơn hàng nhưng không biết phần danh sách đơn nằm ở đâu. Bạn mở dự án trong OpenCode, chọn agent plan, rồi yêu cầu:

text
Hãy tìm phần hiển thị danh sách đơn hàng, mô tả các file liên quan và giải thích dữ liệu đi từ đâu đến giao diện.

OpenCode có thể hỗ trợ khám phá code và trả về phân tích. Bạn giữ nguyên file trong lúc khảo sát, sau đó mới chuyển sang build nếu muốn bắt đầu thay đổi.

B.Nhân viên văn phòng muốn hiểu một công cụ nội bộ

Một nhân viên không chuyên lập trình được giao kiểm tra một dự án nội bộ. Họ có thể dùng agent plan để hỏi các câu ngắn như:

text
Hãy giải thích cấu trúc dự án này bằng ngôn ngữ dễ hiểu và chỉ ra file chính của mỗi phần.

Cách này giúp người mới có bản đồ ban đầu của dự án trước khi nhờ lập trình viên xử lý. Vì plan là chế độ chỉ đọc theo mặc định, nó phù hợp cho giai đoạn tìm hiểu.

C.Dev mới nhận codebase lớn

Một dev mới vào nhóm cần tìm toàn bộ nơi gọi một hàm hoặc API. Có thể gọi subagent general trong yêu cầu:

text
@general Hãy tìm tất cả nơi trong dự án gọi API đăng nhập và nhóm kết quả theo từng chức năng.

README xác nhận general dành cho tìm kiếm phức tạp và công việc nhiều bước. Kết quả cụ thể còn phụ thuộc vào codebase và yêu cầu bạn đưa ra.

D.Dev muốn lập kế hoạch trước khi sửa

Khi nhận một yêu cầu tính năng, bạn có thể bắt đầu bằng plan:

text
Hãy phân tích cách thêm tính năng xuất báo cáo, chỉ ra các module có thể phải thay đổi và đề xuất thứ tự thực hiện. Chưa chỉnh sửa file.

Sau khi xem kế hoạch, nhấn Tab để chuyển sang build và tiếp tục công việc phát triển nếu thấy phù hợp. Cách này tạo một điểm kiểm tra rõ ràng trước khi agent có quyền thay đổi dự án.

Công việc tốt với coding agent bắt đầu từ việc hiểu code, rồi mới cho phép thay đổi.

Ông T

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

A.Terminal không tìm thấy OpenCode sau khi cài

Nếu dùng script, README cho biết OpenCode được cài vào $HOME/.opencode/bin. Terminal có thể chưa nhận thư mục này trong PATH. Hãy kiểm tra lại thư mục cài đặt và tài liệu cấu hình của dự án; README được cung cấp chưa ghi lệnh sửa PATH cụ thể.

B.Cài đè lên phiên bản quá cũ

README yêu cầu gỡ các phiên bản cũ hơn 0.1.x trước khi cài. Nếu bạn từng cài OpenCode, hãy xác định phương thức cài cũ rồi gỡ phiên bản đó bằng công cụ tương ứng trước khi chạy lệnh cài mới.

C.Dùng sai lệnh theo hệ điều hành

Các lệnh Homebrew trong README dành cho macOS và Linux. Lệnh sudo pacman và paru dành cho Arch Linux. Không nên chạy các lệnh này trên Windows. Với Windows, hãy dùng bản desktop opencode-desktop-win-x64.exe được README cung cấp.

D.Agent plan không sửa file

Đây là hành vi đúng thiết kế. Agent plan từ chối chỉnh sửa file theo mặc định vì nó dành cho phân tích và khám phá code. Nếu cần thực hiện công việc phát triển, chuyển sang agent build bằng phím Tab sau khi đã kiểm tra kế hoạch.

E.Agent yêu cầu quyền trước khi chạy lệnh

Agent plan hỏi quyền trước khi chạy bash. Hãy đọc lệnh và xác nhận chỉ khi bạn hiểu tác động của nó. Nếu chỉ muốn phân tích tĩnh, có thể tiếp tục yêu cầu agent tập trung vào việc đọc và giải thích code.

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

OpenCode đáng thử nếu bạn cần một coding agent mã nguồn mở, muốn có chế độ lập kế hoạch chỉ đọc, hoặc muốn dùng cả CLI và desktop. Repo có giấy phép MIT, nhiều lựa chọn cài đặt, agent build, agent plan và subagent general cho tìm kiếm nhiều bước.

Công cụ đặc biệt phù hợp với dev mới nhận dự án vì có thể bắt đầu bằng việc khám phá code trước. Người dùng Windows cũng có lựa chọn desktop riêng, còn người dùng macOS và Linux có nhiều phương án cài CLI.

Giới hạn chính của tư liệu là README không nêu phiên bản Node.js, yêu cầu API key, nhà cung cấp mô hình, chi phí sử dụng, cấu hình bảo mật chi tiết hoặc lệnh khởi động CLI cụ thể. README cũng đánh dấu desktop là bản thử nghiệm. Bạn nên kiểm tra tài liệu cấu hình trong repo và tài liệu OpenCode trước khi đưa code nhạy cảm hoặc cấp quyền rộng cho agent.

Nếu bạn chỉ cần một trình soạn thảo code thông thường, không muốn agent đọc hoặc thay đổi file, hoặc cần một quy trình đã có yêu cầu triển khai và bảo mật rất cụ thể, hãy cân nhắc cách khác. OpenCode phù hợp nhất khi bạn muốn trợ lý AI tham gia vào việc hiểu và phát triển code, đồng thời vẫn có thể bắt đầu bằng chế độ chỉ đọc.

5.0/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?

README được cung cấp không nêu giá, gói miễn phí hay chi phí sử dụng. Repo dùng giấy phép MIT, nhưng điều đó không đủ để kết luận mọi dịch vụ hoặc mô hình liên quan đều miễn phí.

Windows có chạy được OpenCode không?

Có bản ứng dụng desktop cho Windows với file `opencode-desktop-win-x64.exe`. README không mô tả cách cài CLI trên Windows bằng script hoặc npm, nên bản desktop là lựa chọn được tư liệu nêu rõ.

Có cần GPU không?

README không nêu yêu cầu GPU. Tư liệu cũng không đưa yêu cầu phần cứng cụ thể nào khác.

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

README được cung cấp không nói về tài khoản, API key hay biến môi trường cần thiết. Vì vậy chưa có đủ thông tin để khẳng định có hoặc không.

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

`build` là agent mặc định, có đầy đủ quyền cho công việc phát triển. `plan` dành cho phân tích và khám phá code, mặc định từ chối sửa file và hỏi quyền trước khi chạy bash.

OpenCode có chỉnh sửa code tự động không?

Agent `build` có đầy đủ quyền phát triển nên được thiết kế cho công việc có thể bao gồm thay đổi code. Agent `plan` thì từ chối chỉnh sửa file theo mặc định, phù hợp để kiểm tra trước.

OpenCode có bản desktop không?

Có. Desktop app đang ở trạng thái thử nghiệm và có bản cho macOS Apple Silicon, macOS Intel, Windows và Linux; README cũng ghi lệnh Homebrew để cài bản desktop trên macOS.

Chuyển nhanh tới mục

  1. I.OpenCode làm được gì
    1. A.Hỗ trợ phát triển phần mềm
    2. B.Khám phá code theo chế độ chỉ đọc
    3. C.Chuyển đổi agent nhanh
    4. D.Dùng subagent cho việc tìm kiếm phức tạp
    5. E.Chạy bằng terminal hoặc ứng dụng desktop
    6. F.Mã nguồn mở và có thể đóng góp
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chọn cách cài phù hợp
    2. B.Cài CLI bằng script hoặc trình quản lý gói
    3. C.Cài ứng dụng desktop trên Windows
    4. D.Mở OpenCode trong dự án
    5. E.Chọn agent trước khi làm việc
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop cần sửa nhanh trang quản trị
    2. B.Nhân viên văn phòng muốn hiểu một công cụ nội bộ
    3. C.Dev mới nhận codebase lớn
    4. D.Dev muốn lập kế hoạch trước khi sửa
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Terminal không tìm thấy OpenCode sau khi cài
    2. B.Cài đè lên phiên bản quá cũ
    3. C.Dùng sai lệnh theo hệ điều hành
    4. D.Agent plan không sửa file
    5. E.Agent yêu cầu quyền trước khi chạy lệnh
  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ỏ.