Source: https://aiprimetech.io/vi/claude-code/sdk/

[Trang chủ](/vi/) › [Claude Code](/vi/claude-code/) › SDK tác tử

[Tổng quan](/vi/claude-code/)[Cài đặt](/vi/claude-code/install/)[tài liệu tham khảo CLI](/vi/claude-code/cli/)[Giá và giới hạn](/vi/claude-code/pricing/)[Agent SDK](/vi/claude-code/sdk/)[Kỹ năng và plugin](/vi/claude-code/skills/)[GitHub](/vi/claude-code/github/)[Web, máy tính và IDE](/vi/claude-code/web-and-desktop/)[Mô hình](/vi/claude-code/models/)[Lỗi](/vi/claude-code/errors/)[Có phải mã nguồn mở?](/vi/claude-code/open-source/)[Hướng dẫn thực hành](/vi/claude-code/tutorial/)[Dành cho sinh viên](/vi/claude-code/for-students/)[Tự động hóa QA](/vi/claude-code/qa-automation/)[So với Cursor](/vi/claude-code/vs-cursor/)[So với Codex và OpenCode](/vi/claude-code/vs-codex/)[Tác tử phụ](/vi/claude-code/subagents/)[Hook](/vi/claude-code/hooks/)[MCP](/vi/claude-code/mcp/)[Hệ sinh thái](/vi/claude-code/ecosystem/)[VS Code](/vi/claude-code/vscode/)[OpenRouter](/vi/claude-code/openrouter/)[Giới hạn tốc độ](/vi/claude-code/rate-limits/)[Hướng dẫn bằng tiếng Trung](/claude-code/zh/)

Cập nhật lần cuối: ngày 11 tháng Mười, 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](/register?promo=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](/register?promo=CLAUDECODE) [Xem các gói không giới hạn](/vi/plans/)

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.

## Thêm hướng dẫn về Claude Code

[Claude Code: hướng dẫn đầy đủ](/vi/claude-code/)[Cách cài đặt Claude Code](/vi/claude-code/install/)[Tài liệu CLI của Claude Code: lệnh và cờ](/vi/claude-code/cli/)[Giải thích giá và giới hạn của Claude Code](/vi/claude-code/pricing/)[Kỹ năng và plugin của Claude Code](/vi/claude-code/skills/)[Claude Code trong GitHub: App, Action và @claude](/vi/claude-code/github/)[Claude Code có giao diện web không? Giải thích về web, ứng dụng máy tính và IDE](/vi/claude-code/web-and-desktop/)[Claude Code sử dụng mô hình nào và cách thay đổi](/vi/claude-code/models/)[Các lỗi Claude Code và cách khắc phục](/vi/claude-code/errors/)[Claude Code có phải mã nguồn mở không?](/vi/claude-code/open-source/)[Hướng dẫn thực hành Claude Code: phiên làm việc thực tế đầu tiên của bạn](/vi/claude-code/tutorial/)[Claude dành cho sinh viên: Claude Code, API và những quyền lợi thực tế dành cho giáo dục](/vi/claude-code/for-students/)[Cách sử dụng Claude Code để tự động hóa QA](/vi/claude-code/qa-automation/)[Claude Code so với Cursor: chọn công cụ nào, khi nào — và cách sử dụng cả hai](/vi/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: so sánh các tác nhân trong terminal](/vi/claude-code/vs-codex/)[Tác nhân phụ của Claude Code: cách hoạt động, cách định nghĩa và các nhóm tác nhân](/vi/claude-code/subagents/)[Hook của Claude Code: kiểm soát hành động của tác nhân theo quy tắc xác định](/vi/claude-code/hooks/)[MCP của Claude Code: kết nối máy chủ, phạm vi, MCP từ xa và ví dụ thực tế](/vi/claude-code/mcp/)[Hệ sinh thái Claude Code: bộ định tuyến, framework, plugin và các danh sách theo dõi chúng](/vi/claude-code/ecosystem/)[Claude Code trong VS Code: tiện ích mở rộng, cách dùng qua terminal và các lỗi](/vi/claude-code/vscode/)[Cách dùng OpenRouter trong Claude Code (và khi nào không nên dùng)](/vi/claude-code/openrouter/)[Lỗi giới hạn tốc độ của Claude: "API error: rate limit reached" có nghĩa là gì và cách khắc phục](/vi/claude-code/rate-limits/)[Cách dùng Claude Code: từ cài đặt đến sử dụng hằng ngày](/claude-code/zh/)