Nếu bạn đang muốn bắt đầu với Claude Code nhưng chưa biết đi từ đâu, thì hướng dẫn này chính là thứ bạn cần. Bài viết sẽ tóm tắt những khái niệm cốt lõi, framework WAT, cũng như các bước cụ thể để xây dựng, kiểm thử và triển khai các automation AI bằng Claude Code.

1. Giao diện & Cài đặt

Claude Code cho phép bạn xây dựng các dự án lập trình phức tạp và hệ thống tự động hóa ngay trong môi trường phát triển cục bộ (IDE) của mình.

• Môi trường làm việc: Hướng dẫn này sử dụng Visual Studio Code (VS Code) làm nền tảng chính. Đây là một IDE phổ biến, nhẹ và rất phù hợp để tích hợp với Claude Code.
• Cài đặt Extension: Bạn chỉ cần tìm kiếm và cài đặt extension có tên “Claude Code” trong marketplace của VS Code.
• Yêu cầu truy cập:
  • Bạn cần có gói trả phí của Anthropic (Claude Pro hoặc Team).
  • Sau khi cài đặt extension, hãy đăng nhập bằng tài khoản Anthropic của bạn để bắt đầu sử dụng.
• Bố cục giao diện: Sau khi setup xong, bạn sẽ thấy giao diện được chia làm hai phần chính:
  • Bên trái (Explorer): Đây là nơi hiển thị cấu trúc file của bạn, bao gồm các thành phần như Workflows, Tools và Prompts.
  • Bên phải (Agent): Đây là khu vực chat, nơi bạn tương tác trực tiếp với Claude Code để lên kế hoạch và thực thi các tác vụ.
• Bỏ qua quyền xác nhận (Bypass Permissions): Nếu bạn muốn tăng tốc độ làm việc, bạn có thể bật tùy chọn “Bypass Permissions” trong phần cài đặt của extension. Tính năng này cho phép Claude tự động chỉnh sửa file mà không cần hỏi lại bạn ở từng bước — rất tiện khi bạn đang build nhanh hoặc thử nghiệm ý tưởng.

2. WAT Framework – Bộ khung cốt lõi

Để xây dựng các hệ thống AI automation đáng tin cậy, bạn có thể sử dụng một cấu trúc gồm 3 lớp gọi là WAT Framework. Điểm quan trọng của mô hình này là tách biệt rõ ràng giữa phần “suy luận” (AI) và phần “thực thi” (Code). Nhờ vậy, hệ thống vừa linh hoạt, vừa dễ kiểm soát và bảo trì.

Layer 1: Workflows (/workflows)

• Định dạng: File .md (Markdown)
• Mục đích: Đây chính là các SOPs (Standard Operating Procedures – quy trình vận hành chuẩn). Chúng mô tả:
  • Mục tiêu cần đạt được
  • Input cần thiết
  • Thứ tự sử dụng các tool
  • Cách xử lý các tình huống đặc biệt (edge cases)

Lưu ý: Tất cả đều được viết bằng ngôn ngữ tự nhiên

Hãy tưởng tượng đây là người quản lý (manager) — người đưa ra hướng dẫn chi tiết cho “nhân viên” phải làm gì, theo từng bước. Đấy chính là Workflows.

Layer 2: Agent (claude.md)

• Định dạng: File .md đóng vai trò như system prompt
• Mục đích: Đây là “bộ não trung tâm” của Claude Code. Nó hướng dẫn agent:
  • Cách điều hướng trong project (folder structure)
  • Nên dùng tool nào
  • Cách tuân theo WAT Framework
• Khả năng tự sửa lỗi (Self-healing): Agent được thiết kế để:
  • Đọc và hiểu lỗi
  • Refactor lại tools khi cần
  • Cập nhật workflows nếu quy trình bị fail

Nói cách khác, agent không chỉ làm theo lệnh mà còn tự thích nghi và cải thiện hệ thống theo thời gian.

Layer 3: Tools (/tools)

• Định dạng: File .py (Python)
• Mục đích: Đây là nơi chứa code thực thi các hành động cụ thể, ví dụ:
  • Crawl dữ liệu từ website
  • Gửi email
  • Query database
• Bảo mật: Một nguyên tắc cực kỳ quan trọng:
  • Không bao giờ lưu API key hoặc secrets trực tiếp trong code
  • Thay vào đó, hãy lưu chúng trong file .env để tránh bị lộ thông tin

Với 3 layers như trên, WAT Framework hoạt động theo luồng:

• Workflows → đưa ra kế hoạch (làm gì)
• Agent → hiểu kế hoạch và điều phối (làm như thế nào)
• Tools → thực thi hành động (làm thật)

Ba lớp này phối hợp với nhau giúp bạn xây dựng automation AI vừa rõ ràng, vừa dễ mở rộng.

3. Lập kế hoạch & Xây dựng Automation

Trước khi viết bất kỳ dòng code nào, bạn nên chuyển sang Plan Mode trong giao diện Claude Code. Đây là bước cực kỳ quan trọng — giúp bạn tránh việc “code trước, nghĩ sau”.

Bước 1: Brain Dump (Mô tả ý tưởng)

Hãy mô tả mục tiêu của bạn càng rõ càng tốt.
Ví dụ: “Thu thập dữ liệu các kênh YouTube trong lĩnh vực AI và tạo một slide deck có branding.”

Bước 2: Iterative Questioning (Hỏi – đáp lặp lại)

Trong Plan Mode, agent sẽ chủ động đặt câu hỏi để làm rõ yêu cầu của bạn, như:

• Tần suất chạy automation
• Các loại dữ liệu cần lấy
• Cách thức xuất kết quả (email, file, dashboard, …)

=> Điều này giúp đảm bảo hệ thống hiểu đúng nhu cầu trước khi bắt tay vào làm.

Bước 3: To-Do List (Danh sách công việc)

Sau khi kế hoạch được chốt, agent sẽ:

• Tạo checklist công việc
• Thực thi từng bước một bao gồm các công việc như: Tạo folder, Viết script Python, Thiết lập workflows

4. “Siêu năng lực”: MCPs & Skills

Claude Code có thể được mở rộng bằng các khả năng bên ngoài để xử lý những tác vụ mà bản thân nó không làm được.

• MCP (Model Context Protocol) Servers: Bạn có thể hình dung MCP giống như một “App Store cho AI”. Nó cung cấp một “cổng kết nối chung” để liên kết với các dịch vụ như: Gmail, Google Calendar, Slack. Nhờ đó, bạn không cần phải tự viết API integration cho từng dịch vụ nhỏ lẻ.
• Skills: Skills là các instruction động hoặc custom prompt có thể tái sử dụng (ví dụ: một skill “Thiết kế Canva”). Claude chỉ load những skill này khi thực sự cần. Trong đó:
  • Local Skills: Được cài đặt riêng cho từng project cụ thể.
  • Global Skills: Là các skills được cài đặt ở cấp độ toàn bộ Claude Code. Bạn có thể sử dụng chúng trong bất kỳ project nào, không bị giới hạn như Local Skills.

4.1. Skills vs…?

Vì Skills là một khái niệm khá quan trọng trong Claude Code, nên chúng ta sẽ làm rõ nó bằng cách đặt trong tương quan với một số thành phần khác trong hệ thống.

Skills vs. Projects

Projects cung cấp kiến thức nền tĩnh (static background knowledge), luôn được load sẵn mỗi khi bạn bắt đầu một cuộc hội thoại trong project đó. Skills thì khác — chúng là các quy trình chuyên biệt, chỉ được kích hoạt khi cần và có thể sử dụng xuyên suốt nhiều ngữ cảnh trong Claude.

Có thể hiểu đơn giản: Projects = “kiến thức nền”, trong khi đó Skills = “cách làm việc / quy trình xử lý”

Skills vs. MCP (Model Context Protocol)

MCP đóng vai trò kết nối Claude với các dịch vụ và nguồn dữ liệu bên ngoài (như Gmail, Slack, Google Calendar, …). Skills cung cấp “kiến thức thực thi” — tức là hướng dẫn cụ thể để hoàn thành một task hoặc workflow.

Bạn hoàn toàn có thể dùng cả hai cùng lúc: MCP → giúp Claude có công cụ, Skills → giúp Claude biết cách sử dụng công cụ đó hiệu quả. Nếu nhìn toàn bộ hệ thống, MCP giúp mở rộng khả năng (connect ra bên ngoài) còn Skills giúp tối ưu cách làm (logic + quy trình). Khi kết hợp đúng cách, bạn sẽ có một hệ thống AI: biết làm gì (Workflows), biết làm như thế nào (Skills), và có đủ công cụ để làm (MCP + Tools)

5. Testing & Optimization

Xây dựng automation mới chỉ là một nửa chặng đường. Bạn cần test và tinh chỉnh lại logic để hệ thống hoạt động ổn định.

• Chạy thử lần đầu (Initial Run): Thực thi workflow trong môi trường test để phát hiện các dependency còn thiếu hoặc lỗi API.
• Xử lý lỗi (Error Resolution): Nếu một tool bị lỗi, hãy copy log từ terminal và dán lại vào Claude Code. Agent sẽ phân tích lỗi, sửa script Python và chạy lại.
• Branding & Assets: Bạn có thể kéo thả các tài nguyên (logo, hình ảnh, …) vào folder project và yêu cầu agent tích hợp chúng vào output cuối (PDF, slide, …).

6. Deploy lên Production

Sau khi automation chạy ổn định trên local, bạn cần deploy lên cloud để nó có thể chạy tự động theo lịch (Cron) hoặc trigger (Webhook).

• Nền tảng hosting: Bạn có thể tận dụng các nền tảng như Modal để triển khai và vận hành các workload Python một cách linh hoạt trên cloud. Lợi ích mang lại là việc chỉ trả phí theo thời gian thực thi, không cần quản lý server và mọi hạ tầng đã được xử lý sẵn.
• Các bước deploy:
  • Bước 1: Cài đặt Modal client thông qua Claude Code
  • Bước 2: Yêu cầu agent: “Push workflow này lên Modal và chạy mỗi thứ Hai lúc 6 giờ sáng”
  • Bước 3: Kiểm tra bảo mật (Security Review): Luôn yêu cầu agent kiểm tra bảo mật trước khi deploy để đảm bảo không lộ API key hay lỗ hổng
• Monitoring: Bạn có thể sử dụng dashboard của Modal để xem log hay theo dõi lịch sử chạy. Nếu có lỗi trên cloud, chỉ cần copy log và đưa lại cho Claude Code để fix.

Tổng kết

Claude Code không chỉ là một công cụ viết code bằng AI — nó là một cách tiếp cận hoàn toàn mới để xây dựng automation. Thay vì viết mọi thứ từ đầu, bạn làm việc theo một hệ thống rõ ràng:

• Workflows → xác định cần làm gì
• Agent → điều phối và suy luận
• Tools → thực thi hành động
• Skills → chuẩn hóa cách xử lý
• MCP → mở rộng khả năng kết nối

Khi kết hợp tất cả lại, bạn có thể xây dựng những hệ thống automation có cấu trúc rõ ràng, dễ mở rộng và có thể tự cải thiện theo thời gian. Nếu trước đây automation là việc dành cho dev nhiều kinh nghiệm, thì với Claude Code, bất kỳ ai có tư duy hệ thống đều có thể bắt đầu.