Bắt đầu với OpenCode
OpenCode là công cụ AI mã nguồn mở hỗ trợ lập trình qua terminal, ứng dụng desktop hoặc tiện ích IDE. Công cụ có thể đọc và sửa dự án; hãy dùng trên bản sao/Git branch, xem mọi thay đổi và không giao quyền vượt quá nhu cầu.
1. Cài đặt theo tài liệu chính thức
Trên Windows, tài liệu OpenCode khuyến nghị WSL để có tương thích tốt hơn. Có thể xem các phương thức cài mới nhất tại trang chính thức trước khi chạy lệnh. Với môi trường có Node.js, tài liệu hiện liệt kê:
Không chạy lệnh tải/cài từ nguồn không xác minh. Với máy trường, hỏi giáo viên hoặc quản trị viên trước khi cài.
2. Kết nối nhà cung cấp và mở dự án
opencode
/connect
Làm theo hướng dẫn trong ứng dụng để chọn nhà cung cấp mô hình. API key là bí mật: không gửi vào chat, không chụp màn hình công khai, không commit vào Git và không dán vào file website.
3. Khởi tạo ngữ cảnh dự án
Theo tài liệu OpenCode, lệnh này phân tích dự án và tạo tệp AGENTS.md để ghi hướng dẫn/ngữ cảnh cho tác nhân. Hãy đọc lại nội dung, loại bỏ thông tin nhạy cảm, chỉnh cho đúng dự án rồi mới lưu/commit.
4. Quy trình làm việc khuyến nghị
- Đảm bảo dự án có Git; tạo nhánh mới hoặc bản sao lưu.
- Yêu cầu công cụ giải thích cấu trúc dự án trước khi sửa.
- Dùng Plan mode để yêu cầu kế hoạch và xem lại phạm vi.
- Chuyển sang Build mode (phím Tab theo tài liệu hiện hành) chỉ sau khi đồng ý kế hoạch.
- Yêu cầu thay đổi nhỏ, nêu file/phạm vi, tiêu chí hoàn tất và kiểm thử.
- Xem diff từng file; chạy test/lint/build phù hợp; tự kiểm tra website.
- Nếu có hành động lạ, dừng, hoàn tác bằng Git và hỏi người có kinh nghiệm.
Prompt mẫu cho OpenCode
“Hãy triển khai bước [số] đã thống nhất. Không sửa file ngoài phạm vi __. Không thêm thư viện mới nếu chưa hỏi. Sau đó chạy [test/lệnh], báo kết quả thật, nêu file đã đổi và việc còn chưa làm. Đừng tuyên bố test thành công nếu chưa chạy.”
Tài liệu gốc: giao diện, lệnh và cách cài có thể thay đổi theo phiên bản. Hãy dùng docs chính thức và không sao chép lệnh từ hướng dẫn không rõ nguồn.
