OpenCode: agent lập trình AI mã nguồn mở chạy trong terminal

Nếu bạn đang tìm một trợ lý lập trình AI mà bạn có thể xem mã nguồn, tùy chỉnh và dùng ngay trong terminal, thì OpenCode (kho anomalyco/opencode) là cái tên đáng chú ý. Dự án tự giới thiệu ngắn gọn là "agent lập trình AI mã nguồn mở". OpenCode dành cho lập trình viên muốn có một agent hỗ trợ viết code, khám phá codebase và lên kế hoạch thay đổi. Nó cũng phù hợp với những người dùng thích công nghệ muốn thử công cụ AI trên máy của mình.

Dự án được viết bằng TypeScript, phát hành theo giấy phép MIT và đang có hơn 217.000 sao trên GitHub. Phiên bản mới nhất tại thời điểm viết bài là v1.19.3.

OpenCode có gì nổi bật

Giao diện terminal và ứng dụng desktop

OpenCode có giao diện dạng terminal (Terminal UI), phù hợp với ai quen làm việc trên dòng lệnh. Ngoài ra, dự án còn có ứng dụng desktop, hiện đang ở giai đoạn BETA, dành cho macOS, Windows và Linux.

Hai agent tích hợp sẵn, chuyển đổi bằng phím Tab

Điểm thú vị của OpenCode là bạn có sẵn hai agent và có thể chuyển qua lại giữa chúng bằng phím Tab:

• build: agent mặc định, có toàn quyền, dùng cho công việc phát triển.
• plan: agent chỉ đọc, dùng để phân tích và khám phá mã nguồn. Agent này mặc định từ chối chỉnh sửa file và sẽ hỏi ý kiến bạn trước khi chạy lệnh bash. Đây là lựa chọn lý tưởng khi bạn cần tìm hiểu một codebase lạ hoặc lên kế hoạch thay đổi.

Bên cạnh đó còn có một subagent tên general, dành cho các tác vụ tìm kiếm phức tạp và công việc nhiều bước. Subagent này được dùng nội bộ, và bạn có thể gọi nó bằng cách gõ @general trong tin nhắn.

Nhiều cách cài đặt

OpenCode có thể cài qua script, npm (hoặc bun, pnpm, yarn), Homebrew, pacman, AUR, mise và Nix. Với người dùng Windows, cách tiện nhất là tải bản desktop dạng .exe, hoặc cài bản dòng lệnh qua npm hay mise (mise được ghi là dùng cho mọi hệ điều hành).

Tài liệu đa ngôn ngữ, có cả tiếng Việt

README của dự án được dịch ra nhiều ngôn ngữ, trong đó có bản Tiếng Việt. Đây là điểm cộng nhỏ nhưng dễ chịu cho bạn đọc trong nước.

Bạn có thể dùng OpenCode vào việc gì

• Tìm hiểu một dự án mới: dùng agent plan để đọc và phân tích code mà không lo bị sửa file ngoài ý muốn.
• Lên kế hoạch thay đổi: nhờ agent plan phân tích trước, sau đó chuyển sang build bằng phím Tab khi đã sẵn sàng.
• Phát triển tính năng: agent build có toàn quyền, phù hợp cho công việc viết và sửa code hằng ngày.
• Tìm kiếm và xử lý tác vụ nhiều bước: gọi @general khi cần tìm kiếm phức tạp.

Bắt đầu với OpenCode

README đưa ra nhiều cách cài đặt. Dưới đây là các bước cơ bản:

1. Nếu máy bạn đang có phiên bản OpenCode cũ hơn 0.1.x, hãy gỡ bỏ trước khi cài, theo lưu ý của dự án.
2. Chọn một cách cài phù hợp với hệ điều hành của bạn (xem các lệnh bên dưới).
3. Mở OpenCode trong thư mục dự án, dùng phím Tab để chuyển giữa agent build và plan.
4. Đọc thêm phần cấu hình tại tài liệu chính thức.

Cài nhanh bằng script (README gọi đây là cách "YOLO"):

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

Hoặc dùng trình quản lý gói:

npm i -g @opencode/cli@latest          # hoặc bun/pnpm/yarn
brew install anomalyco/tap/opencode-v2 # macOS và Linux (khuyên dùng, luôn cập nhật)
brew install opencode                  # macOS và Linux (formula chính thức, cập nhật chậm hơn)
sudo pacman -S opencode                # Arch Linux (Stable)
paru -S opencode-beta                  # Arch Linux (bản mới nhất từ AUR)
mise use -g opencode                   # Mọi hệ điều hành
nix run github:anomalyco/opencode      # Nix

Cài bản desktop

Bạn có thể tải ứng dụng desktop từ opencode.ai/download. Các file tương ứng gồm:

• macOS (Apple Silicon): opencode-desktop-mac-arm64.dmg
• macOS (Intel): opencode-desktop-mac-x64.dmg
• Windows: opencode-desktop-win-x64.exe
• Linux: .deb, .rpm hoặc .AppImage

Trên macOS, bạn cũng có thể cài qua Homebrew:

brew install --cask opencode-desktop

Tùy chỉnh thư mục cài đặt

Script cài đặt chọn thư mục theo thứ tự ưu tiên sau:

1. $OPENCODE_INSTALL_DIR: thư mục tùy chỉnh
2. $XDG_BIN_DIR: đường dẫn theo chuẩn XDG Base Directory
3. $HOME/bin: thư mục binary chuẩn của người dùng (nếu đã có hoặc tạo được)
4. $HOME/.opencode/bin: mặc định khi không có lựa chọn nào ở trên

OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/v2/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/v2/install | bash

Một vài lưu ý

• Giấy phép: MIT, khá thoáng cho cả mục đích cá nhân lẫn thương mại.
• Nền tảng: bản desktop có cho Windows, macOS và Linux. Bản dòng lệnh có nhiều cách cài cho macOS và Linux, còn npm và mise dùng được trên nhiều hệ điều hành.
• Độ hoàn thiện: bản desktop vẫn đang ở giai đoạn BETA, nên bạn có thể gặp một số thay đổi hoặc lỗi.
• Đóng góp: nếu muốn gửi pull request, bạn nên đọc tài liệu CONTRIBUTING của dự án trước.
• Dự án liên quan: nếu bạn làm một dự án có tên chứa chữ "opencode", nhóm phát triển đề nghị ghi rõ trong README rằng dự án đó không do đội OpenCode xây dựng và không liên kết với họ.

Kết luận

OpenCode là một agent lập trình AI mã nguồn mở với cách làm việc rõ ràng: agent build để viết code, agent plan để đọc và phân tích an toàn, cộng thêm nhiều cách cài đặt và một ứng dụng desktop cho cả Windows. Nếu bạn muốn thử một trợ lý lập trình mà mình có thể kiểm soát, hãy ghé kho anomalyco/opencode trên GitHub hoặc trang chủ opencode.ai để bắt đầu.