Giao diện
Cách dùng tài liệu này
Mục tiêu của cả bộ tài liệu: sau buổi học, bạn tự đưa được một app từ ý tưởng tới bản chạy được, phần lớn việc do AI agent làm, còn bạn ra quyết định và duyệt ở vài điểm mốc.
Công cụ chính là Claude Code. Codex (OpenAI) có mặt ở các trang khối nền và chương 7 dưới dạng đối chiếu, để bạn nào dùng Codex vẫn theo được.
Đọc theo thứ tự nào
| Bước | Dùng gì | Để làm gì |
|---|---|---|
| 1 | Slide (trong buổi học) | Nắm bức tranh chung thật nhanh |
| 2 | Handbook (trang này trở đi) | Hiểu từng khối, đọc lại khi cần |
| 3 | Lab ở chương 9 | Tự chạy trọn một vòng, ra app thật |
Trong handbook, nên đọc theo mạch:
- Hiện trạng: mình đang ở nấc tự động nào, muốn lên nấc nào.
- Các khối nền: 8 thứ tạo nên một "dự án biết cách làm việc với agent".
- Workflow chính: brainstorm → spec → plan → thực thi → review. Đây là chương quan trọng nhất.
- Bức tranh framework, Lên mức tự động, Rào chắn và chi phí: khi đã quen vòng chính.
- Claude Code ↔ Codex và Cheat sheet: tra cứu.
Đi học mà hết giờ? Chỉ cần đọc chương 1 và chương 3, rồi làm lab.
Cần có gì
bunvàgittrên máy. Bài về nhà (Ralph loop) cần thêmjqtrong PATH: hook của plugin gọijq, thiếu thì vòng lặp lặng lẽ dừng sau vòng đầu.- Claude Code đã đăng nhập bằng tài khoản first-party (gói Pro, Max hoặc Team).
- Không cần cloud DB hay dịch vụ trả phí nào khác: lab dùng SQLite cục bộ.
Vì sao cần first-party
Một số tính năng trong tài liệu (ví dụ You Should Know, xem Plugin) chỉ chạy ở phiên first-party có bật telemetry. Gói Pro có thể hết lượt giữa buổi; khi đó xem người dạy demo trên máy của họ.
Tài liệu không có mục xử lý lỗi cài đặt. Máy nào cũng khác nhau, và chính agent trên máy bạn là thứ giỏi nhất trong việc tự gỡ lỗi môi trường.
Quy ước trong tài liệu
- Mỗi trang ghi ngày kiểm chứng ở đầu (
verified). Lệnh, tên setting, phiên bản đúng tại ngày đó. - Thông tin chỉ bên thứ ba nói được ghi rõ là "theo báo cáo cộng đồng, chưa có trong docs chính thức".
- Thuật ngữ kỹ thuật giữ tiếng Anh; lần đầu xuất hiện có kèm cách hiểu tiếng Việt.
- Đường dẫn dạng
practice/starter/...là file trong repo tài liệu này. Mở trực tiếp trong repo để xem đầy đủ.
Nguồn
- Claude Code docs: https://code.claude.com/docs/en/changelog
- Codex docs: https://learn.chatgpt.com/docs/agent-configuration/agents-md