học cách cài đặt Claude Code, viết agent đầu tiên từ đầu, và cuối cùng có được một thứ thực sự: một agent hoạt động, có thể đọc một thư mục, phát hiện vấn đề và viết báo cáo, mà không cần bất kỳ kinh nghiệm lập trình nào.
một chatbot chờ bạn đặt câu hỏi và trả lời nó. một AI agent thì khác: bạn giao cho nó một mục tiêu, và nó tự tìm ra các bước, đọc file, chạy lệnh, và tự động hành động cho đến khi công việc hoàn thành. bạn không phải điều khiển từng bước. bạn chỉ đang đặt ra điểm đến.
sự khác biệt đó rất quan trọng vì nó thay đổi những gì bạn có thể tự động hóa. bạn không phải gõ từng lời nhắc một. bạn đang xây dựng một thứ tự động làm việc trong khi bạn tập trung vào việc khác.
Những Gì Bạn Cần Trước Khi Bắt Đầu
đây là tất cả những gì cần thiết trước khi bạn chạm vào bất kỳ lệnh nào:
- một tài khoản Claude với gói trả phí (Pro ở mức $20/tháng là tối thiểu; Claude Code được bao gồm)
- một máy Mac chạy macOS 13 trở lên, hoặc máy tính Windows, hoặc máy Linux
- một kết nối internet
- khoảng 30 đến 45 phút cho việc thiết lập đầy đủ và xây dựng lần đầu
không yêu cầu kinh nghiệm lập trình trước đó. mọi lệnh trong hướng dẫn này đều được viết đầy đủ. bạn sao chép, dán và nhấn Enter.
chi phí để làm theo hướng dẫn này: $0 ngoài gói đăng ký của bạn. Claude Code được bao gồm trong tất cả các gói Claude trả phí.
Cài Đặt Claude Code (Cách Dùng Ứng Dụng Desktop, Không Cần Terminal)
cách dễ nhất cho người mới bắt đầu là ứng dụng desktop. nó cung cấp cho bạn toàn bộ sức mạnh của Claude Code mà không cần phải học các lệnh terminal trước.
truy cập claude.ai và tải xuống ứng dụng desktop cho nền tảng của bạn. trên macOS, mở file .dmg và kéo Claude vào thư mục Applications. trên Windows, chạy trình cài đặt. khởi chạy ứng dụng, đăng nhập bằng tài khoản Claude của bạn, và nhấp vào tab Code ở giữa trên cùng của màn hình.
nếu tab Code yêu cầu bạn nâng cấp gói, thì gói hiện tại của bạn không bao gồm Claude Code. nếu nó yêu cầu bạn đăng nhập trực tuyến, hãy hoàn tất đăng nhập và khởi động lại ứng dụng. dù thế nào, bạn sẽ đến một không gian làm việc sạch sẽ khi đã vào được.
dấu hiệu thành công: bạn thấy một hộp nhập lệnh trống với tab Code đang hoạt động và không có thông báo lỗi. đó là không gian làm việc agent của bạn. mọi thứ bạn xây dựng đều ở đây.
Những Gì Bạn Sẽ Xây Dựng
bạn sẽ xây dựng một agent cụ thể và bạn sẽ sử dụng nó xuyên suốt hướng dẫn này.
công việc của agent: đọc một thư mục chứa các file văn bản, tìm bất kỳ file nào thiếu dòng tiêu đề ở đầu, và viết một báo cáo có tên \missing-titles.txt\ liệt kê mọi file cần sửa.
đây là một nhiệm vụ thực tế, hữu ích. nó thể hiện mọi hành vi cốt lõi của agent: đọc file, đưa ra quyết định và viết đầu ra. và nó đủ đơn giản để bạn có thể tự kiểm tra bằng mắt khi nó hoạt động.
Bước 1: Tạo Thư Mục Làm Việc Của Bạn
tạo một thư mục mới trên Desktop của bạn có tên \my-agent\. đây là nơi agent sẽ làm việc. nó chỉ có thể nhìn thấy và chạm vào các file bên trong thư mục này, điều này giữ mọi thứ an toàn và được kiểm soát.
bên trong \my-agent\, tạo một thư mục thứ hai có tên \articles\. đây là nơi agent sẽ tìm kiếm các file để kiểm tra.
bây giờ, hãy tạo bốn file văn bản thuần túy bên trong \articles\. đặt tên chúng là \post-one.txt\, \post-two.txt\, \post-three.txt\ và \post-four.txt\. mở hai trong số chúng và thêm dòng này làm dòng đầu tiên:
\\`
Title: My Article
\\`
để hai file còn lại hoàn toàn trống. nhiệm vụ của agent là tìm ra những file trống đó.
dấu hiệu thành công: cấu trúc thư mục của bạn là \my-agent/articles/\ và nó chứa bốn file .txt, hai file có dòng tiêu đề và hai file không có.
Bước 2: Viết File Hướng Dẫn CLAUDE.md
CLAUDE.md là một file văn bản thuần túy mà Claude Code đọc khi bắt đầu mỗi phiên làm việc. nó là hướng dẫn thường trực cho agent của bạn, tương đương với một bản mô tả công việc mà nó không bao giờ quên.
bên trong thư mục \my-agent\ (không phải bên trong \articles\), tạo một file mới có tên \CLAUDE.md\. mở nó trong bất kỳ trình soạn thảo văn bản nào, bao gồm Notepad trên Windows hoặc TextEdit trên Mac, và dán chính xác nội dung này:
\\`
My File Checker Agent
Công việc của bạn
Kiểm tra mọi file .txt bên trong thư mục /articles.
Những gì cần tìm kiếm
Một file hợp lệ bắt đầu bằng một dòng có nội dung chính xác: Title:
Nếu dòng đầu tiên không bắt đầu bằng "Title:", file đó đang thiếu tiêu đề của nó.
Những gì cần làm
- Đọc từng file .txt trong /articles một cách tuần tự.
- Ghi chú lại những file nào thiếu dòng Title.
- Viết một file có tên missing-titles.txt trong thư mục chính.
- Trong file đó, liệt kê mọi tên file đã không vượt qua được kiểm tra, mỗi tên trên một dòng.
- Nếu tất cả các file đều đạt yêu cầu, hãy viết "All files have titles." vào file missing-titles.txt để thay thế.
Những gì không được làm
Không chỉnh sửa bất kỳ file bài viết nào. Chỉ đọc. Chỉ ghi vào file missing-titles.txt.
\\`
lưu file lại. đây là toàn bộ bộ não của agent của bạn. Claude Code sẽ đọc nó trước khi làm bất cứ điều gì.
dấu hiệu thành công: bạn có một file tại \my-agent/CLAUDE.md\ và nó chứa các hướng dẫn ở trên.
Bước 3: Trỏ Claude Code Vào Thư Mục Của Bạn
mở ứng dụng desktop Claude Code và nhấp vào biểu tượng thư mục hoặc tùy chọn "Open folder" để điều hướng đến thư mục \my-agent\ của bạn. chọn nó và xác nhận.
Claude Code sẽ tự động đọc file CLAUDE.md của bạn. bạn sẽ không thấy thông báo xác nhận cho việc này, nó diễn ra ngầm trong nền mỗi khi bạn mở một thư mục.
nếu bạn đang sử dụng terminal thay vì ứng dụng desktop, hãy mở terminal của bạn và chạy:
\\`bash
cd ~/Desktop/my-agent
claude
\\`
lệnh \cd\ có nghĩa là "change directory" (thay đổi thư mục). nó di chuyển bạn vào thư mục \my-agent\ của bạn. gõ \claude\ sẽ bắt đầu phiên agent từ bên trong thư mục đó.
Bước 4: Chạy Agent
trong hộp nhập lệnh ở cuối giao diện Claude Code, hãy gõ chính xác nội dung này:
\\`
Đọc mọi file .txt trong thư mục articles. Tìm bất kỳ file nào thiếu dòng Title ở đầu. Ghi kết quả vào file missing-titles.txt như đã được hướng dẫn trong CLAUDE.md.
\\`
nhấn Enter. hãy quan sát những gì xảy ra.
Claude Code sẽ hiển thị công việc của nó khi nó chạy: nó đang đọc những file nào, nó tìm thấy gì trong mỗi file và nó ghi những gì. sự minh bạch này là có chủ đích. bạn có thể thấy mọi hành động trước khi nó xảy ra và dừng nó lại nếu có điều gì đó có vẻ sai.
dấu hiệu thành công: Claude đọc bốn file, xác định hai file không có tiêu đề và tạo file \missing-titles.txt\ trong thư mục \my-agent\ của bạn. mở file đó và bạn sẽ thấy hai tên file được liệt kê, mỗi tên trên một dòng.
Lỗi Thường Gặp Của Người Mới: Agent Nói Đã Xong Nhưng File Lại Trống
điều này xảy ra khi agent viết file \missing-titles.txt\ nhưng thực sự không đặt bất cứ thứ gì vào đó. nguyên nhân hầu như luôn luôn là do hướng dẫn trong CLAUDE.md quá mơ hồ.
cách khắc phục: mở CLAUDE.md và làm cho các hướng dẫn đầu ra rõ ràng hơn. thay vì "liệt kê các file", hãy viết "viết mỗi tên file trên một dòng riêng, như thế này: post-two.txt." các ví dụ cụ thể trong hướng dẫn của bạn sẽ tạo ra đầu ra cụ thể mọi lúc.
nếu agent viết sai tên file hoặc bỏ sót một file, hãy kiểm tra xem các file bài viết của bạn có thực sự có phần mở rộng \.txt\ hay không và không phải là \.txt.txt\, điều này có thể xảy ra trên Windows khi phần mở rộng file bị ẩn. hãy bật "show file extensions" (hiển thị phần mở rộng file) trong cài đặt File Explorer của bạn để kiểm tra.
Bước 5: Xác Minh và Mở Rộng
mở \missing-titles.txt\ và xác nhận nó liệt kê chính xác hai file bạn đã để trống. nếu đúng như vậy, agent của bạn đã hoạt động chính xác từ đầu đến cuối.
bây giờ bạn đã có một agent hoạt động. nó nằm trong \my-agent\, nó đọc từ \CLAUDE.md\ và nó có thể được chạy bất cứ lúc nào bạn thả các file mới vào thư mục \articles\ và chạy cùng một lời nhắc.
một bước tiếp theo rõ ràng: cập nhật CLAUDE.md để cũng kiểm tra xem mỗi file có dài hơn năm dòng hay không. thêm nội dung này vào mục "Những gì cần tìm kiếm":
\\`
Một file hợp lệ cũng có nhiều hơn 5 dòng nội dung.
Nếu một file có 5 dòng hoặc ít hơn, hãy gắn cờ nó là "quá ngắn" cùng với việc kiểm tra tiêu đề.
\\`
chạy lại agent với cùng một lời nhắc. bây giờ nó sẽ kiểm tra hai thứ thay vì một, mà không cần thay đổi lời nhắc của bạn, chỉ cần thay đổi file hướng dẫn.
Những Gì Bạn Vừa Xây Dựng và Tại Sao Nó Quan Trọng
bạn đã xây dựng một agent có thể đọc file, đưa ra quyết định và viết đầu ra, mà không cần bạn giám sát từng bước. đó là mô hình cốt lõi đằng sau mọi agent tiên tiến hơn mà bạn sẽ xây dựng.
file CLAUDE.md là phần có thể mở rộng. mọi quy tắc mới, kiểm tra mới hoặc định dạng đầu ra mới mà bạn thêm vào đó sẽ thay đổi những gì agent làm mà không làm thay đổi cách bạn chạy nó. lời nhắc vẫn giữ nguyên. các hướng dẫn phát triển.
từ đây, các phần mở rộng tự nhiên là: kiểm tra nhiều loại file hơn, viết báo cáo ở một định dạng khác như CSV, hoặc chạy kiểm tra theo lịch trình bằng tính năng Routines tích hợp sẵn của Claude Code.
có câu hỏi về bước nào không? hãy để lại bên dưới.
