Thực hành kỹ thuật CLI Harness chuyên sâu về Claude Code Harness, Mods và Graph Engineering

Trong GUI, Claude Code có thể rất thú vị.

Tuy nhiên, trong thiết kế harness của CLI, Claude Code có thể mang lại lợi nhuận.

Khóa học này không giới thiệu Claude Code CLI đơn thuần như một công cụ lập trình AI. Thay vào đó, khóa học trình bày cách đưa Claude Code vào các quy trình làm việc backend·DevOps thực tế dưới góc nhìn Context, Permission, Verification, Tool, Subagent và Debugging Harness. Bạn sẽ học cách thiết kế một hệ thống làm việc để Claude có thể hoạt động an toàn trong các dự án thực tế, từ phân tích log, sửa lỗi, khôi phục kiểm thử, thiết kế CLAUDE.md, quản lý phiên làm việc cho đến vận hành song song bằng worktree.

Khuyến nghị dành cho những người như thế này

Sau khi hoàn thành khóa học,

Sau khi học khóa này, bạn sẽ không còn xem Claude Code đơn thuần là “một công cụ để nhập prompt thật tốt”. Thay vào đó, bạn sẽ có thể phán đoán Claude cần xem gì, có thể hành động đến đâu, cần xác minh kết quả như thế nào, khi nào nên clear/compact/restart nếu phiên làm việc bị nhiễm, cũng như cách vận hành worktree và các phiên song song.

Cụ thể, bạn có thể cố định một cách có cấu trúc các quy tắc và điều cấm của dự án trong CLAUDE.md, sắp xếp các vấn đề về nhật ký, biến môi trường và phạm vi cấu hình theo cách để Claude có thể giải quyết, đồng thời kiểm tra các phương án sửa đổi do Claude đề xuất thông qua quy trình xác minh bằng test, diff và phản ví dụ. Nói cách khác, bạn sẽ nâng Claude Code lên mức có thể tích hợp vào quy trình làm việc backend và DevOps thực tế, thay vì chỉ xem nó như một công cụ hỗ trợ dạng GUI.

Từ Claude Code phải chỉ dẫn mỗi lần thành Claude Code làm việc theo các quy tắc của tôi

“Hãy kiểm tra cả phần kiểm thử nhé.”
“Hãy hỏi tôi trước khi chạy lệnh đó.”
“Đừng để lại thông tin nhạy cảm trong nhật ký.”

Càng sử dụng Claude Code trong công việc thực tế, bạn càng phải lặp lại những chỉ dẫn giống nhau. Bởi vì bên cạnh việc tạo mã nhanh chóng, việc xác định những tác vụ nào được phép thực hiện và cần kiểm tra những gì để xem là hoàn tất cũng rất quan trọng.

Trong phần Claude Code Mods này, chúng ta sẽ hiện thực hóa những yêu cầu đó bằng mã. Theo dõi 8 bài giảng để từng bước xây dựng một dự án thực hành duy nhất mang tên Harness Guard Kit.

• Đánh giá trước khi thực thi: kiểm tra lệnh gọi công cụ và xử lý việc chuyển tiếp, yêu cầu phê duyệt hoặc từ chối theo các quy tắc đã đặt ra.

• Quản lý thông tin nhạy cảm và nhật ký công việc: che giấu thông tin nhạy cảm trong nhật ký và thiết kế bản ghi để có thể theo dõi công việc.

• Kiểm tra điều kiện hoàn thành: Thiết lập Completion Gate để đảm bảo công việc không kết thúc khi bỏ sót các bước xác minh cần thiết.

• Quan sát ngữ cảnh và chi phí: Đọc thông tin về ngữ cảnh, bộ nhớ đệm và chi phí, đồng thời phân biệt giữa giá trị quan sát được và giá trị ước tính.

• Kiểm thử hành vi và bàn giao cho nhóm: đánh giá không chỉ các tình huống bình thường mà cả tình huống bị từ chối và xảy ra lỗi, đồng thời xử lý cả quy trình triển khai, cập nhật và thu hồi.

Không chỉ dừng lại ở việc sử dụng các tính năng đã cài đặt, đây là quá trình tự thiết kế cách Claude Code hoạt động theo nhu cầu của dự án của bạn.

Khóa học phù hợp với các nhà phát triển muốn kết nối nguyên tắc làm việc với luồng thực thi thực tế, những người tốn thời gian liên tục kiểm tra kết quả do AI tạo ra, và những người muốn biến tiêu chuẩn làm việc của nhóm thành các công cụ có thể tái sử dụng.

Phần thực hành được tiến hành trong môi trường kiểm tra, đồng thời bạn sẽ học cách Guard tự tạo hoạt động cùng với Claude Code và các chính sách phân quyền hiện có của tổ chức như thế nào.

Đặc điểm của khóa học này

1. Không chỉ là giải thích tính năng, khóa học giảng dạy theo góc nhìn “kỹ thuật harness” dựa trên các bài nghiên cứu.

Khóa học này không liệt kê các tính năng của Claude Code như tài liệu chính thức. Thay vào đó, khóa học giải thích theo góc nhìn thiết kế Context, Permission, Verification, Tool, Subagent và Debugging Harness để Claude Code có thể làm việc an toàn trong các dự án thực tế. Nhờ đó, bạn ít bị ảnh hưởng bởi thông tin phiên bản thay đổi nhanh chóng hơn và vẫn có được những tiêu chí có thể áp dụng vào các dự án thực tế.

2. Xử lý dựa trên các codebase lớn và những vấn đề thực tế trong công việc

Không chỉ tạo ứng dụng demo đơn giản, nội dung còn đề cập đến cách giúp Claude không bị lạc trong các codebase lớn, cách giảm thiểu tình trạng ô nhiễm phiên, cách vận hành worktree và các phiên song song một cách an toàn, cũng như cách kết nối quy trình GitHub Issue → PR với Claude. Nội dung bắt đầu từ những điểm thực sự gây cản trở trong công việc thực tế.

Bạn sẽ học được những nội dung này

Bắt đầu thực hành Claude Code CLI /

Kiến trúc / Bộ nhớ / CLAUDE.md / Chế độ lập kế hoạch / Kỹ năng

Trong phần đầu tiên, chúng ta sẽ làm rõ sự khác biệt giữa Claude dạng GUI và CLI, bắt đầu từ những điểm cơ bản nhất. Đây không chỉ là việc so sánh sự khác nhau về giao diện, mà còn giải thích tại sao trên GUI, bạn dễ chỉ dừng lại ở việc “đặt câu hỏi và nhận câu trả lời”, trong khi trên CLI, bạn có thể kết nối mọi thứ với log thực tế, kiểm thử, Git và cả việc chuẩn bị triển khai. Sau đó, thông qua kiến trúc của Claude Code, bạn sẽ hiểu vì sao harness quan trọng hơn model, đồng thời tìm hiểu vai trò của memory giữa các phiên và CLAUDE.md, cũng như sự khác biệt giữa Plan/Thinking Mode và Subagents, giữa Skills và Tool use.

Tệp cấu hình harness có thể sao chép và sử dụng ngay lập tức

Các tệp cấu hình harness được tự tạo trong khóa học đều được cung cấp đầy đủ dưới dạng tệp hoàn chỉnh.
Sau khi học xong, bạn không cần phải viết lại từ đầu mà có thể sao chép vào dự án của mình và áp dụng ngay.

Các cấu hình được cung cấp như sau.

• CLAUDE.md
  Xác định các quy tắc làm việc mà Claude phải tuân theo trong dự án.

• codecraft-harness/SKILL.md
  Chuyển đổi các yêu cầu ngắn gọn, mơ hồ chỉ gồm một câu thành thiết kế cụ thể và kế hoạch triển khai.

• solid-review/SKILL.md
  Trước khi bắt đầu triển khai, kiểm tra xem việc phân tách trách nhiệm có phù hợp hay không và thiết kế có phức tạp không cần thiết hay không.

• block-sensitive-paths.sh
  Ngăn chặn truy cập vào các tệp và đường dẫn nhạy cảm như .env, SSH Key và thư mục cấp cao hơn của dự án.

• run-tests-after-edit.sh
  Tự động chạy các bài kiểm thử liên quan mỗi khi Claude sửa đổi tệp.

• block-stop-without-tests.sh
  Ngăn không cho báo cáo đã hoàn thành công việc khi chưa chạy kiểm thử hoặc khi kiểm thử thất bại.

• guard.sh
  Chặn cả các yêu cầu mạng bên ngoài không được phép, giúp thiết lập môi trường thực thi an toàn.

Hook có trong khóa học không chỉ là mã ví dụ đơn giản.
Tất cả đều đã được chạy và kiểm tra hoạt động trong môi trường thực tế.

Khi đăng ký tệp cấu hình, mỗi khi Claude chỉnh sửa mã, các bài kiểm thử sẽ tự động được chạy và khi kiểm thử thất bại, Claude không thể tùy tiện kết thúc bằng cách nói “Đã hoàn thành công việc”.

Tức là, vượt qua mức độ yêu cầu Claude xác minh bằng prompt, bạn sẽ học cách buộc hệ thống thực hiện quy trình xác minh.

3. Cẩm nang prompt theo từng mô hình

Dù sử dụng cùng một harness, mỗi mô hình lại có những chỉ dẫn dễ tuân theo và những chỉ dẫn dễ bỏ sót khác nhau.

Trong khóa học này, thay vì sử dụng cùng một prompt cho mọi mô hình, chúng tôi cung cấp 5 loại khối prompt có thể sao chép, trong đó tổng hợp những chỉ dẫn nào cần loại bỏ và những chỉ dẫn nào cần bổ sung phù hợp với đặc điểm của từng mô hình.

• Giảm bớt các chỉ dẫn xác minh do mô hình Opus 5
  tự thực hiện để tránh những công việc trùng lặp không cần thiết.

• Opus 4.8
  Quy định rõ ràng hơn các điều kiện thực thi công cụ để sử dụng đúng công cụ cần thiết vào đúng thời điểm.

• Sonnet 5
  Tìm hiểu cách ghi rõ ràng, cụ thể các tệp cần chỉnh sửa và phạm vi áp dụng.

• Haiku 4.5
  Trình bày quy trình thực hiện theo từng bước để có thể làm việc ổn định ngay cả với các mô hình không có tùy chọn effort.

• Fable 5
  Cung cấp để tham khảo cách không đưa quá nhiều chỉ dẫn cho mô hình mà chỉ giữ lại những hướng dẫn cần thiết.

Mỗi playbook cũng bao gồm các nội dung sau.

• Tổ hợp tham số gây ra 400 Error khi yêu cầu

• Các tham số mặc định và sự khác biệt trong hoạt động của từng mô hình

• Bảng ghi chép so sánh kết quả khi thay đổi giá trị effort

• Thực hành Lab 04 chạy cùng một prompt trên nhiều mô hình và so sánh kết quả

Bạn sẽ không chỉ giải thích “mô hình nào tốt hơn”, mà còn học cách trực tiếp tìm ra thiết lập tối ưu cho từng mô hình bằng cách lặp lại cùng một tác vụ và ghi chép kết quả.

Tài liệu thực hành Graph Engineering — Lab 05

Bạn sẽ trực tiếp so sánh cách xử lý tuần tự một nhiệm vụ phức tạp trong một lần với phương pháp Graph Engineering, trong đó nhiều nhiệm vụ được chia nhỏ và xử lý theo mối quan hệ phụ thuộc.

Phiếu học tập tương tác

Bạn có thể mở tệp HTML bằng trình duyệt để sử dụng mà không cần cài đặt riêng hoặc chạy máy chủ.

Bạn có thể phát lại từng bước để xem cùng một yêu cầu được xử lý khác nhau như thế nào theo hai phương thức dưới đây.

• Lần lượt thực hiện một luồng duy nhất theo kiểu vòng lặp

• Phương thức thực thi dạng đồ thị, chia công việc thành nhiều nút và các mối quan hệ phụ thuộc

Khi chọn từng bước, bạn cũng có thể xem tệp cấu hình đã tạo ra thao tác tương ứng, nhờ đó nhanh chóng hiểu được mối quan hệ giữa kết quả thực thi và cấu hình.

Hướng dẫn học tập theo từng bước

Cung cấp hướng dẫn học tập gồm tổng cộng 645 dòng.

Không giải thích dài dòng về lý thuyết ngay từ đầu, nội dung được 구성 theo thứ tự sau.

Xác nhận kết luận → Thực hành 30 phút → Khái niệm cốt lõi → Lý thuyết nâng cao

Lộ trình học dành cho người không chuyên và lộ trình học dành cho học viên có kinh nghiệm phát triển cũng được phân tách riêng.

Ngay cả những người lần đầu sử dụng Claude Code với phương pháp vibe coding cũng có thể bắt đầu từ phần thực hành, còn các nhà phát triển có thể học sâu hơn về cơ chế hoạt động bên trong và nguyên lý thiết kế.

3 loại dự án demo có thể trực tiếp chạy thử

Bạn không chỉ dừng lại ở việc đọc tệp cấu hình mà còn trực tiếp kiểm tra quá trình chạy claude trong thư mục dự án thực tế, nơi Hook chặn và xác thực công việc.

Mỗi dự án đều được cố ý chứa các vấn đề sau.

• Lỗi kiểu dữ liệu

• Kiểm thử thất bại

• Lỗi logic trông có vẻ bình thường ở bề ngoài

Học viên sẽ trực tiếp trải nghiệm quy trình sau.

Phát hiện vấn đề → Chặn tác vụ → Sửa mã → Chạy kiểm thử → Vượt qua bước xác minh

Dự án dạng vòng lặp và dự án dạng đồ thị sử dụng cùng một đoạn mã, chỉ khác nhau ở cấu hình harness.

Do đó, bạn có thể so sánh chính xác kết quả thay đổi như thế nào do sự khác biệt trong cách tổ chức công việc, chứ không phải do sự khác biệt về mã.

Tài liệu tham khảo

Sau khi học xong khóa học, chúng tôi cũng cung cấp tài liệu thực tiễn để bạn có thể tham khảo khi cấu hình dự án hoặc giải quyết vấn đề.

• Hướng dẫn thiết lập môi trường
  Tổng hợp cách chuẩn bị môi trường thực thi, đăng ký Hook, cùng các lỗi thường gặp và cách khắc phục.

• Phân biệt vai trò của Skill / Hook / CLAUDE.md / Test
  Giải thích từng thành phần đảm nhiệm những gì và nên sử dụng công cụ nào cho từng vấn đề.

• Danh sách kiểm tra harness
  Bạn có thể kiểm tra xem prompt, thiết kế, triển khai, kiểm thử và điều kiện hoàn thành có bị bỏ sót hay không.

• Thẻ câu hỏi và thẻ kiểm thử
  Cung cấp các câu hỏi sử dụng khi yêu cầu chưa rõ ràng, tiêu chí thiết kế kiểm thử và mẫu bảng kiểm chứng.

• Tài liệu playbook theo từng mô hình
  Tổng hợp thông số, đặc tính hoạt động và tiêu chí viết prompt của từng mô hình tại một nơi.

• Bảng ghi chép đánh giá mô hình
  Bạn có thể thực hiện cùng một tác vụ với nhiều mô hình và cấu hình khác nhau, sau đó so sánh và ghi lại kết quả.

Các tài liệu này không chỉ đơn thuần là phần phụ lục của khóa học, mà được biên soạn thành cẩm nang vận hành Claude Code Harness mà bạn có thể sử dụng nhiều lần trong các dự án thực tế.

Người tạo ra khóa học này

• Người sống sót tại Thung lũng Silicon | Ốc sên Mỹ 

  Dựa trên kinh nghiệm và bí quyết tích lũy tại tuyến đầu của Global Tech Scene, khóa học này chỉ ra con đường để những người không chuyên công nghệ vượt qua rào cản kỹ thuật và trở thành chủ nhân của doanh nghiệp.

  • Hiện tại) Nhà sáng lập startup về AI coding & agent tinh chỉnh mô hình cục bộ tại Silicon Valley

    • Phát triển và vận hành Closiro CLI/Mac Desktop (hơn 20K lượt tải xuống)

    • Được chọn vào Chương trình Google for Startups

    • Được chọn tham gia Anthropic for Startups Program

  • Trước đây) Sự nghiệp kỹ sư tại các công ty công nghệ lớn của Mỹ và những startup đầy triển vọng

    • Đã từ bỏ ở vòng cuối cùng của Amazon để khởi nghiệp

    • Kỹ sư tại startup AI fintech ở Thung lũng Silicon

    • Học bổng toàn diện OpenAI / Meta / Apple / Adobe / Amazon

    • Cổng thông tin công cụ tìm kiếm trong nước, phát triển fintech

    • Phát triển AR/B2B/SDK cho startup AI

  • Năng lực đào tạo đã được kiểm chứng

    • Tốt nghiệp chương trình 4 năm tại trường đại học ở Seoul, học song ngành Khoa học Máy tính/Quản trị Kinh doanh và có nhiều kinh nghiệm khởi nghiệp

    • Đã đào tạo hơn 2100 học viên, sở hữu hơn 4.5K người theo dõi trên SNS Threads / hơn 500 người theo dõi trên Substack

    • Threads: https://www.threads.com/@rich_l_2024?igshid=NTc4MTIwNjQ2YQ==

    • Substack: https://open.substack.com/pub/1234373801

Bạn có điều gì thắc mắc không?

Lưu ý trước khi tham gia khóa học