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.

“Workspace” không bắt buộc là dự án code. Trong ChatCode, Workspace là vùng làm việc gắn với một thư mục gốc trên máy tính. 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ả.

Workspace = vùng làm việc bạn cho AI quyền truy cập.

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. Workspace 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 Workspace.

Mỗi workspace gắn với một thư mục gốc. Bạn có thể chọn 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. Mở Workspaces và bấm “+ Thêm workspace”.

Đây là nơi quản lý các vùng làm việc mà bạn cho ChatCode truy cập.

2. Chọn thư mục gốc cho workspace.

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

3. Đặt tên và xác nhận workspace.

ChatCode lưu thư mục gốc làm ranh giới của workspace. Sau khi lưu, workspace xuất hiện trong danh sách để bạn chọn và làm việc.

4. Kiểm tra quyền trước khi dùng.

Mặc định nên bắt đầu với quyền đọc, sau đó chỉ bật ghi/chạy/Git khi công việc thực sự cần.

5. Nếu thêm 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 Workspaces, hộp chọn thư mục gốc và khu vực cấp quyền AI của ChatCode — Giao diện thực tế: vào Workspaces, thêm workspace, chọn đúng thư mục gốc rồi kiểm tra quyền AI của workspace.

Quyền của từng Workspace 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 workspace 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 workspace và các quyền AI thực tế trong ChatCode — Chọn workspace để mở phần cài đặt và quyền. Chỉ bật quyền cần dùng; khi muốn AI sửa hoặc chạy công việc, hãy cấp đúng quyền cho workspace đó.

Dùng ChatCode đọc workspace Company-Data. Tổng hợp các file CSV tháng 7 và tạo report-july.md trong workspace 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. Bật Chế độ nhà phát triển.

Trong phần cài đặt Apps/Plugin nâng cao của ChatGPT, bật Developer mode / Chế độ nhà phát triển. Đây là bước bắt buộc để giao diện cho phép thêm custom plugin/app.

4. Mở Plugin/Apps và Duyệt.

Quay lại phần quản lý Plugin/Apps rồi mở trang duyệt/quản lý plugin.

5. Bấm dấu +.

Sau khi Developer mode đã bật, dấu + để thêm custom plugin/app mới xuất hiện. Bấm vào đó để mở cửa sổ tạo mới.

6. 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. Quay lại cuộc chat, chọn/bật ChatCode trong Plugin/Apps rồi yêu cầu ChatGPT đọc, kiểm tra hoặc làm việc với workspace đã cấp quyền trong ChatCode.

Không thấy dấu +? Hãy kiểm tra lại Developer mode / Chế độ nhà phát triển đã được bật. Khi chế độ này chưa bật, ChatGPT sẽ không hiện nút thêm custom plugin/app.

Các bước thực tế để copy link từ ChatCode và thêm ChatCode trong phần Plugin của ChatGPT — Luồng đúng: ChatCode → Cài đặt ChatGPT → bật Developer mode → Plugin/Apps → Duyệt → + → custom plugin/app mới → dán URL → Tạo.

Nền tảng	Cách thêm	Lưu ý hiện tại
ChatGPT	Cài đặt → bật Developer mode → Plugin/Apps → Duyệt → + → custom plugin/app → dán URL máy chủ/MCP → 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 workspace đang có. Không sửa file.

Giải thích cho tôi về workspace ChatCode. Chưa sửa file,
    chưa chạy lệnh.

Kiểm tra vì sao workspace 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 workspace/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 workspace, 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 workspace 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 workspace.

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 workspace nếu bạn cấp quyền.

Build / test / lint

Chạy task an toàn trong workspace 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 workspace; 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ữ workspace đ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 Workspace độc lập

Mỗi workspace có thư mục gốc, Brain, quyền, Git và server binding riêng; AI có thể chọn đúng workspace 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