10 sai lầm người mới hay mắc khi dùng Claude Code và cách tránh ngay

Định nghĩa

10 sai lầm người mới hay mắc khi dùng Claude Code là những anti-pattern phổ biến trong quá trình tự động hóa công việc hàng ngày — từ việc tin tưởng mù quáng vào AI đến việc quản lý context kém hiệu quả — khiến người dùng lãng phí token, mất dữ liệu quan trọng, hoặc tạo ra workflow không bền vững. Những lỗi này đặc biệt nguy hiểm trong các tác vụ không cần code như dọn file, phân tích CSV sao kê ngân hàng, hoặc quản lý dữ liệu cá nhân, nơi một lệnh sai có thể xóa sạch thư mục Downloads chứa hóa đơn điện tử Shopee/Lazada hoặc làm hỏng file Excel chi tiêu cả năm.

Giải thích chi tiết

Sai lầm về An toàn và Phân quyền

Tin tưởng mù quáng Auto Mode cho tác vụ destructive

Auto Mode (--permission-mode auto) cho phép Claude tự quyết định thực thi lệnh mà không hỏi lại, sử dụng safety classifier để chặn lệnh nguy hiểm. Tuy nhiên, người mới thường bật Auto Mode cho cả việc dọn file hàng loạt hoặc xóa dữ liệu, dẫn đến việc Claude có thể xóa nhầm file quan trọng nếu prompt mơ hồ. Safety classifier không phải lúc nào cũng hiểu được ngữ cảnh file cá nhân — nó có thể cho phép rm -rf ./temp mà không biết đó là thư mục chứa ảnh chụp màn hình chuyển khoản VietQR bạn vừa di chuyển vào.

Dùng sai Permission Mode: Bypass thay vì AcceptEdits

Người mới thường dùng bypassPermissions để "cho nhanh" khi làm việc với file cá nhân, hoặc ngược lại, để nguyên default mode rồi bị ngắt quãng bởi hàng chục prompt xác nhận cho tác vụ đơn giản. Cách đúng là dùng acceptEdits cho workflow hàng ngày — vừa cho phép Claude tự chỉnh sửa file, vừa hiển thị diff để bạn review nhanh trước khi apply, tránh được cả "click chuột mỏi tay" lẫn "oops mất file".

Không cấu hình PreToolUse Hooks cho batch operations

Khi xử lý hàng trăm file (đổi tên ảnh, dọn Downloads), người mới thường bỏ qua việc cài đặt hooks để chặn lệnh nguy hiểm. Một lệnh mv sai pattern có thể ghi đè file quan trọng. PreToolUse hooks là lớp bảo vệ deterministic — dùng regex để chặn các pattern như rm -rf, > /dev/null, hoặc xóa file có extension .docx hoặc .pdf — đảm bảo Claude không thể vượt qua bằng cách "thuyết phục" bằng ngôn ngữ tự nhiên.

Sai lầm về Quản lý Context và Memory

Bỏ qua CLAUDE.md cho task lặp lại

Người mới bắt đầu mỗi session như một tờ giấy trắng, lặp lại việc giải thích "tôi thích đặt tên file theo định dạng YYYY-MM-DD", "đừng xóa file có từ 'hóa đơn' trong tên", hoặc "luôn xuất CSV ra UTF-8 với BOM cho Excel đọc được". Điều này tốn token và dễ sai sót. CLAUDE.md là "bộ não thứ hai" — lưu quy tắc đặt tên file, cấu trúc thư mục, và preference cá nhân, giúp Claude nhớ mọi thứ qua các session.

"Đổ rác" vào Context Window thay vì dùng MCP

Khi phân tích CSV sao kê ngân hàng lớn hoặc quản lý file, người mới thường paste toàn bộ nội dung file vào chat (ví dụ: "đây là 500 dòng chi tiêu của tôi"), hit ngay context limit 200K tokens. Cách đúng là dùng MCP Filesystem hoặc MCP Database — Claude query file qua tool thay vì đọc toàn bộ nội dung, giảm token consumption tới 98.7% và cho phép xử lý file lớn hơn bộ nhớ RAM.

Không tạo Checkpoint trước automation phức tạp

Người mới thường chạy /batch hoặc /loop để xử lý file hàng loạt mà không tạo checkpoint (/checkpoint hoặc commit git). Khi Claude làm sai (ví dụ: đổi tên sai pattern, xóa nhầm file), họ phải sửa thủ công từng file hoặc restore từ backup. Checkpoint cho phép /rewind về trạng thái trước khi chạy automation, cứu vãn hàng giờ làm thủ công.

Sai lầm về Workflow và Prompt

Prompt mơ hồ cho task cụ thể

Thay vì nói "dọn thư mục Downloads đi", người mới cần mô tả cụ thể rule: "Di chuyển file .jpg vào ~/Pictures/YYYY/MM/, xóa file .tmp cũ hơn 30 ngày, giữ nguyên file có từ 'invoice', 'hóa đơn' hoặc 'receipt'". Prompt mơ hồ khiến Claude đoán ý đồ, dẫn đến kết quả không nhất quán giữa các lần chạy. Dùng Planning Mode (/plan) để Claude outline kế hoạch trước khi thực thi, giúp phát hiện hiểu nhầm sớm.

Không validate kết quả đầu ra

Sau khi Claude báo "đã xong", người mới thường tin luôn mà không kiểm tra. Trong phân tích CSV, Claude có thể đã hiểu sai định dạng ngày tháng (MM/DD vs DD/MM — rất phổ biến với sao kê ngân hàng Việt Nam), tính sai công thức, hoặc bỏ sót dòng dữ liệu. Luôn dùng PostToolUse hooks để auto-verify (ví dụ: chạy wc -l kiểm tra số dòng, hoặc md5sum so sánh hash trước/sau), hoặc ít nhất cũng mở file kiểm tra bằng lệnh head trước khi chấp nhận kết quả.

Vibe coding không hiểu logic (đặc biệt nguy hiểm với dữ liệu)

Người mới dùng Claude để "vibe code" script xử lý file, thấy chạy được là vui, nhưng không hiểu logic bên trong. Khi script fail với edge case (ví dụ: filename có dấu tiếng Việt không dấu hoặc có dấu, hoặc CSV có cell chứa newline), họ không biết debug vì không hiểu code sinh ra. Với dữ liệu quan trọng (tài chính, hợp đồng), đây là rủi ro lớn — luôn yêu cầu Claude giải thích từng bước logic trước khi chạy.

Sai lầm về Hiệu năng và Chi phí

Lạm dụng Subagents cho task đơn giản

Thấy subagents hay, người mới spawn agent riêng cho mỗi file nhỏ (ví dụ: 1 agent đổi tên mỗi ảnh), tạo overhead latency và tốn token không cần thiết. Subagents sinh ra để cô lập context cho task phức tạp (security audit, refactoring lớn), không phải để đổi tên 10 file ảnh. Với task đơn giản, dùng bash script sinh ra bởi Claude trong 1 turn là đủ, không cần delegation.

Ví dụ thực tế

Dọn Downloads folder thành thảm họa

Tình huống: User yêu cầu "dọn thư mục Downloads cho gọn", không dùng CLAUDE.md, không checkpoint, Auto Mode bật. Claude quyết định xóa tất cả file cũ hơn 30 ngày, bao gồm cả file hợp đồng thuê nhà PDF và hóa đơn điện tử Shopee quan trọng user vừa tải về 25 ngày trước nhưng chưa đọc.

Cách tránh:

• Tạo CLAUDE.md với rule: "Never delete .pdf, .docx, or files with 'contract', 'invoice', 'hóa đơn', 'tax' in name"
• Dùng plan mode: Claude liệt kê "tôi sẽ xóa 47 file, giữ 12 file" trước khi thực hiện
• Tạo checkpoint: git init && git add . && git commit -m "before cleanup" hoặc dùng /checkpoint
• Dùng PreToolUse hook chặn rm hoàn toàn, chỉ cho phép mv vào thư mục trash tạm thời

Phân tích CSV sao kê ngân hàng 50MB bị "ngốn" token

Tình huống: User paste toàn bộ file CSV sao kê Vietcombank/TPBank 3 năm (50MB) vào chat để "phân tích chi tiêu". Context window đầy ngay lập tức, Claude không thể xử lý, hoặc phải cắt bớt dữ liệu dẫn đến thiếu tháng 12/2023 — tháng chi tiêu cao nhất (Tết Dương lịch).

Cách tránh:

• Cài MCP SQLite: claude mcp add sqlite -- npx @modelcontextprotocol/server-sqlite
• Load CSV vào SQLite local: Claude tự tạo bảng, import data qua tool
• Query qua SQL: SELECT category, SUM(amount) FROM expenses GROUP BY category — chỉ kết quả aggregate vào context, không phải toàn bộ 50MB raw data
• Chi phí giảm từ 5 USD (với Opus) xuống dưới 0.1 USD

/loop dọn file chạy sai lệch

Tình huống: User tạo /loop 1h /clean-downloads để tự động dọn file mỗi giờ, nhưng script có bug logic: nó xóa file có extension .tmp nhưng lại match cả file .template (vì dùng pattern *.tmp* thay vì *.tmp). Sau 1 tuần, toàn bộ template báo cáo công việc biến mất.

Cách tránh:

• Test thủ công 1 lần trước khi schedule: Chạy script 1 lần, kiểm tra kỹ output
• Dùng PostToolUse hook log mọi file đã xóa vào deleted-files.log
• Chỉ schedule task "an toàn" (read-only hoặc move vào trash), không schedule task xóa permanent
• Dùng subagent "Safety Reviewer" kiểm tra script trước khi cho vào loop

Ứng dụng

Người dùng không biết code (Non-coders)

Tập trung vào sai lầm về prompt mơ hồ, không validate kết quả, và vibe coding không hiểu logic. Với người dùng này, Claude Code là công cụ đa năng như máy giặt — họ cần checklist đơn giản trước khi nhấn nút "Chạy". Luôn dùng Planning Mode để Claude "dịch" yêu cầu tiếng Việt thành các bước cụ thể, và yêu cầu giải thích bằng tiếng Việt trước khi thực thi.

Developer và Data Analyst

Tập trung vào sai lầm về bỏ qua hooks, không dùng MCP, lạm dụng subagents. Với kỹ thuật viên, nguy cơ lớn nhất là over-engineering — dùng công nghệ phức tạp cho bài toán đơn giản. Nên áp dụng nguyên tắc: Nếu task xử lý file chỉ chạy 1 lần, dùng bash script đơn giản; chỉ dùng subagents và complex orchestration khi thực sự cần xử lý song song hoặc cô lập context nguy hiểm (ví dụ: chạy code untrusted).

Team và Doanh nghiệp

Tập trung vào sai lầm về Auto Mode không kiểm soát, permission sai, và không checkpoint. Trong môi trường enterprise, cần thiết lập Managed Settings qua plist/Registry để ép buộc permission mode acceptEdits hoặc plan, không cho phép bypassPermissions. Bắt buộc sử dụng CLAUDE.md chia sẻ trong team để đảm bảo automation nhất quán, và tích hợp hooks với SIEM để log mọi thao tác file cho audit trail.

So sánh

Kết luận: Sự khác biệt chính giữa người mới và pro không nằm ở việc biết nhiều lệnh, mà ở việc thiết lập guardrails — luôn có checkpoint để rollback, luôn có hooks để chặn lỗi, và luôn validate trước khi chấp nhận kết quả.

Bài viết liên quan

Cùng cụm (everyday-uses)

• Tự động dọn file, đổi tên, sắp xếp ảnh bằng Claude — Workflow cụ thể để tránh sai lầm về Auto Mode và permission
• Dọn dữ liệu CSV: Chuẩn hoá, loại trùng, phân tích — Ứng dụng đúng cách MCP để tránh lỗi "đổ rác" vào context
• 30+ use case không cần code: Tài chính, pháp lý, tự động hoá — Tình huống thực tế để áp dụng các nguyên tắc an toàn
• Prompt engineering cho Claude Code: Hỏi đúng để được đúng — Cách viết prompt cụ thể để tránh sai lầm về mơ hồ

Đọc tiếp (level-4/pro-automation)

• Tự động Code Review với /loop và GitHub Actions — Cách dùng /loop an toàn trong CI/CD
• Tích hợp Claude Code vào CI/CD pipeline — Thiết lập Headless Mode và permission tự động cho enterprise
• Cost Optimization: Token, session, khi nào dùng Sonnet vs Opus — Chiến lược tối ưu chi phí để tránh lãng phí token như lỗi lạm dụng subagents