Bỏ qua đến nội dung chính

Building with Claude Code

📖 Nội dung bài học

Video

Xây dựng với Claude Code

Viết code gọi Claude API thủ công vẫn ổn, nhưng có một cách nhanh hơn nữa: để Claude viết code cho bạn. Trong bài học này, chúng ta sẽ dùng Claude Code để hoàn thiện một tích hợp API từ một file đã được tạo sẵn (stubbed-out file) — sử dụng các primitive bạn đã học trong suốt khóa học này.

Bắt đầu từ một stub

Dự án rất đơn giản: một file TypeScript lấy thông tin thời tiết. Nó chứa hai stub:

  • getWeather — nhận vào một thành phố và trả về nhiệt độ cùng điều kiện thời tiết.
  • run — một hàm sẽ dùng tool runner và Claude TypeScript SDK.

tool runner là thành phần xử lý tool calling và agent loop cho bạn, để bạn không phải tự kết nối chúng thủ công.

skill Claude API

Claude Code đi kèm với một skill tích hợp sẵn gọi là Claude API. Bạn có thể gọi nó trực tiếp bằng /claude-api, hoặc Claude Code sẽ tự động gọi nó khi phát hiện bạn đang dùng TypeScript SDK.

Nếu bạn không thấy skill này, bạn có thể thêm nó từ marketplace:

/plugin marketplace add AnthropicsSkills

Lưu ý chữ s ở cuối Anthropics — rất dễ bỏ sót.

Claude Code's Add Marketplace dialog after running the /plugin marketplace add command

Một prompt, code hoạt động

Mở thư mục dự án trong terminal của bạn và khởi chạy Claude Code.

Từ đó, nó chỉ cần một prompt duy nhất. Một prompt tốt thực hiện ba điều:

  • nêu tên file bạn muốn thay đổi.
  • nêu tên pattern bạn muốn dùng.
  • nêu tên trạng thái cuối cùng bạn mong đợi.

Claude Code sau đó điền vào getWeatherrun dựa trên các type, thêm một lời gọi vào cuối file, thực thi script và báo cáo kết quả đầu ra. Nếu có lỗi xảy ra, nó sẽ đọc thông báo lỗi và vá code ngay tại chỗ.

Claude Code in the terminal reading weather.ts and the tool runner file after receiving the prompt

Những gì Claude Code đã tạo ra

Trong lần chạy này, Claude Code đã tạo một Zod tool phân tích cú pháp đầu vào và trả về đầu ra dựa trên loại thành phố. Nó cũng tạo ra tool runner và hàm run mà chúng ta yêu cầu, và in ra kết quả cuối cùng của agent loop.

Claude Code generating the weather code in the terminal, with the betaZodTool import and hardcoded city data visible

Pattern cần nhớ

Hầu hết những gì bạn viết với Claude API đều có một hình dạng quen thuộc:

  1. Định nghĩa một tool.
  2. Chuyển nó cho một runner.
  3. Trả về kết quả.

Bạn không cần phải gõ lại điều đó từ trí nhớ mỗi lần. Thay vào đó, hãy tạo stub file, chuyển nó cho Claude Code và chỉ cần xem lại diff.

Tóm tắt

  • Claude Code là một agent chỉnh sửa file và chạy lệnh bên trong terminal của bạn.
  • skill Claude API tích hợp sẵn tự động tải khi Claude Code phát hiện TypeScript SDK, hoặc bạn có thể gọi nó bằng /claude-api.
  • Cung cấp cho nó một prompt nêu tên file, pattern và trạng thái cuối cùng — nó sẽ viết code, chạy và sửa lỗi ngay tại chỗ.
  • Code Claude API tuân theo một hình dạng quen thuộc: định nghĩa một tool, chuyển nó cho một runner, trả về kết quả. Tạo stub, ủy quyền cho nó, xem lại diff.

🎬 Bản ghi video

Source video: Zq_c7xMbxto

Không có transcript — xem phần nội dung bài học bên trên.

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?