# Giao việc cho Claude Code rõ ràng: file, hành vi, kết quả để bớt bị hiểu sai

> Để Claude Code bớt hiểu sai, mỗi yêu cầu cần ba mảnh: file liên quan, hành vi cần xử lý và kết quả mong đợi. Thêm một câu giới hạn phạm vi sửa, rồi vẫn phải kiểm tra lại kết quả. Cứ coi Claude Code như đồng nghiệp mới cần được trao đủ bối cảnh.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Claude Code
- Đăng: 2026-06-02 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/giao-viec-cho-claude-code-bot-hieu-sai

Muốn Claude Code làm đúng ý, bạn cần nói rõ ba thứ: file nào, hành vi nào cần xử lý, và kết quả cuối cùng trông như thế nào. Thiếu một trong ba, công cụ sẽ phải tự đoán. Đoán đúng thì may, đoán lệch thì bạn mất thời gian đọc lại và sửa lại.

Điều này quan trọng hơn với Claude Code so với chat thông thường. Claude Code chạy trong terminal, đọc được thư mục dự án, sửa nhiều file, chạy lệnh và chạy test, rồi sửa tiếp dựa trên kết quả. Nó không chỉ trả lời, nó thao tác trực tiếp lên code của bạn. Một yêu cầu mơ hồ vì thế có thể kéo theo một loạt thay đổi bạn không hề định nhờ.

Bài này đi sâu hơn video ngắn bên dưới: vì sao yêu cầu chung chung hay sinh ra hiểu lệch, ba mảnh thông tin cần có, cách đưa file vào ngữ cảnh, cách giới hạn phạm vi, và những chỗ bạn vẫn phải tự kiểm tra. Đây là một tập trong series giao việc rõ, kiểm tra kỹ. Việc đọc lại thay đổi trước khi commit sẽ có tập riêng, nên ở đây mình chỉ nhắc ngắn.

```video
- youtube | https://youtube.com/shorts/_CUnERLvwJk
- title | Giao việc cho Claude Code để bớt bị hiểu sai
```

## Vì sao yêu cầu chung chung hay bị hiểu lệch

### Công cụ làm được việc thật thì hiểu lệch có giá thật

Khi bạn hỏi một chatbot “form đăng ký nên kiểm tra email thế nào”, câu trả lời sai chỉ tốn vài giây đọc. Khi bạn nói với Claude Code “sửa nút Gửi trong form”, nó có thể mở thư mục, tìm file, sửa và chạy thử. Cái giá của một lần hiểu lệch lúc này là một bản sửa sai chỗ nằm sẵn trong dự án của bạn.

Ví dụ trong video: bạn giao “sửa nút Gửi trong form.js”. Nghe như đủ ý, nhưng thử hỏi lại: sửa theo hướng nào? Nút không bấm được? Nút bấm xong không gửi? Nút gửi hai lần? Công cụ không ở trong đầu bạn. Nó chỉ có chữ bạn viết và những gì nó đọc được trong dự án. Chỗ trống giữa hai thứ đó, nó phải lấp bằng suy đoán.

### Suy đoán không phải lỗi, mà là cách nó hoạt động

Mô hình ngôn ngữ giỏi lấp chỗ trống bằng điều có vẻ hợp lý nhất. Với yêu cầu “sửa nút Gửi”, điều hợp lý nhất có thể là một thay đổi khác hẳn điều bạn đang bực mình. Nó không “lười” hay “cãi”. Nó đang làm đúng việc của nó: hoàn thành yêu cầu với thông tin có sẵn.

Vì vậy, cách nghĩ hữu ích là xem Claude Code như một đồng nghiệp mới. Người đó thông minh, làm nhanh, nhưng hôm nay mới vào dự án. Bạn sẽ không nói với họ “sửa cái nút đi” rồi đi họp. Bạn sẽ chỉ file, nói cái gì đang sai, và nói làm xong thì trông thế nào. Với Claude Code, cũng cần như vậy.

### Ba mảnh ghép của một yêu cầu rõ

Theo dữ kiện trong tập này, một yêu cầu rõ cần chỉ ra:

- **File liên quan:** công cụ biết bắt đầu đọc từ đâu, khỏi phải lục cả dự án để đoán.
- **Hành vi cần xử lý:** tình huống cụ thể đang có vấn đề. Ví dụ “khi bấm Gửi mà ô email đang trống”.
- **Kết quả mong đợi:** thứ bạn dùng để biết việc đã xong. Ví dụ “hiện thông báo, không gửi biểu mẫu”.

Mảnh thứ ba hay bị bỏ quên nhất, và cũng là mảnh đáng giá nhất. Nó biến “làm xong” từ cảm giác thành thứ bạn kiểm tra được. Không có nó, bạn chỉ có thể nhìn đoạn code mới và tự hỏi “chắc là được nhỉ?”.

### Ngữ cảnh khác với phạm vi

Có một điểm một trang tin tức ở cảnh cuối video: nhắc tên file không đồng nghĩa với giới hạn phạm vi sửa. Bạn đưa form.js vào cuộc trò chuyện là cho công cụ biết nên đọc gì. Nhưng nó vẫn có thể sửa thêm file khác nếu thấy cần. Muốn nó dừng lại ở đâu, bạn phải nói thẳng. Ví dụ: “Chỉ sửa form.js; nếu cần sửa file khác, hãy hỏi trước.”

Hai thứ này là hai việc khác nhau: ngữ cảnh là “nhìn vào đâu”, phạm vi là “được chạm vào đâu”. Gộp chúng làm một là nguồn gốc của nhiều lần “sao nó sửa cả file này?”.

## Làm thế nào

```steps
- Mở đúng thư mục | Gõ claude trong thư mục dự án để công cụ làm việc trên đúng dự án
- Chọn file bằng @ | Gõ @ rồi chọn file từ gợi ý để đưa nội dung file vào ngữ cảnh
- Nêu hành vi | Viết tình huống cụ thể cần xử lý, không chỉ nói “sửa lỗi”
- Chốt kết quả | Ghi điều bạn sẽ dùng để kiểm tra khi việc xong
- Giới hạn phạm vi | Nói rõ được sửa file nào, file khác thì hỏi trước
- Kiểm tra lại | Tự chạy thử tình huống và đọc lại thay đổi
```

### Đưa file vào ngữ cảnh bằng @

Trong Claude Code, bạn gõ ký tự @ rồi chọn file từ danh sách gợi ý, ví dụ @form.js. Theo video, cách này đưa nội dung file vào ngữ cảnh. Công cụ khỏi phải tự tìm xem “form.js” nằm ở đâu, và khỏi nhầm với một file trùng tên ở thư mục khác.

Mẹo nhỏ: nếu việc liên quan đến hai file, ví dụ file giao diện và file kiểm tra dữ liệu, hãy nhắc cả hai. Đừng nhắc nửa chừng rồi hy vọng nó tự tìm nốt.

### Viết hành vi như kể một tình huống

Hãy mô tả hành vi theo kiểu “khi... thì...”. So sánh hai câu:

```text
Sửa nút Gửi trong @form.js
```

```text
Trong @form.js, khi người dùng bấm Gửi mà ô email đang trống thì hiện tại biểu mẫu vẫn được gửi đi. Hãy xử lý trường hợp này.
```

Câu thứ hai cho công cụ biết lỗi nằm ở đâu và trong điều kiện nào. Bạn cũng không cần viết dài. Chỉ cần đủ để một người lạ đọc xong biết bạn đang nói về chuyện gì.

### Chốt kết quả mong đợi

Đây là mảnh cuối trong video. Một câu kết quả tốt có hai tính chất: cụ thể và kiểm tra được bằng mắt hoặc bằng lệnh. “Email trống thì hiện thông báo, không gửi biểu mẫu” có tới hai điều để kiểm: thông báo có hiện không, và biểu mẫu có thực sự không đi không. “Làm cho form chạy tốt hơn” thì không kiểm được điều gì.

### Giới hạn phạm vi và để nó hỏi lại

Thêm một câu như “Chỉ sửa form.js; nếu cần sửa file khác, hãy hỏi trước.” Câu này làm hai việc: giữ thay đổi gọn, và biến một quyết định lớn thành một câu hỏi bạn được trả lời. Nếu công cụ hỏi “mình cần sửa thêm file kiểm tra dữ liệu, được không?”, bạn có cơ hội cân nhắc thay vì nhìn thấy nó đã sửa xong.

Lưu ý đúng như video nhắn: đây là yêu cầu, không phải rào chắn kỹ thuật tuyệt đối. Bạn vẫn cần kiểm tra xem công cụ có tuân thủ không.

### Gộp lại thành một câu giao việc hoàn chỉnh

```text
Trong @form.js, khi người dùng bấm Gửi mà ô email đang trống thì biểu mẫu vẫn được gửi.
Kết quả mong đợi: email trống thì hiện thông báo, không gửi biểu mẫu.
Chỉ sửa form.js; nếu cần sửa file khác, hãy hỏi trước.
```

Ba dòng, đủ ba mảnh, cộng thêm một câu phạm vi. Mất chưa tới một phút viết, và tiết kiệm nhiều lần sửa đi sửa lại.

## Dùng vào việc thật

### Chủ shop nhỏ: form đặt hàng bỏ trống số điện thoại

Chị Lan bán đồ handmade, có một trang đặt hàng đơn giản do người quen dựng. Gần đây đơn về thiếu số điện thoại, chị không gọi xác nhận được. Chị mở Claude Code trong thư mục trang web và giao việc như sau:

```text
Trong @dat-hang.js, khi khách bấm “Đặt hàng” mà ô số điện thoại đang trống thì đơn vẫn được gửi đi.
Kết quả mong đợi: ô số điện thoại trống thì hiện dòng chữ đỏ “Vui lòng nhập số điện thoại” ngay dưới ô đó, và đơn không được gửi.
Chỉ sửa dat-hang.js; nếu cần sửa file khác, hãy hỏi trước.
Sửa xong hãy cho mình biết bạn đã thay đổi những dòng nào.
```

Kết quả bạn nhận được: một đoạn kiểm tra thêm vào xử lý nút đặt hàng, kèm lời tóm tắt thay đổi. Chỗ cần kiểm tra lại: tự thử ba trường hợp. Để trống hoàn toàn, nhập toàn khoảng trắng, và nhập đúng số. Ba trường hợp này công cụ có thể chưa nghĩ tới nếu bạn không nêu. Đừng chỉ thử trường hợp “đẹp”.

### Nhân viên văn phòng: sửa file mẫu báo cáo tự động

Anh Minh làm hành chính, có một script nhỏ gộp số liệu từ file CSV thành bảng tổng hợp. Cuối tháng, dòng tổng bị lệch vì có dòng trống ở cuối file CSV. Anh giao việc:

```text
Trong @gop-so-lieu.py, khi file CSV có dòng trống ở cuối thì dòng “Tổng” cộng thêm một giá trị rỗng và báo lỗi.
Kết quả mong đợi: bỏ qua dòng trống, dòng “Tổng” bằng đúng tổng các dòng có số.
Không đổi định dạng đầu ra của bảng. Chỉ sửa gop-so-lieu.py; cần sửa file khác thì hỏi trước.
Sau khi sửa, chạy thử với file mẫu mình để trong thư mục du-lieu-mau và cho mình xem kết quả.
```

Kết quả: script bỏ qua dòng trống, và công cụ chạy thử trên dữ liệu mẫu để báo lại con số. Chỗ cần kiểm tra lại: tự cộng tay vài dòng trong file mẫu để đối chiếu với tổng. Đây là lý do nên đưa file mẫu nhỏ vào dự án: bạn có một phép thử rõ ràng thay vì tin vào lời kể. Lưu ý đừng dùng dữ liệu thật nhạy cảm của công ty để thử khi chưa kiểm tra, vấn đề này có tập riêng trong series.

### Lập trình viên mới: lỗi hiển thị ở một component

Bạn Hà mới vào nghề, được giao sửa lỗi nút “Xem thêm” trong danh sách sản phẩm không ẩn đi sau khi đã tải hết. Thay vì viết “sửa nút Xem thêm”, bạn viết:

```text
Trong @DanhSachSanPham.jsx, khi đã tải hết sản phẩm thì nút “Xem thêm” vẫn hiện và bấm vào không có gì xảy ra.
Kết quả mong đợi: khi không còn sản phẩm để tải thì nút bị ẩn đi; khi còn thì nút hoạt động như cũ.
Chỉ sửa DanhSachSanPham.jsx. Nếu thấy cần đụng tới file khác (ví dụ hàm gọi dữ liệu) thì dừng lại và hỏi mình trước.
Nếu dự án có test liên quan, hãy chạy và báo kết quả.
```

Kết quả: một thay đổi gọn ở điều kiện hiển thị nút. Nếu có test, công cụ chạy và sửa tiếp dựa trên kết quả. Chỗ cần kiểm tra lại: câu “khi còn thì nút hoạt động như cũ” là để chặn việc sửa xong lỗi này lại làm hỏng phần đang chạy. Bạn vẫn nên bấm thử cả hai nhánh và đọc lại các dòng đã thay đổi trước khi commit.

## Góc nhìn khách quan

### Điểm mạnh thật sự

Điểm mạnh lớn nhất của cách giao việc này là nó rẻ mà hiệu quả. Chỉ thêm vài dòng chữ vào yêu cầu, bạn giảm đáng kể số lần phải nói lại. Công cụ đọc được dự án, sửa nhiều file và chạy lệnh nên khi có đủ thông tin, nó làm được trọn một vòng: sửa, chạy, thấy lỗi, sửa tiếp.

Cách này cũng giúp chính bạn. Để viết được dòng “kết quả mong đợi”, bạn buộc phải nghĩ xem mình thực sự muốn gì. Nhiều lần, chỗ mơ hồ nằm ở đầu bạn chứ không phải ở công cụ.

> Yêu cầu rõ không làm công cụ thông minh hơn, nó chỉ làm cho điều bạn muốn khó bị hiểu sai hơn.
>
> — Ông T

### Giới hạn và rủi ro

Đừng nghĩ viết rõ là xong. Một vài giới hạn cần nhớ:

- **Câu giới hạn phạm vi là lời dặn, không phải khoá.** Công cụ có thể vẫn làm lệch. Bạn cần xem lại danh sách file đã đổi.
- **Kết quả mong đợi chỉ kiểm được những gì bạn nghĩ tới.** Trường hợp bạn không nghĩ ra thì cả bạn lẫn công cụ đều không kiểm.
- **Công cụ thao tác trực tiếp trên file.** Làm việc trên dự án chưa được lưu lại bằng git thì rất khó quay lui. Hãy chắc là bạn có cách hoàn tác.
- **Chi phí lượt dùng.** Mỗi lần sửa đi sửa lại là tốn thêm lượt dùng trong gói của bạn. Yêu cầu rõ ngay từ đầu cũng là tiết kiệm.
- **Dữ liệu nhạy cảm.** File bạn đưa vào ngữ cảnh là nội dung được gửi đi xử lý. Đừng đưa mật khẩu, khoá truy cập hay dữ liệu khách hàng thật vào file mà bạn nhắc tới.
- **Phụ thuộc mạng.** Không có kết nối ổn định thì công cụ không làm việc được.

```note
Mọi thay đổi vẫn phải do bạn kiểm tra. Hãy làm việc trong thư mục đã có git hoặc đã sao lưu, không đưa file chứa mật khẩu hay dữ liệu khách thật vào ngữ cảnh, và đọc lại thay đổi trước khi lưu vào lịch sử.
```

### Khi nào nên chọn cách khác

Nếu việc của bạn chỉ là hỏi một khái niệm, nhờ giải thích một đoạn code, hay soạn nháp một đoạn văn, thì một cuộc trò chuyện thông thường với ChatGPT hay chính Claude trên web là đủ. Không cần công cụ thao tác trên thư mục.

Nếu bạn quen làm việc ngay trong trình soạn code và chỉ cần gợi ý từng dòng, các công cụ như Cursor hay GitHub Copilot có thể hợp thói quen hơn. Nếu bạn muốn thử một công cụ dòng lệnh khác, có thể xem Codex CLI hay Gemini CLI. Dù chọn công cụ nào, nguyên tắc nói rõ file, hành vi, kết quả vẫn dùng được, vì bản chất vấn đề là chuyện giao tiếp.

## Lỗi hay gặp và cách tránh

**1. Giao việc theo kiểu “sửa giúp mình cái này”.** Công cụ buộc phải đoán. Cách tránh: luôn có ít nhất một file và một hành vi cụ thể. Chưa viết được hành vi nghĩa là bạn chưa rõ lỗi nằm đâu, hãy tự thử tái hiện lỗi trước.

**2. Quên “kết quả mong đợi”.** Đây là mảnh bị bỏ nhiều nhất. Hậu quả là bạn không có tiêu chí để nói “xong rồi”. Cách tránh: viết câu “Làm xong thì... phải thấy...” trước khi bấm gửi.

**3. Tưởng nhắc file là đã giới hạn phạm vi.** Nhắc file chỉ đưa nó vào ngữ cảnh. Cách tránh: thêm câu “Chỉ sửa file này; cần sửa file khác thì hỏi trước”, rồi xem danh sách file đã đổi sau khi xong.

**4. Tin ngay vào lời “đã sửa xong”.** Công cụ báo xong không có nghĩa là đúng ý bạn. Cách tránh: tự chạy lại đúng tình huống đã mô tả, kể cả những trường hợp lạ như ô chỉ có khoảng trắng.

**5. Giao một việc quá to trong một câu.** Khi một câu yêu cầu cả chục thay đổi, rất khó kiểm. Cách tránh: tách thành từng phần nhỏ, mỗi phần có kết quả riêng. Chuyện chia việc có tập riêng trong series này.

## Dự phóng: chủ đề này sẽ đi về đâu

Phần này là nhận định của Ông T dựa trên hướng đi chung của các AI agent và công cụ lập trình bằng AI, không phải thông báo chính thức của bất kỳ hãng nào.

**Công cụ sẽ tự đọc thêm bối cảnh, nhưng yêu cầu rõ vẫn là gốc (khả năng cao).** Các agent đang giỏi dần việc tự khám phá dự án. Nhưng ý định của bạn, cái “tại sao” và cái “thế nào là đúng”, không nằm trong code. Dù công cụ đọc giỏi đến đâu, bạn vẫn là người biết mình muốn gì. Hãy chuẩn bị bằng cách tập viết ba mảnh ghép thành thói quen.

**Bối cảnh lặp lại sẽ được lưu thành file hướng dẫn dự án (khả năng cao).** Những điều bạn dặn đi dặn lại, như quy ước đặt tên hay cách chạy test, hợp lý nhất là ghi một lần vào file hướng dẫn như CLAUDE.md. Tập khác trong series nói riêng về việc này. Hãy chuẩn bị bằng cách để ý những câu mình lặp lại nhiều lần.

> Giao việc rõ ngày càng giống viết một bản mô tả công việc ngắn hơn là gõ một câu lệnh.
>
> — Ông T

**Phạm vi sẽ được kiểm soát bằng cơ chế chứ không chỉ bằng lời dặn (có thể).** Xu hướng chung của các công cụ agent là thêm quyền hạn rõ ràng: được đọc gì, được sửa gì, thao tác nào phải xin phép. Mình nghĩ hướng này hợp lý vì lời dặn bằng chữ luôn có độ rủi ro. Nhưng cụ thể mỗi công cụ làm thế nào thì mình không khẳng định. Hãy chuẩn bị bằng cách làm quen với việc đọc kỹ các hộp thoại xin phép thay vì bấm đồng ý cho nhanh.

**Kiểm tra tự động sẽ nằm sâu hơn trong quy trình giao việc (còn bỏ ngỏ).** Có thể công cụ sẽ ngày càng dựa vào test và tiêu chí do bạn đặt để tự kiểm lại việc của mình. Mức độ tin cậy còn tuỳ từng dự án, chưa có gì chắc chắn. Hãy chuẩn bị bằng cách giữ cho dự án có vài phép thử đơn giản, dù chỉ là một file dữ liệu mẫu.

## Bắt đầu từ đâu

Giao việc rõ không phải kỹ thuật cao siêu. Nó chỉ là thói quen nói đủ ý với một đồng nghiệp mới: chỉ file, kể hành vi, nêu kết quả, và dặn giới hạn. Phần còn lại là bạn kiểm tra như với mọi sản phẩm của người khác.

Ba việc bạn làm được ngay hôm nay:

1. Chọn một lỗi nhỏ có thật trong dự án của bạn, mở Claude Code trong thư mục đó, gõ @ để chọn file, rồi viết đủ ba dòng: hành vi, kết quả mong đợi, phạm vi.
2. Sau khi công cụ làm xong, tự thử đúng tình huống đã mô tả, thêm một trường hợp lạ mà bạn chưa nêu.
3. Lưu câu giao việc vừa dùng thành một mẫu trong file ghi chú, để lần sau chỉ cần thay tên file và hành vi. Tập sau của series sẽ nói về việc đọc lại thay đổi trước khi commit.

## Câu hỏi thường gặp

### Giao việc cho Claude Code cần viết những gì để ít bị hiểu sai?

Nên có ba phần: file liên quan, hành vi cần xử lý và kết quả mong đợi. Thêm một câu giới hạn phạm vi sửa nếu bạn không muốn công cụ đụng vào file khác. Càng cụ thể thì công cụ càng ít phải tự đoán.

### Gõ @ trong Claude Code để làm gì?

Gõ @ rồi chọn file từ gợi ý sẽ đưa nội dung file đó vào ngữ cảnh. Công cụ biết chính xác bạn đang nói về file nào, khỏi phải tự tìm hay đoán nhầm file trùng tên.

### Tôi đã nhắc tên file thì Claude Code có chỉ sửa file đó không?

Không chắc. Nhắc file chỉ cung cấp ngữ cảnh, không tự giới hạn phạm vi sửa. Bạn nên nói rõ, ví dụ “chỉ sửa file này, cần sửa file khác thì hỏi trước”, rồi vẫn kiểm tra danh sách file đã thay đổi.

### Claude Code có hiểu yêu cầu bằng tiếng Việt không?

Có, công cụ nhận yêu cầu bằng tiếng Việt. Tuy nhiên tiếng Việt hay tiếng Anh thì yêu cầu mơ hồ vẫn dễ bị hiểu lệch. Điều quyết định là bạn có nêu rõ file, hành vi và kết quả hay không.

### Viết yêu cầu rõ rồi thì có cần kiểm tra lại kết quả không?

Vẫn cần. Yêu cầu rõ giúp giảm hiểu sai chứ không đảm bảo đúng tuyệt đối. Bạn nên tự chạy lại tình huống đã mô tả, thử thêm vài trường hợp lạ và đọc lại các thay đổi trước khi lưu vào lịch sử dự án.

### Câu giao việc có nên viết thật dài không?

Không cần dài, chỉ cần đủ ý. Ba đến bốn dòng nêu file, hành vi, kết quả và phạm vi thường là đủ cho một việc nhỏ. Nếu việc quá lớn, hãy tách thành nhiều phần nhỏ, mỗi phần có kết quả riêng.

### Có nên đưa file chứa mật khẩu hay dữ liệu khách hàng vào ngữ cảnh không?

Không nên. Nội dung file bạn đưa vào ngữ cảnh sẽ được dùng để xử lý yêu cầu. Hãy tránh file có mật khẩu, khoá truy cập hoặc dữ liệu khách thật, và dùng dữ liệu mẫu để thử khi cần.
