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 bằng TypeScript, giúp bạn đọc hiểu, phân tích và sửa code bằng ngôn ngữ thường. Repo có hai agent dựng sẵn là build và plan, kèm ứng dụng desktop bản beta. Cài bằng một dòng lệnh hoặc trình quản lý gói nên không khó, nhưng README chưa ghi cách nối mô hình AI hay API key, bạn cần xem thêm tài liệu của dự án.

opencode là một agent lập trình AI mã nguồn mở: bạn mô tả việc cần làm bằng lời, nó đọc dự án, đề xuất và (nếu bạn cho phép) trực tiếp sửa code. Repo do tổ chức anomalyco phát triển, viết chủ yếu bằng TypeScript, dùng giấy phép MIT và hiện có khoảng 226.506 sao cùng 30.658 fork trên GitHub. Con số này cho thấy cộng đồng quan tâm khá lớn.

Vấn đề nó giải quyết rất quen thuộc. Bạn có một dự án code mà mình không hiểu hết, hoặc có một việc lặp đi lặp lại cần viết script. Thay vì tự mò từng file, bạn nhờ một trợ lý AI đọc hộ, giải thích và làm thay. Nhóm hợp nhất là lập trình viên mới, người làm văn phòng hay tự động hoá việc nhỏ, và chủ doanh nghiệp nhỏ có người giúp việc kỹ thuật.

Điểm đáng giá nhất theo README là hai chế độ làm việc tách bạch. Chế độ build có toàn quyền để làm việc phát triển. Chế độ plan chỉ đọc, mặc định từ chối sửa file và hỏi trước khi chạy lệnh. Bạn có thể cho nó xem dự án lạ mà không lo nó tự ý đổi gì.

Agent

anomalyco/opencode

opencode là agent lập trình AI mã nguồn mở, giấy phép MIT, có chế độ build để sửa code và chế độ plan chỉ đọc để phân tích dự án.

★ 227kTypeScriptMIT
Xem repo trên GitHub

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

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.

  • build là agent mặc định, có đầy đủ quyền cho công việc phát triển. Dùng khi bạn đã chắc chắn muốn nó viết hoặc sửa code.
  • plan là agent 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 quyền trước khi chạy lệnh bash.

Lợi ích thực tế: bạn có thể bắt đầu bằng plan để hiểu dự án và lên kế hoạch, rồi mới chuyển sang build khi thấy ổn. Cách này an toàn hơn nhiều so với giao toàn quyền ngay từ đầu.

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ành cho các việc tìm kiếm phức tạp hoặc nhiều bước. README cho biết 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. Hữu ích khi cần lùng một đoạn logic nằm rải rác nhiều nơi.

C.Có cả ứng dụng desktop (bản beta)

Nếu ngại terminal, opencode có ứng dụng desktop bản BETA cho macOS (Apple Silicon và Intel), Windows và Linux. Bạn tải ở trang opencode.ai/download.

D.Nhiều cách cài, mã nguồn mở hoàn toàn

Bạn cài bằng script, npm, Homebrew, pacman, mise hoặc Nix. Giấy phép MIT cho phép dùng tự do, kể cả trong công việc kinh doanh. Dự án còn được cập nhật trong 3 tháng gần đây nên không phải repo bị bỏ quên.

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

Tư liệu README khá ngắn nên phần này mình chỉ nêu những gì có ghi:

  • Hệ điều hành: các lệnh trong README nhắc tới macOS, Linux (kể cả Arch Linux) và cách chạy bằng Nix. Mục mise ghi là dùng được trên mọi hệ điều hành. Với Windows, README chỉ nêu rõ file cài ứng dụng desktop opencode-desktop-win-x64.exe.
  • Trình quản lý gói: tuỳ cách cài bạn chọn, bạn cần npm (hoặc bun/pnpm/yarn), Homebrew, pacman, paru, mise hoặc Nix.
  • Phiên bản cũ: README dặn gỡ các bản cũ hơn 0.1.x trước khi cài.
  • Phiên bản Node, tài khoản, API key, phần cứng: README chưa ghi. Nếu cần biết opencode kết nối với mô hình AI nào và cấu hình ra sao, bạn xem tài liệu tại opencode.ai/docs.

README không nói rõ chi phí. Nếu sau này bạn nối opencode với một dịch vụ AI tính phí theo lượng dùng, hãy kiểm tra gói cước và đặt giới hạn chi tiêu ở phía nhà cung cấp trước. Đừng dán API key vào file trong dự án rồi đẩy lên GitHub công khai.

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

  1. Chọn cách càiQuyết định dùng script, trình quản lý gói hay ứng dụng desktop
  2. Gỡ bản cũNếu từng cài 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ở lại terminalĐể máy nhận lệnh mới (nếu cần)
  5. Xem tài liệu cấu hìnhLàm theo opencode.ai/docs để thiết lập

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

README liệt kê nhiều cách, bạn chỉ cần chọn một. Gợi ý dựa trên README:

  • Muốn nhanh nhất: dùng script (dòng đầu, README gọi vui là "YOLO").
  • Đã quen npm: dùng npm.
  • Dùng Mac hoặc Linux có Homebrew: README đánh dấu anomalyco/tap/opencode-v2 là khuyến nghị và luôn cập nhật mới nhất.
  • Không thích gõ lệnh: tải ứng dụng desktop ở bước 5.

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

README ghi: 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, bỏ qua bước này. README không nêu lệnh gỡ riêng, nên hãy gỡ theo đúng cách bạn đã cài (ví dụ bằng chính trình quản lý gói đã dùng).

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

Mở terminal (trên Windows là PowerShell hoặc môi trường dòng lệnh bạn đang dùng, trên Mac là Terminal) rồi dán một trong các lệnh dưới đây. Đây là nguyên văn từ README:

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

Chỗ người mới hay vấp:

  • Đừng chạy cả khối. Mỗi dòng là một cách cài khác nhau. Chọn một dòng thôi.
  • Dòng bắt đầu bằng # là ghi chú, không phải lệnh.
  • Lệnh curl ... | bash tải script về và chạy ngay. Script này cài opencode vào $HOME/.opencode/bin. Hãy chỉ chạy khi bạn tin nguồn này.
  • npm i -g là cài toàn cục, gõ lệnh ở đâu cũng dùng được. README ghi bạn có thể thay npm bằng bun, pnpm hoặc yarn.
  • sudo sẽ hỏi mật khẩu máy của bạn (trên Linux).
  • Lệnh npm trong README dùng tên gói @opencode/cli. Nếu gặp lỗi không tìm thấy gói, bạn so lại với README mới nhất trên GitHub vì tên gói có thể được cập nhật.

D.Bước 4: Mở lại terminal

Sau khi cài xong, đóng terminal rồi mở lại để máy nhận lệnh mới. Với script cài, chương trình nằm ở $HOME/.opencode/bin; nếu máy báo không tìm thấy lệnh, hãy kiểm tra thư mục này có nằm trong danh sách đường dẫn (PATH) của bạn không. README không hướng dẫn chi tiết phần này.

E.Bước 5: Hoặc cài ứng dụng desktop

Nếu muốn dùng giao diện đồ hoạ, tải file phù hợp tại opencode.ai/download:

Hệ điều hành 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 có Homebrew, README còn có lệnh sau:

Terminal
brew install --cask opencode-desktop

Lệnh này cài ứng dụng desktop (dạng cask) thay vì bản dòng lệnh. Bản desktop vẫn đang ở giai đoạn BETA nên có thể còn lỗi vặt.

F.Bước 6: Làm theo tài liệu để cấu hình

README chưa ghi cách mở chương trình lần đầu, cách chọn mô hình AI hay cách nhập khoá. Phần này nằm ở trang tài liệu opencode.ai/docs. Trong repo cũng có sẵn các file như AGENTS.md và CONTRIBUTING.md nếu bạn muốn hiểu thêm cách dự án vận hành.

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

README không ghi lệnh kiểm tra riêng, nên mình không đưa ra lệnh nào mà tư liệu không có. Bạn có thể tự đánh giá theo các dấu hiệu sau:

  • Lệnh cài chạy xong mà không báo lỗi đỏ.
  • Với bản desktop: mở ứng dụng lên được và thấy giao diện chính.
  • Khi đã vào được giao diện, thử bấm Tab để chuyển giữa hai agent build và plan. Nếu chuyển được, nghĩa là bạn đã chạy đúng chương trình mô tả trong README.

Nếu chưa chắc cách mở bản dòng lệnh, hãy xem phần bắt đầu nhanh trong opencode.ai/docs.

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

Các tình huống dưới đây bám theo khả năng README mô tả: hai agent build/plan và subagent general. Câu lệnh mẫu chỉ là lời nhờ bằng tiếng thường, bạn tự diễn đạt theo ý mình.

Cứ cho AI đọc trước, đừng cho nó sửa vội. Hiểu rồi mới làm thì ít hỏng việc hơn nhiều.

Ông T

A.Nhận một dự án lạ từ người đi trước

Bối cảnh: bạn là lập trình viên mới, vừa được giao một dự án web do người khác để lại, không có tài liệu.

Cách làm: mở opencode trong thư mục dự án, để ở chế độ plan (chỉ đọc). Gõ một câu như: "Dự án này gồm những phần nào, file nào là điểm bắt đầu chạy?". Vì plan mặc định từ chối sửa file nên bạn yên tâm khám phá.

Kết quả: bạn có bản mô tả tổng quan bằng tiếng thường, biết nên đọc file nào trước. README nói rõ chế độ này lý tưởng cho việc khám phá codebase lạ.

B.Lên kế hoạch trước khi sửa tính năng

Bối cảnh: chủ shop online có một trang đặt hàng đơn giản, muốn thêm ô nhập mã giảm giá.

Cách làm: ở chế độ plan, bạn nhờ: "Muốn thêm ô nhập mã giảm giá vào trang đặt hàng, cần sửa những chỗ nào?". Đọc kế hoạch, thấy hợp lý thì nhấn Tab sang build và nhờ nó làm theo kế hoạch đó.

Kết quả: bạn có danh sách thay đổi rõ ràng trước khi code bị đụng tới, dễ kiểm tra và dễ từ chối nếu thấy sai hướng.

C.Tìm một đoạn logic nằm rải rác

Bối cảnh: nhân viên kỹ thuật cần biết giá sản phẩm được tính ở đâu, vì nó xuất hiện ở nhiều chỗ trong dự án.

Cách làm: gọi subagent bằng @general trong tin nhắn, ví dụ: "@general tìm tất cả chỗ đang tính giá sau thuế và liệt kê giúp mình".

Kết quả: nhận lại danh sách các vị trí liên quan, đỡ mất công tìm tay từng file. README mô tả general dành cho tìm kiếm phức tạp và việc nhiều bước.

D.Nhờ sửa lỗi nhỏ với chế độ build

Bối cảnh: dev gặp một lỗi hiển thị nhỏ và đã biết đại khái nó nằm ở đâu.

Cách làm: chuyển sang build, mô tả lỗi và mong muốn, ví dụ: "Nút Gửi bị lệch xuống dưới trên màn hình nhỏ, hãy sửa cho nằm cùng hàng với ô nhập". Đọc kỹ thay đổi nó đề xuất rồi mới chấp nhận.

Kết quả: một thay đổi nhỏ, gọn, bạn kiểm tra được ngay trên trang thật. Với việc nhỏ như vậy, build tiết kiệm khá nhiều thời gian.

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

README không có mục xử lý lỗi, nên các lỗi dưới đây là những tình huống rất dễ xảy ra với loại công cụ dòng lệnh này. Cách khắc phục đều theo hướng an toàn.

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

Thường do chưa mở lại terminal sau khi cài, hoặc thư mục cài chưa nằm trong PATH. Script cài đặt đặt chương trình ở $HOME/.opencode/bin, bạn kiểm tra thư mục này và thêm vào PATH nếu cần. Đóng rồi mở lại terminal trước khi thử lại.

B.Cài xong nhưng chạy ra bản cũ hoặc xung đột

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 bằng nhiều cách khác nhau (ví dụ vừa script vừa Homebrew), máy có thể chạy nhầm bản. Gỡ các bản thừa, chỉ giữ một cách cài.

C.Lệnh npm báo không tìm thấy gói

Bạn gõ sai tên gói, hoặc tên gói đã đổi. Dùng đúng chuỗi trong README (@opencode/cli@latest) và kiểm tra lại README mới nhất trên GitHub. Nếu vẫn lỗi, thử cách cài khác như script hoặc Homebrew.

D.AI sửa code không như ý

Đây là bản chất của mọi agent lập trình. Hãy làm việc trong một thư mục có sao lưu hoặc đã được quản lý phiên bản bằng git, để quay lại được. Dùng chế độ plan trước, chỉ sang build khi bạn đã hiểu nó định làm gì, và đọc kỹ thay đổi trước khi chấp nhận.

E.Nhầm với dự án có tên na ná

README nhắc rằng các dự án có chữ "opencode" trong tên (như "opencode-dashboard" hay "opencode-mobile") không phải do đội opencode làm và không liên kết với họ. Khi tải thêm công cụ bên thứ ba, hãy kiểm tra tác giả trước, đừng cho rằng nó là sản phẩm chính thức.

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

Điểm mạnh:

  • Mã nguồn mở, giấy phép MIT, dùng tự do.
  • Hai chế độ build và plan giúp bạn kiểm soát mức độ "động tay" của AI.
  • Nhiều cách cài, có cả ứng dụng desktop cho người ngại terminal.
  • Cộng đồng lớn (hiện có khoảng 226.506 sao) và repo còn được cập nhật gần đây.
  • README có bản tiếng Việt cho ai thích đọc tiếng mẹ đẻ.

Giới hạn:

  • README ngắn, chưa ghi yêu cầu phiên bản, cách chọn mô hình AI hay cách nhập khoá. Bạn phải đọc thêm tài liệu trên trang chủ.
  • Ứng dụng desktop vẫn là BETA.
  • Cách cài bằng script và Homebrew chủ yếu nhắm tới macOS và Linux; README chưa nói rõ cách dùng bản dòng lệnh trên Windows, chỉ có file cài bản desktop.
  • Mình chưa có thông tin về chi phí khi dùng với từng dịch vụ AI.

Khi nào nên chọn cách khác: nếu bạn chỉ cần hỏi đáp nhanh về một đoạn code, một khung chat AI thông thường là đủ. Nếu bạn cần công cụ có hướng dẫn từng bước thật chi tiết cho người chưa từng đụng terminal, hãy thử bản desktop trước. Còn nếu bạn muốn một trợ lý nằm ngay trong thư mục dự án, có chế độ chỉ đọc để khám phá an toàn, opencode là lựa chọn đáng thử.

4.8/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ở, dùng giấy phép MIT nên tải và dùng tự do. Tuy nhiên README không nói về chi phí khi kết nối với các dịch vụ AI bên ngoài, nên mình chưa có thông tin về phần này. Bạn kiểm tra gói cước của nhà cung cấp mô hình mà bạn chọn.

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

README có file cài ứng dụng desktop cho Windows là `opencode-desktop-win-x64.exe` (bản BETA). README chưa nói rõ cách dùng bản dòng lệnh trên Windows. Mục cài bằng `mise` được ghi là dùng được trên mọi hệ điều hành.

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

Tư liệu README không nêu yêu cầu phần cứng nào, nên chưa có thông tin về việc này. Bạn xem thêm tài liệu tại opencode.ai/docs.

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

Build là agent mặc định, có 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. Plan hợp để khám phá dự án lạ hoặc lên kế hoạch thay đổi.

Có cần API key hay tài khoản để dùng không?

README không ghi yêu cầu tài khoản hay API key. Cách thiết lập mô hình AI nằm trong tài liệu tại opencode.ai/docs. Nếu sau này bạn dùng khoá, hãy giữ kín và không đẩy lên GitHub công khai.

Không thích terminal thì dùng thế nào?

opencode có ứng dụng desktop bản BETA cho macOS, Windows và Linux, tải ở opencode.ai/download. Trên macOS có Homebrew, README cũng có lệnh `brew install --cask opencode-desktop`. Vì còn là bản beta nên có thể còn lỗi.

Các dự án tên có chữ opencode khác có phải của đội opencode không?

Không nhất thiết. README yêu cầu các dự án liên quan dùng chữ opencode trong tên (ví dụ opencode-dashboard, opencode-mobile) phải ghi rõ là không do đội opencode làm và không liên kết với họ. Bạn nên kiểm tra tác giả trước khi cài.

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.Có cả ứng dụng desktop (bản beta)
    4. D.Nhiều cách cài, mã nguồn mở hoàn toàn
  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 với bạn
    2. B.Bước 2: Gỡ bản cũ (nếu có)
    3. C.Bước 3: Chạy lệnh cài
    4. D.Bước 4: Mở lại terminal
    5. E.Bước 5: Hoặc cài ứng dụng desktop
    6. F.Bước 6: Làm theo 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 một dự án lạ từ người đi trước
    2. B.Lên kế hoạch trước khi sửa tính năng
    3. C.Tìm một đoạn logic nằm rải rác
    4. D.Nhờ sửa lỗi nhỏ với chế độ build
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Gõ lệnh mà máy báo không tìm thấy
    2. B.Cài xong nhưng chạy ra bản cũ hoặc xung đột
    3. C.Lệnh npm báo không tìm thấy gói
    4. D.AI sửa code không như ý
    5. E.Nhầm với dự án có tên na 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ỏ.