HƯỚNG DẪN TỪ A ĐẾN Z

Cài ChatCode, cho AI một thư mục để làm việc, rồi bắt đầu chat.

Không cần biết MCP, tunnel hay kiến trúc phía sau. Chỉ cần hiểu một điều: ChatCode cho AI làm việc với những thư mục bạn chủ động thêm vào và chỉ trong phạm vi quyền bạn cấp.

“Project” không bắt buộc là dự án code. Trong ChatCode, Project đơn giản là một thư mục làm việc. Nó có thể là source code, thư mục Markdown/CSV/JSON, kho text, dữ liệu nghiên cứu hoặc một thư mục trống để AI ghi kết quả.

Project = thư mục bạn cho AI quyền làm việc.

ChatCode cần biết ranh giới nào trên máy tính được phép đọc hoặc thay đổi.

📁 Source code

Website, app, plugin, repository Git. Project Brain hiểu file, symbol và quan hệ để AI tìm đúng context.

📚 Kho dữ liệu text

Markdown, TXT, CSV, JSON, config và các file UTF‑8 khác có thể dùng làm nguồn để AI tìm, đọc và tổng hợp.

📝 Thư mục Output

Một thư mục riêng có quyền ghi để AI tạo báo cáo, code, tài liệu hoặc kết quả mà không chạm vào nguồn.

Workflow an toàn cho người mới: thêm D:\Company-Data với quyền chỉ đọc và D:\AI-Output với quyền ghi. Trong chat, yêu cầu AI đọc nguồn thứ nhất và lưu kết quả vào thư mục thứ hai.

Giới hạn hiện tại: công cụ đọc file cục bộ mạnh nhất với file text/code UTF‑8. File binary như PDF, DOCX, XLSX không nên xem là “đọc trực tiếp” trừ khi ChatCode có capability chuyên dụng hoặc bạn chuyển nội dung sang định dạng text phù hợp.

Cài và mở ChatCode.

Free có thể bắt đầu ngay; license chỉ cần khi bạn sử dụng quyền lợi trả phí.

1. Vào trang Tải về.

Mở Tải ChatCode và tải bộ cài Windows chính thức.

2. Chọn ngôn ngữ.

Ngay khi mở bộ cài, chọn English hoặc Tiếng Việt. Lựa chọn này được dùng tiếp trong quá trình cài và trong ứng dụng.

3. Xác nhận cài đặt.

Đọc phần tóm tắt điều khoản, tick đồng ý rồi bấm Cài / Sửa chữa. Nếu máy đã có ChatCode, bộ cài sẽ xử lý theo luồng cập nhật/sửa chữa thay vì tạo một bản cài chồng chéo.

4. Chờ tải gói phát hành an toàn.

ChatCode tải bản phát hành từ máy chủ và kiểm tra kích thước, SHA‑256 và chữ ký phát hành trước khi thực thi.

5. Mở ChatCode.

Sau khi hoàn tất, ứng dụng có thể được khởi động ngay. Vào trang Làm việc và kiểm tra trạng thái ChatCode đang chạy.

6. Free thì bỏ qua License.

Nếu đã mua key: License → Nhập license key → Kích hoạt.

Các màn hình thật của bộ cài ChatCode: chọn ngôn ngữ, xác nhận điều khoản và tải gói phát hành an toàn — Giao diện bộ cài hiện tại. Hình được cắt gọn từ chính các bước cài đặt thực tế để bạn có thể đối chiếu trực tiếp.

Thêm thư mục làm việc.

Bạn có thể thêm một thư mục nhỏ, một cây thư mục lớn, thậm chí cả ổ đĩa — nhưng nên chọn phạm vi hợp lý.

1. Bấm “+ Thêm project”.

Ở trang Làm việc hoặc menu Projects.

2. Chọn thư mục.

Ví dụ D:\Work\shop, D:\Research hoặc D:\.

3. Bấm “Chọn thư mục”.

ChatCode lưu ranh giới thư mục và mặc định tạo project với các quyền ghi đều tắt.

4. Nếu add cả ổ đĩa.

Nên giữ chỉ đọc. Ổ rất lớn có thể làm việc lập chỉ mục/search nặng và nhiều file không liên quan. Tốt hơn là chia theo mục đích.

ChatCode vẫn tự chặn các vùng nhạy cảm phổ biến như .env, .ssh, private key, credential; đồng thời bỏ qua nhiều thư mục build/cache như node_modules, target, dist.

Giao diện Projects, hộp chọn thư mục và khu vực cấp quyền AI của ChatCode — Giao diện thực tế: vào Projects, chọn đúng thư mục gốc rồi kiểm tra quyền AI của project ở panel bên phải.

Quyền của từng thư mục là độc lập.

Đây là điểm quan trọng để dùng ChatCode cho dữ liệu thật mà vẫn kiểm soát rủi ro.

Chỉ muốn AI đọc?

Không bật quyền ghi. AI có thể list/search/read trong project nhưng không được sửa file.

Muốn sửa file hiện có?

Bật Sửa file.

Muốn tạo/xóa/đổi tên?

Bật thêm Tạo / xóa / đổi tên.

Muốn build/test dự án?

Bật Chạy task. Các task vẫn nằm trong allow-list của ChatCode.

Muốn stage/commit Git cục bộ?

Bật Ghi Git cục bộ. ChatCode không tự push chỉ vì quyền này được bật.

Panel chi tiết project và các quyền AI thực tế trong ChatCode — Chọn project để mở phần Chi tiết project. Chỉ bật quyền cần dùng; khi muốn AI sửa và chạy project, xác nhận bằng nút Cho phép AI sửa & chạy project.

Dùng ChatCode đọc project Company-Data. Tổng hợp các file CSV tháng 7 và tạo report-july.md trong project AI-Output. Không sửa bất kỳ file nào trong Company-Data.

Kết nối nền tảng AI.

Với ChatGPT, bạn chỉ cần sao chép link kết nối trong ChatCode, thêm nó vào một lần rồi quay lại cuộc chat để giao việc tự nhiên.

1. Copy link trong ChatCode.

Vào Làm việc → Kết nối AI Chat, chọn ChatGPT rồi bấm Copy link kết nối. Link đầy đủ có mã bảo mật được ẩn trên màn hình và chỉ được đưa vào clipboard khi bạn bấm nút này.

2. Mở Cài đặt của ChatGPT.

Nhấn ảnh đại diện/tên tài khoản ở góc trái dưới → Cài đặt.

3. Mở Plugin.

Trong cửa sổ Cài đặt, chọn Plugin → Duyệt plugin.

4. Thêm plugin riêng.

Ở trang Plugin, bấm dấu + ở bên phải để mở cửa sổ Plugin mới.

5. Tạo ChatCode.

Nhập tên ChatCode, dán nguyên link vừa copy vào phần URL máy chủ. Nếu bạn chưa dùng xác thực nâng cao, giữ lựa chọn xác thực mặc định. Tick Tôi hiểu và muốn tiếp tục rồi bấm Tạo.

Xong. Từ đây bạn có thể quay lại cuộc chat và yêu cầu ChatGPT đọc, kiểm tra hoặc làm việc với project đã cấp quyền trong ChatCode.

Các bước thực tế để copy link từ ChatCode và thêm ChatCode trong phần Plugin của ChatGPT — Luồng giao diện hiện tại: ChatCode → Cài đặt ChatGPT → Plugin → Duyệt plugin → + → Plugin mới → Tạo.

Nền tảng	Cách thêm	Lưu ý hiện tại
ChatGPT	Cài đặt → Plugin → Duyệt plugin → + → Plugin mới → dán URL máy chủ → Tạo.	Tên mục và vị trí có thể thay đổi theo phiên bản giao diện, plan và workspace. Nếu không thấy Plugin, xem bảng tương thích bên dưới.
Claude	Settings → Connectors → Add custom connector → dán Remote MCP URL → Add.	Khả năng thêm custom connector phụ thuộc plan và chính sách hiện tại của Claude.
Mistral / Vibe	Intelligence → Connectors → + Add Connector → Custom Connector → dán MCP server URL.	Quyền quản lý connector phụ thuộc loại tài khoản/workspace.
Grok	grok.com/connectors → New Connector → Custom → dán MCP server URL.	Custom MCP cần endpoint public. ChatCode hiện dùng direct tunnel cho Grok nên URL có thể đổi sau restart.

Cách copy đúng link: ChatCode → Làm việc → Kết nối AI Chat → chọn đúng nền tảng → Copy link kết nối. Không tự sửa URL và không chia sẻ link ra ngoài.

Giao diện và quyền theo plan thay đổi nhanh. Nếu bạn không thấy đúng tên mục như ảnh, đừng đoán đường dẫn. Xem Bảng tương thích AI của ChatCode để kiểm tra trạng thái và hướng dẫn hiện tại.

Chat đầu tiên: bắt đầu thật đơn giản.

Sau khi kết nối xong, bạn không cần dùng câu lệnh kỹ thuật. Hãy nói việc cần làm theo cách tự nhiên, nhưng ở lần đầu nên yêu cầu AI kiểm tra trước khi sửa.

Dùng ChatCode liệt kê các project đang có. Không sửa file.Giải thích cho tôi về project ChatCode. Chưa sửa file, chưa chạy lệnh.Kiểm tra vì sao project này đang lỗi, cho tôi biết nguyên nhân trước. Chưa thay đổi gì.

Kết nối đúng khi: AI tự gọi ChatCode, trả đúng tên project/file trên máy và bạn không phải upload từng file vào cuộc chat. Khi đã xác nhận đúng project, bạn có thể tiếp tục bằng yêu cầu tự nhiên như “sửa lỗi này, test lại rồi build”.

ChatCode có thể biến cuộc chat thành công việc thật.

Khả năng thực tế phụ thuộc quyền project và capability bạn bật.

Đọc & tìm

List file, đọc nhiều file, tìm text, symbol, references và dựng context từ toàn project.

Hiểu codebase

Project Brain dựng graph symbol/import/reference để AI không phải đoán file liên quan.

Sửa & tạo file

Patch, tạo, đổi tên hoặc xóa file trong đúng project nếu bạn cấp quyền.

Build / test / lint

Chạy task an toàn và dùng kết quả để tiếp tục debug, sửa rồi kiểm tra lại.

Git & GitHub

Đọc trạng thái Git, stage/commit theo quyền; liên kết GitHub và hỗ trợ private repository theo workflow của ChatCode.

Remote / Deploy

Gắn SFTP/FTPS/FTP theo project; SSH command là quyền riêng và có cảnh báo rủi ro.

Code từ điện thoại

Khi máy giữ project đang online và connector hoạt động, bạn có thể nói chuyện với AI từ thiết bị khác để làm việc trên máy đó.

Nhiều project độc lập

Mỗi project có path, Brain, quyền, Git và server binding riêng; AI có thể chọn đúng project theo tên.

Kho dữ liệu làm việc

Dùng thư mục chỉ đọc làm nguồn và thư mục ghi làm output để tạo báo cáo/nội dung an toàn hơn.

Đừng chỉ đọc tính năng. Xem ChatCode dùng vào việc gì.

Các bài dưới đây có cấu hình thư mục, quyền và prompt mẫu có thể dùng ngay.

WORKSPACE