claude-api

Overview

claude-api giúp bạn làm gì

Skill claude-api là một tài liệu tham khảo thực tế để xây dựng ứng dụng dùng LLM với Claude thông qua Claude API, Anthropic SDK chính thức và tài liệu Agent SDK khi có sẵn. Nội dung được sắp xếp theo từng ngôn ngữ, giúp lập trình viên nhanh chóng đi từ bước thiết lập ban đầu đến gửi request chạy thực tế, nhận phản hồi streaming, dùng tool và áp dụng các mẫu tích hợp backend.

Skill này đặc biệt hữu ích khi bạn đã xác định sẽ làm việc với Claude và cần hướng dẫn triển khai cụ thể hơn là một phần tổng quan chung về AI. Repository có tài liệu riêng cho C#, Go, Java, PHP, Ruby, Python và TypeScript, cùng với ví dụ HTTP thuần trong curl/.

Skill này dành cho ai

claude-api rất phù hợp với:

• Lập trình viên backend đang tích hợp Claude vào service, worker và công cụ nội bộ
• Lập trình viên API đang cân nhắc giữa gọi HTTP trực tiếp và dùng SDK chính thức
• Các nhóm đang so sánh mức độ hỗ trợ theo ngôn ngữ trước khi chuẩn hóa trên Python, TypeScript, Go, Java, PHP, Ruby hoặc C#
• Lập trình viên cần ví dụ về streaming, tool use, batching, sử dụng files API và xử lý lỗi
• Người xây dựng agent sử dụng tài liệu Agent SDK cho Python hoặc TypeScript

Skill này giải quyết vấn đề gì

Thay vì buộc bạn phải tự ghép nối nhiều ví dụ rời rạc, claude-api cung cấp một điểm khởi đầu có cấu trúc cho những quyết định triển khai phổ biến:

• Nên dùng SDK hay bề mặt API nào
• Nên đọc thư mục ngôn ngữ nào trước
• Cách xác thực bằng ANTHROPIC_API_KEY
• Cách gửi request tin nhắn đầu tiên
• Khi nào nên ưu tiên streaming cho đầu ra dài
• Nên xem ở đâu về tool use, batches, files API, prompt caching, tham chiếu model và mã lỗi

Skill này cũng có các tệp tham chiếu dùng chung như shared/error-codes.md, shared/models.md, shared/prompt-caching.md, shared/live-sources.md và shared/tool-use-concepts.md, rất hữu ích khi bạn cần hướng dẫn về hành vi backend vượt ra ngoài một ví dụ hello-world tối giản.

Các mảng tài liệu được hỗ trợ trong repository

Dựa trên cấu trúc repository, đây là các khu vực chính:

• csharp/
• curl/
• go/
• java/
• php/
• python/agent-sdk
• python/claude-api
• ruby/
• typescript/agent-sdk
• typescript/claude-api
• shared/

Vì vậy, claude-api không chỉ là một bộ ví dụ ngắn cho một ngôn ngữ duy nhất. Cách hiểu đúng hơn là một skill tích hợp backend đa ngôn ngữ cho hệ sinh thái Claude API.

Khi nào claude-api là lựa chọn phù hợp

Hãy dùng claude-api khi:

• Codebase của bạn import anthropic, @anthropic-ai/sdk hoặc claude_agent_sdk
• Bạn muốn áp dụng các mẫu sử dụng Anthropic SDK chính thức
• Bạn cần ví dụ thực tế cho việc tích hợp Claude API ở phía server
• Bạn muốn có hướng dẫn cài đặt theo từng ngôn ngữ trước khi bắt tay triển khai
• Bạn cần hiểu các tính năng như streaming, tool use, batches hoặc hỗ trợ files API

Khi nào claude-api không phù hợp

Skill này không phải lựa chọn tốt nhất nếu:

• Dự án của bạn dùng SDK của nhà cung cấp AI khác như openai
• Bạn cần hỗ trợ lập trình chung không liên quan đến tích hợp Claude
• Bạn đang tìm các mẫu UI frontend thay vì workflow API và backend
• Bạn cần một ngôn ngữ không có trong repository và không muốn dùng ví dụ HTTP thuần từ curl/

How to Use

Cài đặt skill

Thêm claude-api từ repository skills của Anthropic:

npx skills add https://github.com/anthropics/skills --skill claude-api

Sau khi cài xong, hãy bắt đầu với SKILL.md, rồi chuyển sang thư mục ngôn ngữ phù hợp với codebase của bạn.

Chọn đúng thư mục ngay từ đầu

Cách nhanh nhất để dùng claude-api hiệu quả là chọn đúng đường dẫn theo ngôn ngữ trước khi đọc sâu vào chi tiết triển khai.

Một số điểm bắt đầu hữu ích trong repository gồm:

• SKILL.md
• csharp/claude-api.md
• curl/examples.md
• go/claude-api.md
• java/claude-api.md
• php/claude-api.md
• ruby/claude-api.md
• python/claude-api/README.md
• typescript/claude-api/README.md
• python/agent-sdk/README.md
• typescript/agent-sdk/README.md

Nếu bạn đang đánh giá mức độ hỗ trợ SDK trước khi chọn stack, hãy mở song song vài thư mục ngôn ngữ để so sánh. Repository tách bạch khá rõ giữa cách dùng Claude API trực tiếp và phần hướng dẫn Agent SDK cho Python và TypeScript.

Chọn đúng bề mặt theo nhu cầu sử dụng

Dựa trên cấu trúc repository, claude-api hỗ trợ một số hướng triển khai thực tế:

• Dùng curl/examples.md cho request HTTP thuần hoặc cho các ngôn ngữ chưa được hỗ trợ
• Dùng các thư mục ngôn ngữ như go/, java/, php/, ruby/ hoặc csharp/ cho các mẫu SDK chính thức
• Dùng python/claude-api/ hoặc typescript/claude-api/ nếu bạn cần tài liệu sâu hơn về streaming, tool use, batches và files API
• Dùng python/agent-sdk/ hoặc typescript/agent-sdk/ nếu dự án của bạn xoay quanh workflow agent thay vì chỉ gọi message trực tiếp

Cấu trúc này đặc biệt hữu ích khi cân nhắc cài đặt vì không phải ngôn ngữ nào cũng có cùng mức hỗ trợ cho các tính năng cấp cao. Ví dụ, repository có tài liệu Agent SDK riêng cho Python và TypeScript, trong khi các ngôn ngữ khác tập trung vào cách dùng Claude API SDK.

Thiết lập xác thực an toàn

Trong các ví dụ của repository, cách làm tiêu chuẩn là dùng biến môi trường ANTHROPIC_API_KEY thay vì hardcode secret. Điều này khiến claude-api phù hợp với các workflow backend hướng production và cả môi trường CI.

Trước khi chạy thử các ví dụ, hãy chắc chắn runtime của bạn có thể đọc được ANTHROPIC_API_KEY.

Các cách cài đặt điển hình theo ngôn ngữ

Dựa trên nội dung repository, có các ví dụ cài đặt sau:

• C#: dotnet add package Anthropic
• Go: go get github.com/anthropics/anthropic-sdk-go
• PHP: composer require "anthropic-ai/sdk"
• Ruby: gem install anthropic
• Java: thiết lập dependency với com.anthropic:anthropic-java
• HTTP thuần: dùng curl với https://api.anthropic.com/v1/messages

Nếu bạn đang phân vân giữa SDK và HTTP, hãy bắt đầu với SDK khi ngôn ngữ của bạn được hỗ trợ, rồi chuyển sang ví dụ trong curl/ khi cần kiểm soát request ở mức thấp hơn hoặc đang làm việc với ngôn ngữ khác.

Bắt đầu với một request message cơ bản

Hầu hết hướng dẫn theo ngôn ngữ trong claude-api đều bắt đầu bằng cùng một quy trình thực tế:

1. Khởi tạo client
2. Đọc API key từ môi trường
3. Gửi một request message với model Claude
4. Đọc các khối văn bản từ response

Tính nhất quán này rất hữu ích khi một nhóm làm việc trên nhiều ngôn ngữ backend. Bạn có thể chuẩn hóa mẫu request ngay cả khi cú pháp code khác nhau.

Dùng streaming cho phản hồi dài

SKILL.md trong repository nêu rõ rằng nên mặc định ưu tiên streaming cho các request có thể có input dài, output dài hoặc max_tokens cao, vì streaming giúp hạn chế timeout request. Đây là một trong những điểm vận hành quan trọng nhất mà claude-api mang lại.

Nếu ứng dụng của bạn tạo ra câu trả lời dài, bản tóm tắt, vòng lặp tool hoặc quá trình suy luận kéo dài, hãy đọc tài liệu streaming trước:

• python/claude-api/streaming.md
• typescript/claude-api/streaming.md
• Các phần về streaming trong những tệp theo ngôn ngữ như go/claude-api.md, java/claude-api.md, ruby/claude-api.md và csharp/claude-api.md

Khám phá các tính năng backend nâng cao

Một lý do đáng để cài claude-api thay vì chỉ dựa vào một quickstart ngắn là repository này có độ phủ chủ đề sâu hơn. Một số tệp liên quan gồm:

• python/claude-api/tool-use.md
• typescript/claude-api/tool-use.md
• python/claude-api/batches.md
• typescript/claude-api/batches.md
• python/claude-api/files-api.md
• typescript/claude-api/files-api.md
• shared/tool-use-concepts.md
• shared/prompt-caching.md
• shared/models.md

Những tài liệu này đặc biệt có giá trị với workflow backend trong production, khi bạn cần nhiều hơn một ví dụ request-response đơn lẻ.

Dùng tài liệu tham chiếu chung để xử lý sự cố

Nếu lần tích hợp đầu tiên chưa chạy được, claude-api có sẵn tài liệu hỗ trợ giúp bạn debug và lên kế hoạch:

• shared/error-codes.md để tra ý nghĩa lỗi HTTP, khả năng retry và các nguyên nhân phổ biến
• shared/models.md để tham khảo thông tin liên quan đến model
• shared/live-sources.md để xem hướng dẫn liên quan đến source

Tài liệu mã lỗi đặc biệt hữu ích vì nó phân biệt rõ các tình huống có thể retry như 429, 500 và 529, so với các lỗi request không nên retry như 400 hoặc lỗi xác thực như 401.

Checklist thực tế trước khi áp dụng claude-api

Trước khi quyết định dùng skill này trong dự án, hãy tự hỏi:

• Chúng ta có cần ví dụ SDK chính thức cho một trong các ngôn ngữ được hỗ trợ không?
• Chúng ta có kỳ vọng output dài và vì vậy cần hướng dẫn về streaming không?
• Chúng ta có cần ví dụ về tool use, files API hoặc xử lý batch không?
• Chúng ta có đang xây dựng workflow agent bằng Python hoặc TypeScript không?
• Chúng ta có muốn một đường lui sang HTTP thuần bằng curl không?

Nếu câu trả lời cho nhiều câu hỏi trong số này là có, claude-api rất có thể là lựa chọn phù hợp.

FAQ

claude-api trong repository này là gì?

claude-api là một skill trong anthropics/skills, giúp lập trình viên xây dựng ứng dụng với Claude API, Anthropic SDK và các tài nguyên Agent SDK. Nội dung được tổ chức theo ngôn ngữ và có thêm các tài liệu tham chiếu dùng chung để hỗ trợ.

Cài claude-api như thế nào?

Dùng:

npx skills add https://github.com/anthropics/skills --skill claude-api

Sau đó mở SKILL.md và thư mục ngôn ngữ phù hợp với stack của bạn.

claude-api hỗ trợ những ngôn ngữ nào?

Dựa trên repository, tài liệu hiện có cho C#, Go, Java, PHP, Ruby, Python, TypeScript và cả ví dụ HTTP thuần bằng curl.

claude-api có hướng dẫn về Agent SDK không?

Có, nhưng theo cấu trúc repository thì tài liệu Agent SDK hiện nằm cụ thể trong python/agent-sdk/ và typescript/agent-sdk/. Nếu bạn cần ví dụ về workflow agent, đây là hai thư mục nên xem đầu tiên.

claude-api có hỗ trợ streaming và tool use không?

Có. Repository có tài liệu về streaming và tool use, đặc biệt trong các thư mục Claude API cho Python và TypeScript; ngoài ra một số hướng dẫn theo ngôn ngữ khác cũng có phần nói về streaming.

claude-api chỉ dành cho gọi API trực tiếp thôi đúng không?

Không. Skill này bao quát cả cách dùng Claude API trực tiếp lẫn các mẫu tích hợp dựa trên SDK. Ngoài ra còn có ví dụ HTTP thuần trong curl/examples.md cho những ai không muốn dùng SDK hoặc đang làm việc với ngôn ngữ khác.

Khi nào nên dùng curl thay vì SDK?

Hãy dùng curl khi bạn cần ví dụ HTTP thuần, khi ngôn ngữ của bạn chưa có SDK chính thức được tài liệu này hỗ trợ, hoặc khi bạn muốn xem trực tiếp cấu trúc request và response trước khi chọn một thư viện client.

claude-api có hướng dẫn xử lý lỗi không?

Có. shared/error-codes.md mô tả các mã lỗi HTTP, nguyên nhân phổ biến và lỗi nào có thể retry. Nhờ vậy, claude-api hữu ích không chỉ cho giai đoạn thiết lập ban đầu mà còn cho việc lập kế hoạch tích hợp production.

claude-api có phù hợp để hỗ trợ lập trình chung không?

Không. Mô tả của repository tập trung vào việc sử dụng Claude API và Anthropic SDK. Nếu công việc của bạn không liên quan đến tích hợp Claude, skill này sẽ quá chuyên biệt.

Sau khi cài claude-api thì nên đọc gì trước?

Hãy bắt đầu với SKILL.md, rồi chuyển sang tệp phù hợp với ngôn ngữ và nhu cầu của bạn. Với nhiều nhóm, thứ tự hợp lý nhất là:

1. SKILL.md
2. Hướng dẫn theo ngôn ngữ của bạn, chẳng hạn go/claude-api.md hoặc php/claude-api.md
3. Các tài liệu theo chủ đề như streaming.md, tool-use.md, batches.md hoặc files-api.md
4. Các tài liệu tham chiếu chung như shared/error-codes.md