OpenCode: coding agent mã nguồn mở cho terminal và desktop beta

OpenCode là AI coding agent mã nguồn mở, có hai chế độ build và plan để lần lượt thực hiện hoặc phân tích code. Dự án đang xuất hiện trên GitHub Trending; bạn có thể cài CLI hoặc thử ứng dụng desktop beta.

Một codebase lạ, một lỗi khó lần theo, một ticket cần xử lý gấp: phần tốn thời gian đôi khi không phải viết dòng code đầu tiên, mà là tìm đúng nơi để bắt đầu.

OpenCode là một AI coding agent mã nguồn mở hướng tới công việc lập trình. Dự án có thể dùng trong terminal và có ứng dụng desktop đang ở giai đoạn beta. Điểm đáng chú ý là người dùng có thể chuyển giữa chế độ phân tích chỉ đọc và chế độ phục vụ công việc phát triển.

OpenCode có những agent nào?

README của dự án nêu ba agent tích hợp sẵn.

build: agent mặc định, có quyền đầ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á codebase. Mặc định không được sửa file. Hỏi quyền trước khi chạy lệnh bash. general: subagent dành cho tác vụ tìm kiếm phức tạp hoặc nhiều bước; có thể gọi bằng @general trong tin nhắn.

Bạn có thể chuyển giữa build và plan bằng phím Tab.

Cách phân vai này hữu ích khi chưa muốn AI sửa code ngay. Với một dự án mới hoặc yêu cầu chưa rõ, hãy bắt đầu bằng plan để khảo sát cấu trúc, lần theo luồng xử lý và lập kế hoạch. Chỉ chuyển sang build khi đã xác định phạm vi công việc.

Cài OpenCode trong terminal

README liệt kê nhiều phương án cài đặt. Nếu đã dùng Node.js, bạn có thể cài CLI qua npm:

bash npm i -g @opencode/cli@latest

Trên macOS và Linux, README khuyến nghị công thức Homebrew sau:

bash brew install anomalyco/tap/opencode-v2

Một lựa chọn khác là dùng script cài đặt:

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

Theo README, script này cài OpenCode vào:

bash $HOME/.opencode/bin

Dự án cũng lưu ý nên gỡ các phiên bản cũ hơn 0.1.x trước khi cài.

Ngoài ra, README còn nêu các lựa chọn qua bun, pnpm, yarn, mise, Nix và trình quản lý gói của Arch Linux.

Cách thử an toàn trên một codebase

Trước khi giao quyền chỉnh sửa cho agent, hãy thử theo quy trình nhỏ và có giới hạn.

Mở terminal trong một bản sao dự án phù hợp để thử nghiệm. Cài OpenCode bằng một trong các cách ở trên. Chuyển sang agent plan bằng Tab. Yêu cầu agent khảo sát một khu vực cụ thể, chẳng hạn luồng đăng nhập hoặc cách một API xử lý dữ liệu. Đọc lại nhận định và kế hoạch trước khi quyết định thay đổi gì. Khi cần thực hiện tác vụ phát triển, chuyển sang build và giới hạn rõ phạm vi.

README không nêu trong phần hướng dẫn ngắn cú pháp khởi chạy phiên terminal hay định dạng prompt chi tiết. Sau khi cài đặt, nên xem tài liệu chính thức của dự án để biết cách cấu hình và sử dụng đầy đủ.

Giao việc rõ ràng để dễ kiểm soát

Dù dùng agent nào, yêu cầu nên có mục tiêu và ranh giới cụ thể. Thay vì nói “sửa hết bug”, hãy chỉ rõ tính năng cần xem, các phần không được đụng tới và đầu ra mong muốn.

Ví dụ, với plan, bạn có thể dùng yêu cầu như:

text Phân tích lỗi <mô tả lỗi> trong phần <khu vực code>. Chỉ đọc code, không sửa file. Hãy nêu: Luồng xử lý liên quan Các file cần kiểm tra Giả thuyết nguyên nhân Kế hoạch sửa theo từng bước Những điểm cần kiểm tra lại

Khi đã thống nhất hướng làm, có thể chuyển sang build:

text Thực hiện kế hoạch đã thống nhất cho <mục tiêu>. Chỉ thay đổi các file liên quan đến <phạm vi>. Trước khi chạy lệnh có thể làm thay đổi dữ liệu hoặc môi trường, hãy giải thích mục đích của lệnh. Sau khi sửa, tóm tắt thay đổi và các kiểm tra đã thực hiện.

Một yêu cầu tốt không nhất thiết phải dài. Điều quan trọng là nêu rõ phạm vi, hành động được phép và tiêu chí bàn giao.

Dùng plan cho việc đọc và review code

README không giới thiệu OpenCode như công cụ review pull request chuyên biệt. Tuy vậy, đặc tính chỉ đọc của plan khiến nó phù hợp cho bước khảo sát trước khi review.

Bạn có thể dùng nó để:

Lần theo luồng dữ liệu của một tính năng. Xác định các file liên quan đến một thay đổi. Đối chiếu kế hoạch sửa với cấu trúc hiện có. Tổng hợp các điểm mà người review cần xem kỹ hơn.

Kết quả phân tích của agent vẫn nên được kiểm tra lại bằng diff, test và bối cảnh nghiệp vụ của dự án. Đây là phần mà người trong team vẫn cần chịu trách nhiệm cuối cùng.

Desktop beta và lưu ý khi cấp quyền

OpenCode cũng có ứng dụng desktop beta cho:

macOS Apple Silicon macOS Intel Windows Linux với gói .deb, .rpm hoặc .AppImage

Trên macOS, README nêu lệnh cài qua Homebrew cask:

bash brew install --cask opencode-desktop

Vì build là agent có quyền đầy đủ cho công việc phát triển, nên cần thận trọng khi dùng trên repo thật. Một số thực hành nên cân nhắc:

Dùng Git để kiểm tra diff và có phương án hoàn tác. Bắt đầu bằng plan khi chưa quen codebase. Chỉ đồng ý chạy lệnh khi đã hiểu mục đích của chúng. Không đưa secrets, khóa truy cập hoặc dữ liệu nhạy cảm vào yêu cầu. Tự kiểm tra lại thay đổi và chạy các kiểm thử phù hợp.

OpenCode đáng chú ý với những ai muốn thử một coding agent ngay trong môi trường làm việc quen thuộc là terminal. Giá trị của nó không nhất thiết nằm ở việc giao toàn bộ dự án cho AI, mà ở khả năng hỗ trợ đọc code, khoanh vùng vấn đề và chuẩn bị kế hoạch trước khi bạn đưa ra quyết định kỹ thuật.