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

opencode: agent viết code 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: agent viết code 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ở, viết bằng TypeScript, giấy phép MIT. Bạn dùng nó để đọc, hỏi đáp và sửa code ngay trong dự án của mình. Cài đặt khá dễ: chỉ cần một dòng lệnh, một trình quản lý gói, hoặc tải bản desktop (đang ở dạng BETA).

opencode là một agent lập trình AI mã nguồn mở: bạn giao việc bằng tiếng người, nó đọc code trong dự án, trả lời câu hỏi và (nếu bạn cho phép) sửa code giúp bạn. Dự án viết bằng TypeScript, dùng giấy phép MIT, hiện có khoảng 226.506 sao và 30.658 fork trên GitHub. Con số đó cho thấy rất nhiều người đang dùng và theo dõi nó.

Repo này dành cho ba nhóm người. Thứ nhất là lập trình viên mới, cần một "người bạn" giải thích code lạ. Thứ hai là dev đang làm dự án, muốn giao bớt việc lặp lại. Thứ ba là người làm kinh doanh, văn phòng có biết chút code (script, file tự động hoá) và muốn có người đọc giúp.

Điểm đáng giá nhất là hai chế độ làm việc tách bạch. Chế độ build có toàn quyền để làm việc. Chế độ plan chỉ đọc, mặc định không cho sửa file. Bạn chuyển qua lại bằng phím Tab. Nhờ vậy bạn có thể cho nó "xem trước, chưa động vào gì" rồi mới cho làm thật.

Agent

anomalyco/opencode

opencode là agent lập trình AI mã nguồn mở (giấy phép MIT), có hai chế độ build và plan, cài bằng một dòng lệnh hoặc dùng bản desktop.

★ 227kTypeScriptMIT
Xem repo trên GitHub

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

Theo README, opencode có những phần chính sau.

  • Agent build (mặc định). Đây là agent có toàn quyền để làm việc phát triển phần mềm. Dùng khi bạn đã rõ muốn nó viết hay sửa cái gì.
  • Agent plan (chỉ đọc). Mặc định từ chối sửa file và hỏi bạn trước khi chạy lệnh bash. Rất hợp để khám phá một dự án lạ hoặc lên kế hoạch thay đổi mà không sợ nó làm hỏng gì.
  • Subagent general. Dùng cho các việc tìm kiếm phức tạp và nhiều bước. opencode dùng nó ở bên trong, và bạn cũng có thể gọi bằng cách gõ @general trong tin nhắn.
  • Nhiều cách cài. Có script cài một dòng, npm, Homebrew, pacman và AUR (Arch Linux), mise, Nix. Ai dùng hệ nào cũng có đường đi.
  • Bản desktop (BETA). Nếu không quen terminal, bạn có thể tải ứng dụng cho macOS, Windows hoặc Linux.
  • Có tài liệu riêng. Phần cấu hình chi tiết nằm ở trang tài liệu của dự án (opencode.ai/docs). README chỉ nói sơ, nên khi cần chỉnh sâu bạn sẽ phải sang đó.

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

README ghi khá ít về yêu cầu, nên mình chỉ nêu đúng những gì có:

  • Hệ điều hành: có bản cho macOS (Apple Silicon và Intel), Windows (x64) và Linux. Các lệnh cài bằng Homebrew, pacman, paru nói rõ là cho macOS/Linux hoặc Arch Linux. mise được ghi là dùng được trên mọi hệ điều hành.
  • Công cụ cài đặt: tuỳ cách bạn chọn. Dùng npm thì cần npm (hoặc bun/pnpm/yarn). Dùng Homebrew thì cần Homebrew. Dùng Nix thì cần Nix.
  • Phiên bản cũ: README nhắc nên gỡ các bản cũ hơn 0.1.x trước khi cài.
  • Tài khoản, API key, phần cứng: README chưa ghi gì về việc này. Một agent AI thường cần kết nối tới một mô hình ngôn ngữ nào đó, nhưng cách kết nối cụ thể bạn hãy xem ở trang tài liệu của dự án.

README không nói gì về chi phí hay API key. Nếu sau này bạn nhập key của một dịch vụ AI vào opencode, hãy giữ key bí mật, đừng dán lên nhóm chat hay đưa vào file code đẩy lên GitHub. Hãy xem trang tài liệu của dự án để biết cách khai báo key đúng chỗ.

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

  1. Chọn cách càiQuyết định dùng script một dòng, trình quản lý gói hay bản 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àiMở terminal và dán đúng lệnh của cách bạn chọn
  4. Hoặc tải bản desktopTải file cài cho macOS, Windows hoặc Linux
  5. Mở và thửVào thư mục dự án và bắt đầu trò chuyện với agent

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

README đưa ra khá nhiều lựa chọn. Nếu bạn mới, mình gợi ý chọn một trong hai: script một dòng (nhanh nhất) hoặc bản desktop (không cần gõ lệnh). Nếu bạn đã quen npm hoặc Homebrew thì dùng chúng cho tiện quản lý cập nhật.

Terminal là cửa sổ gõ lệnh. Trên Windows bạn mở PowerShell hoặc Windows Terminal. Trên macOS bạn mở ứng dụng Terminal. Trên Linux bạn mở terminal của bản phân phối đang dùng.

B.Gỡ phiên bản cũ (nếu có)

README ghi: hãy gỡ các phiên 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 bạn gỡ theo đúng cách bạn đã cài trước đó (ví dụ gỡ gói qua npm hoặc Homebrew).

C.Cài bằng một dòng lệnh

README gọi đây là cách "YOLO", nghĩa là tải script về rồi chạy ngay. Nhanh, nhưng bạn nên tin nguồn. Script này cài opencode vào thư mục $HOME/.opencode/bin.

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

Lệnh này dùng curl và bash, nên hợp với macOS và Linux. Trên Windows bạn có thể chạy nó trong môi trường có bash (như WSL). Nếu thấy phiền thì dùng bản desktop hoặc npm ở dưới.

D.Cài bằng trình quản lý gói

Các dòng dưới đây chép đúng theo 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
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

Ghi chú cho từng dòng:

  • npm i -g ... cài toàn cục bằng npm, dùng được trên mọi hệ điều hành có npm. Phần chú thích cho biết bạn có thể thay bằng bun, pnpm hoặc yarn.
  • Hai dòng brew là cho macOS và Linux. README khuyên dòng thứ nhất (anomalyco/tap/opencode-v2) vì luôn mới nhất. Dòng thứ hai là bản chính thức của Homebrew nhưng cập nhật chậm hơn.
  • pacman và paru là cho Arch Linux. paru lấy bản mới nhất từ AUR.
  • mise use -g opencode dùng được trên mọi hệ điều hành, nếu bạn đã có mise.
  • nix run ... dành cho người dùng Nix.

Chỗ dễ vấp: tên gói trong README hơi khác nhau giữa các cách (ví dụ @opencode/cli với npm, opencode-v2 với tap của Homebrew). Cứ chép đúng từng dòng, đừng tự sửa tên.

E.Hoặc tải bản desktop (BETA)

Nếu không muốn gõ lệnh, bạn tải ứng dụng ở trang tải xuống của dự án (opencode.ai/download). README liệt kê các file:

  • macOS chip Apple Silicon: opencode-desktop-mac-arm64.dmg
  • macOS chip 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 bằng Homebrew:

Terminal
# macOS (Homebrew)
brew install --cask opencode-desktop

Bản desktop đang ở giai đoạn BETA, nên có thể còn lỗi vặt.

F.Mở opencode lần đầu

README chưa ghi lệnh khởi chạy hay các bước thiết lập ban đầu (như đăng nhập, chọn mô hình). Bạn xem phần hướng dẫn ở trang tài liệu của dự án (opencode.ai/docs). Gợi ý nhỏ: sau khi cài, hãy mở terminal ngay trong thư mục dự án của bạn rồi mới khởi chạy, để agent làm việc đúng thư mục. Với bản desktop thì mở ứng dụng và chọn thư mục dự án.

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

README không nêu lệnh kiểm tra phiên bản hay màn hình mong đợi, nên mình không đưa ra lệnh nào mà README không có. Bạn có thể tự kiểm tra theo các dấu hiệu thực tế sau:

  • Lệnh cài chạy xong mà không báo lỗi đỏ.
  • Nếu dùng script một dòng, thư mục $HOME/.opencode/bin đã được tạo ra (README nói script cài vào đây).
  • Nếu dùng bản desktop, ứng dụng mở lên được.
  • Khi khởi chạy xong, bạn nhấn Tab và thấy agent đổi giữa build và plan. Đây là hành vi README mô tả, nên nếu thấy được thì chứng tỏ bạn đang chạy đúng opencode.

Nếu chưa thấy, đừng vội cài lại. Hãy xem phần lỗi hay gặp ở dưới.

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

Các tình huống dưới đây bám đúng những gì README mô tả: hai agent build và plan, subagent general, và việc chuyển bằng Tab. Mình để câu lệnh mẫu dưới dạng lời bạn gõ cho agent.

A.Dev mới nhận dự án lạ: dùng plan để làm quen

Bạn vừa vào công ty và được giao một dự án mà không ai còn nhớ rõ cấu trúc. Hãy mở opencode trong thư mục dự án, nhấn Tab sang agent plan, rồi hỏi:

text
Dự án này làm gì? Hãy giải thích cấu trúc thư mục chính và file nào là điểm bắt đầu.

Vì plan chỉ đọc nên bạn yên tâm: nó không sửa file, và còn hỏi trước khi chạy lệnh bash. Kết quả bạn nhận được là một bản giải thích để bạn đọc tiếp, thay vì mất cả buổi lần mò từng thư mục.

Cứ để agent đọc trước, sửa sau: chế độ chỉ đọc là cách rẻ nhất để làm quen với code lạ.

Ông T

B.Chủ shop có script tự động hoá: nhờ giải thích và lập kế hoạch sửa

Bạn có một script nhỏ do người khác viết để xuất đơn hàng ra file. Giờ muốn thêm một cột. Bạn không cần hiểu hết code. Ở chế độ plan, bạn gõ:

text
Mình muốn thêm một cột mới vào file xuất đơn hàng. Hãy chỉ ra phải sửa ở đâu và kế hoạch từng bước.

Bạn sẽ có một kế hoạch rõ ràng. Khi thấy hợp lý, nhấn Tab sang build và nhờ nó làm theo kế hoạch. Nhớ lưu bản sao của file gốc trước khi cho build sửa, phòng khi kết quả chưa như ý.

C.Dev tìm đoạn code rải rác khắp dự án: gọi @general

Bạn cần biết chỗ nào trong dự án đang xử lý việc tính phí vận chuyển, mà nó nằm rải rác nhiều file. README nói subagent general dành cho các việc tìm kiếm phức tạp và nhiều bước, gọi bằng @general. Bạn gõ:

text
@general Tìm tất cả chỗ trong dự án có xử lý phí vận chuyển và liệt kê theo từng file.

Kết quả là một danh sách các chỗ liên quan, giúp bạn tiết kiệm thời gian tìm kiếm thủ công.

D.Nhân viên văn phòng: dùng bản desktop để hỏi về một thư mục code

Bạn không rành terminal nhưng đồng nghiệp gửi một thư mục code nhỏ và nhờ bạn xem nó làm gì. Hãy cài bản desktop (BETA), mở thư mục đó và dùng chế độ plan để hỏi "thư mục này làm gì, chạy thế nào". Bạn nhận được lời giải thích bằng ngôn ngữ dễ hiểu để trao đổi lại với đồng nghiệp. Đây là cách dùng thận trọng, vì plan không sửa file.

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

1. Gõ lệnh mà báo không tìm thấy lệnh (command not found). Thường do terminal chưa nhận đường dẫn mới sau khi cài. Hãy đóng terminal rồi mở lại. Nếu bạn dùng script một dòng, README nói opencode nằm ở $HOME/.opencode/bin; hãy kiểm tra thư mục này có tồn tại không. Nếu vẫn lỗi, xem trang tài liệu của dự án về cách thêm đường dẫn.

2. Cài bằng npm bị lỗi quyền (permission). Lệnh npm i -g đôi khi cần quyền cao hơn trên một số máy. Đừng vội dùng quyền quản trị cho mọi thứ. Hãy thử cách khác trong README (script một dòng, Homebrew, mise) hoặc tải bản desktop.

3. Cài lẫn nhiều cách nên bị xung đột phiên bản. README có nhiều tên gói khác nhau (như opencode và opencode-v2 ở Homebrew). Nếu bạn lỡ cài hai bản, hãy gỡ bớt một bản để tránh nhầm. README cũng dặn gỡ các bản cũ hơn 0.1.x trước khi cài.

4. Agent build sửa file không như ý. Build có toàn quyền, nên nó có thể sửa nhiều chỗ. Cách an toàn: dùng plan trước để xem kế hoạch, và dùng Git hoặc bản sao lưu để quay lại được. Với việc quan trọng, hãy đọc kỹ những gì nó đã thay đổi.

5. Agent chạy nhưng không trả lời hoặc báo lỗi kết nối. README không nói về phần kết nối với mô hình AI, nên mình không đoán nguyên nhân. Hãy kiểm tra phần cấu hình trong tài liệu của dự án và hỏi thêm ở cộng đồng Discord của dự án.

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

Điểm mạnh:

  • Mã nguồn mở, giấy phép MIT, dùng và xem code thoải mái.
  • Có hai chế độ rõ ràng: build làm việc, plan chỉ đọc. Rất hợp với người mới, vì có chỗ để "xem mà không động vào".
  • Nhiều cách cài, có cả bản desktop nên người không quen terminal vẫn thử được.
  • Dự án đông người dùng và vẫn được cập nhật trong 3 tháng gần đây.

Giới hạn:

  • README khá ngắn. Cách thiết lập ban đầu, kết nối mô hình AI và chi phí đều nằm ở tài liệu riêng, không có trong README.
  • Bản desktop còn ở dạng BETA.
  • Tên gói và cách cài hơi nhiều, người mới dễ rối nếu không chọn một cách và làm theo.
  • Agent có quyền sửa file ở chế độ build, nên cần cẩn thận và có bản sao lưu.

Khi nào nên chọn cách khác: nếu bạn không hề đụng tới code và chỉ cần một trợ lý trò chuyện thông thường, một ứng dụng chat AI đơn giản sẽ hợp hơn. Còn nếu bạn làm việc với code, muốn một agent mã nguồn mở có chế độ chỉ đọc an toàn, thì opencode đáng để cài thử.

4.3/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ở với giấy phép MIT, nên bạn dùng và xem code tự do. README không nói gì về chi phí khi kết nối với các mô hình AI. Phần này bạn cần xem trong tài liệu của dự án.

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

Có. README ghi có file cài cho Windows là opencode-desktop-win-x64.exe (bản desktop BETA). Lệnh cài một dòng dùng curl và bash nên hợp với macOS/Linux hơn. Ngoài ra bạn có thể dùng npm hoặc mise (mise được ghi là chạy trên mọi hệ điều hành).

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

README không nêu yêu cầu phần cứng nào. Vì vậy mình không thể khẳng định cần hay không. Bạn xem thêm trong tài liệu của dự án.

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

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

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

General là subagent dành cho các việc tìm kiếm phức tạp và nhiều bước. opencode dùng nó ở bên trong, và bạn cũng có thể gọi bằng cách gõ @general trong tin nhắn.

Dữ liệu và code của mình có an toàn không?

README không có thông tin về cách xử lý dữ liệu. Repo có file SECURITY.md để bạn tham khảo chính sách bảo mật. Với code quan trọng, hãy dùng chế độ plan trước và đọc kỹ những gì agent thay đổi.

opencode khác gì các công cụ viết code AI khác?

README không so sánh với công cụ nào. Điểm nổi bật được mô tả là mã nguồn mở, có hai agent build và plan, có subagent general, và có cả bản desktop BETA.

Chuyển nhanh tới mục

  1. I.opencode làm được gì
  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.Gỡ phiên bản cũ (nếu có)
    3. C.Cài bằng một dòng lệnh
    4. D.Cài bằng trình quản lý gói
    5. E.Hoặc tải bản desktop (BETA)
    6. F.Mở opencode lần đầu
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev mới nhận dự án lạ: dùng plan để làm quen
    2. B.Chủ shop có script tự động hoá: nhờ giải thích và lập kế hoạch sửa
    3. C.Dev tìm đoạn code rải rác khắp dự án: gọi @general
    4. D.Nhân viên văn phòng: dùng bản desktop để hỏi về một thư mục code
  6. VI.Lỗi hay gặp và cách xử lý
  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ỏ.