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

opencode: trợ lý lập trình AI mã nguồn mở chạy ngay trong terminal — hướng dẫn cài đặt và dùng

10 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 ngay 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 bằng TypeScript). Bạn nhờ nó đọc, giải thích, lập kế hoạch và sửa code trong dự án. Cài đặt khá dễ: chỉ cần một dòng lệnh hoặc một trình quản lý gói quen thuộc, hoặc tải bản desktop (BETA).

opencode là một agent lập trình AI mã nguồn mở. Bạn mở nó trong thư mục dự án, nói bằng ngôn ngữ thường điều bạn muốn, và nó đọc code, đề xuất cách sửa, rồi làm giúp bạn. Tác giả tóm tắt repo bằng đúng một câu: "The open source coding agent".

Repo này hợp với lập trình viên mới muốn có "người kèm cặp" khi đọc một dự án lạ. Nó cũng hợp với dev đã có kinh nghiệm muốn một agent không bị khoá vào một hãng, và với người làm văn phòng, kinh doanh có dùng ít code (file xử lý dữ liệu, script nhỏ) và muốn nhờ AI viết hộ. Hiện repo có khoảng 226.500 sao và khoảng 30.600 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.

Điều đáng giá nhất là sự tách bạch giữa hai chế độ. Một chế độ cho phép AI sửa file. Một chế độ chỉ đọc để phân tích và lên kế hoạch. Người mới nhờ đó có thể "hỏi trước, sửa sau", ít lo AI lỡ tay động vào file của mình.

Agent

anomalyco/opencode

opencode là agent lập trình AI mã nguồn mở: đọc code, sửa file, chạy lệnh theo yêu cầu của bạn, có bản terminal và bản desktop.

★ 227kTypeScriptMIT
Xem repo trên GitHub

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

Dưới đây là những gì README nói rõ. Mình không thêm tính năng nào ngoài tư liệu.

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

opencode có hai agent dựng sẵn và bạn chuyển giữa chúng bằng phím Tab:

  • buildagent mặc định, toàn quyền cho công việc phát triển. Dùng khi bạn muốn nó thật sự viết và sửa code.
  • planagent chỉ đọc, dùng để phân tích và khám phá code. Mặc định nó từ chối sửa file, và hỏi bạn trước khi chạy lệnh bash.

Lợi ích thực tế: khi vào một dự án chưa quen, bạn bật plan để hỏi "phần này chạy thế nào?" mà không sợ nó sửa nhầm. Hiểu xong rồi mới chuyển sang build.

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

Ngoài hai agent trên còn có subagent general, dùng cho các tìm kiếm phức tạp và công việc nhiều bước. Chủ yếu opencode dùng nó ở bên trong, nhưng bạn cũng có thể gọi trực tiếp bằng @general trong tin nhắn.

C.Nhiều cách cài, có cả bản desktop

Bạn có thể cài bằng script một dòng, npm, Homebrew, pacman, paru, mise hoặc Nix. Ngoài ra có ứng dụng desktop (đang BETA) cho macOS, Windows và Linux. Ai ngại terminal có thể bắt đầu bằng bản desktop.

D.Mã nguồn mở, giấy phép MIT

Bạn đọc được code, xem nó làm gì, và dùng theo giấy phép MIT. Với công cụ có quyền đọc và sửa file trên máy bạn, đây là điểm cộng về sự minh bạch.

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

Tư liệu README ghi khá ngắn, nên mình chỉ liệt kê những gì có thật:

  • Hệ điều hành: README liệt kê các cách cài cho macOS, Linux (Homebrew, pacman, paru), mọi hệ điều hành (mise) và Nix. Bản desktop có file cho macOS (Apple Silicon và Intel), Windows (opencode-desktop-win-x64.exe) và Linux (.deb, .rpm hoặc .AppImage).
  • Terminal: nếu cài bằng dòng lệnh, bạn cần mở một cửa sổ terminal. Trên Windows có thể là PowerShell hoặc Terminal.
  • Node/npm hoặc trình quản lý gói tuỳ cách cài bạn chọn. README nhắc npm, bun, pnpm, yarn, Homebrew, mise. README không nêu phiên bản tối thiểu.
  • Lưu ý khi nâng cấp: README dặn gỡ các phiên 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 nói. Nếu bạn cần cấu hình mô hình AI hoặc khoá truy cập, hãy xem tài liệu chính thức tại opencode.ai/docs.

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

  1. Chọn cách càiScript một dòng, trình quản lý gói, hoặc bản desktop
  2. Gỡ bản cũNếu đang có phiên bản cũ hơn 0.1.x thì gỡ trước
  3. Chạy lệnh càiDán đúng một lệnh trong README vào terminal
  4. Mở dự ánVào thư mục code của bạn rồi mở opencode
  5. Đọc tài liệuXem opencode.ai/docs để cấu hình thêm

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

README đưa nhiều lựa chọn. Cách chọn nhanh:

  • Ngại gõ lệnh: tải bản desktop (BETA).
  • Dùng macOS hoặc Linux và có Homebrew: dùng brew.
  • Đã quen npm: dùng npm.
  • Dùng Arch Linux: dùng pacman hoặc paru.

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

README dặn: gỡ các phiên bản cũ hơn 0.1.x trước khi cài. Cách gỡ phụ thuộc vào cách bạn đã cài trước đó, và README không hướng dẫn chi tiết phần này. Bạn dùng lại đúng công cụ đã cài (npm, brew…) để gỡ.

C.Chạy lệnh cài

Đây là toàn bộ lệnh trong README, chép nguyên văn. Bạn chỉ chọn MỘT dòng phù hợp với máy mình, không chạy hết:

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 tải script cài đặt về và chạy ngay. README gọi vui là "YOLO" vì bạn chạy script mà chưa đọc nội dung. Script cài opencode vào thư mục $HOME/.opencode/bin. Dòng này cần môi trường bash (macOS, Linux, hoặc Git Bash trên Windows).
  • npm i -g ... cài toàn cục bằng npm. README ghi bạn có thể thay bằng bun, pnpm hoặc yarn.
  • brew install anomalyco/tap/opencode-v2 là cách README ghi "recommended, always up to date" cho macOS và Linux.
  • brew install opencode là công thức brew chính thức, nhưng README nói nó cập nhật ít hơn.
  • pacman và paru dành cho Arch Linux. Bản 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 ... chạy thẳng bằng Nix.

Chỗ người mới hay vấp: dòng có chữ # là ghi chú, bạn không cần chép phần ghi chú. Và đừng dán cả khối vào terminal cùng lúc.

Nếu muốn dùng bản desktop, README nêu các file tải về theo hệ điều hành:

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

Còn trên Windows bạn tải opencode-desktop-win-x64.exe từ trang tải của dự án (opencode.ai/download) rồi chạy file như một phần mềm thông thường.

D.Mở dự án và bắt đầu

README chưa ghi rõ lệnh khởi chạy sau khi cài. Gói tên là opencode, nên thông thường bạn mở terminal trong thư mục dự án rồi gõ tên lệnh đó. Để chắc chắn, hãy đối chiếu với tài liệu chính thức tại opencode.ai/docs. Với bản desktop thì chỉ cần mở ứng dụng.

opencode có thể đọc và sửa file, và agent build có toàn quyền cho việc phát triển. Hãy thử trên một thư mục dự án có bản sao lưu hoặc có quản lý phiên bản trước. Đừng mở nó trong thư mục chứa dữ liệu quan trọng mà bạn chưa sao lưu.

E.Đọc tài liệu để cấu hình

README chỉ dẫn mọi cấu hình nằm ở trang tài liệu chính thức (opencode.ai/docs). Phần tìm hiểu sâu về agent nằm ở mục agents của trang đó.

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

README không mô tả màn hình hay lệnh kiểm tra phiên bản cụ thể. Bạn có thể tự kiểm tra theo các dấu hiệu sau:

  • Sau khi cài, mở terminal mới (đóng cửa sổ cũ rồi mở lại) để máy nhận lệnh mới. Nếu cài bằng script, thư mục cài là $HOME/.opencode/bin.
  • Mở opencode trong một thư mục dự án và xem giao diện có hiện lên không.
  • Nhấn Tab. README nói đây là phím chuyển giữa agent build và plan, nên bạn sẽ thấy chế độ đổi qua lại.
  • Với bản desktop: mở ứng dụng lên là thấy giao diện.

Nếu terminal báo không tìm thấy lệnh, 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 vào hai chế độ build và plan cùng subagent general mà README mô tả. Câu lệnh mẫu là câu bạn gõ bằng tiếng Việt hoặc tiếng Anh cho AI, không phải lệnh của repo.

A.Nhân viên mới nhận dự án lạ

Bạn vừa vào công ty và được giao một dự án có hàng trăm file. Bạn mở opencode trong thư mục dự án, nhấn Tab để chuyển sang agent plan (chỉ đọc, mặc định từ chối sửa file), rồi hỏi:

Code
Hãy giải thích cấu trúc thư mục dự án này và cho mình biết file nào là điểm bắt đầu.

Kết quả: bạn có bản tóm tắt cấu trúc dự án mà không có file nào bị sửa. Đây là cách an toàn nhất để làm quen.

Hỏi bằng chế độ chỉ đọc trước, sửa bằng chế độ build sau — người mới sẽ ít sợ hơn nhiều.

Ông T

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

Bạn là dev và muốn thêm một tính năng nhỏ. Thay vì để AI sửa ngay, bạn dùng agent plan để phân tích:

Code
Mình muốn thêm tính năng xuất báo cáo ra file. Hãy chỉ ra những file cần sửa và các bước nên làm, chưa sửa gì.

Bạn đọc kế hoạch, chỉnh lại nếu cần, rồi nhấn Tab sang agent build và nhờ nó làm theo từng bước. Kết quả là bạn kiểm soát được hướng đi, AI lo phần gõ code.

C.Chủ shop nhờ viết script xử lý file

Bạn làm kinh doanh nhỏ, có thư mục chứa file đơn hàng và muốn một script gom dữ liệu. Với agent build, bạn mô tả bằng lời thường:

Code
Trong thư mục này có các file đơn hàng. Hãy viết một script gom chúng thành một bảng tổng hợp và giải thích cách chạy.

Kết quả: AI tạo script trong thư mục và hướng dẫn cách chạy. Hãy kiểm tra kết quả trên bản sao dữ liệu trước. Lưu ý README không nói cụ thể về loại tác vụ này, nên đây là cách ứng dụng chung của một agent lập trình.

D.Tìm nhanh một thứ trong dự án lớn

Khi cần tìm "chỗ nào trong dự án xử lý đăng nhập", bạn có thể gọi subagent general bằng @general ngay trong tin nhắn:

Code
@general tìm giúp mình các chỗ xử lý đăng nhập và liệt kê file liên quan.

README mô tả general dùng cho tìm kiếm phức tạp và công việc nhiều bước. Kết quả là danh sách vị trí cần xem, đỡ phải tự lục từng thư mục.

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

README không có mục xử lý sự cố, nên các lỗi dưới đây là những tình huống rất dễ gặp với loại công cụ này.

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

Thường do terminal chưa nhận đường dẫn mới sau khi cài. Hãy đóng terminal, mở lại. Nếu cài bằng script, thư mục cài là $HOME/.opencode/bin, bạn kiểm tra thư mục này có tồn tại và đã nằm trong biến PATH của máy chưa.

B.Lệnh curl chạy không được trên Windows

Lệnh một dòng dùng bash, mà PowerShell mặc định không có bash. Bạn có thể dùng cách khác trong README (ví dụ npm hoặc mise) hoặc tải file .exe của bản desktop.

C.Cài chồng lên bản cũ bị lỗi

README dặn gỡ phiên bản cũ hơn 0.1.x trước khi cài. Nếu bạn quên và thấy hành vi lạ, hãy gỡ bản cũ bằng đúng công cụ đã dùng để cài (npm, brew…) rồi cài lại.

D.Hai cách npm khác nhau, không rõ nên chọn cái nào

README ghi lệnh npm i -g @opencode/cli@latest, trong khi tên gói công khai của repo là opencode. Nếu lệnh npm báo lỗi, đừng tự đoán tên gói. Hãy chuyển sang cách khác trong README (brew, script, mise) hoặc đối chiếu trang tài liệu chính thức.

E.AI sửa file ngoài ý muốn

Agent build có toàn quyền. Cách phòng: dùng plan để xem trước, và làm việc trong thư mục có sao lưu hoặc có quản lý phiên bản để quay lại được khi cần.

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 (khoảng 226.500 sao).
  • Có sẵn hai chế độ build và plan, chuyển bằng Tab, rất hợp người mới.
  • Nhiều cách cài, có cả bản desktop cho Windows, macOS, Linux.
  • Vẫn đang được cập nhật.

Giới hạn:

  • README ngắn: không nói về API key, mô hình AI nào dùng được, chi phí hay yêu cầu phần cứng. Bạn phải xem tài liệu chính thức.
  • Bản desktop còn ở mức BETA.
  • Lệnh cài một dòng chạy script mà bạn chưa đọc. Nếu cẩn thận, hãy chọn cách cài bằng trình quản lý gói.
  • README có hai cách npm khác nhau, dễ gây rối cho người mới.

Khi nào nên chọn cách khác: nếu bạn chỉ muốn chat hỏi đáp một lần, một trình chat AI thông thường là đủ. Nếu bạn cần cam kết về dữ liệu, chi phí hay quyền truy cập, hãy đọc kỹ tài liệu chính thức trước khi đưa code công ty vào. Còn nếu muốn một agent mở, tự kiểm soát được, và có chế độ chỉ đọc để học dự án, opencode đáng thử.

3.9/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 repo là mã nguồn mở theo giấy phép MIT, nên bạn dùng và đọc code miễn phí. README không nói gì về chi phí của mô hình AI hoặc dịch vụ đi kèm. Phần này bạn cần xem tài liệu chính thức.

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

Có bản desktop cho Windows là file opencode-desktop-win-x64.exe (đang BETA). README cũng liệt kê cách cài mise chạy mọi hệ điều hành và cách cài npm. Lệnh curl một dòng cần bash, nên trên Windows bạn cần môi trường có bash hoặc chọn cách khác.

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

README không nêu yêu cầu phần cứng. Chưa có thông tin về việc cần GPU hay không.

Cần API key không?

README chưa nói về API key hay tài khoản. Bạn nên xem trang tài liệu chính thức để biết cách cấu hình mô hình AI.

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

Build là agent mặc định, toàn quyền 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 quyền trước khi chạy lệnh bash. Bạn chuyển qua lại bằng phím Tab.

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

Repo có file SECURITY.md, nhưng README không nói chi tiết về cách xử lý dữ liệu. Vì agent có thể đọc và sửa file trên máy bạn, hãy thử trên dự án có sao lưu và đọc tài liệu chính thức trước khi dùng với code nhạy cảm.

Tôi muốn làm dự án có chữ "opencode" trong tên thì sao?

README yêu cầu bạn ghi chú trong README của dự án mình rằng dự án không do nhóm OpenCode xây dựng và không liên kết với họ. Ví dụ tên như opencode-dashboard hoặc opencode-mobile.

Chuyển nhanh tới mục

  1. I.opencode làm được gì
    1. A.Hai agent có sẵn, đổi qua lại bằng phím Tab
    2. B.Subagent general cho việc tìm kiếm phức tạp
    3. C.Nhiều cách cài, có cả bản desktop
    4. D.Mã nguồn mở, giấy phép MIT
  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ỡ bản cũ (nếu có)
    3. C.Chạy lệnh cài
    4. D.Mở dự án và bắt đầu
    5. E.Đọc tài liệu để cấu hình
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Nhân viên mới nhận dự án lạ
    2. B.Lên kế hoạch trước khi sửa lỗi
    3. C.Chủ shop nhờ viết script xử lý file
    4. D.Tìm nhanh một thứ trong dự án lớn
  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
    2. B.Lệnh curl chạy không được trên Windows
    3. C.Cài chồng lên bản cũ bị lỗi
    4. D.Hai cách npm khác nhau, không rõ nên chọn cái nào
    5. E.AI sửa file ngoài ý muốn
  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ỏ.