ChatCode không mở / không chạy
Khởi động lại app → kiểm tra Windows có chặn/cách ly file không → xác nhận bạn dùng bản Windows được hỗ trợ → tải lại từ trang chính thức nếu file không toàn vẹn.
TROUBLESHOOTING
Đừng sửa ngẫu nhiên. Chọn đúng triệu chứng trước.
Kiểm tra từ lớp đơn giản nhất: app → project → quyền → kết nối AI → mạng/remote → tài khoản/license. Làm theo thứ tự giúp tránh đổi cấu hình không cần thiết.
⌕
AI không thấy project
Mở ChatCode → xác nhận project còn trong danh sách → kiểm tra path thư mục vẫn tồn tại → dùng prompt “liệt kê project, không sửa file” trước.
AI đọc được nhưng không sửa được
Đây thường là quyền, không phải lỗi kết nối. Kiểm tra project có bật Sửa file; tạo/xóa/đổi tên và chạy task là các quyền riêng.
Connector báo offline / unavailable
Kiểm tra máy giữ project còn bật → ChatCode đang chạy → có Internet → link connector còn đúng. Với URL động, restart có thể làm link thay đổi.
URL đổi sau khi restart
Nếu gói/AI đang dùng URL động, copy link mới từ ChatCode rồi cập nhật connector. Không tự ghép token hoặc sửa URL thủ công.
Không thấy nút tạo connector
Đừng giả định là lỗi ChatCode. Quyền custom connector phụ thuộc nhà cung cấp AI, plan, workspace và đôi khi cả web/mobile.
GitHub sai account / sai repo
Kiểm tra account đã liên kết, remote origin và project trước khi stage/commit/push. ChatCode không nên tự đổi origin để “sửa nhanh”.
Remote / deploy không hoạt động
Xác nhận profile server gắn đúng project, host/path đúng và credential còn hiệu lực. Với production, đừng thử lệnh phá hủy để kiểm tra kết nối.
Windows cảnh báo file tải về
Chỉ tiếp tục sau khi xác nhận file đến từ website chính thức và hash khớp release. ZIP chỉ giảm cảnh báo ở bước tải; Windows vẫn có thể kiểm tra file sau giải nén.
License / thiết bị / tài khoản có vấn đề
Đăng nhập trang Tài khoản để kiểm tra license và thiết bị. Không gửi full license key cho hỗ trợ; chỉ gửi mã lỗi và phần key đã che.
Không tìm thấy triệu chứng gần giống. Mở Help Center hoặc liên hệ hỗ trợ.
!
Khi cần gửi yêu cầu hỗ trợ.
Gửi đủ bằng chứng để không phải hỏi đi hỏi lại.
Nên gửi
Phiên bản ChatCode · Windows version · nền tảng AI · bước đang làm · thông báo/mã lỗi · việc bạn kỳ vọng xảy ra.
Không nên gửi
Full license key · connector URL đầy đủ · token · password · private key · file .env hoặc credential.