Prompt Engineering Cho Claude Code: Complete Guide (2026)

Viết prompt cho Claude Code không giống viết prompt cho ChatGPT hay Claude.ai. Bạn không đang hỏi đáp, bạn đang giao việc cho một agent tự động có quyền đọc file, chạy lệnh, và sửa code. Cách tiếp cận sai sẽ lãng phí cả token lẫn thời gian.

Bài này mình tổng hợp từ tài liệu chính thức của Anthropic (code.claude.com/docs/en/best-practices) và kinh nghiệm thực tế khi dùng Claude Code hàng ngày. Không có lý thuyết màu mè, chỉ có workflow và template bạn dùng được ngay.

Prompt Trong Claude Code Khác Chat Thường Thế Nào?

Claude Code hoạt động trong môi trường agentic: nó không chỉ trả lời mà còn chạy tool (Read, Edit, Bash), truy cập file, và thực hiện nhiều bước liên tiếp. Anthropic xác nhận rằng đặt câu hỏi ở cuối prompt dài giúp tăng chất lượng phản hồi lên 30% vì Claude xử lý context trước khi đọc yêu cầu cụ thể (Anthropic, 2025).

Sự khác biệt lớn nhất: khi chat thông thường, context window gần như vô hạn với một vòng hỏi đáp. Còn trong Claude Code, một session làm việc có thể tiêu tốn hàng chục nghìn token chỉ để đọc vài file source. Prompt kém chất lượng không chỉ cho kết quả tệ, nó còn đốt token nhanh hơn bạn nghĩ.

Ba điểm cốt lõi cần nhớ:

• Bạn đang giao việc, không hỏi đáp. Thay vì “Bạn có thể giải thích auth flow không?”, hãy nói “Đọc @src/auth và giải thích logic token refresh.”
• Context window đầy rất nhanh. File lớn, lịch sử dài, tool outputs đều ăn token. Prompt rõ ràng giúp Claude hoàn thành task nhanh hơn, ít vòng lặp hơn.
• Agent có quyền hành động. Claude Code có thể sửa file thật, chạy lệnh thật. Prompt mơ hồ dẫn đến hành động ngoài ý muốn.

Để hiểu sâu hơn về cách Claude Code quản lý token và context, bạn có thể đọc thêm về memory và context trong Claude Code.

Quy Trình 4 Bước Chính Thức: Explore, Plan, Implement, Commit

Anthropic công bố quy trình 4 bước chính thức cho mọi task phức tạp trong Claude Code. Quy trình này không tùy chọn khi bạn làm việc với codebase lớn vì nó ngăn Claude “nhảy vào code” trước khi hiểu rõ toàn cảnh, tránh những thay đổi không mong muốn gây tốn thêm nhiều vòng sửa lỗi (Anthropic, 2025).

Phase 1 – Explore: Đọc và Hiểu Trước

Trước khi code bất cứ thứ gì, bật Plan Mode bằng cách nhấn Shift+Tab. Trong mode này, Claude chỉ đọc và phân tích, không sửa file. Prompt mẫu:

Đọc @src/auth và hiểu cách sessions được quản lý.
Tập trung vào:
- Cách token được tạo và lưu trữ
- Flow khi token hết hạn
- Các edge case đã được xử lý

Phase 2 – Plan: Lấy Kế Hoạch Rõ Ràng

Sau khi Claude hiểu code, hỏi về kế hoạch trước khi cho phép thực thi. Bước này tiết kiệm rất nhiều thời gian vì bạn phát hiện vấn đề trước khi Claude đã viết 200 dòng code sai hướng.

Những file nào cần thay đổi để implement token refresh?
Tạo kế hoạch chi tiết trước khi viết bất kỳ dòng code nào.

Phase 3 – Implement: Thực Thi Có Kiểm Soát

Bây giờ tắt Plan Mode, quay về Normal Mode, và cho phép Claude thực hiện kế hoạch đã duyệt. Luôn yêu cầu viết test cùng lúc để không phải quay lại sau.

Implement kế hoạch đã thống nhất.
Viết unit tests cho logic token refresh.
Chạy tests sau khi viết xong.

Phase 4 – Commit: Đóng Gói Gọn Gàng

Commit với message mô tả rõ thay đổi.
Mở PR nếu cần review.

8 Prompt Templates Thực Tế Nào Hay Nhất?

Dưới đây là 8 template mình dùng thường xuyên nhất, được đúc kết từ tài liệu chính thức của Anthropic và thực tế làm việc hàng ngày. Mỗi template giải quyết một loại task cụ thể và đã được kiểm chứng qua nhiều dự án thực tế (Anthropic Prompting Guide, 2025).

Template 1: Read và Act

Pattern cơ bản nhất cho mọi task liên quan đến code hiện có. Luôn cho Claude đọc context trước khi làm.

Đọc @src/auth và hiểu cách sessions được quản lý.
Sau đó implement token refresh với sliding window 15 phút.

Template 2: Find và Fix Theo Scope

Dùng khi muốn Claude tìm và sửa một vấn đề cụ thể trên toàn codebase. Định nghĩa rõ “scope” để tránh Claude đụng vào những gì không cần thiết.

Tìm tất cả chỗ dùng API deprecated getUserById() trong @src/.
Thay thế bằng findUserById() theo signature mới trong @docs/api-v2.md.
Không sửa gì trong @tests/.

Template 3: Refactor Không Phá Behavior

Refactor @src/utils/helpers.js lên ES2024:
- Dùng optional chaining và nullish coalescing
- Giữ nguyên tất cả function signatures
- Chạy tests sau khi xong để verify không có regression

Template 4: Write với Test Cases Cụ Thể

Cách tốt nhất để đảm bảo code đúng spec: định nghĩa test cases trước, yêu cầu chạy tests ngay sau khi viết xong.

Viết function validateEmail(email: string): boolean
Test cases bắt buộc pass:
- validateEmail("user@example.com") === true
- validateEmail("invalid") === false
- validateEmail("a@b") === false
- validateEmail("user+tag@domain.co.uk") === true
Chạy tests ngay sau khi viết xong.

Template 5: Interview Mode cho Feature Mới

Khi bạn chưa rõ hoàn toàn requirements, dùng AskUserQuestion để Claude phỏng vấn bạn trước khi bắt tay vào làm.

Mình muốn build tính năng notification system.
Phỏng vấn mình bằng AskUserQuestion để làm rõ:
- Yêu cầu kỹ thuật (channels, delivery guarantees)
- UI/UX (in-app, email, push?)
- Edge cases (offline users, rate limiting)
Hỏi từng câu một, không hỏi tất cả cùng lúc.

Template 6: @file Reference Patterns

# Giải thích logic cụ thể
Giải thích logic trong @src/utils/auth.js.
Tập trung vào hàm refreshToken và tại sao nó cần mutex lock.

# So sánh hai implementation
So sánh @src/v1/parser.js và @src/v2/parser.js.
Điểm khác biệt chính trong error handling là gì?

Template 7: Sub-agents cho Task Phức Tạp

Khi task cần điều tra nhiều nhánh độc lập, dùng sub-agents trong Claude Code để chạy song song và tổng hợp kết quả.

Dùng sub-agents để điều tra cách auth xử lý token refresh:
- Agent 1: Đọc @src/auth/ và map toàn bộ token lifecycle
- Agent 2: Đọc @tests/auth/ và xác định test coverage hiện tại
- Agent 3: Tìm bug reports liên quan trong @docs/
Tổng hợp kết quả và đề xuất hướng fix.

Template 8: Headless Mode cho Automation

# List tất cả API endpoints và output JSON
claude -p 'list all REST API endpoints in @src/routes/ with method, path, and auth required' --output-format json

# Chạy trong CI/CD pipeline
claude -p 'review @src/auth.js for security issues. Output as JSON with severity levels.' --output-format json | jq '.issues[] | select(.severity == "high")'

4 Prompt Templates Mới Cho 2026 Là Gì?

Bốn template phía dưới được tinh chỉnh cho hệ sinh thái Claude Code 2026 với hệ thống Claude Skills, quy trình Multi-Agent Orchestration, tính năng Outcomes, và dashboard Agent View. Khác với tám template phía trên thiên về single-shot prompt, bốn template này dành cho workflow dài hạn cộng nhiều phiên làm việc song song.

Template 9: Skill Invocation Prompt

Cú pháp: /<tên-skill> [ngữ cảnh cụ thể] với ràng buộc [X], output dưới dạng [Y]. Ví dụ thực tế: /graphify . focus on auth module với ràng buộc Python only, output dưới dạng markdown summary với 5 cluster chính. Mẹo: phần ngữ cảnh phải đủ cụ thể để skill chọn đúng nhánh xử lý, không quá rộng kiểu “phân tích toàn dự án” sẽ kích hoạt heuristic mặc định và đốt token vô ích cho khu vực không liên quan.

Template 10: Multi-Agent Orchestration Handoff

Cú pháp: Bạn là agent điều phối. Phân công ba sub-agent: (1) Explorer [mô tả], (2) Worker [mô tả], (3) Verifier [mô tả]. Mỗi sub-agent có quyền ghi riêng vào thư mục [X], không được vượt phạm vi. Kết quả integrated phải pass [checklist]. Pattern này áp dụng cho task lớn cần chia nhỏ song song, tránh được vấn đề agent giẫm chân nhau khi ghi file. Đọc thêm về sub-agents trong Claude Code để hiểu cú pháp chính thức.

Template 11: Outcomes Grading Prompt

Cú pháp: Đánh giá outcome lần chạy trước theo bốn tiêu chí: (1) Có đạt mục tiêu nguyên gốc không? (2) Có side effect không mong muốn nào? (3) Token consumption so với baseline? (4) Reproducibility điểm 1-5. Template này tận dụng tính năng Outcomes ra mắt tháng năm năm 2026, cho phép agent tự đánh giá mỗi lần chạy và học từ thất bại. Đọc Managed Agents với Dreaming và Outcomes để hiểu cơ chế đầy đủ.

Template 12: Agent View Dispatch Prompt

Cú pháp: claude --bg "[mô tả task] trong worktree [X], priority [Y], notify khi xong". Template này dispatch nhiệm vụ vào background session độc lập, hiển thị ngay trong Agent View dashboard với trạng thái alive. Mẹo: luôn chỉ định worktree cụ thể để tránh xung đột với phiên đang chạy ở terminal khác, và đặt notification để biết khi task hoàn tất mà không phải mở dashboard liên tục.

/effort Và Ultrathink: Khi Nào Dùng Mức Nào?

Claude Code hỗ trợ 4 mức effort thông qua slash commands, mỗi mức phù hợp với loại task khác nhau. Đặc biệt, từ khóa ultrathink kích hoạt thinking budget lên tới 31,999 token, nhưng chỉ nên dùng cho những quyết định kiến trúc thực sự quan trọng (Anthropic, 2025).

Lưu ý quan trọng: ultrathink chỉ hoạt động trong một turn, không duy trì qua nhiều vòng hội thoại. Dùng nó để lấy một phân tích sâu, sau đó làm việc dựa trên kết quả đó. Nếu bạn dùng ultrathink cho mọi task, bạn sẽ chậm và tốn kém mà không có lợi ích tương xứng.

# Sai: ultrathink cho task đơn giản
ultrathink: đổi màu button từ blue sang red

# Đúng: ultrathink cho quyết định kiến trúc
ultrathink: Phân tích trade-offs giữa event sourcing và CQRS
cho hệ thống payment với 100k transactions/ngày.
Context: @docs/current-architecture.md

CLAUDE.md Là Standing Prompt Hiệu Quả Nhất?

CLAUDE.md là file cấu hình được Claude Code đọc tự động khi khởi động session. Đây là cơ chế để bạn thiết lập “quy tắc của dự án” một lần, áp dụng mãi mãi mà không cần nhắc lại trong mỗi prompt. Tuy nhiên, file CLAUDE.md phình to là một trong những anti-pattern nguy hiểm nhất vì Claude sẽ bắt đầu bỏ qua những rule bị chôn vùi.

Nguyên tắc đơn giản nhất để quyết định thứ gì nên có trong CLAUDE.md: “Nếu xóa dòng này, Claude có tự làm sai không?” Nếu câu trả lời là “không”, hãy xóa nó.

Nên Đưa Vào CLAUDE.md

# CLAUDE.md - ví dụ tốt

## Lệnh thường dùng
npm run test:unit       # Chạy unit tests
npm run lint:fix        # Auto-fix ESLint
docker compose up -d    # Khởi động local env

## Code style
- TypeScript strict mode, no any
- Async/await, không dùng callback
- Test file đặt cùng thư mục với source

## Quy tắc commit
- Conventional commits (feat/fix/chore)
- Không commit trực tiếp vào main

## Đọc thêm
See @README.md for project overview
See @docs/architecture.md for system design

Không Nên Đưa Vào CLAUDE.md

# CLAUDE.md - ví dụ XẤU (đừng làm thế này)

# BAD: Claude tự đọc được từ code
- Dự án dùng React và TypeScript
- State management bằng Redux

# BAD: Convention chuẩn, không cần nhắc
- Tên hàm dùng camelCase
- Indent bằng 2 spaces

# BAD: Tutorial dài (dùng @imports thay thế)
Để setup project, đầu tiên bạn cần cài Node.js...
[500 chữ hướng dẫn mà Claude không cần]

Bạn có thể đọc thêm hướng dẫn chi tiết về CLAUDE.md là gì và cách cấu hình hiệu quả trong bài riêng về chủ đề này.

7 Anti-Patterns Phải Tránh Ngay?

Anthropic xác nhận những lỗi phổ biến này qua tài liệu chính thức và feedback từ developer community. Mỗi anti-pattern dưới đây đều có ví dụ BAD và GOOD để bạn so sánh trực tiếp, vì đọc ví dụ cụ thể giúp nhớ lâu hơn nhiều so với lý thuyết.

Anti-Pattern 1: Prompt Mơ Hồ, Không Có Location

Không có location, không có error message, không có repro steps, Claude phải đoán mò. Kết quả là Claude đọc rất nhiều file chỉ để tìm hiểu bạn đang nói về bug gì, tốn token vô ích và cho kết quả không chắc chắn.

Anti-Pattern 2: Tiêu Chí “Trông Đẹp Hơn” Không Đo Được

Anti-Pattern 3: Kitchen Sink Session

Context bẩn là nguyên nhân số 1 gây ra kết quả lạ trong Claude Code. Đọc thêm về cách tiết kiệm token Claude Code để quản lý context tốt hơn.

Anti-Pattern 4: Sửa Claude 3+ Lần Liên Tiếp

Sau 3 lần sửa mà Claude vẫn không hiểu đúng ý bạn, vấn đề thường là prompt ban đầu thiếu thông tin, không phải Claude “cứng đầu”. /clear và viết lại sẽ nhanh hơn nhiều so với tiếp tục cố gắng sửa trong session đã ô nhiễm.

Anti-Pattern 5: Hỏi Thay Vì Ra Lệnh

Anti-Pattern 6: CLAUDE.md Quá Dài

Anti-Pattern 7: Lạm Dụng Ultrathink

3 Anti-Pattern Mới Trong Kỷ Nguyên Multi-Agent Là Gì?

Bảy anti-pattern phía trên áp dụng cho single-shot prompt. Ba anti-pattern phía dưới phát sinh trong môi trường Multi-Agent Orchestration cộng background session, đặc biệt khi bạn vận hành nhiều phiên Claude song song trên nhiều dự án khách hàng.

Anti-Pattern 8: Shared Write Scope Giữa Các Sub-Agent

Để hai sub-agent cùng ghi vào một thư mục mà không có lock hoặc partition rõ ràng. Hậu quả: agent ghi đè kết quả của nhau, hoặc tệ hơn là tạo merge conflict ngẫu nhiên rất khó tái hiện. Cách tránh: mỗi sub-agent phải có write scope độc quyền được khai báo trong prompt khởi tạo, ví dụ Explorer chỉ đọc, Worker A ghi vào src/auth/, Worker B ghi vào src/payment/, hai vùng không giao nhau.

Anti-Pattern 9: Cài 20 Claude Skills Mà Không Audit Định Kỳ

Cài đặt toàn bộ Claude Skills bạn tìm thấy trên chợ rồi không bao giờ kiểm tra lại. Theo bài kiểm tra trên r/ClaudeCode kéo dài 30 ngày, 80 phần trăm kỹ năng được cài không bao giờ được gọi, đốt khoảng 500 ngàn token siêu dữ liệu mỗi tháng cho mục đích vô ích. Cách tránh: cài 5 đến 10 kỹ năng thật sự dùng hằng ngày, kiểm tra lại mỗi quý qua lệnh /skill audit, xoá kỹ năng không khớp với quy trình hiện tại. Tham khảo bộ tuyển chọn tại Top 20 Claude Skills 2026.

Anti-Pattern 10: Bật /loop Tần Suất Cao Không Có Budget Guard

Lập lịch cron với /loop every 1 minute cho task không thực sự cần realtime. Hậu quả: quota tuần bị đốt hết trong vài tiếng đầu, các nhiệm vụ quan trọng còn lại bị từ chối. Cách tránh: đặt mức trần ngân sách thông qua /budget set weekly $X trước khi kích hoạt cron tần suất cao, hoặc dùng tần suất thấp hơn như mỗi 5 đến 15 phút cho task không khẩn cấp. Đọc thêm Claude Code Routines workflow để biết cách thiết lập budget guardrail đầy đủ.

9 Khái Niệm Nền Tảng Nào Mỗi Developer Cần Nắm Trước Khi Viết Prompt?

Trước khi đi sâu vào template và anti-pattern, mình tổng hợp chín khái niệm nền tảng mà mọi lập trình viên cần hiểu vững khi làm việc với prompt engineering. Đây là vocabulary cốt lõi giúp bạn không bị bối rối khi đọc tài liệu kỹ thuật của Anthropic, OpenAI, hoặc bất kỳ vendor LLM nào khác. Hiểu rõ chín khái niệm này tiết kiệm hàng giờ debug khi prompt cho ra kết quả không mong muốn trong môi trường sản xuất.

Một, Large Language Model là gì. LLM là mô hình ngôn ngữ lớn đứng sau Claude, GPT, Gemini, và mọi trợ lý AI hiện đại. Hiểu cách LLM hoạt động (dự đoán token kế tiếp theo xác suất) là điều kiện tiên quyết để viết prompt hiệu quả, vì bạn cần biết model đang nghĩ gì khi nhận input của bạn. Chín khái niệm dưới đây đều là thuộc tính hoặc kỹ thuật xoay quanh cơ chế nền tảng này.

Hai, Token là đơn vị xử lý. Token là đơn vị nhỏ nhất mà LLM xử lý, một câu tiếng Việt thường chia thành sáu đến mười token tùy tokenizer. API tính phí theo token nên hiểu cơ chế này giúp tiết kiệm chi phí đáng kể khi build sản phẩm. Tiếng Việt tốn nhiều token hơn tiếng Anh khoảng hai lần do encoding ký tự có dấu phức tạp hơn.

Ba, Context window giới hạn bộ nhớ. Context window là độ dài tối đa của input cộng output mà model xử lý trong một lần gọi. Claude Opus 4.7 hỗ trợ một triệu token, Grok 4.1 hai triệu, Llama 4 Scout mười triệu. Vượt quá ngưỡng này thì model quên đầu cuộc hội thoại hoặc cắt mất thông tin quan trọng, gây lỗi khó debug.

Bốn, Temperature kiểm soát độ ngẫu nhiên. Temperature thấp khoảng không phẩy hai đến không phẩy ba cho output ổn định, phù hợp viết code và trả lời factual. Temperature cao khoảng không phẩy bảy đến một cho output đa dạng, phù hợp brainstorm và viết sáng tạo. Hầu hết API mặc định không phẩy bảy nhưng cho code thì giảm xuống không phẩy hai sẽ ổn định hơn nhiều.

Năm, System prompt định nghĩa vai trò. System prompt là phần hướng dẫn được đặt ở đầu hội thoại, định nghĩa vai trò và quy tắc hành xử của LLM. Ví dụ điển hình “Bạn là chuyên gia DevOps, trả lời ngắn gọn bằng tiếng Việt, không dùng jargon nếu không cần thiết”. System prompt áp dụng cho toàn bộ phiên làm việc và có trọng số cao hơn user prompt. Đây là kỹ thuật quan trọng nhất khi build chatbot doanh nghiệp.

Sáu, Zero-shot và Few-shot Learning. Zero-shot là yêu cầu LLM giải bài toán trực tiếp không kèm ví dụ mẫu. Few-shot là cung cấp hai đến năm ví dụ trước khi đưa bài toán thực, giúp model hiểu pattern mong muốn. Few-shot thường cho kết quả tốt hơn hai mươi đến bốn mươi phần trăm nhưng tốn nhiều token hơn. Biết cách chọn giữa hai pattern này tiết kiệm đáng kể chi phí khi gọi API ở quy mô lớn hằng ngày.

Bảy, Chain-of-Thought (CoT). Chain-of-Thought là kỹ thuật prompt khuyến khích LLM suy nghĩ ra giấy trước khi đưa ra câu trả lời cuối cùng. Khi thêm câu “Hãy suy nghĩ từng bước trước khi trả lời” vào prompt, độ chính xác trên các bài toán logic phức tạp tăng từ ba mươi bốn mươi phần trăm lên bảy mươi tám mươi phần trăm. Claude Opus 4.7 và GPT-5.4 đều có chế độ reasoning tích hợp sẵn dùng CoT làm mặc định cho mọi tác vụ.

Tám, Prompt caching giảm chi phí lặp lại. Anthropic và OpenAI hỗ trợ kỹ thuật caching để giảm chi phí cho prompt lặp lại nhiều lần. Khi bật caching, phần system prompt và context tĩnh được lưu vào bộ nhớ tạm của hãng, lần gọi sau chỉ tính phí phần thay đổi. DeepSeek V3.2 giảm tới chín mươi phần trăm chi phí với caching. Đây là kỹ thuật quan trọng nhất khi build chatbot có lưu lượng truy cập lớn hằng ngày.

Chín, Context engineering quản lý toàn bộ ngữ cảnh. Context engineering là nghệ thuật thiết kế context window hiệu quả cho LLM. Khác với prompt engineering tập trung vào câu lệnh, context engineering quản lý toàn bộ thông tin model thấy mỗi lần inference gồm system prompt, lịch sử hội thoại, tài liệu tham khảo, kết quả tool call. Context engineering tốt là kỹ năng phân biệt developer làm AI hời hợt với chuyên gia thực thụ trong giai đoạn 2026-2027.

Chín khái niệm trên là vocabulary tối thiểu mà mọi lập trình viên làm việc với prompt engineering cần thuộc lòng. Đầu tư hai đến ba ngày đọc kỹ từng khái niệm và áp dụng vào dự án thực tế của mình sẽ tiết kiệm hàng tuần thử và sai khi prompt cho ra kết quả không mong đợi trong tương lai. Khi đã nắm vững nền tảng, các template và anti-pattern trong các phần kế tiếp của bài viết sẽ trở nên trực giác hơn nhiều.

Code with Claude London 5/2026: Cập Nhật Prompt Engineering Cho Developer

Sự kiện Code with Claude tại London ngày mười chín và hai mươi tháng năm năm 2026 mang đến nhiều thay đổi quan trọng trong cách Anthropic định hướng prompt engineering cho cộng đồng developer toàn cầu. Ba điểm cập nhật đáng chú ý nhất cho người dùng làm việc với Claude Code hằng ngày trong giai đoạn hiện tại.

Một, Karpathy Gia Nhập Anthropic Trước Sự Kiện

Andrej Karpathy, cựu thành viên sáng lập OpenAI và là người đặt ra thuật ngữ vibe coding đầu năm 2025, chính thức gia nhập Anthropic ngay trước thềm Code with Claude London. Karpathy là chuyên gia hàng đầu thế giới về Transformer và prompt engineering, có ảnh hưởng lớn đến cách cộng đồng tiếp cận viết prompt cho LLM. Sự gia nhập này hứa hẹn nhiều tài liệu chất lượng cao từ chính Karpathy về kỹ thuật viết prompt hiệu quả trong sáu đến mười hai tháng tới, đặc biệt là các pattern reasoning chain dài phù hợp với mô hình Opus 4.7.

Hai, Pattern Vibe Coding Trở Thành Chính Thống

Boris Cherny, creator của Claude Code, xác nhận trên sân khấu sự kiện rằng toàn bộ phần mềm Claude Cowork được Claude Code tự generate qua pattern vibe coding trong dưới hai tuần. Pattern này dựa trên việc viết spec rõ ràng kết hợp với reasoning chain dài, không phải là cách prompt tùy hứng như nhiều người hiểu lầm. Đây là sự xác nhận quan trọng cho cộng đồng developer rằng kỹ thuật viết prompt theo intent với spec rõ ràng đang trở thành chuẩn mực mới trong ngành phát triển phần mềm. Lập trình viên không nắm vững prompt engineering theo hướng intent-driven sẽ bị tụt hậu so với đồng nghiệp đã quen pattern này trong vòng mười hai đến mười tám tháng tới.

Ba, Skills Marketplace Chính Thức Mở Cho Cộng Đồng

Anthropic công bố Skills Marketplace là kho tập trung các kỹ năng prompt được kiểm duyệt chất lượng do chính đội ngũ Anthropic và đối tác công nghệ phát triển. Mỗi skill là gói prompt template tái sử dụng được, đóng gói toàn bộ best practice cho một tác vụ cụ thể như viết test, refactor code, sinh tài liệu kỹ thuật. Developer Việt Nam có thể tìm và cài skill phù hợp công việc trong vài giây qua giao diện tìm kiếm theo danh mục công việc cụ thể, thay vì phải lội qua hàng nghìn repo GitHub khác nhau như trước đây. Đây là bước tiến quan trọng cho việc chuẩn hóa và chia sẻ kiến thức prompt engineering trong cộng đồng toàn cầu.

Câu Hỏi Thường Gặp

Prompt Cho Claude Skills Có Khác Prompt Thường Không?

Có khác. Prompt thường gọi Claude trực tiếp với toàn bộ ngữ cảnh, còn prompt cho Claude Skills dùng cú pháp /<tên-skill> để kích hoạt kỹ năng đã được mã hoá sẵn, Claude tự nạp chỉ dẫn từ tệp SKILL.md cộng phần khai báo YAML rồi xử lý theo nhánh tương ứng. Lợi ích: tiết kiệm token vì không phải viết lại bối cảnh dài, kết quả nhất quán giữa các lần gọi, và dễ chia sẻ với đồng đội qua chợ marketplace nội bộ.

Multi-Agent Có Đắt Hơn Single-Agent Không?

Có, mỗi sub-agent là một phiên Claude độc lập tốn token riêng. Tuy nhiên với task lớn cần chia nhỏ song song, multi-agent thường hoàn thành nhanh hơn 2 đến 3 lần so với single-agent xử lý tuần tự, đổi lại bằng việc đốt token nhiều hơn khoảng 1.5 đến 2 lần. Quy tắc kinh nghiệm: dùng multi-agent khi task có ba nhánh trở lên có thể chạy song song và độc lập về write scope, dùng single-agent khi task tuần tự hoặc chỉ có một hai nhánh.

Làm sao biết prompt của mình có đủ context chưa?

Kiểm tra bằng cách đọc lại prompt như thể bạn là một người mới hoàn toàn không biết dự án. Nếu bạn cần hỏi thêm để hiểu yêu cầu, Claude cũng sẽ thiếu thông tin tương tự. Prompt tốt cần có: file/function cụ thể, expected behavior, và điều kiện hoàn thành đo được.

Khi nào nên dùng @file reference thay vì paste code trực tiếp?

Luôn dùng @file thay vì paste code khi file đó tồn tại trong dự án. Lý do: Claude Code đọc file theo context thật, hiểu được imports và dependencies xung quanh. Paste code trực tiếp làm mất context, Claude phân tích đoạn code như một đảo cô lập.

Plan Mode có làm chậm workflow không?

Với task đơn giản, Plan Mode là overhead không cần thiết. Với task phức tạp (nhiều file, logic liên kết), Plan Mode thực ra nhanh hơn vì tránh được nhiều vòng sửa lỗi sau khi code đã được viết sai hướng. Quy tắc thực tế: task có thể mô tả trong một câu ngắn thì skip Plan Mode.

Có thể dùng nhiều CLAUDE.md trong cùng một dự án không?

Có. Claude Code đọc CLAUDE.md theo hierarchy: root CLAUDE.md cho toàn dự án, và CLAUDE.md trong thư mục con cho context cụ thể hơn. Đây là cách hữu ích để giữ CLAUDE.md gọn nhẹ: rules chung ở root, rules đặc thù (ví dụ: backend, frontend) ở thư mục con tương ứng.

Tại sao Claude đôi khi làm trái yêu cầu trong CLAUDE.md?

Nguyên nhân phổ biến nhất là CLAUDE.md quá dài, khiến rule bị “chôn vùi” trong context. Rule quan trọng nên đặt gần đầu file và viết ngắn gọn. Rule phức tạp nên tách ra file riêng rồi dùng See @path/to/rule.md trong CLAUDE.md. Mình thấy file dưới 50 dòng hiệu quả nhất.

Nên dùng /effort level trong prompt hay trong CLAUDE.md?

Trong prompt, không trong CLAUDE.md. Mức effort phụ thuộc vào từng task cụ thể, không phải toàn bộ dự án. Đặt effort level cố định trong CLAUDE.md sẽ gây lãng phí (dùng /effort max cho mọi thứ) hoặc kết quả kém chất lượng (dùng /effort low cho task phức tạp).

Claude Code có hiểu tiếng Việt trong prompt không?

Có, Claude hiểu tiếng Việt tốt. Tuy nhiên, trong môi trường technical, mình khuyến khích dùng tiếng Anh cho tên file, function, và command, còn tiếng Việt cho mô tả business logic và requirements. Điều này giúp tránh nhầm lẫn khi Claude tìm kiếm trong codebase.

Kết Luận

Prompt engineering cho Claude Code không phải nghệ thuật bí ẩn. Nó là kỹ năng thực tế: giao việc rõ ràng, chọn đúng công cụ, tránh những lỗi đã được đặt tên. Bốn điểm cốt lõi bạn có thể áp dụng ngay hôm nay:

• 4-phase workflow cho task phức tạp: Explore, Plan, Implement, Commit. Đừng bỏ qua bước Plan.
• 8 templates thực tế đủ cho 90% tình huống hàng ngày. Không cần phát minh lại từ đầu.
• Chọn đúng /effort level. Ultrathink là công cụ mạnh, dùng đúng chỗ.
• CLAUDE.md gọn là CLAUDE.md hiệu quả. Nguyên tắc “xóa đi Claude có làm sai không?”

Mình sẽ tiếp tục cập nhật khi Anthropic ra thêm tính năng mới. Nếu bạn chưa cài Claude Code, xem hướng dẫn cài đặt từng bước cho mọi hệ điều hành trước khi thực hành. Đã nắm prompt engineering rồi? Bước tiếp theo là Claude Code skills, nơi bạn đóng gói prompt patterns thành file tái sử dụng. Nếu bạn có template nào hay hoặc anti-pattern nào mình chưa đề cập, để lại comment bên dưới nhé.

Bài tiếp theo bạn có thể đọc là tổng hợp đầy đủ về slash commands trong Claude Code, bao gồm cả những lệnh ít người biết đến. Tham khảo roadmap đầy đủ để chọn learning path phù hợp.