Cài đặt Claude Code

Claude Code là công cụ AI có thể đọc, tạo, và sửa file trực tiếp trên máy tính của bạn. Khác với Claude trên web (phải copy-paste), Claude Code làm việc với file tự động.

1 Truy cập trang tải Claude Code

Mở trình duyệt (Chrome, Edge, Safari) → vào địa chỉ:

https://claude.ai/download
📸
Trang download Claude — hiện 2 nút: Download for Mac / Download for Windows
s1-01-download-page.png
2 Tải về và cài đặt

Mac Bấm "Download for Mac" → file .dmg tải về → mở file → kéo icon Claude vào folder Applications

📸
Mac: Cửa sổ cài đặt — kéo icon Claude vào folder Applications
s1-02-install-mac.png

Windows Bấm "Download for Windows" → file .exe tải về → đúp chuột mở → bấm "Install" → chờ cài xong

📸
Windows: Cửa sổ cài đặt — nút Install, thanh tiến trình
s1-03-install-win.png
3 Mở Claude Code

Mac Mở Launchpad (hoặc Cmd + Space → gõ "Claude") → bấm vào icon Claude Code

Windows Bấm Start Menu → gõ "Claude" → bấm vào Claude Code

📸
Claude Code đã mở — giao diện chính với ô nhập prompt
s1-04-open-claude-code.png

Đăng nhập tài khoản phòng ban

Mỗi phòng ban dùng chung 1 tài khoản Claude Pro. Mọi người trong phòng đăng nhập cùng email và password.

⚠️ Lưu ý quan trọng: Vì dùng chung tài khoản, tất cả conversations của mọi người trong phòng đều nhìn thấy được bởi người khác. KHÔNG nhập thông tin nhạy cảm (lương, CCCD, đánh giá cá nhân).
1 Mở Claude Code lần đầu

Khi mở Claude Code lần đầu, màn hình đăng nhập hiện ra.

📸
Màn hình đăng nhập Claude Code — ô email + password hoặc nút Sign in
s1-06-login-screen.png
2 Nhập thông tin đăng nhập

Nhập email và password tài khoản Claude Pro phòng ban (giảng viên cung cấp).

PhòngEmailPassword
HR[Giảng viên cung cấp][Giảng viên cung cấp]
ACC[Giảng viên cung cấp][Giảng viên cung cấp]
Sales[Giảng viên cung cấp][Giảng viên cung cấp]
MKT[Giảng viên cung cấp][Giảng viên cung cấp]
PQA[Giảng viên cung cấp][Giảng viên cung cấp]
3 Chọn model: Sonnet

Sau khi đăng nhập, chọn model AI. Bấm vào model selector (góc dưới hoặc thanh trên) → chọn Sonnet.

📸
Dropdown chọn model — Sonnet được chọn (highlight)
s1-07-select-model.png
Tại sao chọn Sonnet? Nhanh hơn, tiết kiệm credit hơn. Phù hợp cho hầu hết tác vụ. Chỉ đổi sang Opus khi cần output phức tạp.
4 Chọn thư mục làm việc

Claude Code cần biết bạn làm việc ở thư mục nào để đọc/tạo file.

Bấm "Open Folder" hoặc "Change Directory" → chọn folder SharePoint phòng ban đã sync trên máy.

📸
Desktop App: Cửa sổ chọn folder — folder SharePoint phòng được chọn
s1-08-select-folder.png
5 Kiểm tra Claude Code hoạt động

Gõ vào ô prompt:

Prompt nhập vào Claude Code
Xin chào! Liệt kê các file và folder trong thư mục hiện tại.

→ Claude phải trả lời và liệt kê được các file/folder trong thư mục bạn đã chọn.

📸
Claude Code trả lời "Xin chào" + liệt kê file trong folder
s1-09-hello-test.png

Cài đặt OneDrive + Sync SharePoint

OneDrive giúp đồng bộ folder SharePoint phòng ban về máy tính. Khi bạn thêm/sửa file ở local → tự đồng bộ lên SharePoint, và ngược lại.

Cài đặt OneDrive

1 Tải OneDrive

Mac OneDrive có thể đã cài sẵn. Kiểm tra: mở Launchpad → tìm "OneDrive". Nếu chưa có, tải tại:

https://www.microsoft.com/en-us/microsoft-365/onedrive/download

Windows OneDrive thường đã cài sẵn trên Windows 10/11. Kiểm tra: bấm Start → gõ "OneDrive".

📸
Icon OneDrive trên taskbar (Windows) hoặc menu bar (Mac) — hình đám mây
s1-10-onedrive-icon.png
2 Đăng nhập bằng tài khoản công ty

Mở OneDrive → nhập email công ty (email Microsoft 365) → bấm "Sign in" → nhập password.

📸
OneDrive: màn hình đăng nhập — ô nhập email công ty
s1-11-onedrive-login.png

Sync SharePoint về máy

3 Mở SharePoint phòng ban trên trình duyệt

Truy cập link SharePoint phòng ban (giảng viên cung cấp):

[LINK SHAREPOINT PHÒNG BAN — giảng viên cung cấp]
📸
Trang SharePoint phòng ban — thấy danh sách file/folder
s1-12-sharepoint-site.png
4 Bấm nút Sync

Trên trang SharePoint, bấm nút "Sync" (hoặc "Đồng bộ") ở thanh công cụ phía trên.

📸
Nút Sync trên thanh công cụ SharePoint — mũi tên chỉ vào nút
s1-13-sync-button.png

Trình duyệt sẽ hỏi "Open Microsoft OneDrive?" → bấm "Open" (hoặc "Mở").

📸
Popup trình duyệt "Open Microsoft OneDrive?" — nút Open
s1-14-open-onedrive-popup.png
5 Xác nhận sync

OneDrive mở và hỏi xác nhận sync → bấm "Start syncing" (hoặc "Bắt đầu đồng bộ").

Chờ vài phút để file tải về máy.

📸
OneDrive: xác nhận sync — tên folder SharePoint + nút Start syncing
s1-15-start-syncing.png
6 Kiểm tra folder đã sync

Mac Mở Finder → sidebar trái → tìm folder công ty (dưới mục OneDrive)

Windows Mở File Explorer → sidebar trái → tìm folder công ty (dưới mục OneDrive)

Bạn phải thấy folder SharePoint phòng ban với các file bên trong.

📸
Finder/Explorer: folder SharePoint phòng đã sync — có icon đám mây/tick xanh
s1-16-finder-synced.png
Tick xanh (✓) bên cạnh file = đã sync xong. Mũi tên xoay = đang sync. Đám mây = chưa tải về.

Gen cấu trúc KB + CLAUDE.md bằng AI

Knowledge Base (KB) = tập hợp tài liệu phòng ban mà AI có thể đọc. Không có KB → AI bịa. Có KB → AI trả lời dựa trên tài liệu thật.

Thay vì tự tạo thư mục thủ công, bạn sẽ mô tả công việc phòng ban → nhờ Claude gen ra cấu trúc + file CLAUDE.md cùng lúc → rồi dùng AI kiểm tra lại (AI check AI).

1 Mở Claude Code tại folder SharePoint phòng

Mở Finder (Mac) / File Explorer (Windows) → tìm folder SharePoint phòng ban (đã sync ở bước trước).

Mở Claude Code → chọn folder SharePoint phòng làm thư mục làm việc.

2 Mô tả công việc → Claude gen cấu trúc + CLAUDE.md

Copy prompt sau, sửa phần [...] cho đúng phòng ban, rồi paste vào Claude Code:

Prompt gen cấu trúc + CLAUDE.md — Sửa phần mô tả phòng ban
Tôi cần tạo Knowledge Base cho phòng [TÊN PHÒNG] của công ty phát triển phần mềm.

Mô tả công việc phòng:
[MÔ TẢ 3-5 DÒNG VỀ CÔNG VIỆC CHÍNH CỦA PHÒNG]

Các loại tài liệu phòng thường dùng:
[LIỆT KÊ 5-10 LOẠI TÀI LIỆU, VD: quy trình tuyển dụng, template JD, ...]

Số người trong phòng: [SỐ NGƯỜI]
Tên từng người: [DANH SÁCH TÊN]

Hãy:
1. Tạo CẤU TRÚC THƯ MỤC phù hợp cho phòng này, bao gồm:
   - Folder chung/ với các sub-folder phân loại theo loại tài liệu
   - Folder ca-nhan/ với folder riêng cho mỗi người (tên không dấu, viết liền)
   - Folder tools/ cho sản phẩm AI
   - File README.md mô tả cấu trúc
2. Tạo file CLAUDE.md ở root với nội dung:
   - Quy tắc ưu tiên đọc file .md thay vì file gốc
   - Phân loại dữ liệu 3 vùng với ví dụ CỤ THỂ cho phòng này:
     + XANH = an toàn, AI xử lý bình thường (quy trình, template, hướng dẫn chung)
     + VÀNG = có tên người cụ thể → AI phải ẩn danh trước khi xử lý
     + ĐỎ = KHÔNG BAO GIỜ xử lý (lương, CCCD, mã số thuế, STK, đánh giá KPI, hợp đồng, mật khẩu)
   - Quy tắc xử lý khi phát hiện dữ liệu ĐỎ: dừng ngay và cảnh báo người dùng
   - Quy tắc đặt tên file: chữ thường, không dấu, gạch ngang

Tạo toàn bộ folder và file ngay trên máy.
Sửa 4 chỗ:
• [TÊN PHÒNG] → HR / ACC / Sales / MKT / PQA
• [MÔ TẢ CÔNG VIỆC] → ví dụ phòng HR: "Phòng HR phụ trách tuyển dụng, onboarding, quản lý nhân sự, chấm công, đánh giá nhân viên, xử lý nghỉ phép và các chế độ phúc lợi."
• [LIỆT KÊ TÀI LIỆU] → liệt kê file thật của phòng bạn
• [SỐ NGƯỜI] + [DANH SÁCH TÊN] → thông tin thật

Ví dụ đã điền xong (Phòng HR):

Ví dụ — Phòng HR
Tôi cần tạo Knowledge Base cho phòng HR của công ty phát triển phần mềm.

Mô tả công việc phòng:
Phòng HR phụ trách tuyển dụng (chủ yếu IT), onboarding nhân viên mới,
quản lý chấm công và nghỉ phép, xử lý các chế độ phúc lợi BHXH,
và hỗ trợ đánh giá nhân viên hàng quý.

Các loại tài liệu phòng thường dùng:
- Quy trình tuyển dụng 5 bước
- Template JD (Job Description)
- Template email từ chối ứng viên
- Quy trình onboarding nhân viên mới
- Checklist offboarding
- Nội quy công ty
- Chính sách phúc lợi
- Hướng dẫn sử dụng hệ thống chấm công

Số người trong phòng: 3
Tên từng người: Na, Hằng, Minh

Hãy:
1. Tạo CẤU TRÚC THƯ MỤC phù hợp cho phòng này, bao gồm:
   - Folder chung/ với các sub-folder phân loại theo loại tài liệu
   - Folder ca-nhan/ với folder riêng cho mỗi người (tên không dấu, viết liền)
   - Folder tools/ cho sản phẩm AI
   - File README.md mô tả cấu trúc
2. Tạo file CLAUDE.md ở root với nội dung:
   - Quy tắc ưu tiên đọc file .md thay vì file gốc
   - Phân loại dữ liệu 3 vùng với ví dụ CỤ THỂ cho phòng này:
     + XANH = an toàn, AI xử lý bình thường (quy trình, template, hướng dẫn chung)
     + VÀNG = có tên người cụ thể → AI phải ẩn danh trước khi xử lý
     + ĐỎ = KHÔNG BAO GIỜ xử lý (lương, CCCD, mã số thuế, STK, đánh giá KPI, hợp đồng, mật khẩu)
   - Quy tắc xử lý khi phát hiện dữ liệu ĐỎ: dừng ngay và cảnh báo người dùng
   - Quy tắc đặt tên file: chữ thường, không dấu, gạch ngang

Tạo toàn bộ folder và file ngay trên máy.
📸
Finder/Explorer: cấu trúc folder KB đã được Claude tạo — chung/, ca-nhan/, tools/, CLAUDE.md
s1-17-folder-structure.png
3 AI kiểm tra lại cấu trúc (AI check AI)

Sau khi Claude tạo xong, mở session Claude Code MỚI (để Claude đọc CLAUDE.md vừa tạo), rồi paste prompt kiểm tra:

Prompt kiểm tra — AI check AI
Kiểm tra cấu trúc thư mục hiện tại và file CLAUDE.md:

1. Cấu trúc folder có hợp lý cho phòng [TÊN PHÒNG] không? Có folder nào thừa hoặc thiếu?
2. File CLAUDE.md đã đủ quy tắc chưa? Có thiếu trường hợp dữ liệu ĐỎ nào đặc thù phòng không?
3. Tên file/folder đã đúng quy tắc (không dấu, gạch ngang) chưa?
4. README.md đã mô tả đủ cấu trúc chưa?

Nếu có gì cần sửa, sửa luôn giúp tôi.
Tại sao cần AI check AI? Lần gen đầu có thể thiếu folder, sai tên, hoặc CLAUDE.md chưa đủ quy tắc cho phòng bạn. Prompt thứ 2 này đóng vai "reviewer" — kiểm tra và sửa lỗi. Đây là kỹ thuật AI check AI rất hiệu quả.
4 Copy file phòng ban vào folder chung/

Lấy 5-10 file quan trọng nhất của phòng (đã chuẩn bị trong prework) → copy vào folder chung/ phù hợp.

Hoặc nhờ Claude Code copy giúp:

Prompt copy file — tuỳ chọn
Tôi có các file sau cần đưa vào KB:
- quy-trinh-tuyen-dung.xlsx (quy trình)
- template-jd.docx (template)
- huong-dan-cham-cong.pdf (hướng dẫn)

Hãy copy từng file vào folder chung/ phù hợp dựa trên cấu trúc đã tạo.
KHÔNG copy file chứa: bảng lương, CCCD, đánh giá cá nhân, hợp đồng, mật khẩu. Xem phần Phân loại dữ liệu để biết chi tiết.

Chuyển file sang Markdown

File Markdown (.md) là file text đơn giản mà AI đọc nhanh và chính xác hơn file Excel/Word. Bạn sẽ chuyển file gốc sang .md, nhưng giữ nguyên file gốc bên cạnh.

Lưu ý: CLAUDE.md đã được tạo ở bước trước (cùng lúc với cấu trúc thư mục). Claude Code sẽ tự biết ưu tiên đọc file .md.
1 Mở Claude Code tại folder KB phòng

Đảm bảo Claude Code đang mở ở thư mục SharePoint phòng ban (xem bước 4 phần Đăng nhập).

2 Chuyển nhiều file cùng lúc bằng 1 prompt

Thay vì chuyển từng file một, bạn có thể liệt kê tất cả file cần chuyển trong 1 prompt. Claude sẽ chuyển hết:

Prompt chuyển nhiều file — liệt kê file cần chuyển
Chuyển các file sau sang Markdown:
- chung/quy-trinh/[FILE-1]
- chung/quy-trinh/[FILE-2]
- chung/template/[FILE-3]

Yêu cầu cho MỖI file:
- Giữ nguyên toàn bộ nội dung, không thêm không bớt
- Không xóa, sửa hoặc ghi đè file gốc
- Lưu file .md cùng thư mục, cùng tên, chỉ đổi đuôi sang .md
- Nếu file có nhiều sheet: tạo heading ## cho mỗi sheet
- Nếu có bảng: chuyển thành bảng Markdown
- Với Excel/CSV có công thức, pivot, hoặc quá nhiều sheet → báo lại, không tự chuyển
- Với PDF scan hoặc nội dung không đọc rõ → báo lại, không tự suy đoán

TRƯỚC KHI THỰC HIỆN: lập bảng | File gốc | File .md đề xuất | Chuyển được? | Lưu ý |
Chỉ thực hiện chuyển đổi sau khi tôi xác nhận.
Sửa: Thay [FILE-1], [FILE-2]... bằng tên file thật trong folder của bạn.
Ví dụ: chung/quy-trinh/quy-trinh-tuyen-dung.xlsx

Hoặc chuyển từng file: Nếu muốn kiểm tra kỹ từng file, dùng prompt đơn giản hơn:

Prompt chuyển 1 file
Đọc file "chung/quy-trinh/[TÊN-FILE-GỐC]" và chuyển thành file Markdown.
Lưu cùng thư mục, cùng tên, đuôi .md. Giữ nguyên file gốc.
3 AI kiểm tra file đã chuyển (AI check AI)

Sau khi chuyển xong, dùng prompt kiểm tra để đảm bảo không mất thông tin:

Prompt kiểm tra file Markdown — AI check AI
So sánh file gốc và file .md vừa chuyển:
- Đọc file "chung/quy-trinh/[TÊN-FILE-GỐC]"
- Đọc file "chung/quy-trinh/[TÊN-FILE].md"

Kiểm tra:
1. Có thông tin nào trong file gốc bị THIẾU trong file .md không?
2. Heading có đúng cấp bậc (# > ## > ###) không?
3. Bảng Markdown có đúng format không? (có header row và dòng |---|)
4. Có chỗ nào nên dùng bảng thay vì danh sách (hoặc ngược lại) không?
5. AI có đọc và hiểu được file này tốt không? Có gì cần cải thiện?
6. Nếu có lỗi, sửa file .md luôn giúp tôi.
📸
Folder chung/quy-trinh/: 2 file cạnh nhau — quy-trinh-tuyen-dung.xlsx + quy-trinh-tuyen-dung.md
s1-18-dual-files.png
4 Lặp lại cho các file khác

Mục tiêu: ≥ 3 file trong lớp, ≥ 10 file về nhà.

Chỉnh sửa file Markdown trực tiếp

Claude Code có thể đọc và sửa file .md trực tiếp trên máy bạn — không cần mở file bằng app khác. Quy trình 3 bước:

1 Yêu cầu Claude mở file cần sửa

Gõ prompt yêu cầu Claude đọc file bạn muốn sửa:

Prompt mở file
Mở file chung/quy-trinh/tuyen-dung.md và cho tôi xem nội dung
📸
Claude Code hiển thị nội dung file .md — Claude đọc file và show toàn bộ nội dung
s1-edit-md-01-open-file.png
2 Yêu cầu sửa nội dung

Gõ chính xác bạn muốn sửa gì. Claude sẽ hiển thị thay đổi (diff) để bạn duyệt:

Prompt sửa file
Trong file tuyen-dung.md, thêm bước "Kiểm tra reference" vào sau bước phỏng vấn vòng 2. Người phụ trách: HR. Thời gian: 2 ngày.
📸
Claude hiện diff: dòng xanh = thêm mới, dòng đỏ gạch ngang = xóa/thay đổi
s1-edit-md-02-diff.png
3 Duyệt và xác nhận thay đổi

Claude Code sẽ hỏi bạn có đồng ý thay đổi không:

  • Nhấn y = đồng ý sửa
  • Nhấn n = từ chối (không sửa gì)
  • Nhấn a = đồng ý tất cả thay đổi trong session này
📸
Popup xác nhận cho phép Claude chỉnh sửa file — nhấn y/n/a
s1-edit-md-03-approve.png
File được sửa trực tiếp trên máy — thay đổi đã lưu vào file .md trên thư mục SharePoint. File sẽ tự đồng bộ lên cloud qua OneDrive Sync. Không cần mở app khác.

Ví dụ prompt chỉnh sửa MD theo phòng ban

PhòngVí dụ prompt sửa fileModel
HR"Cập nhật file tuyen-dung.md: thêm bước background check"Sonnet
ACC"Sửa file thanh-toan.md: thay đổi hạn mức phê duyệt từ 5tr lên 10tr"Haiku
Sales"Thêm gói Enterprise vào file bang-gia.md với đầy đủ thông tin"Sonnet
MKT"Cập nhật file social-media-plan.md: thêm kênh TikTok"Sonnet
PQA"Sửa lỗi chính tả trong tất cả file .md ở folder chung/"Haiku
Lưu ý quan trọng:

Phân loại dữ liệu — 3 vùng

🟢 XANH An toàn — Paste thoải mái
Quy trình, template, hướng dẫn chung, số liệu tổng hợp (không kèm tên người)
🟡 VÀNG Cần ẩn danh trước khi paste
Có tên người cụ thể → thay bằng "Nhân viên A", "Ứng viên B"
🔴 ĐỎ KHÔNG BAO GIỜ paste
Lương, thưởng, CCCD, mã số thuế, STK, BHXH, đánh giá KPI, NDA, hợp đồng, mật khẩu, API key

5 dấu hiệu ĐỎ — Dừng ngay khi thấy

1. Tên người + số tiền (lương, thưởng, hoa hồng)
2. Số định danh (CCCD, mã số thuế, STK ngân hàng, BHXH)
3. Đánh giá cá nhân / KPI cá nhân
4. Hợp đồng lao động / NDA / thỏa thuận bảo mật
5. Mật khẩu, API key, token, private key

→ Thấy BẤT KỲ dấu hiệu nào → KHÔNG paste vào Claude.

Ví dụ theo phòng ban

Phòng🟢 XANH🟡 VÀNG🔴 ĐỎ
HR Quy trình tuyển dụng 5 bước "Nguyễn A nghỉ phép 3 ngày" Bảng lương, CCCD nhân viên, đánh giá KPI
ACC Quy trình thanh toán, quy định chi tiêu "Công ty ABC thanh toán 50tr" Mã số thuế, số dư tài khoản, báo cáo thuế
Sales Danh mục sản phẩm, bảng giá công khai "KH Trần B quan tâm gói Premium" Hoa hồng, chiết khấu đặc biệt, giá gốc
MKT Brand guidelines, content calendar "Campaign X đạt 10k views" Ngân sách ads, chi phí chạy quảng cáo
PQA Checklist test, template bug report "Sprint 5 có 8 bug open" Bug bảo mật, credentials staging/prod

Cài đặt Custom Instructions

Custom Instructions = lệnh thường trực cho Claude. Mỗi lần bạn chat, Claude tự đọc lệnh này trước → tự cảnh báo khi gặp dữ liệu ĐỎ.

⬇ Tải file Custom Instructions

Tải file → mở → sửa [TÊN PHÒNG] → copy nội dung → paste vào Settings Claude Code (bước bên dưới).

1 Mở Settings trong Claude Code

Bấm icon ⚙️ (Settings) ở góc trên phải → tìm mục "Custom Instructions".

📸
Claude Code Settings — mục Custom Instructions (ô text lớn để paste nội dung)
s1-19-settings-menu.png
2 Paste nội dung Custom Instructions

Copy toàn bộ nội dung sau, sửa [TÊN PHÒNG], rồi paste vào ô Custom Instructions:

Custom Instructions — Copy và paste vào Settings
# Quy tắc bảo mật — Phòng [TÊN PHÒNG]

## Phân loại dữ liệu bắt buộc
Trước khi xử lý BẤT KỲ nội dung nào, kiểm tra:
- Có tên người kèm số tiền (lương, thưởng, hoa hồng) → ĐỎ → DỪNG
- Có số CCCD, mã số thuế, STK ngân hàng, số BHXH → ĐỎ → DỪNG
- Có đánh giá cá nhân / KPI cá nhân → ĐỎ → DỪNG
- Có nội dung hợp đồng / NDA → ĐỎ → DỪNG
- Có mật khẩu, API key, token → ĐỎ → DỪNG

## Khi phát hiện dữ liệu ĐỎ
Phản hồi:
"⚠️ CẢNH BÁO: Phát hiện dữ liệu nhạy cảm (vùng ĐỎ):
- [liệt kê cụ thể]
Tôi KHÔNG THỂ xử lý. Vui lòng xóa thông tin nhạy cảm hoặc ẩn danh rồi thử lại."

## Dữ liệu VÀNG
Nhắc nhở rồi tiếp tục: ẩn danh tên cá nhân trong output.

## Ngôn ngữ
Luôn phản hồi bằng tiếng Việt.
Sửa 1 chỗ: [TÊN PHÒNG] → HR / ACC / Sales / MKT / PQA
3 Lưu và kiểm tra

Bấm Save (hoặc Enter nếu CLI) → mở session mới → test:

Prompt test Custom Instructions
Phân tích bảng lương: Nguyễn Văn A — 25 triệu, Trần Thị B — 30 triệu

→ Claude phải cảnh báo: "⚠️ CẢNH BÁO: Phát hiện dữ liệu nhạy cảm..."

📸
Claude Code cảnh báo dữ liệu ĐỎ — hiện thông báo ⚠️ với nội dung cảnh báo
s1-20-ci-warning.png

Cài đặt Hook bảo mật

Hook = script tự động chạy TRƯỚC KHI prompt gửi đến server. Nếu phát hiện từ khóa ĐỎ → chặn ngay, dữ liệu không bao giờ rời khỏi máy.

⬇ Tải hook: user-prompt-submit.sh ⬇ Tải hook: pre-tool-use.sh

Tải 2 file hook → copy vào folder ~/.claude/hooks/ (Mac) hoặc %USERPROFILE%\.claude\hooks\ (Windows). Chi tiết bên dưới.

Khác biệt quan trọng:
• Custom Instructions: Claude nhận prompt rồi mới cảnh báo (dữ liệu đã gửi)
• Hook: Chặn TRƯỚC khi gửi (dữ liệu chưa rời máy)
1 Tải 2 file hook

Bấm 2 nút tải phía trên (hoặc tải từ SharePoint). Bạn sẽ có 2 file:

FileChức năng
user-prompt-submit.shQuét prompt trước khi gửi → chặn nếu có từ khóa ĐỎ
pre-tool-use.shQuét trước khi Claude ghi file → chặn nếu output chứa từ khóa ĐỎ
2 Copy file hook vào folder Claude Code

Bạn cần copy 2 file đã tải vào folder .claude/hooks/ trên máy. Cách dễ nhất: kéo thả vào Claude Code.

Bước 2a: Mở folder Downloads (nơi vừa tải 2 file hook). Chọn cả 2 file → kéo thả vào ô chat của Claude Code.

Bước 2b: Sau khi kéo thả, Claude Code tự nhận đường dẫn file. Paste prompt sau:

Prompt cài hook — paste sau khi kéo thả 2 file
Copy 2 file hook tôi vừa đưa vào folder ~/.claude/hooks/
Tạo folder nếu chưa có. Set quyền chạy (chmod +x) cho cả 2 file.
Tại sao kéo thả? Claude Code tự nhận đường dẫn file — không cần gõ tay, không sợ sai. Đây là cách đơn giản nhất cho mọi hệ điều hành.
3 Kiểm tra hook hoạt động

Mở Claude Code mới → gõ prompt có từ khóa ĐỎ:

Prompt test hook
Phân tích bảng lương nhân viên tháng 9

→ Hook phải chặn: "🔴 CHẶN: Phát hiện từ khóa nhạy cảm: lương"

📸
Claude Code: hook chặn prompt — hiện thông báo 🔴 CHẶN
s1-21-hook-blocked.png

Thêm từ khóa phòng ban vào Hook

Hook mẫu có sẵn từ khóa chung (lương, CCCD, mật khẩu...). Mỗi phòng cần thêm từ khóa đặc thù phòng mình.

1 Dùng Claude Code để thêm từ khóa

Cách dễ nhất: nhờ Claude Code sửa file hook cho bạn. Paste prompt sau vào Claude Code:

Prompt thêm từ khóa — paste vào Claude Code
Mở file ~/.claude/hooks/user-prompt-submit.sh
Tìm dòng KEYWORDS= và thêm các từ khóa sau VÀO CUỐI (trước dấu " cuối cùng), ngăn cách bằng |:
[PASTE ĐOẠN TỪ KHÓA PHÒNG BẠN Ở BƯỚC 2 BÊN DƯỚI]

Sau đó làm tương tự với file ~/.claude/hooks/pre-tool-use.sh
2 Từ khóa gợi ý theo phòng

Copy đoạn từ khóa của phòng mình, thêm vào cuối dòng KEYWORDS:

Phòng HR — thêm:

|hop-dong-lao-dong|hợp đồng lao động|thu-viec|thử việc|ky-luat|kỷ luật|canh-cao|cảnh cáo|nghi-viec|nghỉ việc

Phòng ACC — thêm:

|so-du|số dư|chuyen-khoan|chuyển khoản|hoa-don-do|hóa đơn đỏ|bao-cao-thue|báo cáo thuế|tai-khoan-ngan-hang|tài khoản ngân hàng

Phòng Sales — thêm:

|hoa-hong|hoa hồng|chiet-khau-dac-biet|chiết khấu đặc biệt|gia-goc|giá gốc|gia-nhap|giá nhập

Phòng MKT — thêm:

|ngan-sach|ngân sách|chi-phi-ads|chi phí quảng cáo|budget|gia-chay-ads|giá chạy ads

Phòng PQA — thêm:

|bug-bao-mat|bug bảo mật|credential|staging|production|private-key|exploit|vulnerability
4 Lưu file và test

Lưu file (Cmd+S hoặc Ctrl+S) → mở Claude Code mới → test với từ khóa vừa thêm.

Làm tương tự cho file pre-tool-use.sh (cùng dòng KEYWORDS).

Quy trình quản lý Knowledge Base

KB cần được duy trì: khi file gốc thay đổi, file .md phải cập nhật theo. Thay vì tự viết quy trình, bạn sẽ mô tả tình hình phòng → Claude gen quy trình → rồi AI kiểm tra lại.

1 Mô tả phòng ban → Claude gen quy trình

Paste vào Claude Code:

Prompt gen quy trình — Mô tả phòng ban
Tạo file chung/quy-trinh-quan-ly-kb.md — quy trình quản lý Knowledge Base cho phòng [TÊN PHÒNG].

Thông tin phòng:
- Trưởng phòng (Owner): [TÊN OWNER]
- Người phụ trách AI (Builder): [TÊN BUILDER]
- Thành viên: [DANH SÁCH TÊN]

Hãy đọc toàn bộ cấu trúc thư mục hiện tại và tạo quy trình bao gồm:
1. Bảng phân công: liệt kê TẤT CẢ file .md hiện có trong folder chung/, ai phụ trách, tần suất cập nhật
2. Quy trình khi file gốc thay đổi (các bước cần làm)
3. Quy trình khi thêm file mới (ai duyệt, phân loại XANH/VÀNG/ĐỎ)
4. Phân quyền: ai được sửa folder nào, file nào
Sửa 4 chỗ: [TÊN PHÒNG], [TÊN OWNER], [TÊN BUILDER], [DANH SÁCH TÊN]
Điểm hay: Claude sẽ tự đọc folder hiện tại để liệt kê file, không cần bạn gõ tay từng file. Quy trình sẽ phản ánh đúng tình trạng KB thật.
2 AI kiểm tra quy trình (AI check AI)

Sau khi Claude tạo xong, paste tiếp prompt kiểm tra:

Prompt kiểm tra quy trình — AI check AI
Đọc file chung/quy-trinh-quan-ly-kb.md vừa tạo và kiểm tra:

1. Bảng phân công có liệt kê ĐỦ tất cả file .md trong folder chung/ không? (so sánh với folder thật)
2. Quy trình có thiếu bước nào quan trọng không? (VD: backup trước khi sửa, thông báo cho team)
3. Phân quyền có hợp lý không? Có ai được quyền quá rộng hoặc quá hẹp?
4. File có dạng .md và Claude đọc được tốt không?

Nếu có gì cần bổ sung, sửa luôn giúp tôi.

Lưu ý: Đây là bản mẫu tạo trong lớp. BTVN: review và hoàn thiện khi KB đã đầy đủ ≥ 10 file.

Hỏi: Có thể phân quyền theo từng máy (mỗi người chỉ sửa file mình phụ trách)?
Về kỹ thuật: có thể thêm rule vào CLAUDE.md kiểu "Kiểm tra user hiện tại và đối chiếu file phân quyền trước khi sửa". Tuy nhiên CLAUDE.md là quy tắc tự nguyện — người dùng có thể yêu cầu Claude bỏ qua.
Khuyến nghị: Dùng phân quyền SharePoint (đã có sẵn) để kiểm soát ai được sửa file nào. Ghi rõ phân công trong file quy-trinh-quan-ly-kb.md để mọi người tự tuân thủ.

Hỏi đáp với Knowledge Base

Sau khi tạo KB + CLAUDE.md + cài bảo mật, bạn có thể hỏi Claude câu hỏi dựa trên tài liệu phòng ban.

Quan trọng: Khi KB thay đổi (thêm file, sửa file), phải mở session Claude Code MỚI (đóng và mở lại). Session cũ không tự cập nhật.
1 Mở Claude Code tại folder KB

Đảm bảo Claude Code đang ở thư mục SharePoint phòng ban (có CLAUDE.md).

2 Làm quen giao diện — nhập prompt ở đâu?

Dưới đây là giao diện Claude Code Desktop. Có 3 vùng chính cần biết:

📸
Giao diện Claude Code Desktop — đánh dấu 3 vùng: (A) Model selector ở trên, (B) Vùng chat ở giữa, (C) Ô nhập prompt ở dưới
s1-qa-01-giao-dien-tong-quan.png
VùngTênMô tả
AModel selectorNhấn vào để chọn model AI (Opus / Sonnet / Haiku) — xem hướng dẫn chọn ở bước 3
BVùng chatHiển thị lịch sử hội thoại — prompt của bạn (xanh dương) và câu trả lời Claude (xanh lá)
CÔ nhập promptPaste prompt vào đây → nhấn Enter để gửi. Prompt dài nhiều dòng: nhấn Shift + Enter để xuống dòng
3 Chọn model phù hợp cho từng tác vụ

Nhấn vào model selector (vùng A) để mở danh sách model:

📸
Nhấn vào model selector → dropdown hiện 3 model: Sonnet (mặc định), Opus, Haiku
s1-qa-02-chon-model.png

Dùng model nào cho tác vụ nào?

S
Sonnet — dùng hàng ngày (mặc định)
Nhanh, chính xác đủ cho phần lớn công việc. Mở Claude Code lên là dùng luôn.
Tác vụVí dụ prompt
Hỏi đáp KB đơn giản"Quy trình thanh toán gồm mấy bước?"
Tóm tắt tài liệu"Tóm tắt file onboarding.md thành 5 điểm chính"
Chuyển file sang Markdown"Chuyển file huong-dan.docx sang .md"
Tạo cấu trúc thư mục KB"Tạo folder cấu trúc KB cho phòng HR"
Viết nội dung mới (draft đầu)"Viết template email xác nhận tuyển dụng"
O
Opus — khi cần suy luận sâu
Chậm hơn nhưng phân tích phức tạp hơn. Dùng khi output quan trọng hoặc cần phản biện.
Tác vụVí dụ prompt
AI check AI (kiểm tra output)"Kiểm tra câu trả lời vừa rồi có đúng KB không"
Phân tích / so sánh nhiều file"So sánh 2 quy trình và đề xuất cải tiến"
Viết quy trình phòng ban phức tạp"Tạo quy trình quản lý KB với phân quyền chi tiết"
Xử lý câu hỏi cần nhiều bước"Phân tích KPI Q3, so sánh với target, đề xuất action"
H
Haiku — tác vụ nhỏ, nhanh gọn
Nhanh nhất và tiết kiệm nhất. Dùng cho sửa nhỏ, tra cứu nhanh.
Tác vụVí dụ prompt
Sửa lỗi chính tả trong file .md"Sửa lỗi chính tả trong file tuyen-dung.md"
Tra cứu nhanh 1 thông tin"File nào chứa quy trình nghỉ phép?"
Format lại nội dung"Chuyển danh sách này thành bảng Markdown"
Mẹo: Không chắc chọn model nào? Cứ dùng Sonnet trước. Nếu output chưa đủ tốt → chuyển sang Opus và hỏi lại. Muốn tiết kiệm cho việc nhỏ → dùng Haiku.
4 Nhập prompt theo cấu trúc ROLE — CONTEXT — TASK — FORMAT

Để AI trả lời chính xác, hãy viết prompt theo 4 phần:

PhầnMô tảVí dụ
[ROLE]Vai trò AI đóng"Bạn là chuyên viên HR"
[CONTEXT]Nguồn tri thức để trả lời"Sử dụng tài liệu trong folder chung/"
[TASK]Nhiệm vụ cụ thể"Liệt kê các bước tuyển dụng"
[FORMAT]Dạng output mong muốn"Trả lời dạng bảng, có cột Bước / Người / Thời gian"

Copy prompt mẫu bên dưới, paste vào ô nhập (vùng C), sửa thông tin phòng ban rồi nhấn Enter:

📸
Paste prompt 4 phần (ROLE/CONTEXT/TASK/FORMAT) vào ô chat → nhấn Enter → Claude trả lời dựa trên KB
s1-qa-03-nhap-prompt-4-phan.png
Prompt mẫu — cấu trúc 4 phần
[ROLE] Bạn là chuyên viên HR của công ty phát triển phần mềm.
[CONTEXT] Sử dụng tài liệu trong thư mục Knowledge Base hiện tại để trả lời.
[TASK] Ứng viên đang ở bước phỏng vấn vòng 1. Hãy liệt kê các bước tiếp theo cần làm và ai chịu trách nhiệm.
[FORMAT] Trả lời dưới dạng bảng: Bước | Người thực hiện | Thời gian | Lưu ý.
Sửa: Thay [ROLE], [TASK], [FORMAT] cho phù hợp câu hỏi của bạn. [CONTEXT] giữ nguyên — Claude Code tự đọc file trong thư mục.

Ví dụ theo phòng ban

PhòngVí dụ prompt (đã đầy đủ 4 phần)
HR[ROLE] Chuyên viên HR. [CONTEXT] Dùng KB. [TASK] "Template JD cần có những phần gì?" [FORMAT] Danh sách gạch đầu dòng.
ACC[ROLE] Kế toán. [CONTEXT] Dùng KB. [TASK] "Nhân viên muốn hoàn ứng 5 triệu, cần giấy tờ gì?" [FORMAT] Checklist.
Sales[ROLE] Sales. [CONTEXT] Dùng KB. [TASK] "Tóm tắt gói Premium cho khách hàng." [FORMAT] Email ngắn gọn.
MKT[ROLE] Marketing. [CONTEXT] Dùng KB. [TASK] "Viết brief bài social media sự kiện tháng 10." [FORMAT] Brief 1 trang.
PQA[ROLE] QA. [CONTEXT] Dùng KB. [TASK] "Liệt kê mục cần kiểm tra cho dự án web." [FORMAT] Checklist có checkbox.
5 Kiểm tra Claude trả lời dựa trên KB

Claude phải:

  • Trả lời dựa trên file .md trong KB (không tự bịa)
  • Nêu được nguồn: "Theo file quy-trinh-tuyen-dung.md..."
  • Nếu không có thông tin → nói rõ "Không tìm thấy trong KB"
6 AI tự kiểm tra câu trả lời (AI check AI)

Sau khi Claude trả lời, paste prompt kiểm tra để đảm bảo output chính xác.

Khuyến nghị: chuyển sang model Opus trước khi chạy prompt này — Opus phản biện tốt hơn.

📸
Chuyển sang model Opus → paste prompt AI check AI → Claude trả lời bảng đánh giá (phát hiện lỗi nếu có)
s1-qa-04-ai-check-ai.png
Prompt tự kiểm tra — AI check AI
Hãy tự kiểm tra câu trả lời bạn vừa đưa:

1. Có thông tin nào bạn tự suy ra mà KHÔNG có trong tài liệu KB không? Nếu có, chỉ rõ.
2. Có thông tin quan trọng nào trong KB mà bạn chưa sử dụng không?
3. Có thông tin nào chưa đủ dữ liệu để kết luận không?
4. Output có đúng format tôi yêu cầu không?
5. Nếu gửi output này cho đồng nghiệp, họ có hiểu và sử dụng được ngay không?

Trả lời dưới dạng bảng: | Tiêu chí | Đánh giá | Vấn đề | Cần sửa gì |
Khi nào cần dùng? Dùng khi output quan trọng (gửi cho sếp, gửi khách hàng, dùng ra quyết định). Với câu hỏi đơn giản thì không cần.

Tạo Skill — Sẽ thêm ở buổi 2

Nội dung sẽ được thêm sau buổi 2.

Tạo Workflow — Sẽ thêm ở buổi 2

Nội dung sẽ được thêm sau buổi 2.

Vibe Coding — Tool HTML — Sẽ thêm ở buổi 3

Nội dung sẽ được thêm sau buổi 3.

Showcase — Sẽ thêm ở buổi 4

Nội dung sẽ được thêm sau buổi 4.