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

OpenCode: coding agent 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 →

OpenCode: coding agent mã nguồn mở — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

OpenCode là coding agent mã nguồn mở cho công việc phát triển phần mềm. Bạn có thể dùng agent build để làm việc toàn quyền, agent plan để đọc và phân tích mã nguồn, cùng subagent general cho các tìm kiếm phức tạp. README có nhiều cách cài, gồm npm, Homebrew, Nix và ứng dụng desktop; Windows có bản desktop riêng.

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 mã nguồn. Công cụ có thể giúp khám phá một codebase, lập kế hoạch thay đổi, tìm kiếm nhiều bước và thực hiện công việc phát triển thông qua các agent tích hợp.

OpenCode phù hợp với lập trình viên mới muốn có trợ lý khi đọc dự án, cũng như đội ngũ phát triển cần một công cụ làm việc trong terminal hoặc ứng dụng desktop. Dự án dùng TypeScript, có giấy phép MIT và hiện có khoảng 226580 sao cùng 30675 fork.

Điểm đáng giá nhất là OpenCode tách rõ hai cách làm việc: build có toàn quyền để phát triển và plan chỉ đọc để phân tích, khám phá code an toàn hơn. Bạn có thể đổi agent bằng phím Tab, còn subagent general được dùng cho các yêu cầu tìm kiếm phức tạp và nhiều bước.

Agent

anomalyco/opencode

OpenCode là 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.

★ 227kTypeScriptMIT
Xem repo trên GitHub

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

A.Hỗ trợ phát triển trong codebase

Agent build là agent mặc định và có toàn quyền phục vụ công việc phát triển. Bạn có thể dùng nó khi đã biết mình muốn sửa hoặc xây dựng phần nào trong dự án. Với người mới, cách này giúp chuyển từ việc hỏi đáp chung sang làm việc ngay trong ngữ cảnh của codebase.

README không liệt kê riêng từng lệnh thao tác trong phiên làm việc, nên bạn không nên tự suy đoán thêm cú pháp. Hãy bắt đầu bằng việc mở OpenCode trong dự án, sau đó nhập yêu cầu bằng ngôn ngữ tự nhiên và quan sát kết quả mà công cụ trả về.

B.Đọc và khám phá mã nguồn ở chế độ chỉ đọc

Agent plan dành cho việc phân tích và khám phá code. Agent này mặc định từ chối chỉnh sửa tệp và sẽ hỏi quyền trước khi chạy lệnh bash. Đây là lựa chọn phù hợp khi bạn mới nhận một dự án, chưa hiểu cấu trúc thư mục hoặc muốn xem kế hoạch trước khi cho phép thay đổi.

Cách tách plan khỏi build có lợi trong các tình huống cần kiểm tra an toàn. Bạn có thể bắt đầu bằng plan để yêu cầu giải thích luồng xử lý, tìm nơi cần sửa hoặc lập kế hoạch, rồi chuyển sang build khi đã hiểu rõ phạm vi công việc.

C.Tìm kiếm phức tạp với subagent general

OpenCode có thêm subagent general cho các tìm kiếm phức tạp và quy trình nhiều bước. Subagent này được OpenCode sử dụng nội bộ và có thể được gọi trong tin nhắn bằng @general.

Điều này hữu ích khi câu hỏi không nằm trong một tệp duy nhất. Chẳng hạn, khi cần lần theo nhiều phần của một codebase, bạn có thể yêu cầu @general hỗ trợ tìm kiếm thay vì tự mở từng thư mục.

D.Làm việc bằng terminal hoặc ứng dụng desktop

README cung cấp nhiều cách cài OpenCode trong terminal, gồm script cài đặt, npm, Bun, pnpm, yarn, Homebrew, Arch Linux, mise và Nix. Cách này phù hợp với dev quen dùng dòng lệnh hoặc muốn đưa công cụ vào quy trình phát triển hiện tại.

OpenCode cũng có ứng dụng desktop ở trạng thái BETA. Bản tải xuống được cung cấp cho macOS Apple Silicon, macOS Intel, Windows và Linux dưới dạng .deb, .rpm hoặc .AppImage. Người dùng Windows có thể chọn ứng dụng desktop thay vì bắt đầu bằng terminal.

E.Chuyển đổi agent bằng phím Tab

OpenCode có hai agent tích hợp sẵn và cho phép chuyển đổi bằng phím Tab. Agent build là lựa chọn mặc định cho phát triển; agent plan là lựa chọn đọc-only cho phân tích và khám phá.

Cơ chế này giúp bạn thay đổi mức độ can thiệp trong cùng công cụ. Khi cần hiểu dự án, chọn plan. Khi đã sẵn sàng làm việc, chuyển sang build.

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

Bạn cần một máy thuộc nền tảng được README hỗ trợ bằng một trong các cách cài tương ứng. README nêu các lựa chọn cho macOS, Linux, Arch Linux, Nix và ứng dụng desktop Windows. Với Windows, phần README cung cấp tệp cài desktop dạng opencode-desktop-win-x64.exe.

Nếu cài bằng npm, bạn cần có npm. README cũng nêu Bun, pnpm và yarn là các lựa chọn package manager khác, nhưng không ghi phiên bản cụ thể của các công cụ này.

Nếu dùng Homebrew, bạn cần Homebrew trên macOS hoặc Linux. Nếu dùng Arch Linux, README nêu pacman cho bản Stable và paru cho bản Latest từ AUR. Nếu dùng Nix, bạn cần môi trường Nix để chạy lệnh tương ứng.

README không nêu yêu cầu về phiên bản Node.js, Python, GPU, tài khoản, API key hay nhà cung cấp mô hình. Vì vậy, không thể khẳng định bạn cần chuẩn bị các mục này chỉ dựa trên tư liệu hiện có. README cũng không mô tả chi tiết dữ liệu được gửi đi hoặc cơ chế xác thực.

Một lưu ý quan trọng: README khuyên xóa các phiên bản cũ hơn 0.1.x trước khi cài. Hãy kiểm tra máy đang có phiên bản OpenCode cũ hay không trước khi bắt đầu.

OpenCode có agent build là agent toàn quyền. Hãy dùng agent plan để đọc và lập kế hoạch trước khi cho phép thay đổi trong một codebase quan trọng. README chưa mô tả chi tiết cơ chế dữ liệu, API key hoặc chi phí, nên hãy kiểm tra tài liệu cấu hình trước khi đưa mã nguồn nhạy cảm vào quy trình.

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

  1. Chọn cách càiChọn terminal, package manager 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 bản desktop tương ứng
  3. Kiểm tra phiên bản cũXóa bản cũ hơn 0.1.x trước khi cài nếu máy đang có
  4. Mở OpenCodeKhởi động công cụ trong dự án cần làm việc
  5. Chọn agentDùng Tab để chuyển giữa build và plan

A.Chọn phương án cài đặt

Nếu bạn dùng terminal trên macOS hoặc Linux, README đưa ra script cài nhanh và nhiều package manager. Nếu bạn dùng Windows, README cung cấp ứng dụng desktop dạng .exe; đây là lựa chọn trực tiếp nhất được nêu cho nền tảng này.

Nếu máy đã từng cài OpenCode, hãy xử lý phiên bản cũ hơn 0.1.x trước. README chỉ đưa ra lời khuyên xóa phiên bản cũ, không ghi lệnh gỡ cụ thể cho từng hệ điều hành, nên bạn không nên tự dùng một lệnh gỡ chưa được xác nhận.

B.Cài bằng script

Mở terminal trên macOS hoặc Linux 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 dự án rồi chuyển cho bash thực thi. Bạn cần mở terminal có kết nối mạng và quyền cài đặt phù hợp.

README cho biết script cài OpenCode vào $HOME/.opencode/bin. Nếu sau khi cài, terminal báo không tìm thấy lệnh, hãy kiểm tra thư mục này đã được thêm vào PATH chưa. README không cung cấp lệnh chỉnh PATH cụ thể, nên hãy xem phần tài liệu cấu hình của dự án thay vì tự đoán.

C.Cài bằng npm hoặc package manager

Nếu bạn đã có npm, chạy:

Terminal
npm i -g @opencode/cli@latest

Đây là lệnh cài gói CLI ở phạm vi toàn cục và lấy bản latest. README ghi chú rằng bạn cũng có thể dùng Bun, pnpm hoặc yarn, nhưng không đưa ra lệnh đầy đủ riêng cho từng công cụ. Vì vậy, hãy dùng đúng cú pháp package manager mà bạn đang quen thuộc và đối chiếu tài liệu của dự án nếu gặp lỗi.

README còn liệt kê các phương án sau:

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

Hai lệnh brew dành cho macOS và Linux. README đánh dấu brew install anomalyco/tap/opencode-v2 là lựa chọn được khuyến nghị và luôn cập nhật; brew install opencode là công thức chính thức nhưng cập nhật ít hơn. Trên Arch Linux, pacman là bản Stable, còn paru cài bản Latest từ AUR.

Lệnh mise use -g opencode dùng mise ở phạm vi toàn cục. Lệnh Nix chạy OpenCode trực tiếp từ GitHub. Mỗi phương án cần công cụ tương ứng đã có sẵn trên máy.

D.Cài ứng dụng desktop

README cho biết OpenCode có ứng dụng desktop ở trạng thái BETA. Hãy tải đúng tệp theo nền tảng: macOS Apple Silicon dùng opencode-desktop-mac-arm64.dmg, macOS Intel dùng opencode-desktop-mac-x64.dmg, Windows dùng opencode-desktop-win-x64.exe, còn Linux có .deb, .rpm hoặc .AppImage.

Trên macOS, README cung cấp thêm lệnh Homebrew:

Terminal
brew install --cask opencode-desktop

Với Windows, hãy chạy tệp .exe đã tải. README không đưa ra lệnh PowerShell hoặc quy trình cài bằng terminal cho Windows. Với Linux, hãy chọn đúng định dạng gói mà hệ thống của bạn hỗ trợ; README không ghi thêm lệnh cài riêng cho từng định dạng.

E.Mở dự án và chọn agent

Sau khi cài xong, mở OpenCode trong dự án bạn muốn làm việc. README không cung cấp một lệnh khởi động cụ thể hoặc ví dụ câu lệnh CLI, nên phần này cần thực hiện từ giao diện hoặc theo tài liệu của dự án.

Khi OpenCode đã mở, dùng phím Tab để chuyển giữa hai agent tích hợp sẵn. Chọn plan khi cần đọc, phân tích hoặc khám phá. Chọn build khi muốn thực hiện công việc phát triển với quyền truy cập đầy đủ.

Nếu yêu cầu cần tìm kiếm phức tạp hoặc nhiều bước, gọi @general ngay trong tin nhắn. Đây là cú pháp duy nhất README nêu cho việc gọi subagent.

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

Cách kiểm tra đầu tiên là xem OpenCode có mở được sau khi cài hay không. Nếu dùng ứng dụng desktop, bạn cần thấy ứng dụng khởi động bình thường. Trên Windows, hãy mở tệp desktop đã tải; trên macOS hoặc Linux, mở ứng dụng tương ứng.

Nếu cài bằng terminal, hãy kiểm tra lệnh OpenCode có thể được gọi trong terminal. README không cung cấp lệnh kiểm tra phiên bản hoặc lệnh khởi động cụ thể, nên không nên tự đưa ra một câu lệnh chưa có trong tư liệu.

Khi công cụ chạy, dấu hiệu quan trọng là bạn có thể chuyển agent bằng phím Tab và thấy hai lựa chọn build và plan. Agent mặc định là build. Khi chọn plan, công cụ phải hoạt động theo mô tả đọc-only: từ chối chỉnh sửa tệp theo mặc định và hỏi quyền trước khi chạy bash.

Bạn cũng có thể gửi một yêu cầu khám phá đơn giản trong một dự án thử nghiệm. Nếu OpenCode trả lời dựa trên codebase và không báo lỗi khởi động, phần cài đặt cơ bản đã hoạt động. Với yêu cầu tìm kiếm nhiều bước, thử gọi @general trong tin nhắn và quan sát xem subagent có được nhận diện hay không.

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

A.Chủ shop cần hiểu công cụ nội bộ

Một chủ shop có thể nhận một dự án quản lý đơn hàng nhưng không biết mã nguồn được chia thành những phần nào. Hãy mở dự án bằng OpenCode, chọn agent plan bằng phím Tab, rồi hỏi bằng ngôn ngữ tự nhiên: “Hãy khám phá cấu trúc dự án này, giải thích các phần chính và lập kế hoạch để tìm luồng xử lý đơn hàng.”

Kết quả mong đợi là phần phân tích và kế hoạch dựa trên codebase. Vì plan đọc-only và hỏi quyền trước khi chạy bash, đây là cách phù hợp để bắt đầu mà chưa cho phép công cụ tự chỉnh sửa.

B.Nhân viên văn phòng cần phối hợp với dev

Một nhân viên văn phòng có thể dùng OpenCode để đọc một dự án hoặc tài liệu kỹ thuật mà không cần tự mở từng tệp. Hãy giữ agent plan, sau đó nhập: “Tóm tắt cách các thư mục trong dự án liên quan đến nhau và chỉ ra nơi cần hỏi nhóm phát triển nếu muốn thay đổi một chức năng.”

Kết quả nhận được là bản giải thích ở mức codebase. README không mô tả khả năng tạo báo cáo văn phòng hay xuất file, nên hãy xem OpenCode như công cụ hỗ trợ đọc và trao đổi về dự án, không tự hứa rằng nó sẽ tạo đúng định dạng tài liệu cụ thể.

C.Dev mới muốn sửa một tính năng

Dev mới có thể dùng quy trình hai lượt. Trước hết chọn plan và nhập: “Tìm các phần liên quan đến chức năng đăng nhập, giải thích luồng hiện tại và đề xuất kế hoạch sửa lỗi.” Sau khi đã xem kế hoạch, dùng Tab chuyển sang build và yêu cầu tiếp tục thực hiện kế hoạch đã thống nhất.

Agent build là agent mặc định và có toàn quyền cho công việc phát triển. Vì vậy, trước khi chuyển sang build, hãy chắc rằng bạn đang mở đúng thư mục dự án và hiểu phạm vi thay đổi.

D.Dev cần tìm kiếm qua nhiều phần của dự án

Khi vấn đề liên quan đến nhiều tệp hoặc nhiều bước tìm kiếm, nhập yêu cầu có @general, chẳng hạn: “@general hãy tìm toàn bộ các phần liên quan đến luồng thanh toán và giải thích chúng liên kết với nhau như thế nào.”

README xác nhận @general là cách gọi subagent general cho các tìm kiếm phức tạp và nhiều bước. Kết quả cụ thể phụ thuộc vào codebase và yêu cầu bạn gửi, nên hãy kiểm tra lại các phát hiện quan trọng trước khi dùng để sửa mã.

Hãy bắt đầu bằng plan để hiểu codebase, rồi mới chuyển sang build khi đã rõ thay đổi cần làm.

Ông T

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

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

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

B.Đang dùng phiên bản OpenCode quá cũ

README khuyên xóa phiên bản cũ hơn 0.1.x trước khi cài. Nếu gặp hành vi khác với tài liệu hoặc xung đột khi cài, hãy xác định phiên bản cũ đang tồn tại và gỡ theo cách phù hợp với phương án cài trước đó. Không nên xóa ngẫu nhiên các thư mục hệ thống.

C.Chọn sai package manager hoặc định dạng cài

brew chỉ phù hợp khi máy có Homebrew, pacman và paru dành cho Arch Linux, còn nix run cần môi trường Nix. Hãy chọn đúng lệnh theo hệ điều hành và công cụ đang có. Trên Windows, README cung cấp bản desktop .exe thay vì các lệnh package manager nói trên.

D.Agent chỉnh sửa khi bạn chỉ muốn đọc

Nếu muốn phân tích mà không sửa tệp, hãy chuyển sang plan bằng phím Tab. Agent này từ chối chỉnh sửa theo mặc định và hỏi quyền trước khi chạy bash. Nếu đang ở build, hãy kiểm tra lại agent trước khi gửi yêu cầu.

E.Ứng dụng desktop chưa ổn định như mong đợi

README đánh dấu desktop app là BETA. Nếu gặp vấn đề với bản desktop, hãy xem tài liệu của dự án hoặc cân nhắc dùng phương án terminal được README liệt kê. Tư liệu hiện có chưa nêu danh sách lỗi desktop cụ thể hay cách khắc phục riêng.

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 lựa chọn cài đặt và hỗ trợ cả terminal lẫn desktop. Việc có sẵn build, plan và general tạo ra quy trình khá dễ hiểu: khám phá trước, lập kế hoạch, rồi mới phát triển. Dự án cũng có giấy phép MIT, đang được cập nhật và có cộng đồng lớn thể hiện qua số sao và fork hiện có.

Giới hạn lớn nhất của tư liệu hiện tại là README không ghi rõ phiên bản Node.js, yêu cầu API key, mô hình sử dụng, chi phí, cơ chế dữ liệu hay lệnh khởi động CLI chi tiết. Vì vậy, nếu bạn cần kiểm soát chặt dữ liệu, xác minh chi phí hoặc triển khai theo chính sách doanh nghiệp, hãy đọc thêm tài liệu cấu hình và bảo mật của repo trước khi dùng với mã nguồn nhạy cảm.

Bạn nên chọn OpenCode khi cần trợ lý làm việc trực tiếp với codebase và muốn chuyển đổi giữa phân tích chỉ đọc với phát triển toàn quyền. Nếu chỉ cần một trình soạn thảo đơn giản, không muốn agent truy cập dự án, hoặc cần tài liệu rõ về xác thực và chi phí ngay từ đầu, hãy cân nhắc công cụ khác phù hợp hơn.

4.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?

Repo có giấy phép MIT. README được cung cấp không nêu chi phí sử dụng, chi phí mô hình hoặc điều kiện dịch vụ, nên chưa thể khẳng định toàn bộ quá trình sử dụng là miễn phí.

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

Có. README liệt kê ứng dụng desktop cho Windows với tệp `opencode-desktop-win-x64.exe`. README không cung cấp lệnh cài CLI riêng cho Windows.

Có cần GPU để chạy OpenCode không?

README không nêu yêu cầu GPU. Vì vậy, tư liệu hiện có chưa đủ để khẳng định bạn cần hoặc không cần GPU.

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

README được cung cấp không đề cập API key, tài khoản hay quy trình đăng nhập. 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 chi tiết.

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

`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 để phân tích và khám phá, mặc định từ chối chỉnh sửa tệp và hỏi quyền trước khi chạy bash.

OpenCode có ứng dụng desktop không?

Có, nhưng README đánh dấu desktop app là BETA. Bản tải xuống được liệt kê cho macOS Apple Silicon, macOS Intel, Windows và Linux.

Khi nào nên dùng @general?

README cho biết `general` là subagent dành cho các tìm kiếm phức tạp và nhiều bước. Bạn có thể gọi nó trong tin nhắn bằng `@general`.

Chuyển nhanh tới mục

  1. I.OpenCode làm được gì
    1. A.Hỗ trợ phát triển trong codebase
    2. B.Đọc và khám phá mã nguồn ở chế độ chỉ đọc
    3. C.Tìm kiếm phức tạp với subagent general
    4. D.Làm việc bằng terminal hoặc ứng dụng desktop
    5. E.Chuyển đổi agent bằng phím Tab
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chọn phương án cài đặt
    2. B.Cài bằng script
    3. C.Cài bằng npm hoặc package manager
    4. D.Cài ứng dụng desktop
    5. E.Mở dự án và chọn agent
  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 hiểu công cụ nội bộ
    2. B.Nhân viên văn phòng cần phối hợp với dev
    3. C.Dev mới muốn sửa một tính năng
    4. D.Dev cần tìm kiếm qua nhiều phần của dự án
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Terminal báo không tìm thấy OpenCode sau khi cài
    2. B.Đang dùng phiên bản OpenCode quá cũ
    3. C.Chọn sai package manager hoặc định dạng cài
    4. D.Agent chỉnh sửa khi bạn chỉ muốn đọc
    5. E.Ứng dụng desktop chưa ổn định như mong đợi
  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ỏ.