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 coding agent (trợ lý lập trình AI) mã nguồn mở, giấy phép MIT, viết bằng TypeScript. Bạn cài bằng một dòng lệnh, trình quản lý gói hoặc tải bản desktop (beta), rồi nhờ nó đọc, phân tích và sửa code. Cài đặt khá dễ, nhưng README chỉ hướng dẫn phần cài; phần cấu hình chi tiết nằm ở trang tài liệu chính thức.

opencode là một coding agent mã nguồn mở: một trợ lý AI giúp bạn đọc, hiểu và sửa code ngay trên máy của mình. Tác giả mô tả ngắn gọn đây là «The open source coding agent». Repo hiện có khoảng 226.506 sao và 30.658 fork, giấy phép MIT, viết chủ yếu bằng TypeScript và vẫn được cập nhật trong 3 tháng gần đây.

Nếu bạn là lập trình viên mới, đang ngợp trước một dự án lạ vài trăm file, opencode giúp bạn khám phá và hỏi đáp trên chính mã nguồn đó. Nếu bạn làm văn phòng hay kinh doanh và có người trong nhóm làm phần mềm, đây cũng là công cụ để hiểu một dự án đang làm gì mà không phải ngồi đọc từng dòng.

Đ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. Chế độ plan chỉ đọc, mặc định từ chối sửa file. Bạn đổi qua lại bằng phím Tab. Nhờ vậy bạn có thể cho AI «xem trước, nghĩ trước» rồi mới cho nó động vào code.

Agent

anomalyco/opencode

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

★ 227kTypeScriptMIT
Xem repo trên GitHub

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

README của repo khá ngắn, nên dưới đây mình chỉ nói những gì nó thực sự ghi.

A.Hai agent có sẵn: build và plan

  • build là agent mặc định, có quyền đầy đủ cho công việc phát triển. Bạn dùng khi đã biết mình muốn gì và sẵn sàng cho nó chỉnh sửa.
  • plan là agent chỉ đọc, dùng để phân tích và khám phá code. Mặc định nó từ chối chỉnh sửa file, và hỏi bạn trước khi chạy lệnh bash. Rất hợp khi bạn mở một dự án lạ hoặc muốn lập kế hoạch thay đổi trước khi làm thật.

Đổi giữa hai agent chỉ cần nhấn Tab. Lợi ích thực tế: bạn kiểm soát được mức «tay chân» của AI, không lo nó tự sửa lung tung khi bạn chỉ muốn tìm hiể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ùng cho các tìm kiếm phức tạp và công việc nhiều bước. README nói 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 bạn cần lần theo một chuỗi việc dài mà không muốn tự chia nhỏ.

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

opencode có script cài một dòng, cài qua npm/bun/pnpm/yarn, Homebrew, Arch Linux (pacman và AUR), mise và Nix. Ngoài ra còn có ứng dụng desktop (BETA) cho macOS, Windows và Linux. Người không quen terminal có thể chọn bản này.

D.Mã nguồn mở, có tài liệu riêng

Giấy phép MIT nên bạn dùng khá thoải mái. Tài liệu cấu hình chi tiết nằm ở trang chủ dự án (opencode.ai/docs), còn cộng đồng có Discord và X.com.

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ì suy ra được từ tư liệu:

  • Hệ điều hành: macOS, Linux và Windows đều có đường cài. Bản desktop có file riêng cho macOS (Apple Silicon và Intel), Windows (x64) và Linux (.deb, .rpm hoặc .AppImage). Lệnh mise use -g opencode được ghi là chạy trên mọi hệ điều hành.
  • Một cửa sổ terminal nếu bạn cài bằng lệnh. Trên Windows, mở PowerShell. Trên macOS hoặc Linux, mở Terminal.
  • Node/npm hoặc Homebrew nếu bạn chọn cách cài tương ứng. README không ghi phiên bản Node tối thiểu.
  • 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.
  • Tài khoản, API key, phần cứng: README chưa nói gì về các mục này. Cách kết nối với mô hình AI nằm trong tài liệu tại opencode.ai/docs, bạn đọc ở đó trước khi bắt đầu.

README không nêu chuyện API key hay chi phí. Nếu sau này bạn kết nối opencode với một dịch vụ AI tính phí, hãy kiểm tra gói cước và đừng dán key vào nơi công khai hay đưa vào file code mà bạn đẩy lên GitHub.

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

  1. Mở terminalDùng PowerShell trên Windows, Terminal trên macOS hoặc Linux
  2. Chọn một cách càiScript một dòng, npm, Homebrew hoặc bản desktop
  3. Chạy lệnh càiDán đúng lệnh từ README rồi Enter
  4. Kiểm tra thư mục càiScript cài vào $HOME/.opencode/bin
  5. Đọc tài liệu cấu hìnhXem opencode.ai/docs để thiết lập tiếp

A.Mở terminal và gỡ bản cũ

Trước tiên, nếu máy bạn từng cài opencode bản rất cũ (thấp hơn 0.1.x), README khuyên gỡ nó đi trước. Nếu bạn chưa từng cài, bỏ qua bước này.

Terminal không cần mở ở thư mục đặc biệt để chạy lệnh cài, vì đây là cài toàn máy. Nhưng khi dùng opencode làm việc với code, bạn nên mở terminal ngay trong thư mục dự án của mình.

B.Cách 1: script cài một dòng (macOS, Linux)

README gọi cách này là «YOLO», nghĩa là nhanh nhưng bạn nên tự biết mình đang chạy gì. Lệnh tải script từ trang chủ rồi chạy luôn bằng bash:

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

Script này cài opencode vào thư mục $HOME/.opencode/bin. Lệnh có | bash nên cần môi trường có bash; trên Windows thường chạy được trong Git Bash hoặc WSL, nhưng README không nói rõ, nên nếu muốn an tâm hãy chọn cách npm hoặc bản desktop.

C.Cách 2: cài bằng npm, bun, pnpm hoặc yarn

Nếu bạn đã có Node.js, đây là cách dễ nhất, cũng chạy được trên Windows PowerShell:

PowerShell
npm i -g @opencode/cli@latest

README ghi chú bạn có thể thay npm bằng bun, pnpm hoặc yarn. Cờ -g nghĩa là cài toàn máy để gõ lệnh ở thư mục nào cũng được. Lưu ý: tên gói trong lệnh README là @opencode/cli, trong khi metadata của repo ghi tên gói npm là opencode. Hai tên này khác nhau, nên bạn hãy làm đúng theo dòng lệnh trong README, hoặc đối chiếu lại ở trang tài liệu nếu máy báo không tìm thấy gói.

D.Cách 3: Homebrew (macOS và Linux)

README đưa hai công thức. Công thức đầu được ghi là khuyến nghị và luôn mới nhất:

Terminal
brew install anomalyco/tap/opencode-v2

Công thức chính thức của Homebrew, được cập nhật chậm hơn:

Terminal
brew install opencode

Chọn một trong hai, đừng cài cả hai.

E.Cách 4: các trình quản lý khác

Cho người dùng Arch Linux, README ghi bản ổn định và bản mới nhất từ AUR:

Terminal
sudo pacman -S opencode
paru -S opencode-beta

Dùng mise (chạy trên mọi hệ điều hành) hoặc Nix:

Terminal
mise use -g opencode
nix run github:anomalyco/opencode

F.Cách 5: bản ứng dụng desktop (BETA)

Nếu ngại gõ lệnh, vào opencode.ai/download và tải file phù hợp: opencode-desktop-mac-arm64.dmg (Mac chip Apple), opencode-desktop-mac-x64.dmg (Mac Intel), opencode-desktop-win-x64.exe (Windows), hoặc .deb, .rpm, .AppImage cho Linux. Trên macOS bạn cũng có thể dùng Homebrew:

Terminal
brew install --cask opencode-desktop

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

G.Tải mã nguồn về (nếu bạn muốn tự xem)

README không hướng dẫn tự build từ mã nguồn, mà chỉ trỏ tới tài liệu đóng góp (CONTRIBUTING.md trong repo). Nếu bạn chỉ muốn xem code:

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

Người dùng thông thường không cần bước này.

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

README không có mục kiểm tra cài đặt hay lệnh --version. Vì vậy mình chỉ gợi ý những cách kiểm tra an toàn:

  • Với script cài một dòng, kiểm tra thư mục $HOME/.opencode/bin đã có file chương trình chưa.
  • Với npm, Homebrew hay mise, đóng terminal cũ, mở terminal mới rồi thử gọi chương trình bằng tên opencode. README không ghi lệnh khởi chạy, nên nếu máy báo không tìm thấy lệnh, hãy xem phần hướng dẫn trên opencode.ai/docs.
  • Với bản desktop, mở ứng dụng lên; nếu cửa sổ hiện ra là bạn đã cài thành công.

Khi giao diện đã mở, bạn thử nhấn Tab. Theo README, phím này đổi giữa hai agent build và plan. Thấy nó chuyển được là bạn đang dùng đúng.

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

Các tình huống dưới đây bám vào những khả năng có trong README: agent build, agent plan và subagent general. Câu lệnh mẫu là gợi ý của mình để bạn bắt chước.

A.Làm quen với một dự án lạ bằng chế độ plan

Bối cảnh: bạn vừa nhận một dự án từ đồng nghiệp đã nghỉ việc, code nhiều thư mục, không có tài liệu. Bạn sợ lỡ tay làm hỏng.

Cách làm: mở terminal trong thư mục dự án, khởi chạy opencode, nhấn Tab để sang agent plan (chỉ đọc, từ chối sửa file mặc định). Rồi hỏi:

text
Hãy giải thích cấu trúc dự án này: thư mục nào làm gì, chương trình bắt đầu chạy từ đâu.

Kết quả: bạn nhận được bản tóm tắt cấu trúc mà không sợ file nào bị sửa. README nói rõ plan hợp cho việc khám phá codebase lạ.

B.Lập kế hoạch trước khi sửa lớn

Bối cảnh: bạn là lập trình viên mới và được giao thêm một tính năng nhỏ, ví dụ thêm trường «số điện thoại» vào form đăng ký. Bạn chưa chắc phải sửa ở những file nào.

Cách làm: ở chế độ plan, nhờ nó đề xuất:

text
Mình muốn thêm trường số điện thoại vào form đăng ký. Liệt kê những file cần sửa và thứ tự làm, chưa sửa gì cả.

Nếu nó xin chạy lệnh bash, đọc kỹ lệnh rồi mới đồng ý, vì README nói plan sẽ hỏi quyền trước. Khi kế hoạch hợp lý, nhấn Tab sang build và nhờ nó làm theo.

Cho AI đọc trước, sửa sau: hai chế độ plan và build chính là chiếc phanh tay bạn cần khi giao code cho máy.

Ông T

C.Giao việc tìm kiếm nhiều bước cho subagent

Bối cảnh: bạn cần biết một hàm tính phí vận chuyển được gọi ở những đâu trong dự án, và cái nào trong số đó đang dùng công thức cũ.

Cách làm: gõ @general trong tin nhắn để gọi subagent chuyên cho tìm kiếm phức tạp và việc nhiều bước:

text
@general Tìm mọi chỗ dự án tính phí vận chuyển và cho mình biết chỗ nào đang dùng công thức khác nhau.

Kết quả: bạn nhận lại danh sách các vị trí liên quan để tự rà lại, thay vì phải tự tìm từng file.

D.Chọn bản desktop cho người ít dùng terminal

Bối cảnh: bạn là chủ shop nhỏ, có thuê một bạn làm website bán hàng và muốn tự hiểu bên trong mà không muốn gõ lệnh.

Cách làm: tải bản desktop từ opencode.ai/download, mở thư mục dự án của website, dùng chế độ plan để hỏi các câu như «trang thanh toán đang nhận những thông tin gì của khách?».

Kết quả: bạn nắm được dự án đang làm gì trước khi trao đổi lại với người làm web. Nhớ rằng đây là bản beta, và nên dùng plan để tránh thay đổi ngoài ý muốn.

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

A.Gõ lệnh báo «không tìm thấy lệnh» sau khi cài

Thường do terminal cũ chưa nhận đường dẫn mới. Đóng hẳn terminal rồi mở lại. Nếu bạn cài bằng script một dòng, chương trình nằm ở $HOME/.opencode/bin; kiểm tra thư mục này có file hay không và xem nó đã nằm trong biến PATH của bạn chưa.

B.npm báo không tìm thấy gói

README dùng tên @opencode/cli, còn thông tin repo ghi tên gói opencode. Hãy chép đúng dòng lệnh trong README, kiểm tra chính tả và dấu @. Nếu vẫn lỗi, đối chiếu lại trang tài liệu cài đặt trên opencode.ai.

C.Cài chồng nhiều bản, chạy ra bản cũ

README dặn gỡ phiên bản cũ hơn 0.1.x trước khi cài. Ngoài ra đừng cài đồng thời hai công thức Homebrew (opencode-v2 và opencode). Chọn một, gỡ cái còn lại nếu đã lỡ cài.

D.Chạy script curl trên Windows không được

Lệnh curl ... | bash cần bash. PowerShell mặc định không chạy kiểu này. Hãy dùng cách npm, mise hoặc tải file .exe của bản desktop.

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

Đây là rủi ro chung của agent ở chế độ build. Hãy tập thói quen: khám phá và lên kế hoạch ở chế độ plan, chỉ sang build khi đã rõ việc, và làm trên dự án đã có Git để 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 (hiện có khoảng 226.506 sao) và vẫn được cập nhật.
  • Có nhiều cách cài cho nhiều hệ điều hành, kể cả bản desktop cho người ngại terminal.
  • Tách hai chế độ build và plan là cách thiết kế dễ hiểu, giúp bạn giữ quyền kiểm soát.

Giới hạn

  • README rất 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 đọc thêm tài liệu chính thức.
  • Một số lệnh cài trong README không thống nhất về tên gói, nên người mới có thể bối rối.
  • Bản desktop còn là beta.
  • Như mọi AI agent, kết quả cần được con người đọc lại trước khi dùng thật.

Khi nào chọn cách khác: nếu bạn chỉ cần hỏi đáp chung chung về lập trình, một ứng dụng chat AI thông thường là đủ. Nếu bạn cần cam kết rõ về chi phí hay quyền riêng tư dữ liệu, hãy đọc kỹ tài liệu và điều khoản của dịch vụ AI mà bạn kết nối, vì tư liệu repo chưa nói về việc này.

4.2/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. Tuy nhiên README không nói gì về chi phí của mô hình AI mà bạn kết nối. Phần đó chưa có thông tin, bạn xem tài liệu tại opencode.ai/docs.

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

Có đường cài cho Windows: bản desktop `opencode-desktop-win-x64.exe` (đang beta), hoặc cài qua npm, hay mise (được ghi là chạy trên mọi hệ điều hành). Lệnh `curl ... | bash` cần có bash nên không phải lựa chọn mặc định trên PowerShell.

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, nên mình chưa có thông tin chính xác. Bạn nên xem tài liệu chính thức nếu định chạy trên máy cấu hình yếu.

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

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

Gọi subagent @general để làm gì?

general là subagent cho các tìm kiếm phức tạp và công việc nhiều bước. README nói 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ữ liệu và code của mình có an toàn không?

README không mô tả chi tiết về xử lý dữ liệu hay quyền riêng tư. Repo có file SECURITY.md, bạn nên đọc, đồng thời kiểm tra điều khoản của dịch vụ AI mà bạn kết nối. Đừng đưa thông tin nhạy cảm như key hay mật khẩu vào cuộc trò chuyện.

Cài xong rồi, cấu hình tiếp ở đâu?

README trỏ tới trang tài liệu tại opencode.ai/docs cho mọi cấu hình, trong đó có phần về agent. Ngoài ra bạn có thể hỏi cộng đồng qua Discord hoặc X.com của dự án.

Chuyển nhanh tới mục

  1. I.opencode làm được gì
    1. A.Hai agent có sẵn: build và plan
    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ở, có tài liệu riêng
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Mở terminal và gỡ bản cũ
    2. B.Cách 1: script cài một dòng (macOS, Linux)
    3. C.Cách 2: cài bằng npm, bun, pnpm hoặc yarn
    4. D.Cách 3: Homebrew (macOS và Linux)
    5. E.Cách 4: các trình quản lý khác
    6. F.Cách 5: bản ứng dụng desktop (BETA)
    7. G.Tải mã nguồn về (nếu bạn muốn tự xem)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Làm quen với một dự án lạ bằng chế độ plan
    2. B.Lập kế hoạch trước khi sửa lớn
    3. C.Giao việc tìm kiếm nhiều bước cho subagent
    4. D.Chọn bản desktop cho người ít dùng terminal
  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 lệnh» sau khi cài
    2. B.npm báo không tìm thấy gói
    3. C.Cài chồng nhiều bản, chạy ra bản cũ
    4. D.Chạy script curl trên Windows không được
    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ỏ.