A–Z GUIDE

Install ChatCode, give AI a folder to work in, then start chatting.

You do not need to understand MCP, tunnels, or the architecture behind them. Just remember one thing: ChatCode lets AI work with folders you explicitly add, only within the permissions you grant.

“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ả.
1

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

ChatCode needs a clear boundary for what may be read or changed on your computer.

📁 Source code

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

📚 Text data library

Markdown, TXT, CSV, JSON, config, and other UTF‑8 files can be used as sources for AI to search, read, and summarize.

📝 Output folder

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.

A safe beginner workflow: add D:\Company-Data as read-only and D:\AI-Output as writable. In chat, ask AI to read from the first folder and save results into the second.
Current limitation: local file reading works best with UTF‑8 text/code files. Binary files such as PDF, DOCX, and XLSX should not be treated as directly readable unless ChatCode has a dedicated capability or the content is converted to an appropriate text format.
2

Install and open ChatCode.

You can start with Free immediately; a license is only needed for paid entitlements.

1. Open the Downloads page.

Mở Download 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.

If you purchased a 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.
3

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.

For example 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 add cả ổ đĩa.

Keep it read-only. Very large drives can make indexing/search heavier and introduce unrelated files. Splitting by purpose is usually better.

ChatCode still blocks common sensitive areas such as .env, .ssh, private keys, and credentials; it also skips many build/cache folders such as 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, add workspace, chọn đúng thư mục gốc rồi kiểm tra quyền AI của workspace.
4

Quyền của từng Workspace là độc lập.

This is key to using ChatCode with real data while keeping risk under control.

Only want AI to read?

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

Want to edit existing files?

Enable Sửa file.

Want to create/delete/rename?

Also enable Tạo / xóa / đổi tên.

Want to build/test the project?

Enable Chạy task. Tasks still remain within ChatCode's allow-list.

Want to stage/commit Git locally?

Enable Ghi Git cục bộ. ChatCode does not push automatically just because this permission is enabled.

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

Connect your AI platform.

Với ChatGPT, bạn chỉ cần sao chép link kết nối trong ChatCode, add 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. Enable 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 add 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 + để add 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 add custom plugin/app.
Các bước thực tế để copy link từ ChatCode và add 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.
PlatformHow to addCurrent note
ChatGPTCà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.
ClaudeSettings → Connectors → Add custom connector → dán Remote MCP URL → Add.Khả năng add custom connector phụ thuộc plan và chính sách hiện tại của Claude.
Mistral / VibeIntelligence → 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.
Grokgrok.com/connectors → New Connector → Custom → dán MCP server URL.Custom MCP requires a public endpoint. ChatCode currently uses a direct tunnel for Grok, so the URL may change after 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.
Interfaces and plan entitlements change quickly. Nếu bạn không thấy đúng tên mục such as ảnh, đừng đoán đường dẫn. Xem ChatCode AI compatibility matrix để kiểm tra trạng thái và hướng dẫn hiện tại.
6

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ì.
The connection is working when: 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 such as “sửa lỗi này, test lại rồi build”.
7

ChatCode can turn a chat into real work.

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

Read & search

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

Understand codebases

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

Edit & create files

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.

Work from your phone

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.

Working data library

Dùng thư mục read-only 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.

8

Do not just read features. See what ChatCode is useful for.

The articles below include folder setups, permissions, and prompts you can use immediately.

View all use cases → · Open prompt library → · Find help →