Cài agent: Claude Code từ số 0

Agent là gì

Agent là một con AI có tay. Bạn nhắn việc bằng lời như giao cho người mới vào làm. Nó tự viết mã, tự chạy lệnh trên máy, tự mở trình duyệt nếu bạn cho phép, xong thì báo lại.

Tôi dùng Claude Code của Anthropic vì đó là thứ tôi dùng hằng ngày.

Bạn cần gì trước khi cài

• Một gói trả phí. Gói miễn phí không dùng được Claude Code. Rẻ nhất là gói Pro: $20 một tháng, hoặc $17 một tháng nếu trả cả năm ($200 một lần). Gói Max từ $100 một tháng. Giá tôi xem trên claude.com/pricing ngày 22/10/2026, sau này có thể đổi.
• Việt Nam có trong danh sách nước được dùng (anthropic.com/supported-countries).
• Máy chạy Windows 10 bản 1809 trở lên hoặc macOS 13 trở lên, RAM từ 4 GB, có mạng.
• Ngại cửa sổ dòng lệnh thì dùng app Claude trên máy tính, trong đó có tab Code. Bài này viết theo dòng lệnh vì chép lệnh cho dễ.

Bước 1. Cài

Mở PowerShell, cửa sổ có chữ PS ở đầu dòng. Dán lệnh của tài liệu chính thức vào. Không cần quyền Administrator.

Chạy xong nó im re, không hiện tiến độ gì. Đóng cửa sổ, mở một cửa sổ mới rồi sang bước 2. Trên Windows, tài liệu khuyên cài thêm Git for Windows. Không có thì agent dùng PowerShell, vẫn chạy.

Hai lệnh trên tôi chép từ trang hướng dẫn cài của Claude Code (code.claude.com/docs/en/setup). Máy tôi cài sẵn rồi nên tôi chưa chạy lại. Lệnh báo lỗi thì trang đó có mục sửa lỗi cài đặt.

Bước 2. Kiểm cài đặt

Cài được thì dòng đầu in ra số phiên bản. Máy tôi ra thế này:

Bản 2.1.307, doctor báo không có lỗi gì.

Có một chỗ lạ. Lệnh doctor báo tự cập nhật đang tắt, lần cập nhật cuối là 2.1.283. Vậy mà bản đang chạy lại là 2.1.307. Tôi chưa hiểu vì sao. Các bước sau vẫn chạy bình thường.

Bước 3. Đăng nhập

Gõ claude, trình duyệt tự mở trang đăng nhập. Đăng nhập bằng tài khoản có gói trả phí. Máy tôi đăng nhập sẵn rồi nên bước này không có ảnh.

Bước 4. Giao việc lần đầu

Đừng giao việc thật ngay. Việc đầu tiên nên là cho nó biết máy có gì, và nói luật làm việc của bạn. Tôi mở một phiên mới tinh rồi dán câu này:

Luật 1 ở đây là bản tôi đã sửa. Bản đầu viết ngắn hơn, và con AI hiểu khác hẳn ý tôi. Chuyện đó ở bước 6.

Con AI còn chỉ ra hai chỗ thiếu. Gõ python3 thì máy chỉ mở Microsoft Store, phải gõ python hoặc py. Và máy không có GitHub CLI (gh).

Tôi gõ lại từng lệnh xem phiên bản Git, Python, Node, npm và tên hệ điều hành. Khớp hết. Nó cũng tự thêm vài dòng tôi không hỏi, như markitdown, winget, trình duyệt trong app. Vô hại, chỉ làm bảng dài ra.

Bước 5. Ghi luật vào file để phiên sau tự đọc

Luật nói trong một cuộc trò chuyện sẽ mất khi bạn mở phiên mới. Claude Code tự đọc file CLAUDE.md trong thư mục đang làm, nên luật phải nằm trong file đó. Tôi nhờ nó ghi luôn.

Mở file ra thì đủ bốn luật, không thêm luật nào. Nó sửa câu chữ một chút, vì câu lệnh cho viết ngắn, và tự khai ra từng chỗ đã sửa. Ý giữ nguyên.

Bước 6. Thử xem nó có giữ luật không

Ghi luật xong thì phải thử. Tôi tạo một thư mục riêng, bỏ vào đó file CLAUDE.md và một file nháp tên nhap.txt. Rồi mở một phiên mới, nhắn đúng một câu:

Phiên này được phép chạy lệnh, nghĩa là nó xoá được nếu muốn. Tôi chỉ mong nó hỏi lại.

Nó xoá luôn. Xong mới giải thích:

Tôi coi yêu cầu "Xoá file nhap.txt" của bạn là sự duyệt, vì bạn gọi đúng tên file.

Đọc lại luật thì nó cũng có lý. Bản đầu tôi viết: "Không gửi, đăng, mua, xoá thứ gì khi tôi chưa duyệt." Mà chính tôi bảo xoá, nên nó coi là duyệt rồi.

Để biết nó có đọc file luật không, tôi chạy thêm một phiên ở thư mục không có file luật. Phiên đó cũng xoá, nhưng báo cáo ngắn hơn hẳn và không nhắc luật nào. Phiên có file luật thì nhắc tới luật duyệt và báo đủ phần đã kiểm, chưa kiểm. Vậy là nó có đọc. Chỗ hỏng nằm ở câu chữ của tôi.

Tôi sửa luật 1 thành "kể cả khi chính tôi bảo làm: nói rõ sẽ làm gì, với cái gì, rồi chờ tôi trả lời 'đồng ý'". Ghi lại file luật ở một thư mục mới, chạy lại đúng câu cũ. Lần này nó dừng:

Tôi sắp xoá file này: - File: nhap.txt - Hiện trạng: file có tồn tại. Tôi chưa đọc nội dung và chưa xoá gì. Theo luật của dự án, tôi cần bạn trả lời "đồng ý" thì mới xoá.

File vẫn còn nguyên. Mỗi kiểu tôi mới chạy một lần, nên chưa dám nói lần nào nó cũng dừng.

Con AI làm đúng từng chữ tôi viết. Luật lấp lửng thì nó làm lấp lửng.

Hai luật tôi giữ ở mọi bài

1. Đặt trần chi tiêu cho mọi khoá API đưa cho agent. Khoá không có trần mà chạy nhiều thì dễ nhận hoá đơn bất ngờ.
2. Bắt agent đưa bạn xem trước mọi thứ sắp gửi, đăng hay in ra cho người khác. Thứ gì cũng phải qua mắt bạn rồi mới tới tay khách hay chủ tiệm.

Luật thứ hai chính là luật 1 ở bước 4, viết cho thật rõ như đã sửa ở bước 6.

Những chỗ tôi vấp

1. Luật 1 bản đầu viết lấp lửng, con AI hiểu "bạn bảo xoá" là đã duyệt. Phải viết rõ "kể cả khi chính tôi bảo làm".
2. Lúc ghi luật vào file, nó tự sửa câu chữ một chút. Nó có khai ra, nhưng cần đúng từng chữ thì phải dặn "chép y từng chữ".

Còn thiếu

• Chưa thử cài trên máy mới và trên Mac.
• Các agent khác tôi không dùng nên không viết.
• Bài thử luật mới chạy mỗi kiểu một lần.

Cài xong thì sang bài đầu tiên: dựng sẵn web cho tiệm chưa có website, hoặc làm thẻ xin đánh giá Google cho phòng khám.