Claude Agent SDK (trước đây là Claude Code SDK) — Tài liệu Python và TypeScript, tự động hóa không cần giao diện (2026)

Claude Code SDK, nay là Claude Agent SDK

Vòng lặp tác tử chạy trong terminal của bạn cũng được cung cấp dưới dạng thư viện. Anthropic đổi tên Claude Code SDK thành Claude Agent SDK khi nhận thấy mọi người dùng nó để xây dựng nhiều thứ hơn hẳn các công cụ lập trình.

TLDR

Python: pip install claude-agent-sdk; TypeScript: npm install @anthropic-ai/claude-agent-sdk.
Bạn có được tác tử đầy đủ — công cụ thao tác tệp, bash, tác tử phụ, MCP — được điều khiển từ mã, với các hàm callback xử lý quyền.
SDK đọc ANTHROPIC_BASE_URL và ANTHROPIC_API_KEY giống như CLI, nên việc tính phí qua gateway được áp dụng.

Hai cách tự động hóa Claude Code

Cách đơn giản là dùng chế độ in của CLI — claude -p từ bất kỳ ngôn ngữ nào, với đầu ra JSON. Cách tiếp cận đầy đủ là Agent SDK, cung cấp vòng lặp, bộ công cụ, hook và quyền dưới dạng các đối tượng do bạn kiểm soát.

Python

import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Edit", "Bash"],
        max_turns=8,
    )
    async for message in query(
        prompt="add type hints to utils.py and run the tests",
        options=options,
    ):
        print(message)

anyio.run(main)

TypeScript

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "find and fix the flaky test in this repo",
  options: { allowedTools: ["Read", "Edit", "Bash"], maxTurns: 8 },
})) {
  console.log(message);
}

Chạy qua gateway

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
python agent.py

SDK khởi chạy cùng môi trường thực thi Claude Code, nên chỉ cần các biến môi trường. Với các tác nhân chạy lâu, giá gateway có tác động lớn nhất: một vòng lặp tự chủ có thể thực hiện hàng trăm lệnh gọi mỗi giờ, và gói giá cố định biến chi phí ước tính thành một con số cố định.

SDK bổ sung gì so với chế độ in

Callback cấp quyền — phê duyệt hoặc từ chối từng lệnh gọi công cụ từ mã của bạn.
Công cụ tùy chỉnh thông qua các máy chủ MCP chạy trong cùng tiến trình, để tác nhân có thể gọi các hàm của bạn.
Hook cho các sự kiện công cụ, vòng đời phiên và lỗi.
Tác nhân con và đầu ra có cấu trúc, không cần gọi shell rồi phân tích văn bản.

Dùng thử miễn phí trước

Tài khoản mới nhận được $5 tín dụng API miễn phí với mã CLAUDECODE — đủ cho một buổi tối dùng Claude Code với Sonnet — sau đó là tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Tạo tài khoản với mã CLAUDECODE

Câu hỏi thường gặp

Claude Code SDK có giống Anthropic SDK không?

Không. Anthropic SDK gọi trực tiếp Messages API. Claude Agent SDK (trước đây là Claude Code SDK) chạy toàn bộ tác nhân — công cụ, tệp, bash, tác nhân con — trên nền API đó.

Agent SDK hỗ trợ những ngôn ngữ nào?

Chính thức hỗ trợ Python và TypeScript; các ngôn ngữ khác có thể điều khiển chế độ in của CLI với đầu ra JSON.

SDK có hoạt động với URL cơ sở tùy chỉnh không?

Có. SDK kế thừa ANTHROPIC_BASE_URL và ANTHROPIC_API_KEY từ môi trường, giống hệt CLI.

Chạy Claude Code trên cổng API

Vẫn các mô hình đó, hai biến môi trường, tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá — hoặc gói không giới hạn với phí cố định. Tài khoản mới: $5 tín dụng API miễn phí với mã CLAUDECODE.

Lấy khóa API Xem các gói không giới hạn

AI Prime Tech là một cổng API độc lập, không có quan hệ liên kết với Anthropic và không được Anthropic chứng thực hay tài trợ. “Claude” và “Claude Code” là các nhãn hiệu của Anthropic. Các tính năng Claude Code được mô tả ở đây dựa trên tài liệu công khai của Anthropic tại thời điểm viết và thường xuyên thay đổi; giá và danh sách mô hình trên trang này được đọc từ cấu hình hiện hành của cổng API này.