Framework · Anthropic
Tổng quan về Claude Agent SDK
SDK của Anthropic cung cấp harness của Claude Code, gồm các công cụ thao tác tệp và shell, quyền, hook, subagent và skill, bên trong chương trình Python hoặc TypeScript của riêng bạn. Khác với các lựa chọn còn lại trong danh sách này, SDK chỉ chạy các model Claude và việc sử dụng chịu sự điều chỉnh của Điều khoản thương mại của Anthropic.
Phù hợp nhất với: Ứng dụng cần Claude thực hiện công việc thực tế trên hệ thống tệp, với quyền sử dụng công cụ do bạn kiểm soát.
Thông tin chính
- Đơn vị duy trì
- Anthropic
- Ngôn ngữ
- Python, TypeScript
- Giấy phép
- Anthropic Commercial Terms
- Phiên bản mới nhất
Python 0.2.163 / TypeScript 0.3.286· 30 tháng 9, 2026- Repository
- anthropics/claude-agent-sdk-python
- Tùy chọn chạy trên nền tảng lưu trữ
- Claude Managed Agents
Bắt đầu nhanh
Cài package, thiết lập thông tin xác thực, rồi chạy agent đơn giản nhất theo tài liệu chính thức. ID model sử dụng trong tài liệu có thể chưa được bật cho tài khoản của bạn.
Python
pip install claude-agent-sdkimport asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
async for message in query(
prompt="Find and fix the bug in auth.py",
options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"]),
):
print(message) # Claude reads the file, finds the bug, edits it
asyncio.run(main())TypeScript
npm install @anthropic-ai/claude-agent-sdkimport { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "Find and fix the bug in auth.ts",
options: { allowedTools: ["Read", "Edit", "Bash"] }
})) {
console.log(message); // Claude reads the file, finds the bug, edits it
}Tính năng
| Mọi model | Không | Chỉ Claude, qua Anthropic, Bedrock, Google Cloud hoặc Foundry |
|---|---|---|
| MCP client | Có | Tùy chọn mcpServers; plugin có thể đóng gói MCP server |
| MCP server | Chưa xác nhận | |
| Đa agent | Có | Subagent xử lý các tác vụ phụ có phạm vi cụ thể |
| Lượt chạy bền vững | Chưa xác nhận | Có thể tiếp tục hoặc phân nhánh session; không có engine thực thi bền vững |
| Phê duyệt của con người | Có | Chế độ quyền xác định công cụ nào cần được phê duyệt |
| Tracing | Có | Hỗ trợ xuất OpenTelemetry; trace đang ở giai đoạn beta |
| Evals | Không |
Các thay đổi gần đây
- Đổi tên từ Claude Code SDK; đã có hướng dẫn chuyển đổi.
- Cả hai SDK hiện đều đi kèm binary Claude Code gốc.
- Từ ngày 15 tháng 6 năm 2026, việc dùng SDK trên các gói thuê bao sẽ tính vào hạn mức tín dụng Agent SDK hằng tháng riêng.
- Ứng dụng bên thứ ba không được cung cấp tùy chọn đăng nhập claude.ai nếu chưa được Anthropic phê duyệt.