Tổng quan Agent SDK

Một agent là một ứng dụng hoàn thành tác vụ bằng cách tự lên kế hoạch các bước đi và gọi tool để đọc file, chạy lệnh, hoặc sửa code. Agent SDK cung cấp cho bạn cùng bộ tool, agent loop, và cơ chế quản lý context đang vận hành Claude Code, có thể lập trình bằng Python và TypeScript.

So sánh Agent SDK với các công cụ Claude khác

Agent SDK, CLI, Client SDK, và Managed Agents đều phù hợp với những nhu cầu khác nhau. Dùng bảng dưới để tìm ra công cụ khớp với thứ bạn đang xây.

Nếu bạn đang…	Dùng	Vì sao
Xây agent mà không muốn tự cài đặt tool loop	Agent SDK	Một thư viện chạy agent loop ngay trong process của bạn, bằng Python hoặc TypeScript.
Làm việc phát triển tương tác hoặc chạy tác vụ đơn lẻ từ terminal	Claude Code CLI	Giao diện terminal, xây cho việc dùng tương tác hàng ngày.
Gọi trực tiếp API và tự cài đặt tool loop	Client SDK	Truy cập trực tiếp Anthropic API thay vì Claude Code. Bạn tự cài tool loop.
Chạy agent dài hạn hoặc bất đồng bộ mà không muốn tự quản lý sandbox hay session infrastructure	Managed Agents	REST API được host sẵn, một sản phẩm riêng biệt so với Agent SDK. Anthropic vận hành agent và sandbox.

SDK chỉ có ở dạng thư viện cho Python và TypeScript. Để chạy cùng agent loop từ ngôn ngữ khác, bạn có thể chạy CLI như một subprocess với flag -p và --output-format json.

Năng lực (capability)

Mọi thứ khiến Claude Code mạnh mẽ đều có sẵn trong SDK.

Năng lực	Nó làm gì	Tìm hiểu thêm
Built-in tools	Đọc, ghi, sửa file, chạy lệnh, tìm kiếm trên web	Tools reference
Hooks	Chạy code tuỳ biến tại các thời điểm quan trọng trong vòng đời của agent	Hooks
Subagents	Sinh ra các agent chuyên biệt cho các subtask tập trung	Subagents
MCP	Kết nối tool và nguồn dữ liệu bên ngoài qua Model Context Protocol	MCP
Permissions	Kiểm soát tool nào tự động chạy, tool nào cần phê duyệt	Permissions
Sessions	Duy trì context xuyên suốt các lượt trao đổi, resume hoặc fork về sau	Sessions
Skills, commands, và memory	Tự động load từ .claude/ của dự án và từ ~/.claude/, giống hệt Claude Code	Skills, Commands, Memory, Configuration loading
Plugins	Đóng gói skills, agents, hooks, và MCP servers, rồi load bằng đường dẫn local	Plugins

Bắt đầu

Làm theo Quickstart để cài SDK, thiết lập API key, và xây agent đầu tiên của bạn - một agent tìm và sửa bug trong code có sẵn.

Ghi chú

Trừ khi được chấp thuận trước, Anthropic không cho phép nhà phát triển bên thứ ba cung cấp đăng nhập claude.ai hay rate limit cho sản phẩm của họ, kể cả agent xây trên Claude Agent SDK. Dùng các phương thức xác thực bằng API key được mô tả trong Quickstart thay vào đó.

Changelog

Xem changelog đầy đủ cho các cập nhật SDK, sửa lỗi, và tính năng mới:

• TypeScript SDK: xem CHANGELOG.md
• Python SDK: xem CHANGELOG.md

Báo lỗi

Nếu bạn gặp bug hoặc vấn đề với Agent SDK:

• TypeScript SDK: báo lỗi trên GitHub
• Python SDK: báo lỗi trên GitHub

Quy tắc thương hiệu (branding)

Với các đối tác tích hợp Claude Agent SDK, việc dùng branding Claude là tuỳ chọn. Khi nhắc đến Claude trong sản phẩm của bạn:

Được phép:

• “Claude Agent”, ưu tiên dùng cho dropdown menu
• “Claude”, khi nằm trong menu đã có nhãn “Agents”
• “{TênAgentCủaBạn} Powered by Claude”, nếu bạn đã có tên agent riêng

Không được phép:

• “Claude Code” hoặc “Claude Code Agent”
• ASCII art mang thương hiệu Claude Code hoặc các yếu tố hình ảnh mô phỏng Claude Code

Sản phẩm của bạn nên giữ thương hiệu riêng và không được trông giống Claude Code hay bất kỳ sản phẩm nào của Anthropic. Nếu có câu hỏi về tuân thủ branding, liên hệ đội sales của Anthropic.

Giấy phép và điều khoản

Việc sử dụng Claude Agent SDK chịu sự điều chỉnh của Điều khoản dịch vụ thương mại của Anthropic, kể cả khi bạn dùng nó để vận hành sản phẩm và dịch vụ cung cấp cho khách hàng và người dùng cuối của riêng bạn, trừ khi một thành phần hoặc dependency cụ thể được bảo hộ bởi giấy phép khác như ghi trong file LICENSE của thành phần đó.

Bước tiếp theo

Các tài nguyên sau đi sâu hơn về kỹ thuật và ví dụ dự án cho việc xây dựng với Agent SDK.

• Quickstart: xây agent đầu tiên tìm và sửa bug
• Agent loop: cách Claude lên kế hoạch, gọi tool, và quyết định khi nào tác vụ hoàn thành
• Ví dụ agent: các app demo để phát triển local
• TypeScript SDK: tài liệu tham khảo API TypeScript đầy đủ
• Python SDK: tài liệu tham khảo API Python đầy đủ
• Thiết kế agent harness: cách đội Claude Code dùng dynamic workflow để điều phối subagent ở quy mô lớn

Nguồn

Dịch và biên soạn từ Agent SDK overview.