OpenCode là AI coding agent mã nguồn mở chạy trong terminal, IDE hoặc desktop app. Nó có thể đọc codebase, chạy lệnh, sửa file, và tương tác với bạn qua chat — tất cả ngay trong cửa sổ terminal quen thuộc.
Bài viết này hướng dẫn từ cài đặt đến sử dụng thành thạo.
Cài Đặt#
macOS / Linux#
curl -fsSL https://opencode.ai/install | bashnpm (mọi nền tảng)#
npm install -g opencode-aiWindows#
Khuyến nghị dùng WSL. Ngoài ra có thể cài qua:
choco install opencode # Chocolatey
scoop install opencode # Scoop
npm install -g opencode-aiHomebrew (macOS/Linux)#
brew install anomalyco/tap/opencodeSau khi cài, chạy opencode --version để kiểm tra.
Kết Nối LLM Provider#
Lần đầu chạy, OpenCode cần một provider để xử lý ngôn ngữ. Có ba cách:
Cách 1: OpenCode Zen (dễ nhất)#
Trong TUI, gõ /connect, chọn opencode, truy cập opencode.ai/auth ↗, đăng ký và copy API key về dán vào terminal.
Cách 2: Dùng API key có sẵn#
/connect
Chọn provider như OpenAI, Anthropic, Google Gemini, hoặc GitHub Copilot — rồi nhập API key.
Cách 3: Config file#
Tạo hoặc sửa file ~/.config/opencode/config.jsonc:
{
"provider": "anthropic",
"apiKey": "sk-ant-..."
}Khởi Tạo Dự Án#
cd /path/to/du-an
opencodeSau khi vào giao diện chat, gõ: /init
OpenCode sẽ phân tích dự án và tạo file AGENTS.md — file này chứa hướng dẫn về cấu trúc, coding style, conventions của dự án. Nên commit file này vào git.
Giao Diện TUI (Terminal UI)#
Khi chạy opencode, bạn sẽ thấy:
- Vùng chat — tương tác với AI
- Thanh input — gõ prompt ở dưới cùng
- Indicator góc phải dưới — hiển thị Plan mode hay Build mode
Plan mode vs Build mode#
| Mode | Tab | AI làm gì |
|---|---|---|
| Plan | Tab lần 1 | Chỉ đề xuất, không chạm vào code |
| Build | Tab lần 2 | Đọc, sửa, tạo file thực tế |
Luôn dùng Plan mode trước khi cho AI sửa code phức tạp — kiểm tra kế hoạch rồi mới chuyển sang Build.
Các Lệnh Cơ Bản#
| Lệnh | Mô tả |
|---|---|
/init | Phân tích dự án, tạo AGENTS.md |
/connect | Kết nối LLM provider |
/undo | Hoàn tác thay đổi cuối |
/redo | Làm lại thay đổi đã undo |
/share | Tạo link chia sẻ session |
/clear | Xoá lịch sử chat |
Ctrl+C | Thoát |
Cách Đặt Câu Hỏi Hiệu Quả#
1. Dùng @ để tham chiếu file#
@src/utils/auth.ts có vấn đề gì không?
Gõ @ rồi tìm tên file — OpenCode sẽ đọc file đó và thêm vào context.
2. Hỏi về codebase#
- Giải thích flow đăng nhập trong dự án này.
- Hệ thống routing hoạt động thế nào?
3. Yêu cầu thay đổi#
- Thêm validate email vào form đăng ký ở @src/components/Signup.tsx.
- Dùng zod schema, trả về lỗi dễ đọc.
- Chạy test sau khi xong.
4. Plan trước khi build#
Bấm Tab để chuyển sang Plan mode:
- Thêm tính năng quên mật khẩu:
- Gửi email reset link
- Token hết hạn sau 1 giờ
- UI reset password
Xem kế hoạch, góp ý, rồi bấm Tab lần nữa để AI bắt đầu làm.
Undo/Redo — An Toàn Khi Dùng AI#
OpenCode ghi lại từng thay đổi. Sai thì /undo:
/undo# hoàn tác thay đổi cuối/undo# gọi tiếp để undo thêm/redo# làm lại nếu undo nhầm
Chia Sẻ Session#
/share
Tạo link có thể gửi cho đồng nghiệp — họ sẽ thấy toàn bộ hội thoại và thay đổi. Link mẫu: https://opencode.ai/s/4XP1fce5
Tuỳ Biến OpenCode#
Theme#
Chọn theme trong file config hoặc qua lệnh: /theme
Xem thêm: Themes
Config#
File ~/.config/opencode/config.jsonc cho phép tuỳ chỉnh sâu:
- Keybind
- Model mặc định
- Formatter
- Permission rules
Rules (file AGENTS.md)#
File AGENTS.md trong project hướng dẫn AI về:
- Coding conventions
- Stack và framework
- Kiến trúc dự án
- Những điều cần tránh
Thực Hành: Một Phiên Làm Việc Mẫu#
# 1. Mở terminal, vào project
cd ~/projects/my-app
# 2. Mở OpenCode
opencode
# 3. Init (lần đầu)
/init
# 4. Hỏi về codebase
@src/routes/index.ts có chức năng gì?
# 5. Plan tính năng mới (Tab -> Plan)
Thêm phân trang cho danh sách user. Mỗi trang 20 items.
Dùng offset-based pagination.
# 6. Duyệt kế hoạch, chuyển Build (Tab)
OK, làm đi.
# 7. Kiểm tra kết quả
/undo # nếu chưa ưng, sửa prompt rồi làm lại
# 8. Chia sẻ nếu cần
/shareLưu Ý Khi Dùng OpenCode#
- Commit trước khi dùng AI — phòng trường hợp cần revert
- Review code AI tạo — AI có thể tạo code chạy được nhưng chưa tối ưu
- Càng cụ thể càng tốt — “Sửa lỗi” khác xa “Thêm null check ở dòng 42”
- Dùng Plan mode cho task lớn — tránh mất công sửa đi sửa lại
- Kéo thả ảnh vào terminal để AI phân tích UI mockup
Tổng Kết#
OpenCode là công cụ mạnh mẽ nếu bạn biết cách dùng:
- Cài đặt — 1 câu lệnh, 30 giây
- Kết nối — provider tuỳ chọn
- Init — để AI hiểu dự án
- Prompt rõ ràng — tận dụng
@file, Plan/Build mode - Undo khi cần — an toàn, không sợ hỏng
Càng dùng nhiều, bạn càng hiểu cách nói chuyện với AI để đạt kết quả mong muốn. Bắt đầu ngay hôm nay:
curl -fsSL https://opencode.ai/install | bash