Khóa học
Claude Code 101
3 giờ
28.3K
Sử dụng Claude API của Anthropic cho phép bạn đi xa hơn việc chỉ trò chuyện với chatbot. Nó giúp bạn tích hợp toàn bộ năng lực của Claude AI vào các ứng dụng của mình.
Anthropic đã gây sốc cho giới AI khi ra mắt Fable 5, một mô hình mạnh đến mức chính phủ Mỹ đã tạm thời hạn chế quyền truy cập ngay sau khi ra mắt. Mặc dù mô hình đã được khôi phục cho người dùng toàn cầu, cách chúng ta truy cập đã thay đổi.
Anthropic hiện chỉ cho phép truy cập Fable 5 qua API dựa trên tín dụng tính theo mức sử dụng (việc cắt chuyển này có hiệu lực sau một đợt gia hạn năm ngày ngắn).
Điều này có nghĩa là chúng ta phải suy nghĩ lại cách tương tác với AI. Các mô hình mạnh và công cụ lập trình tự động cần nhiều tài nguyên tính toán hơn đáng kể so với các gói người dùng tính phí cố định có thể cung cấp.
Trong hướng dẫn này, tôi sẽ giúp bạn chuẩn bị cho thực tế mới này bằng cách tìm hiểu cách sử dụng Claude API.
Tôi sẽ chỉ cho bạn cách thiết lập Claude Code với Anthropic Developer API. Bằng cách chuyển sang mô hình trả phí theo mức sử dụng ngay hôm nay, bạn sẽ đảm bảo truy cập liên tục vào các mô hình tiên tiến như Fable 5, loại bỏ giới hạn tốc độ vô hình và học cách chạy các phiên lập trình phức tạp trực tiếp từ terminal.
Nếu bạn cần tài liệu tham khảo nhanh, hãy xem cheat sheet Claude API trong Python.
Vì sao bạn cần Claude API thay vì thuê bao Claude Pro
Với nhiều người, gói Claude Pro 20 USD/tháng là cách lý tưởng để truy cập AI hàng đầu. Nó mang lại mức giá cố định và quyền truy cập ổn định.
Tuy nhiên, sự trỗi dậy của các công cụ lập trình tự động đã hoàn toàn thay đổi bài toán. Các quy trình tác tử (agentic) đòi hỏi nhiều tài nguyên hơn nhiều so với một thuê bao tiêu chuẩn có thể cung cấp, khiến Claude API trở thành lựa chọn khả thi duy nhất cho các nhà phát triển nghiêm túc.
Dưới đây là ba lý do chính để từ bỏ gói thuê bao và dùng Claude Code trực tiếp qua API.
Cạn token do công cụ tác tử
Các gói tiêu chuẩn gặp khó với các công cụ như Claude Code vì cách chúng vận hành.
Không giống một phiên chat web đơn giản, công cụ lập trình tự động phải liên tục quét toàn bộ dự án để hiểu nó đang làm việc trên những gì.
Mỗi lần chúng ta giao việc, nó sẽ đi qua nhiều bước: đọc tệp, kiểm tra cấu trúc, chạy kiểm thử. Điều này đòi hỏi gửi một lượng dữ liệu khổng lồ qua lại để luôn cập nhật trạng thái hiện tại của mã.
Quy trình này tiêu tốn token rất nhanh. Với thuê bao Pro, các quy trình phức tạp này có thể dùng hết giới hạn sử dụng nhiều giờ của chúng ta chỉ trong vài phút, khiến công việc bị dừng đột ngột.
Bảo vệ dung lượng sử dụng hằng ngày của bạn
Tài khoản Claude Pro dùng chung một bể tài nguyên. Nếu chúng ta dùng tài khoản chính cho lập trình qua terminal, những tác vụ tự động nặng sẽ lấy mất dung lượng dành cho trình duyệt hoặc ứng dụng di động.
Không ai muốn bị khóa khỏi một cuộc trò chuyện đơn giản chỉ vì một tác vụ lập trình nền chạm trần. Chuyển công cụ phát triển qua Claude API sẽ giữ công việc lập trình chuyên nghiệp tách biệt hoàn toàn khỏi việc dùng AI hằng ngày của bạn.
Quyền truy cập độc quyền vào các mô hình hạng nặng
Khi Anthropic ra mắt các mô hình xây dựng riêng cho kỹ thuật hạng nặng và công việc tự động, như Claude Fable 5, họ đang rời xa các gói tính phí cố định.
Vì Fable 5 đòi hỏi năng lực tính toán khổng lồ, Anthropic xác nhận rằng mô hình này cuối cùng sẽ yêu cầu hình thức tính phí theo mức sử dụng để quản lý chi phí vận hành cao.
Sự hạn chế này là hình dung trước về tương lai. Bám vào thuê bao người dùng đồng nghĩa bạn sẽ mất quyền truy cập vào các bộ máy suy luận mạnh nhất của Anthropic, khiến tài khoản Claude API trở thành điều kiện bắt buộc để luôn ở tuyến đầu.
Claude API so với thuê bao Claude
Sự khác biệt giữa thuê bao người dùng và API cho nhà phát triển nằm ở đánh đổi giữa chi phí dự đoán được và quyền truy cập không gián đoạn.
Thuê bao Claude mang lại mức phí cố định hằng tháng.
Chúng ta có thể dùng cường độ cao một thời gian, rồi cuối cùng sẽ chạm phải giới hạn sử dụng động tùy theo tải máy chủ. Khi Claude Code đụng phải bức tường vô hình này giữa dự án, nó sẽ dừng hẳn.
Chúng ta buộc phải chờ vài giờ để giới hạn được đặt lại trước khi tác tử có thể hoàn tất việc viết mã.
Claude API gỡ bỏ “bánh tập” này. Không có giới hạn thông điệp theo giờ, không băng thông dùng chung, không thời gian chờ. Nếu chúng ta muốn Fable 5 tái cấu trúc một codebase khổng lồ suốt tám giờ liền, API sẽ thực thi mọi lệnh mà không bị ngắt quãng.
Tuy nhiên, sự tự do này kéo theo một rủi ro lớn: vỡ ngân sách. Dùng thuê bao có thể gây bực bội khi chạm giới hạn, nhưng ít nhất chúng ta biết chính xác hóa đơn cuối tháng là bao nhiêu.
Điều này đặc biệt nguy hiểm với các mô hình đắt đỏ như Fable 5.
Quản lý chi phí Claude API và kiểm soát ngân sách
Có hai cách để kiểm soát ngân sách khi dùng API.
Thứ nhất, đảm bảo tắt tính năng tự động nạp tiền (auto-reload). Auto-reload sẽ cho phép Claude tự động mua tín dụng khi hết.
Do mức tiêu thụ token khi dùng Claude Code rất khó dự đoán, tôi khuyến nghị mạnh mẽ không bật tính năng này.
Thứ hai là lựa chọn cẩn thận mô hình sử dụng.
Fable 5 rất mạnh trong việc giải bài toán phức tạp và triển khai ứng dụng phức tạp. Tuy nhiên, nó thường là “dùng dao mổ trâu giết gà” cho các tác vụ đơn giản.
Cá nhân tôi thích dùng các mô hình rẻ hơn và chỉ chuyển sang mô hình đắt hơn khi mô hình rẻ thất bại sau nhiều lần thử. Mô hình tôi dùng nhiều nhất thực ra là Haiku 4.5.
Để chọn mô hình, hãy dùng lệnh /model.
Thiết lập Claude API từng bước (với Fable 5)
Nếu bạn tìm một hướng dẫn riêng về Claude Fable 5 API, hãy xem bài hướng dẫn riêng của chúng tôi.
Để bắt đầu, đăng nhập vào nền tảng web Claude và thiết lập thanh toán. Tiếp theo, mở terminal và cài đặt Claude Code bằng lệnh:
npm install -g @anthropic-ai/claude-codeSau khi cài đặt, chúng ta có thể chạy bằng cách gõ claude trong terminal. Lần chạy đầu, nó sẽ yêu cầu cấu hình. Hãy nhớ chọn “API usage billing” trong quá trình thiết lập:
Sau đó, Claude sẽ mở trình duyệt và yêu cầu quyền liên kết tài khoản và tạo khóa API cho chúng ta. Nhấn “Authorize” và tài khoản sẽ được liên kết tự động.
Khi hoàn tất thiết lập, chúng ta sẵn sàng bắt đầu xây dựng với Claude Code:
Trong trường hợp của tôi, Claude Code đã chạy với Fable 5. Nếu không, chúng ta có thể chọn mô hình bằng lệnh /model và chọn Fable 5 từ menu.
Chuyển Claude Code từ thuê bao sang API
Với những ai đã dùng Claude Code bằng thuê bao và muốn chuyển sang tính phí qua API, quy trình rất đơn giản.
- Đăng xuất bằng lệnh
/logout. - Chạy lại Claude Code bằng lệnh
claudevà chọn phương thức đăng nhập “Anthropic Console account · API usage billing”.
Nếu chúng ta hết tín dụng khi Claude Code đang triển khai một tính năng, nó sẽ dừng và thông báo cần nạp thêm tín dụng.
Sau khi thêm tín dụng, nếu Claude vẫn đang chạy, chỉ cần yêu cầu tiếp tục bằng một prompt, nó sẽ làm tiếp từ chỗ dừng. Nếu không chạy, dùng lệnh claude --continue.
Xây dựng một dự án thực tế với Claude API
Trọng tâm của hướng dẫn này là học cách thiết lập Claude Code với API hơn là cung cấp hướng dẫn chi tiết về cách dùng Claude Code.
Nếu bạn muốn tìm hiểu sâu hơn, hãy đăng ký khóa học Claude Code 101 của chúng tôi.
Tổng quan dự án
Mục tiêu của dự án là xây dựng một ứng dụng Python cho phép người dùng dễ dàng tìm ảnh trên máy tính của họ.
Ngày nay, mọi người chụp rất nhiều ảnh, và chúng thường bị lộn xộn, rải rác ở nhiều nơi. Với riêng tôi, là một nhiếp ảnh gia, việc tìm một bức ảnh sau vài tháng chụp thường là cơn đau đầu.
Ý tưởng của ứng dụng là cho phép người dùng tìm ảnh bằng cách mô tả nội dung trong ảnh hoặc cung cấp ảnh chụp màn hình/ảnh tham chiếu.
Chế độ thứ hai đặc biệt hữu ích với tôi vì tôi thường đăng tác phẩm lên mạng xã hội, nên có thể chỉ cần chụp màn hình bài đăng là tìm được tệp gốc chất lượng cao.
Chúng ta có thể để Claude Code tự xác định kiến trúc dự án và làm toàn bộ phần triển khai. Có lẽ vẫn ổn.
Nhưng vì mục đích học tập, tôi muốn tự định nghĩa kiến trúc và để Claude Code tập trung vào triển khai.
Kiến trúc dự án với CLAUDE.md
Để tạo ứng dụng này, tôi đã tạo một tệp CLAUDE.md mô tả kiến trúc của dự án.
Tệp CLAUDE.md là một tệp cấu hình Markdown theo dự án mà Claude Code đọc ở đầu mỗi phiên để thiết lập bộ nhớ bền vững về kiến trúc, tiêu chuẩn mã và sở thích quy trình làm việc của bạn.
Ứng dụng có hai thành phần chính:
- Quy trình nạp ảnh cho phép người dùng chọn một thư mục chứa ảnh, chuyển ảnh thành vector và lưu vào cơ sở dữ liệu vector.
- Đầu vào đa phương thức cho phép người dùng tìm kiếm trong cơ sở dữ liệu.
Để mã hóa ảnh thành vector, chúng ta dùng mô hình CLIP. Với cơ sở dữ liệu, chúng ta dùng ChromaDB, chạy cục bộ miễn phí.
Trực giác hoạt động là mô hình CLIP được huấn luyện để chuyển văn bản và hình ảnh thành vector (biểu diễn số của dữ liệu) sao cho các ảnh trông giống nhau hoặc chứa khái niệm tương tự sẽ được đặt gần nhau trên bản đồ này, còn ảnh không liên quan thì bị đẩy xa hơn.
Khi muốn tìm một ảnh, chúng ta cũng chuyển truy vấn thành một vector truy vấn và dùng ChromaDB để tìm các vector gần nhất với vector truy vấn.
Nếu bạn muốn tìm hiểu thêm về cơ sở dữ liệu vector, hãy xem Hướng dẫn ChromaDB: Từng bước.
Prompt
Với kiến trúc dự án đã được chỉ rõ trong tệp CLAUDE.md, tôi mở một terminal trong thư mục đó và đưa cho Claude Code đang chạy mô hình Fable 5 prompt sau:
Build a desktop graphical app for my photography search engine with Python.
First, plan the application architecture exactly as outlined in the CLAUDE.md file, ensuring the GUI can handle both folder ingestion and searching.
Create a virtual environment, install the necessary dependencies (including customtkinter and raw image processing libraries), and save them to requirements.txt.
Write the application logic, paying special attention to background threading for the ingestion process. Kết quả
Tôi gửi prompt và để Claude Code “làm phép”. Khoảng bảy phút sau, mọi thứ hoàn tất.
Tôi chạy ứng dụng, và nó trông như sau:
Tôi tải lên vài bức ảnh tôi chụp trong năm nay rồi vào Instagram chụp màn hình một bài đăng của tôi để dùng làm ảnh tham chiếu.
Tôi cố tình để nguyên toàn bộ giao diện để làm khó ứng dụng trong việc tìm ảnh gốc. Đây là kết quả tôi nhận được:
Tôi phải nói là nó hoạt động khá tốt, và giao diện đúng như tôi hình dung. Tôi cũng thử tìm bằng văn bản để tìm ảnh Taipei 101, tòa nhà cao nhất Đài Loan.
Đây là kết quả:
Mức sử dụng token Claude API và chi phí thực tế
Tổng cộng, tạo dự án này tốn 3,65 USD token API. Chúng ta có thể xem chi tiết chi phí phiên làm việc bằng lệnh /cost:
Điều thú vị là chúng ta thấy nó cũng dùng claude-haiku-4.5 cho một phần công việc.
Điều này cho thấy Fable 5 khá đắt.
Một phiên bảy phút trên dự án trống đã tốn 3,65 USD.
Vì thế tôi chỉ có thể hình dung dùng Fable 5 trên dự án có hàng trăm tệp mã sẽ tốn bao nhiêu.
Tất nhiên, trong thực tế, khi xây dựng ứng dụng thật cũng tạo ra doanh thu, các chi phí này cần được đánh giá khác đi vì chúng trở thành khoản đầu tư.
Các tính năng nâng cao của Claude API bạn nên biết
Chuyển sang API sẽ mở ra các công cụ mà Claude.ai không cung cấp: lưu đệm prompt, xử lý theo lô và tích hợp công cụ.
Nếu bạn dùng Claude Code, định tuyến lượng lớn cuộc gọi API hoặc xây dựng hệ thống tác tử tương tác với dịch vụ bên ngoài, đây là những tính năng ảnh hưởng trực tiếp nhất đến chi phí và độ trễ.
1. Lưu đệm prompt (giảm chi phí)
Lưu đệm prompt sẽ lưu các phần tĩnh của cửa sổ ngữ cảnh trên máy chủ giữa các lần gọi API, để bạn không phải trả phí xử lý lại cùng nội dung trong mỗi yêu cầu.
Nếu bạn đang làm việc với Claude Code, rất có thể bạn đang gửi cùng một ngữ cảnh lớn trong mọi lần gọi (tệp CLAUDE.md, tóm tắt codebase hoặc system prompt dài). Theo tài liệu lưu đệm của Anthropic, các tiền tố được lưu đệm có thể giảm chi phí đầu vào tới 90% và rút ngắn thời gian tới token đầu tiên vì tiền tố được bỏ qua tái nạp.
Yêu cầu đầu tiên phải trả đủ giá đầu vào. Mọi lần gọi tiếp theo đánh trúng cùng tiền tố bộ nhớ đệm sẽ được tính ở mức giá giảm.
2. Batch API (xử lý bất đồng bộ)
Batch API xử lý các khối lượng công việc không cần phản hồi theo thời gian thực.
Xử lý 10.000 phiếu hỗ trợ khách hàng, tạo tài liệu cho toàn bộ codebase hoặc chạy eval trên một bộ kiểm thử lớn: đều phù hợp để xử lý theo lô. Anthropic định giá yêu cầu theo lô bằng 50% chi phí token đầu vào và đầu ra tiêu chuẩn, và toàn bộ công việc được gửi trong một lần gọi API thay vì yêu cầu bạn tự quản lý hàng đợi.
Ràng buộc là công việc theo lô có thể mất tới 24 giờ để hoàn thành và kết quả đến cùng lúc, không luồng. Điều này phù hợp với pipeline ngoại tuyến, nhưng không phù hợp cho bất cứ thứ gì hướng tới người dùng.
3. Sử dụng công cụ và Giao thức Ngữ cảnh Mô hình (MCP)
Sử dụng công cụ (đôi khi gọi là function calling) cho phép Claude gọi các hàm bên ngoài trong quá trình sinh và đưa kết quả vào phản hồi của nó.
Bạn định nghĩa các công cụ sẵn có theo định dạng JSON Schema; Claude quyết định khi nào gọi, truyền đối số nào và làm gì với đầu ra. Nhờ đó Claude có thể truy vấn cơ sở dữ liệu, gọi REST API hoặc chạy script Python mà bạn không cần chỉ rõ điểm gọi trong prompt.
Model Context Protocol (MCP) mở rộng điều này với một giao diện máy chủ chuẩn hóa: thay vì định nghĩa công cụ theo từng dự án, Claude kết nối tới máy chủ MCP cục bộ cung cấp quyền truy cập tệp, thực thi mã hoặc đọc cơ sở dữ liệu.
Computer Use API hoạt động khác: Claude diễn giải ảnh chụp màn hình và phát ra sự kiện bàn phím/chuột, điều hướng giao diện mà không cần quyền truy cập API theo chương trình vào ứng dụng nền.
Kết luận
Chuyển sang Claude API là bước cần thiết để chạy các công cụ phát triển tự động, nhưng đòi hỏi thay đổi cách chúng ta quản lý dự án.
Fable 5 chắc chắn là một mô hình lập trình xuất sắc, có khả năng tạo ra ứng dụng phức tạp, hoạt động hoàn chỉnh chỉ từ một prompt.
Năng lực suy luận của nó có thể biến tầm nhìn kiến trúc thành hiện thực chức năng chỉ trong vài phút, thật sự ấn tượng.
Tuy nhiên, dùng Claude API để có mức sức mạnh này sẽ phải trả giá. Vì các mô hình như Fable 5 rất tốn kém để vận hành, điều quan trọng là phải chiến lược trong việc chọn mô hình.
Tôi khuyên dùng các mô hình rẻ, hiệu quả cho tác vụ thường nhật và dành Fable 5 cho khi bạn gặp bế tắc thật sự hoặc thách thức kiến trúc phức tạp cần suy luận sâu hơn.
Như chúng ta thấy với dự án của mình, ngay cả với một ứng dụng khá đơn giản chỉ một tệp, chi phí token API cũng có thể tăng nhanh. Hãy bảo vệ ví tiền của bạn bằng cách theo dõi sát mức sử dụng và quan trọng nhất là tắt tự động nạp tiền để đảm bảo phiên lập trình tự động không “tung hoành” ngân sách của bạn.
Nếu bạn muốn tìm hiểu thêm về hệ sinh thái Claude, hãy xem khóa học Claude 101.
