Trải nghiệm khi dùng OpenCode
Bạn cài OpenCode bằng một lệnh hoặc tải bản desktop, rồi mở Terminal trong thư mục dự án và chạy opencode. Một giao diện văn bản hiện ra ngay trong cửa sổ Terminal, bạn gõ yêu cầu bằng lời, ví dụ giải thích cấu trúc dự án này hoặc thêm trang liên hệ, và agent đọc file, đề xuất thay đổi rồi thực hiện.
Bấm phím Tab để chuyển giữa hai agent có sẵn. Agent plan chỉ đọc và phân tích, mặc định từ chối sửa file và hỏi trước khi chạy lệnh, rất hợp để khám phá một dự án lạ hoặc lên kế hoạch. Agent build có toàn quyền để thực sự làm việc. Ngoài ra có subagent general xử lý tìm kiếm phức tạp, gọi bằng @general.
Phần mô hình AI bạn tự chọn và cấu hình theo tài liệu tại opencode.ai/docs, nên chi phí và chất lượng phụ thuộc nhà cung cấp bạn nối vào. Đây là lựa chọn mã nguồn mở thay cho các công cụ cùng loại như Claude Code hay Codex.
Tính năng nổi bật
Giao diện Terminal gọn
Chat và xem thay đổi ngay trong cửa sổ Terminal, không phải rời khỏi nơi bạn đang làm việc.
Hai agent build và plan
Chuyển nhanh bằng phím Tab: build để làm thật, plan để chỉ đọc, phân tích và lên kế hoạch an toàn.
Subagent general
Một agent phụ xử lý các tìm kiếm và công việc nhiều bước, gọi bằng @general trong tin nhắn.
Có bản ứng dụng desktop (beta)
Tải file cài cho macOS, Windows hoặc Linux ở trang opencode.ai/download nếu bạn không thích dùng Terminal.
Nhiều cách cài
Script cài một dòng, npm, Homebrew, pacman, mise, nix, tuỳ hệ điều hành và thói quen của bạn.
Mã nguồn mở, cấu hình được
Có tài liệu cấu hình agent và tuỳ biến tại trang docs, giấy phép MIT.
Tận dụng OpenCode vào việc gì?
Lập trình viên mới vào team
Tìm hiểu một dự án mới nhận
Dùng agent plan để hỏi cấu trúc, luồng chạy và chỗ cần sửa mà không sợ AI chỉnh nhầm file.
Người làm web, freelancer
Thêm tính năng nhỏ vào website
Mô tả bằng lời rồi để agent build sửa file, bạn xem diff trước khi giữ lại.
Người thích tự chọn nhà cung cấp
Thử nhiều mô hình AI khác nhau
Công cụ mở nên bạn có thể đổi nơi lấy mô hình theo giá hoặc chất lượng thay vì bị gắn với một hãng.
Sinh viên
Học viết code với trợ lý
Nhờ agent giải thích đoạn code và gợi ý cải tiến ngay trên bài tập của mình.
Cần chuẩn bị gì?
- Windows, macOS hoặc Linux; Windows có bản desktop dạng file .exe.
- Một tài khoản hoặc khoá API của nhà cung cấp mô hình AI mà bạn định dùng (cấu hình theo opencode.ai/docs).
- Terminal; nếu cài bằng npm thì cần Node.js.
- Một thư mục dự án để làm việc.
Hướng dẫn cài đặt chi tiết
Cài trên Windows
Cách dễ nhất cho người thường: vào opencode.ai/download và tải bản desktop dạng .exe cho Windows (README ghi đây là bản beta), rồi bấm đúp để cài.
https://opencode.ai/downloadCách nhanh hơn: mở PowerShell và cài bằng winget (trình quản lý ứng dụng có sẵn trên Windows 10/11).
winget install --id Anomaly.OpenCode.Desktop -eNếu đã có Node.js, bạn có thể cài bản dòng lệnh bằng npm theo đúng lệnh trong README. Bạn nên đối chiếu lại README hiện tại vì tên gói có thể thay đổi.
npm i -g @opencode/cli@latestREADME cũng nhắc nên gỡ các phiên bản cũ hơn 0.1.x trước khi cài.
Cài trên macOS / Linux
Chạy script cài một dòng của dự án. Nó cài OpenCode vào thư mục .opencode/bin trong thư mục home của bạn.
curl -fsSL https://opencode.ai/v2/install | bashHoặc dùng Homebrew; README ghi bản từ tap anomalyco luôn mới nhất, còn bản formula chính thức cập nhật chậm hơn.
brew install anomalyco/tap/opencode-v2Người dùng Arch Linux có gói trong pacman và AUR; macOS cũng có bản desktop qua Homebrew cask.
brew install --cask opencode-desktop
Dùng thử lần đầu
Mở Terminal, đi vào thư mục dự án (hoặc một thư mục thử) rồi chạy opencode.
cd duong-dan-du-an opencodeLàm theo hướng dẫn trên màn hình để nối với nhà cung cấp mô hình AI của bạn; chi tiết xem tại opencode.ai/docs.
Bấm Tab để chọn agent plan, rồi hỏi: dự án này làm gì và các file chính nằm ở đâu.
Bấm Tab quay lại agent build và nhờ một việc nhỏ như thêm một dòng giới thiệu vào README, rồi xem thay đổi trước khi chấp nhận.
Mẹo dùng hay
- Dùng agent plan khi mới mở một dự án lạ: nó mặc định không sửa file và hỏi trước khi chạy lệnh.
- Luôn làm việc trong một nhánh Git riêng để dễ hoàn tác nếu AI sửa chưa vừa ý.
- Tên gói và lệnh cài của dự án có thể đổi theo thời gian, nên kiểm tra README mới nhất trước khi cài.
- Gọi @general khi cần tìm kiếm rộng trong nhiều file.
Lưu ý và hạn chế
- Dự án dùng tên opencode nên có nhiều dự án khác nhau mang tên tương tự; README nhắc rõ các dự án như opencode-dashboard không phải do nhóm này làm.
- Bản desktop vẫn ở giai đoạn beta, có thể còn lỗi.
- Chi phí phát sinh nằm ở nhà cung cấp mô hình bạn nối vào; agent có quyền chạy lệnh nên hãy xem kỹ trước khi cho phép.
Câu hỏi thường gặp
OpenCode có miễn phí không?
Phần mềm mã nguồn mở theo giấy phép MIT. Bạn thường vẫn phải trả tiền cho API của nhà cung cấp mô hình nếu dùng mô hình trả phí.
Có chạy được trên Windows không?
Có. README liệt kê bản desktop dạng .exe cho Windows; bản dòng lệnh cài qua npm hoặc các cách khác.
Khác gì Claude Code hay Codex?
Đó là sản phẩm của từng hãng gắn với mô hình của họ. OpenCode là mã nguồn mở và cho bạn nối nhiều nhà cung cấp mô hình, theo tài liệu chính thức.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/anomalyco/opencode.gitRepo tương tự nên xem
Claude Code
anthropics / claude-code
Trợ lý AI viết code của Anthropic chạy trong Terminal, đọc hiểu dự án, sửa file và xử lý Git bằng lời thường
Codex CLI
openai / codex
Trợ lý AI viết code của OpenAI chạy nhẹ trong Terminal, đăng nhập bằng tài khoản ChatGPT hoặc khoá API
Cline
cline / cline
Trợ lý AI viết code mã nguồn mở trong VS Code, JetBrains, Terminal và app desktop, dùng được nhiều mô hình