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

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

11 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: 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

opencode là một agent lập trình AI mã nguồn mở (giấy phép MIT), viết chủ yếu bằng TypeScript. Nó giúp bạn khám phá, lên kế hoạch và sửa code trong dự án thật, có cả bản dòng lệnh lẫn ứng dụng desktop (beta). Cài đặt chỉ cần một dòng lệnh hoặc một trình quản lý gói quen thuộc, nên không quá khó với người mới.

opencode là một agent lập trình AI mã nguồn mở. Bạn mở nó trong thư mục dự án, trò chuyện bằng ngôn ngữ thường, và nó giúp bạn đọc hiểu code, lên kế hoạch sửa, rồi sửa file giúp bạn. Tác giả mô tả ngắn gọn repo này là "the open source coding agent".

Repo này hợp với ba nhóm người. Nhóm đầu là lập trình viên muốn có trợ lý AI ngay trong terminal. Nhóm hai là người mới học code, hay phải đọc một dự án lạ mà không biết bắt đầu từ đâu. Nhóm ba là người làm kinh doanh, văn phòng có chút kỹ thuật, muốn nhờ AI chỉnh script hoặc file cấu hình nhỏ.

Điểm đáng giá nhất là hai chế độ làm việc tách bạch. Chế độ plan chỉ đọc và phân tích, không tự ý sửa file. Chế độ build có toàn quyền để làm việc thật. Nhờ vậy bạn có thể thăm dò trước cho an toàn, rồi mới cho phép nó động tay vào code. Repo hiện có khoảng 226.506 sao và 30.658 fork, giấy phép MIT, và vẫn được cập nhật trong 3 tháng gần đây.

Agent

anomalyco/opencode

opencode là agent lập trình AI mã nguồn mở, giúp đọc hiểu code, lên kế hoạch và sửa code ngay trong dự án của bạn. Có bản dòng lệnh và bản desktop (beta).

★ 227kTypeScriptMIT
Xem repo trên GitHub

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

Dưới đây là những gì README nói rõ. Phần còn lại về cấu hình, README chỉ dẫn sang trang tài liệu của dự án.

A.Hai agent có sẵn, đổi bằng phím Tab

opencode có hai agent dựng sẵn, bạn chuyển qua lại bằng phím Tab:

  • buildagent mặc định, toàn quyền, dùng cho công việc phát triển thật sự như viết và sửa code.
  • planagent chỉ đọc, dùng để phân tích và khám phá code.

Lợi ích thực tế: khi chưa tin tưởng AI hoặc chưa hiểu dự án, bạn để ở plan. Khi đã đồng ý với hướng làm, bạn bấm Tab sang build.

B.Chế độ plan an toàn theo mặc định

Theo README, agent plan:

  • Mặc định từ chối sửa file.
  • Hỏi xin phép trước khi chạy lệnh bash.
  • Hợp để khám phá codebase lạ hoặc lên kế hoạch thay đổi.

Với người mới, đây là lớp bảo vệ rất đáng giá. Bạn hỏi thoải mái mà không sợ AI lỡ tay xoá hay ghi đè file.

C.Subagent general cho việc tìm kiếm phức tạp

Ngoài hai agent chính còn có subagent general, dành cho các tìm kiếm phức tạp và việc nhiều bước. Nó chủ yếu được dùng nội bộ, nhưng bạn có thể gọi trực tiếp bằng cách gõ @general trong tin nhắn.

D.Nhiều cách cài, nhiều nền tảng

opencode cài được bằng script, npm, Homebrew, pacman, paru, mise hoặc nix. Ngoài ra còn có ứng dụng desktop (BETA) cho macOS, Windows và Linux. Bạn không phải gắn bó với terminal nếu thấy nó khó.

E.Tài liệu và cộng đồng

README được dịch ra rất nhiều ngôn ngữ, trong đó có tiếng Việt (file README.vi.md trong repo). Dự án có trang tài liệu riêng, kênh Discord và tài khoản X để hỏi đáp.

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

README không có mục "yêu cầu hệ thống" riêng. Những gì tư liệu nói được là:

  • Hệ điều hànhbản dòng lệnh có lệnh cài cho macOS, Linux (Homebrew, Arch Linux), và mise "any OS" (chạy trên mọi hệ điều hành). Bản desktop (beta) có file cho macOS (Apple Silicon và Intel), Windows và Linux.
  • Gỡ bản cũREADME dặn gỡ các phiên bản cũ hơn 0.1.x trước khi cài.
  • Trình quản lý góituỳ cách cài bạn chọn, cần sẵn npm (hoặc bun/pnpm/yarn), brew, pacman, paru, mise hay nix.
  • Terminalbạn cần biết mở terminal. Trên Windows là PowerShell hoặc Windows Terminal, trên macOS là ứng dụng Terminal.

Chuyện tài khoản, API key, phiên bản Node cụ thể hay phần cứng (GPU, RAM): README chưa ghi. Bạn xem trang tài liệu của dự án tại opencode.ai/docs để biết cách kết nối với dịch vụ AI.

README chưa nói opencode dùng nhà cung cấp AI nào hay tính phí ra sao. Trước khi dùng, hãy đọc tài liệu chính thức để biết bạn sẽ kết nối dịch vụ nào và có mất chi phí không. Nếu cần nhập khoá API, đừng dán khoá vào nơi công khai và đừng đưa vào file được đẩy lên GitHub.

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

  1. Chọn cách càiScript một dòng, npm, Homebrew hoặc ứng dụng desktop
  2. Gỡ bản cũXoá các phiên bản cũ hơn 0.1.x nếu có
  3. Chạy lệnh càiDán đúng lệnh của cách bạn chọn vào terminal
  4. Biết nơi càiScript cài vào thư mục $HOME/.opencode/bin
  5. Mở dự ánMở terminal trong thư mục dự án và xem tài liệu để bắt đầu

A.Bước 1: Chọn cách cài phù hợp

README liệt kê nhiều cách. Bạn chỉ cần chọn một:

  • Dùng macOS hoặc Linux và quen Homebrew: dùng brew.
  • Đã có Node.js: dùng npm.
  • Muốn nhanh nhất: dùng script một dòng.
  • Ngại terminal: tải ứng dụng desktop (mục sau).

B.Bước 2: Gỡ phiên bản cũ nếu có

README dặn: gỡ các bản cũ hơn 0.1.x trước khi cài. Nếu bạn chưa từng cài opencode thì bỏ qua bước này. README không ghi lệnh gỡ, nên hãy gỡ theo đúng cách bạn đã cài trước đó (ví dụ qua chính trình quản lý gói bạn dùng).

C.Bước 3: Chạy lệnh cài

Đây là khối lệnh nguyên văn trong README. Chỉ chạy một dòng phù hợp với máy bạn, đừng chạy hết cả khối:

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

# Package managers
npm i -g @opencode/cli@latest      # or bun/pnpm/yarn
brew install anomalyco/tap/opencode-v2 # macOS and Linux (recommended, always up to date)
brew install opencode              # macOS and Linux (official brew formula, updated less)
sudo pacman -S opencode            # Arch Linux (Stable)
paru -S opencode-beta              # Arch Linux (Latest from AUR)
mise use -g opencode               # Any OS
nix run github:anomalyco/opencode  # Nix

Giải thích từng dòng:

  • curl ... | bash (README gọi đùa là "YOLO"): tải script cài đặt từ trang chính thức rồi chạy luôn. Nhanh, nhưng bạn không xem được script trước khi nó chạy. Nếu thận trọng, hãy chọn cách dùng trình quản lý gói.
  • npm i -g @opencode/cli@latest: cài toàn cục bằng npm. Chữ -g nghĩa là cài cho cả máy chứ không riêng một thư mục. README ghi bạn có thể thay bằng bun, pnpm hoặc yarn.
  • brew install anomalyco/tap/opencode-v2: cách Homebrew được README đánh dấu "recommended, always up to date" (khuyên dùng, luôn mới nhất).
  • brew install opencode: công thức Homebrew chính thức, nhưng README nói nó cập nhật chậm hơn.
  • sudo pacman -S opencode và paru -S opencode-beta: dành cho Arch Linux. Bản đầu là bản ổn định, bản sau là bản mới nhất từ AUR.
  • mise use -g opencode: dùng mise, README ghi là chạy trên mọi hệ điều hành.
  • nix run github:anomalyco/opencode: chạy thẳng bằng Nix.

Chỗ người mới hay vấp: các dòng có dấu # phía sau chỉ là ghi chú, bạn không cần gõ phần đó. Ngoài ra, tên gói npm trong README (@opencode/cli) và tên gói npm ghi trong thông tin repo (opencode) khác nhau. Mình chép đúng theo README. Nếu lệnh npm báo lỗi, hãy thử cách khác như Homebrew hoặc script, hoặc kiểm tra lại trên trang tài liệu chính thức.

D.Bước 4: Biết chương trình được cài ở đâu

README nói script cài đặt đặt opencode vào thư mục $HOME/.opencode/bin. Nếu sau khi cài mà terminal báo không tìm thấy lệnh, thư mục này có thể chưa nằm trong PATH của bạn. README chưa hướng dẫn chỗ này, nên hãy mở terminal mới rồi thử lại, hoặc xem trang tài liệu.

E.Bước 5: Hoặc dùng ứng dụng desktop (BETA)

Nếu không muốn dùng dòng lệnh, tải bản desktop tại trang tải của dự án (opencode.ai/download). README liệt kê:

Nền tảng File tải
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ài được bằng Homebrew:

Terminal
brew install --cask opencode-desktop

Lệnh này cài bản desktop như một ứng dụng bình thường. Nhớ đây là bản beta, nên có thể còn lỗi vặt.

F.Bước 6: Mở dự án và bắt đầu

README chưa ghi lệnh khởi động cụ thể và cách đăng nhập/kết nối dịch vụ AI. Phần này bạn xem ở trang tài liệu của dự án (opencode.ai/docs). Điều README xác nhận là sau khi vào giao diện, bạn dùng phím Tab để đổi giữa agent build và plan.

Nếu muốn tự lấy mã nguồn về xem, bạn có thể dùng lệnh git phổ thông:

Terminal
git clone https://github.com/anomalyco/opencode.git
cd opencode

Lệnh đầu tải toàn bộ mã nguồn về máy. Lệnh sau đi vào thư mục vừa tải. Với người chỉ muốn dùng, bước này không bắt buộc.

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

README không mô tả một lệnh kiểm tra riêng. Bạn có thể tự kiểm tra theo các dấu hiệu hợp lý sau:

  • Lệnh cài kết thúc không báo lỗi đỏ nào.
  • Bạn mở được giao diện opencode (bản dòng lệnh hoặc bản desktop).
  • Bấm Tab thấy chuyển được giữa hai agent build và plan, đúng như README mô tả.
  • Với script cài, thư mục $HOME/.opencode/bin đã xuất hiện trên máy.

Nếu một trong các dấu hiệu này không có, xem phần lỗi thường gặp bên dưới.

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

Các tình huống dưới đây bám đúng khả năng README nêu: đọc hiểu code, lên kế hoạch ở chế độ chỉ đọc, và làm việc có toàn quyền ở chế độ build. Câu lệnh mẫu là câu bạn gõ cho trợ lý bằng ngôn ngữ thường.

A.Nhận một dự án lạ và cần hiểu nhanh

Bối cảnh: bạn là lập trình viên mới vào công ty, được giao một dự án mà không ai còn nhớ rõ cấu trúc.

Cách làm: mở opencode trong thư mục dự án, để ở agent plan (chỉ đọc, an toàn), rồi hỏi:

Code
Dự án này làm gì? Liệt kê các thư mục chính và file nào là điểm bắt đầu của chương trình.

Kết quả: bạn nhận được bản tóm tắt cấu trúc dự án mà không có file nào bị sửa. Nếu cần tìm sâu hơn, bạn gọi @general để nhờ subagent tìm kiếm nhiều bước.

B.Lên kế hoạch trước khi sửa lỗi

Bối cảnh: website của một shop nhỏ có trang giỏ hàng chạy sai, bạn không chắc lỗi nằm ở đâu.

Cách làm: ở agent plan, mô tả triệu chứng:

Code
Trang giỏ hàng cộng sai tổng tiền khi có mã giảm giá. Tìm đoạn code liên quan và đề xuất cách sửa, chưa sửa vội.

Kết quả: bạn có danh sách file nghi ngờ và hướng sửa để xem xét. Khi đồng ý, bấm Tab sang build và nhờ nó thực hiện.

Cứ để AI đọc trước, sửa sau. Một kế hoạch tốt rẻ hơn rất nhiều so với một lần sửa sai.

Ông T

C.Nhờ sửa một script nhỏ cho công việc văn phòng

Bối cảnh: nhân viên văn phòng có một script đổi tên hàng loạt file báo cáo, nay cần thêm bước gắn tháng vào tên file.

Cách làm: chuyển sang agent build, rồi nhờ:

Code
Sửa script này để tên file mới có thêm tháng ở đầu. Giải thích ngắn bạn đã đổi gì.

Kết quả: trợ lý chỉnh file trực tiếp trong thư mục. Hãy sao lưu thư mục trước khi để nó sửa, và đọc lại thay đổi trước khi chạy script trên dữ liệu thật.

D.Làm quen với phần mới của một codebase trước khi đóng góp

Bối cảnh: bạn muốn đóng góp vào một dự án mã nguồn mở nhưng chưa rõ mình nên bắt đầu từ đâu.

Cách làm: dùng chế độ plan để hỏi về một module cụ thể, ví dụ:

Code
Giải thích module xử lý đăng nhập hoạt động thế nào và các file nào liên quan.

Kết quả: bạn nắm được luồng chạy trước khi viết dòng code đầu tiên. Chế độ plan hỏi xin phép trước khi chạy lệnh bash nên bạn kiểm soát được những gì nó làm trên máy.

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

A.Gõ lệnh báo không tìm thấy chương trình

Nguyên nhân hay gặp là terminal đang mở chưa nhận thư mục cài mới. Script cài vào $HOME/.opencode/bin. Hãy đóng terminal, mở lại rồi thử lần nữa. Nếu vẫn lỗi, kiểm tra thư mục trên có tồn tại không và xem tài liệu chính thức về cách thêm vào PATH. README chưa ghi chi tiết phần này.

B.Lệnh npm không cài được

README dùng tên gói @opencode/cli, trong khi thông tin repo ghi tên gói npm là opencode. Nếu lệnh npm lỗi, đừng thử đoán tên khác. Hãy chuyển sang Homebrew hoặc script cài, hoặc kiểm tra lại trên trang tài liệu chính thức.

C.Cài chồng lên bản cũ gây lỗi lạ

README dặn gỡ các bản cũ hơn 0.1.x trước khi cài. Nếu bạn từng cài opencode từ lâu và bây giờ gặp lỗi lạ, hãy gỡ bản cũ theo đúng cách đã cài, rồi cài lại từ đầu.

D.Agent plan không chịu sửa file

Đây không phải lỗi. Chế độ plan mặc định từ chối sửa file và hỏi phép trước khi chạy bash. Muốn nó sửa, bấm Tab để sang agent build. Chỉ làm vậy khi bạn đã đọc kế hoạch và đồng ý.

E.Lỡ để agent build sửa sai file

Chế độ build có toàn quyền nên có thể sửa nhiều file. Cách phòng là làm trong thư mục đã sao lưu hoặc dùng Git để quay lại bản cũ. Hãy xem lại các thay đổi trước khi dùng cho dữ liệu hay hệ thống thật.

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

Điểm mạnh

  • Mã nguồn mở, giấy phép MIT, cộng đồng lớn (hiện có khoảng 226.506 sao) và vẫn cập nhật gần đây.
  • Hai chế độ build và plan giúp bạn kiểm soát mức độ AI được phép làm.
  • Nhiều cách cài, có cả ứng dụng desktop cho Windows, macOS và Linux.
  • Tài liệu có nhiều ngôn ngữ, gồm tiếng Việt.

Giới hạn

  • README khá ngắn, không nói rõ cách kết nối dịch vụ AI, lệnh khởi động hay chi phí. Bạn phải đọc thêm trang tài liệu chính thức.
  • Bản desktop vẫn là beta.
  • Có sự không nhất quán giữa tên gói npm trong README và trong thông tin repo. Người mới nên chọn cách cài khác nếu gặp lỗi.
  • Chế độ build có toàn quyền, nên cần thói quen sao lưu và đọc lại thay đổi.

Khi nào nên chọn cách khác

Nếu bạn hoàn toàn không đụng đến code hay terminal và chỉ cần một khung chat AI để hỏi đáp, một ứng dụng chat thông thường sẽ đơn giản hơn. Còn nếu bạn làm việc với dự án phần mềm và muốn một trợ lý AI đọc, lập kế hoạch và sửa code ngay trong thư mục làm việc, opencode đáng để thử. Bạn nên bắt đầu ở chế độ plan, rồi mới chuyển sang build khi đã quen.

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?

Bản thân opencode là mã nguồn mở theo giấy phép MIT, nên bạn dùng và xem mã nguồn tự do. README không nói rõ về chi phí của dịch vụ AI mà nó kết nối tới, nên chưa có thông tin về việc đó. Bạn nên xem trang tài liệu chính thức trước khi dùng.

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

Có bản desktop (BETA) cho Windows, file tải là opencode-desktop-win-x64.exe. Với bản dòng lệnh, README ghi mise chạy trên mọi hệ điều hành, và ghi rõ các cách cài cho macOS và Linux. Cách cài dòng lệnh riêng cho Windows thì README chưa nói rõ.

Cần GPU hay cấu hình máy mạnh không?

README không nêu yêu cầu về GPU hay phần cứng. Vì vậy chưa có thông tin chính thức về cấu hình tối thiểu. Bạn xem thêm trang tài liệu của dự án.

Khác nhau giữa agent build và plan là gì?

Build là agent mặc định, toàn quyền, dùng cho công việc phát triển. Plan là agent chỉ đọc: mặc định từ chối sửa file và hỏi phép trước khi chạy lệnh bash. Bạn đổi qua lại bằng phím Tab.

Subagent @general dùng để làm gì?

Đó là subagent dành cho các tìm kiếm phức tạp và việc nhiều bước. Nó chủ yếu được hệ thống dùng nội bộ, nhưng bạn có thể gọi trực tiếp bằng cách gõ @general trong tin nhắn.

Dữ liệu và code của tôi có an toàn không?

README không nói gì về việc dữ liệu được gửi đi đâu hay lưu thế nào, nên chưa có thông tin cụ thể. Điều chắc chắn là agent plan mặc định không sửa file và hỏi phép trước khi chạy bash. Với dự án nhạy cảm, bạn nên đọc kỹ tài liệu và chính sách của dịch vụ AI bạn kết nối.

Tôi không rành terminal thì có dùng được không?

Có thể thử bản desktop (BETA), tải ở trang tải của dự án, không cần gõ lệnh cài. Dù vậy, README chưa hướng dẫn chi tiết cách dùng, nên bạn cần đọc thêm trang tài liệu chính thức.

Chuyển nhanh tới mục

  1. I.opencode làm được gì
    1. A.Hai agent có sẵn, đổi bằng phím Tab
    2. B.Chế độ plan an toàn theo mặc định
    3. C.Subagent general cho việc tìm kiếm phức tạp
    4. D.Nhiều cách cài, nhiều nền tảng
    5. E.Tài liệu và cộng đồng
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Bước 1: Chọn cách cài phù hợp
    2. B.Bước 2: Gỡ phiên bản cũ nếu có
    3. C.Bước 3: Chạy lệnh cài
    4. D.Bước 4: Biết chương trình được cài ở đâu
    5. E.Bước 5: Hoặc dùng ứng dụng desktop (BETA)
    6. F.Bước 6: Mở dự án và bắt đầu
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Nhận một dự án lạ và cần hiểu nhanh
    2. B.Lên kế hoạch trước khi sửa lỗi
    3. C.Nhờ sửa một script nhỏ cho công việc văn phòng
    4. D.Làm quen với phần mới của một codebase trước khi đóng góp
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Gõ lệnh báo không tìm thấy chương trình
    2. B.Lệnh npm không cài được
    3. C.Cài chồng lên bản cũ gây lỗi lạ
    4. D.Agent plan không chịu sửa file
    5. E.Lỡ để agent build sửa sai file
  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ỏ.