Tác nhân Claude Code: Hướng dẫn thực tiễn về quy trình mã hóa tự động

Nếu ai đó hỏi tôi điều gì khiến Claude Code khác với ChatGPT hay GitHub Copilot, tôi sẽ không bắt đầu từ mô hình ngôn ngữ. Tôi sẽ bắt đầu từ quy trình làm việc.

Hãy tưởng tượng mở một terminal bên trong một kho Git và gõ một yêu cầu duy nhất:

Add request validation to every FastAPI endpoint,
write tests for the new validation logic, update the documentation, 
and commit everything using a descriptive Git commit message.

Thay vì hỏi hàng tá câu tiếp theo, Claude Code bắt đầu làm việc. 

Nó tìm kiếm trong dự án của bạn để hiểu cấu trúc API, xác định mọi endpoint, chỉnh sửa các tệp phù hợp, tạo bài kiểm thử, sửa mọi lỗi, cập nhật tài liệu và tạo một commit Git tóm tắt các thay đổi.

Từ góc nhìn của bạn, trải nghiệm này giống như giao việc cho một đồng đội giỏi hơn là trò chuyện với một AI. 

Chính sự chuyển dịch đó làm cho các tác nhân Claude Code trở nên thú vị.

Tính năng khiến điều này khả thi là các tác nhân phụ (sub-agent) của Claude Code. Thay vì buộc một phiên AI phải lý luận về toàn bộ kho mã, Claude Code có thể khởi chạy các nhân sự chuyên biệt để điều tra các phần khác nhau của dự án, xây dựng kế hoạch triển khai, hoặc tự chỉnh sửa mã trước khi báo cáo lại cho phiên chính. 

Thay vì cố gắng giải quyết mọi vấn đề trong một cuộc trò chuyện duy nhất, Claude Code có thể ủy thác công việc cho các tác nhân chuyên biệt. 

Ba loại tác nhân chính là: 

• Explore, tập trung vào khám phá dự án
• Plan, tập trung vào xây dựng kế hoạch triển khai, và
• General-purpose, dùng để chỉnh sửa mã và thực thi lệnh.

Điều này đã thay đổi cách tôi tiếp cận phát triển. Thay vì hỏi, "AI có thể viết hàm này không?" tôi lại tự hỏi, "Mảnh việc lớn nhất tôi có thể bàn giao an toàn là gì?" 

Kết thúc hướng dẫn này, bạn sẽ biết cách dùng các tác nhân Claude Code hiệu quả, khi nào nên dùng mỗi loại tác nhân phụ, cách cấu hình bộ nhớ dự án lâu dài với CLAUDE.md, và cách xây dựng các quy trình tự động giúp tiết kiệm thời gian mà vẫn giữ quyền kiểm soát. 

Điều kiện tiên quyết

Hướng dẫn này giả định bạn đã quen dùng terminal và điều hướng thư mục với các lệnh dòng lệnh cơ bản như cd, ls hoặc dir. 

Bạn không cần là chuyên gia Bash, nhưng nên cảm thấy thoải mái khi làm việc từ dòng lệnh.

Bạn cũng sẽ cần:

• Node.js cài trên máy
• Một khóa API Anthropic
• Một kho Git để thử nghiệm
• Hiểu biết cơ bản về Python, JavaScript, hoặc ngôn ngữ lập trình khác

Nếu bạn hoàn toàn mới với Claude Code, tôi cũng khuyên đọc Claude Code: A Guide With Practical Examples trước khi đi sâu vào các tác nhân phụ.

Claude Code Agents là gì?

Các tác nhân Claude Code là những nhân sự tự động hoàn thành các tác vụ phát triển phần mềm nhiều bước bằng cách sử dụng kho cục bộ, terminal, và công cụ phát triển của bạn. 

Khác với ChatGPT hay Claude Chat, Claude Code có thể kiểm tra tệp, thực thi lệnh Bash, chỉnh sửa mã nguồn, và tự xác minh công việc trước khi trả kết quả.

Hầu hết trợ lý mã hóa AI vẫn đi theo quy trình hội thoại. 

Bạn hỏi một câu, nhận được câu trả lời, rồi quyết định bước tiếp theo. 

Cách đó hiệu quả khi viết câu truy vấn SQL hoặc giải thích một pipeline scikit-learn, nhưng bắt đầu vỡ vụn khi một tác vụ trải dài 20 tệp, cần vài lệnh terminal, hoặc phụ thuộc vào việc hiểu một kho mã lạ.

Claude Code tiếp cận khác đi. 

Vì nó làm việc trực tiếp bên trong kho Git của bạn, nó có thể điều tra mã trước khi quyết định. Thay vì yêu cầu bạn dán tệp vào cửa sổ chat, nó tự đọc dự án và thu thập ngữ cảnh cần thiết.

Giả sử bạn yêu cầu:

Replace every custom customer ID validator with Pydantic models, 
update the FastAPI endpoints, rewrite the affected pytest tests, 
and summarize the migration.

Một chatbot truyền thống có lẽ sẽ tạo mã ví dụ và hỏi thêm thông tin. 

Claude Code tìm kiếm trong kho, xác định logic kiểm tra hiện có, chỉnh sửa các tệp liên quan, chạy test suite, sửa mọi hồi quy nó gây ra, và báo cáo công việc hoàn tất.

Chuyển dịch từ trả lời câu hỏi sang hoàn thành mục tiêu chính là điều khiến việc mã hóa theo hướng tác nhân với Claude Code khác biệt trong phát triển hằng ngày.

Vòng lặp tác nhân hoạt động thế nào? 

Mỗi tác nhân Claude Code đều theo cùng một chu trình quyết định: đọc thông tin, quyết định bước tiếp, hành động, rồi đánh giá kết quả trước khi lặp lại. 

Vòng lặp đơn giản, nhưng lặp lại hàng chục lần cho phép tác nhân tự phục hồi khỏi lỗi thay vì dừng lại sau một lần thất bại.

Hãy tưởng tượng yêu cầu Claude Code sửa một test suite đang lỗi. Quy trình thường trông như sau:

Sơ đồ cho thấy cách Claude Code vận hành khi sửa lỗi kiểm thử

Tôi nghĩ đây là mô hình tư duy dễ nhất để hiểu Claude Code. 

Tác nhân không cố giải toàn bộ vấn đề trong một bước. Nó đưa ra chuỗi quyết định nhỏ dựa trên những gì xảy ra sau hành động trước đó.

Một tác nhân phụ cũng theo đúng vòng lặp đó, nhưng trong ngữ cảnh cách ly của riêng nó. 

Khác biệt này quan trọng vì một lần gọi công cụ chỉ thực hiện một hành động, trong khi một tác nhân phụ có thể dành hàng chục bước lý luận để hướng tới một mục tiêu duy nhất trước khi báo cáo lại.

Tại sao Claude Code dùng tác nhân phụ? 

Claude Code dùng tác nhân phụ vì các kho lớn hiếm khi vừa trong một ngữ cảnh làm việc duy nhất. Một monorepo với dịch vụ Python, ứng dụng React, migration SQL và cấu hình Terraform chứa nhiều thông tin hơn mức một tác nhân nên xử lý cùng lúc. 

Thay vì xem kho là một tác vụ khổng lồ, Claude Code ủy thác các cuộc điều tra tập trung cho những nhân sự chuyên biệt. 

Một tác nhân Explore có thể phân tích xác thực, một tác nhân khác kiểm tra mô hình cơ sở dữ liệu, còn tác nhân thứ ba rà soát các tuyến API. Bộ điều phối kết hợp những phát hiện đó trước khi quyết định bước tiếp theo.

Kiến trúc này có lợi thế thực tiễn khác: nhiều cuộc điều tra diễn ra song song. 

Thay vì tự đọc mọi thư mục hoặc chờ một tác nhân xem toàn bộ kho, vài tác nhân phụ có thể khám phá các khu vực khác nhau cùng lúc.

Bạn sẽ thấy mẫu hình này xuyên suốt phần còn lại của hướng dẫn. Tác nhân Explore thu thập thông tin, tác nhân Plan tổ chức triển khai, và tác nhân general-purpose thực hiện công việc phát triển thực tế.

Nếu muốn tìm hiểu rộng hơn về cách hệ thống AI tự động hoạt động ngoài phạm vi Claude Code, bài viết của DataCamp LLM Agents Explained: Architecture, Frameworks, and Use Cases cung cấp một tổng quan khái niệm xuất sắc.

Cài đặt và thiết lập Claude Code như thế nào? 

Trước khi chúng ta bắt đầu dùng các tác nhân Claude Code, cần có một bản cài đặt hoạt động. 

May mắn thay, bắt đầu chỉ mất vài phút.

Cài đặt Claude Code

Claude Code được phân phối dưới dạng gói npm, vì vậy bạn sẽ cần Node.js cài sẵn trên máy. Để tham khảo hướng dẫn, tôi khuyên làm theo tài liệu npm về cài đặt Node.js và npm.

Cài đặt Claude Code toàn cục bằng:

npm install -g @anthropic-ai/claude-code

Tiếp theo, tạo khóa API Anthropic từ Anthropic Console và thêm vào môi trường của bạn.

Trên macOS hoặc Linux:

export ANTHROPIC_API_KEY="your_api_key_here"

Trên Windows PowerShell:

$env:ANTHROPIC_API_KEY="your_api_key_here"

Để xác minh mọi thứ cài đặt đúng, chạy:

claude --version

Nếu Claude Code in ra phiên bản đã cài, bạn sẵn sàng sử dụng.

Lúc này, cũng đáng để xác nhận rằng Git khả dụng vì nhiều quy trình Claude Code liên quan đến đọc lịch sử kho, tạo commit, hoặc so sánh thay đổi. 

Nếu bạn chưa có Git, hãy làm theo hướng dẫn cài đặt Git để bắt đầu.

Cả hai lệnh nên thực thi thành công trước khi chuyển tiếp.

Phiên Claude Code đầu tiên của bạn

Khi đã cài Claude Code, hãy chuyển vào bất kỳ dự án Git nào bằng cd my-project.

Sau đó khởi chạy Claude Code: claude.

Trước khi nhờ nó viết mã, hãy dành vài phút tìm hiểu cách nó khám phá một kho. Tôi thường bắt đầu với các yêu cầu như:

• "Kho này làm gì?"
• "Giải thích kiến trúc."
• "Tìm mọi ghi chú TODO."
• "Những mô-đun nào chứa logic nghiệp vụ cốt lõi?"
• "Xác thực được triển khai như thế nào?"

Những câu hỏi đó không tạo ra tính năng mới, nhưng chúng cho Claude Code bối cảnh tương tự như một đồng đội mới sẽ thu thập trước khi viết mã. 

Tôi thấy rằng đầu tư 2–3 phút khám phá thường mang lại triển khai tốt hơn là nhảy thẳng vào yêu cầu tính năng.

Bước tiếp theo là cấu hình bộ nhớ dự án lâu dài với CLAUDE.md. Theo kinh nghiệm của tôi, không tệp nào có tác động lớn hơn đến chất lượng công việc của Claude Code về lâu dài.

Vì sao CLAUDE.md là tệp quan trọng nhất đối với Claude Code?

CLAUDE.md là một tệp hướng dẫn bền vững cho Claude biết về sở thích của bạn và cách dự án hoạt động trước khi nó bắt đầu lý luận về một tác vụ. 

Thay vì giải thích lại tech stack, quy ước mã hóa và quy trình phát triển mỗi lần mở phiên mới, bạn ghi lại một lần và để mọi tác nhân tương lai xây dựng trên cùng ngữ cảnh đó.

Khi mới biết về các tác nhân Claude Code, mọi người thường tập trung vào prompt. Tôi nghĩ đó là ngược lại. 

Một CLAUDE.md viết tốt cải thiện chất lượng kết quả nhiều hơn là miệt mài chỉnh câu chữ của prompt, vì mọi tác nhân đều bắt đầu với cùng hiểu biết về dự án.

Hãy nghĩ về cách bạn hướng dẫn một kỹ sư mới. 

Có lẽ bạn không bắt đầu bằng cách đưa họ một vé Jira. Bạn sẽ giải thích về kho, chỉ cách chạy test suite, nêu một vài quy ước mã hóa, và cảnh báo những phần không nên đụng tới. 

CLAUDE.md phục vụ đúng mục đích đó.

Lợi ích càng rõ khi bạn bắt đầu dùng các quy trình tự động của Claude Code.

Một tác nhân được kỳ vọng làm việc độc lập cần có ngữ cảnh dự án đáng tin cậy. 

Không có nó, Claude Code sẽ tốn thời gian khám phá lại thông tin hoặc đưa ra giả định có thể không khớp với tiêu chuẩn của nhóm bạn.

Bạn nên đưa gì vào CLAUDE.md?

Một CLAUDE.md tốt không thay thế tài liệu dự án hay README.md. Đó là tập hợp hướng dẫn mà Claude Code thường xuyên cần khi đọc mã, viết tính năng và chạy công cụ phát triển.

Tôi thường tổ chức thành năm phần: tổng quan dự án, tech stack, quy ước mã hóa, lệnh thường dùng và thư mục cần tránh. Tôi sẽ điểm qua từng phần.

Tổng quan dự án

Bắt đầu bằng mô tả ngắn về việc dự án thực sự làm gì.

Customer analytics platform built with FastAPI.
The application serves machine learning predictions through REST APIs.
Production deployments run through GitHub Actions.

Ba dòng này ngay lập tức cho Claude Code biết nó đang làm việc với FastAPI, GitHub Actions và một ứng dụng máy học chứ không phải một kho Python chung chung.

Ngăn xếp công nghệ

Tiếp theo, chỉ cần liệt kê các thư viện và framework chính định hình dự án.

Python 3.12
FastAPI
Pydantic v2
SQLAlchemy
PostgreSQL
Pytest
Ruff

Tôi luôn bao gồm số phiên bản khi có ý nghĩa. 

Cách tiếp cận khuyến nghị cho Pydantic v2 khác Pydantic v1, và Claude Code không nên phải đoán API bạn dùng. 

Điều này đặc biệt quan trọng nếu bạn dùng gói cũ, để nó không xây dựng trên các giả định sai.

Quy ước mã hóa

Phần này ghi lại các quy tắc bạn hay nhắc đi nhắc lại.

Always use type hints.
Prefer dependency injection.
Write tests for every new feature.
Keep business logic separate from API routes.
Reuse existing utility functions before creating new ones.

Lưu ý đây là các quy tắc kỹ thuật thực tiễn chứ không phải sở thích về style. 

Claude Code thường suy ra định dạng từ các tệp hiện có, nhưng nó sẽ không tự biết rằng nhóm bạn kỳ vọng mọi endpoint dùng dependency injection hoặc mọi tính năng phải có bài kiểm thử pytest.

Lệnh thường dùng

Claude Code thường tự xác minh công việc bằng cách chạy lệnh phát triển. Cung cấp chính xác các lệnh nhóm bạn dùng sẽ tránh thử-sai không cần thiết. 

Điều này có thể là bất cứ thứ gì như các tác vụ task cụ thể hoặc script CI.

pytest
Run one test file:
pytest tests/test_api.py
Lint:
ruff check .
Format:
ruff format .
Start the development server:
uvicorn app.main:app --reload

Phần này đặc biệt hữu ích với các kho dùng script tùy biến, quy trình Docker, hoặc công cụ như poetry, uv, hay tox.

Tệp và thư mục cần tránh

Mỗi kho đều có những tệp không nên thay đổi tự động.

Ví dụ gồm:

Never edit generated files.
Do not modify Alembic migrations.
Avoid changing Terraform configuration unless requested.
Do not update dependency versions automatically.

Tôi thấy phần này ngăn lỗi nhiều hơn hầu hết phần khác. Một câu bảo Claude Code đừng đụng vào mã sinh tự động rẻ hơn rất nhiều so với việc rà soát hàng chục thay đổi tệp không cần thiết.

Ví dụ về CLAUDE.md

Đây là ví dụ giản lược cho một dự án API Python. 

Hãy lưu ý cách tôi dùng định dạng markdown để giúp dễ đọc hơn và cung cấp cho Claude nhiều ngữ cảnh.

# Project Overview

Customer analytics platform built with FastAPI.

## Technology

- Python 3.12
- FastAPI
- PostgreSQL
- SQLAlchemy
- Pydantic v2
- Pytest
- Ruff

## Coding Standards

- Use type hints everywhere.
- Write tests for new features.
- Prefer dependency injection.
- Keep business logic separate from API routes.

## Common Commands

pytest
ruff check .
ruff format .

## Avoid Editing

generated/
alembic/versions/
terraform/

Đừng lo lắng về việc phiên bản đầu tiên phải hoàn hảo. 

Chính CLAUDE.md của tôi cũng thay đổi vài lần khi tôi nhận ra những hướng dẫn lặp lại đáng để ghi chép. Hãy coi nó như mã nguồn, không phải tài liệu bất biến. 

Nếu bạn muốn đi sâu hơn vào viết tệp hướng dẫn hiệu quả, bài của DataCamp Writing the Best CLAUDE.md: A Complete Guide for Claude Code bao quát các ví dụ lớn hơn và mẫu nâng cao.

Bạn nên dùng CLAUDE.md cấp dự án hay cấp người dùng?

Claude Code hỗ trợ hai phạm vi cho hướng dẫn bền vững. Hiểu sự khác biệt giúp tách quy tắc dự án khỏi sở thích cá nhân của bạn.

CLAUDE.md cấp dự án

Một tệp cấp dự án nằm bên trong kho.

	my-project/
	│
	├── CLAUDE.md
	├── app/
	├── tests/
	└── pyproject.toml

Mọi thứ trong tệp này chỉ áp dụng cho kho đó. Tôi dùng nó cho lựa chọn công nghệ, lệnh kiểm thử, quy ước mã hóa, cấu trúc thư mục và các quy tắc riêng của kho. 

Vì tệp nằm cạnh mã nguồn, mọi cộng tác viên nhận cùng hướng dẫn sau khi clone dự án. Hãy coi như cung cấp cho mỗi tác nhân một sổ tay trước khi bắt đầu.

CLAUDE.md cấp người dùng

Claude Code cũng hỗ trợ tệp cấu hình toàn cục.

Tệp này theo bạn từ dự án này sang dự án khác. Tôi coi nó như sổ tay vận hành cá nhân hơn là tài liệu dự án.

Ví dụ, tệp cấp người dùng của tôi có thể gồm các hướng dẫn như:

Explain architectural trade-offs.
Suggest performance improvements when appropriate.
Default to Python examples unless another language is requested.
Keep explanations concise.

Những sở thích này hợp lý dù tôi làm việc với FastAPI, React hay PyTorch.

Cách hai tệp phối hợp

Một chi tiết từng khiến tôi bối rối khi mới dùng Claude Code là hai tệp này không loại trừ lẫn nhau. 

Tệp CLAUDE.md cấp người dùng được nạp trước, rồi CLAUDE.md cấp dự án bổ sung hướng dẫn riêng của kho.

Hãy coi như một hệ thống phân cấp. 

Tệp toàn cục định nghĩa cách tôi muốn làm việc. Tệp dự án giải thích kho này hoạt động ra sao. 

Cùng nhau, chúng cung cấp cho mọi tác nhân cả sở thích cá nhân và ngữ cảnh dự án trước khi bắt đầu lý luận.

Claude Code kết hợp sở thích cấp người dùng với hướng dẫn cụ thể của dự án trước khi bắt đầu tác vụ.

Ba loại tác nhân phụ của Claude Code là gì?

Claude Code dùng ba loại tác nhân phụ chuyên biệt vì các tác vụ phát triển khác nhau cần công cụ khác nhau. 

Một tác nhân điều tra kho không cần quyền chỉnh sửa tệp, trong khi một tác nhân triển khai tính năng có lẽ cần truy cập Bash, Git và test suite của bạn.

Khi mới dùng Claude Code, tôi luôn chọn tác nhân general-purpose vì có vẻ là tùy chọn mạnh nhất. 

Một thời gian sau, tôi nhận ra mình tốn thời gian và token nhiều hơn cần thiết. Hầu hết quy trình sẽ nhanh hơn nếu bạn khám phá trước, lập kế hoạch thứ hai, và cuối cùng mới triển khai.

So sánh ba tác nhân phụ của Claude Code

Tên gọi khá mô tả, nhưng mỗi tác nhân đảm nhận một vai trò riêng trong quy trình lớn hơn.

Tác nhân Explore của Claude Code là gì?

Tác nhân Explore của Claude Code là người điều tra chỉ đọc, tìm kiếm trong kho và tóm tắt phát hiện mà không thay đổi tệp nào.

Đây là tác nhân tôi dùng nhiều nhất khi mở một dự án lạ. Thay vì tự cuộn qua hàng chục mô-đun Python hay thành phần JavaScript, tôi nhờ Explore giải thích cách một hệ con hoạt động và chỉ ra các tệp quan trọng.

Các trường hợp dùng tốt gồm:

• Tìm nơi triển khai xác thực
• Lần theo một yêu cầu qua nhiều dịch vụ
• Kiểm toán logging hoặc xử lý lỗi
• Xác định các API lỗi thời
• Tóm tắt một gói hoặc thư mục
• Nhận diện logic nghiệp vụ bị trùng lặp

Vì tác nhân Explore không thể chỉnh sửa tệp hay thực thi lệnh shell, chúng cũng là tác nhân an toàn nhất để chạy song song.

Chọn mức độ kỹ lưỡng

Tác nhân Explore hỗ trợ các độ sâu điều tra khác nhau.

Nếu tôi chỉ cần định vị một hàm, tôi dùng thiết lập nhanh nhất. Nếu tôi chuẩn bị refactor qua vài gói, chờ thêm một phút cho cuộc điều tra sâu hơn thường rất đáng.

Tác nhân Plan của Claude Code là gì?

Tác nhân Plan của Claude Code phân tích thay đổi được yêu cầu và đưa ra chiến lược triển khai mà không sửa đổi kho.

Tôi hầu như không bao giờ bỏ qua bước này. Dành thêm một phút để xem lại kế hoạch rẻ hơn nhiều so với phát hiện giữa chừng rằng hệ con khác phụ thuộc vào đoạn mã bạn đang thay đổi.

Một kế hoạch điển hình gồm:

• Những tệp nên thay đổi
• Thứ tự triển khai khuyến nghị
• Phụ thuộc và điểm tích hợp
• Chiến lược kiểm thử
• Rủi ro hoặc giả định

Sau khi bạn xem kế hoạch, có thể tinh chỉnh hoặc bàn giao trực tiếp cho tác nhân general-purpose.

Bài của DataCamp Claude Code Plan Mode: Design Review-First Refactoring Loops khám phá kỹ hơn quy trình ưu tiên rà soát này.

Tác nhân Claude Code general-purpose là gì?

Một tác nhân general-purpose có thể đọc tệp, chỉnh sửa mã nguồn, thực thi lệnh Bash, chạy kiểm thử, và tiếp tục làm việc cho đến khi đạt mục tiêu yêu cầu.

Đây là tác nhân thực sự xây dựng phần mềm. Nó có quyền truy cập ngữ cảnh kho giống các tác nhân khác, nhưng còn có quyền thực hiện thay đổi và xác minh công việc.

Các tác vụ điển hình gồm:

• Triển khai tính năng mới
• Refactor nhiều mô-đun
• Di trú phụ thuộc
• Cập nhật tài liệu
• Phối hợp thay đổi trên nhiều gói

Các tác nhân general-purpose tiêu tốn nhiều token hơn vì chúng thực hiện đáng kể nhiều công việc hơn. 

Đó là lý do khác khiến tôi ưa mẫu Explore → Plan → Implement. 

Các tác nhân rẻ hơn trả lời câu hỏi đầu, để phần triển khai tốn kém hơn khi con đường đã rõ.

Đến đây, chúng ta đã bao quát các yếu tố giúp tác nhân Claude Code thành công: bộ nhớ dự án bền vững qua CLAUDE.md và các tác nhân phụ chuyên biệt cho điều tra, lập kế hoạch và triển khai. 

Tiếp theo, chúng ta sẽ ghép các mảnh lại bằng cách xây dựng các quy trình tác nhân hoàn chỉnh mà bạn có thể dùng ngay trong dự án của mình.

Chạy các quy trình tác nhân Claude Code đầu tiên của bạn

Cách tốt nhất để tận dụng Claude Code là giao cho nó một mục tiêu thay vì yêu cầu những mảnh rời.

Tôi đã chốt một quy trình đơn giản hoạt động tốt trên các dự án Python, kho khoa học dữ liệu và ứng dụng web:

1. Khám phá kho.
2. Tạo kế hoạch.
3. Rà soát kế hoạch.
4. Triển khai thay đổi.
5. Xác minh kết quả.

Quy trình này không bắt buộc, nhưng phản chiếu cách các kỹ sư giàu kinh nghiệm tiếp cận thay đổi lớn. 

Dành một phút để hiểu kho thường giúp tiết kiệm vài phút chỉnh sửa không cần thiết về sau. 

Tạo một prompt kỹ hơn, thậm chí dành một giờ để tinh chỉnh prompt đó, có thể giúp bạn tiết kiệm hàng giờ làm việc sau này.

Quy trình 1: Khám phá một codebase lạ

Tác nhân Explore là điểm xuất phát tốt nhất khi bạn tiếp quản một kho mới hoặc quay lại dự án đã bỏ quên vài tháng. 

Thay vì đọc thư mục thủ công, hãy nhờ Claude Code điều tra kiến trúc và tóm tắt những điều quan trọng.

Ví dụ:

Use an Explore agent to explain how authentication works. 
Identify the main modules involved, summarize the request flow, 
and highlight any technical debt or TODO comments.

Kết quả sẽ không phải là một bức tường mã nguồn sao chép. Thay vào đó, bạn thường nhận được lời giải thích súc tích về luồng xác thực, các tệp liên quan và những khu vực đáng chú ý. 

Tôi thường dùng bản tóm tắt đó làm điểm khởi đầu cho nhiệm vụ tiếp theo thay vì viết một prompt khác từ đầu.

Quy trình 2: Lập kế hoạch trước khi triển khai

Khi đã hiểu kho, hãy nhờ tác nhân Plan thiết kế triển khai trước khi viết mã. 

Đây là một thói quen dễ áp dụng và đã giúp tôi tránh được vài lần refactor sai hướng.

Một prompt có thể như sau:

Create an implementation plan for adding role-based access control.
Identify the files that should change, potential risks,
dependencies, and a recommended implementation order.
Do not modify any code.

Rà soát kế hoạch trước khi tiến tiếp. Nếu mọi thứ hợp lý, bạn có thể bàn giao kế hoạch đó trực tiếp cho tác nhân general-purpose. 

Nếu không, điều chỉnh tài liệu thiết kế dễ hơn nhiều so với hoàn nguyên thay đổi trên cả chục tệp.

Một cách hay để tận dụng bước này là dùng một phiên Claude Code khác để rà soát công việc của phiên đầu. Một prompt đơn giản có thể là:

This is my current goal: to add role-based access control to this repository. 
Take a look at this existing implementation plan and do an adversarial review.
Once done, create a report that summarizes the strong and weak points of the plan.

Quy trình 3: Song song hóa việc khám phá kho

Một trong những tính năng tôi thích ở Claude Code là việc khám phá không nhất thiết diễn ra tuần tự. Nếu dự án của bạn gồm nhiều hệ con độc lập, bạn có thể điều tra chúng cùng lúc.

Ví dụ, bạn có thể khởi chạy một tác nhân Explore để kiểm tra lớp API, một tác nhân khác để rà soát mô hình cơ sở dữ liệu, và tác nhân thứ ba để xem xét pipeline máy học. 

Trong khi các tác nhân đó làm việc độc lập, bộ điều phối kết hợp phát hiện của họ vào một phản hồi duy nhất.

Tôi không dùng tác nhân song song cho mọi tác vụ, nhưng chúng rất phù hợp cho monorepo lớn hoặc ứng dụng trưởng thành có nhiều dịch vụ. Thay vì chờ một cuộc điều tra dài, bạn thường có thể hiểu kho nhanh hơn vì nhiều phần của dự án được phân tích đồng thời.

Cách tốt nhất là dùng một tác nhân lớn để điều phối nhiều tác nhân khác. 

Sự điều phối theo hướng tác nhân là cách tuyệt vời để thực hiện công việc song song mà không cần nhiều phiên, đồng thời gộp vào một ngữ cảnh duy nhất. 

Một prompt hay có thể như sau:

I want you to look at the following components: 
Inspect the API layer, review the DB models, and examine the ML pipeline. 
Look for weaknesses. 
I want this done in parallel, so spawn subagents using Opus/Sonnet models 
in order to do this work and have each generate a concise report and share out 
one master document that outlines the work needed to be done.

Thực hành tốt nhất cho các tác nhân Claude Code

Hầu hết vấn đề mọi người gặp với Claude Code không phải do mô hình. Chúng đến từ prompt mơ hồ, thiếu ngữ cảnh dự án, hoặc yêu cầu giải quyết vấn đề mà nó chưa hiểu đầy đủ.

Sau một thời gian dùng Claude Code thường xuyên, đây là những thói quen tác động lớn nhất tới kết quả của tôi.

Viết prompt mà tác nhân có thể thực thi

Claude Code hoạt động tốt nhất khi mục tiêu, phạm vi và tiêu chí thành công được nêu rõ. 

Thay vì mô tả mục tiêu cuối cùng một cách chung chung, hãy nói rõ tác nhân nên kiểm tra kho nào, tệp nào cần chỉnh sửa, và bạn sẽ biết tác vụ hoàn tất bằng cách nào.

Ví dụ:

❌ Mơ hồ Cải thiện API.

✅ Cụ thể Cập nhật các endpoint xác thực FastAPI sang dùng kiểm tra Pydantic v2, tạo hoặc cập nhật các bài kiểm thử pytest liên quan, chạy test suite, và tóm tắt mọi tệp đã chỉnh sửa.

Prompt thứ hai cho Claude Code một mục tiêu rõ, ranh giới và cách xác minh thành công. Thường dẫn đến ít prompt tiếp theo và ít dọn dẹp thủ công hơn.

Quản lý ngữ cảnh trước khi trở thành vấn đề

Các cuộc trò chuyện dài cuối cùng tích lũy đủ ngữ cảnh đến mức Claude Code tiêu tốn token để nhớ cuộc thảo luận trước thay vì lý luận về tác vụ hiện tại.

Khi điều đó xảy ra, hãy dùng /compact để tóm tắt cuộc trò chuyện trong khi vẫn giữ ngữ cảnh quan trọng. Tôi thấy tốt hơn là nén sớm thay vì chờ đến khi hiệu năng suy giảm rõ rệt.

Một CLAUDE.md tốt cũng giúp ở đây vì quy ước dự án không cần lặp lại mỗi phiên. Claude Code tự nạp ngữ cảnh đó, dành nhiều thời gian hơn cho công việc bạn yêu cầu nó làm.

Để biết thêm lời khuyên về quản lý ngữ cảnh, phát triển hướng kiểm thử và thiết kế prompt, xem Claude Code Best Practices: Planning, Context Transfer, TDD.

Suy nghĩ về chi phí token

Không phải tác vụ nào cũng cần tác nhân general-purpose.

Nếu bạn chỉ cần tìm nơi định nghĩa một hàm, tác nhân Explore thường nhanh hơn và rẻ hơn. 

Nếu bạn đang rà soát thay đổi kiến trúc lớn, tác nhân Plan thường cung cấp đủ thông tin mà không cần chỉnh sửa kho.

Dành tác nhân general-purpose cho các tác vụ thực sự cần thực thi. Những việc như chỉnh sửa tệp, chạy lệnh Bash, hoặc chạy kiểm thử. Ghép đúng tác nhân với tác vụ giúp kiểm soát cả thời gian chạy và lượng token.

Biết khi nào không nên dùng tác nhân

Các tác nhân Claude Code tạo ra một chút chi phí phụ vì có trao đổi ngữ cảnh và token. 

Chúng điều tra kho, lý luận về tác vụ và xác minh công việc. Với thay đổi rất nhỏ, chi phí này không phải lúc nào cũng đáng.

Bạn có lẽ không cần tác nhân để:

• Đổi tên một biến.
• Sửa lỗi chính tả trong tệp Markdown.
• Giải thích một thông báo lỗi Python.
• Trả lời nhanh một câu hỏi SQL.

Trong những tình huống đó, một cuộc trò chuyện Claude Code thông thường hoặc thậm chí chỉnh sửa thủ công thường nhanh hơn. Tôi thường tự hỏi một câu trước khi khởi chạy tác nhân: Tôi sẽ tốn nhiều thời gian giải thích tác vụ này hơn là tự làm không? Nếu câu trả lời là có, tôi giữ mọi thứ đơn giản.

Lời kết

Các tác nhân Claude Code thay đổi vai trò của AI trong phát triển phần mềm. Thay vì tạo các đoạn mã rời rạc, chúng có thể xử lý những vấn đề phức tạp hơn như điều tra kho, thiết kế triển khai, chỉnh sửa mã, chạy kiểm thử và làm việc qua các mục tiêu nhiều bước với rất ít giám sát.

Bài học lớn nhất tôi rút ra là quy trình làm việc tốt quan trọng hơn prompt tốt. 

Một CLAUDE.md rõ ràng, vài phút khám phá kho và một kế hoạch triển khai thấu đáo ổn định cho kết quả tốt hơn so với nhảy thẳng vào sinh mã.

Khi bạn dành nhiều thời gian hơn với Claude Code, có lẽ bạn sẽ phát triển quy trình riêng. Quy trình của tôi vẫn bắt đầu gần như giống nhau mỗi lần: khám phá trước, lập kế hoạch thứ hai, triển khai sau cùng.

Đó là một thói quen đơn giản, nhưng đã giúp tôi tiết kiệm vô số vòng rà soát và giúp tôi tin tưởng các quy trình tự động hơn nhiều so với khi mới bắt đầu dùng.

Nếu bạn muốn tìm hiểu thêm về các ý tưởng rộng hơn đằng sau hệ thống tự động, tôi khuyến nghị các tài nguyên sau:

• Introduction to AI Agents 
• Introduction to Claude Models 
• Claude Code Hooks: A Practical Guide to Workflow Automation 
• Claude Agent SDK Tutorial: Create Agents Using Claude Sonnet 4.5 
• How to Build Claude Code Plugins 
• Claude Code 2.1: A Guide With Practical Examples 
• Model Context Protocol (MCP): A Guide With Demo Project 
• AI Agents with Hugging Face smolagent