Cách Sử Dụng Claude Agent SDK Với Gói Claude Của Bạn?

Anthropic cho phép bạn chạy Claude Agent SDK bằng gói Claude hiện có từ ngày 15/6/2026. Trước đây, để xây dựng ứng dụng bằng Agent SDK, bạn cần một API key riêng và thanh toán theo mức sử dụng, tách biệt với gói Claude Pro hoặc Max. Từ ngày 15/6, gói Claude hàng tháng sẽ bao gồm một khoản tín dụng riêng cho Agent SDK. Không cần API key.

Dùng thử Apidog ngay hôm nay

Nếu bạn muốn thử xây dựng một tác nhân tùy chỉnh như bot triển khai, trợ lý nghiên cứu hoặc công cụ phân loại nhưng không muốn thêm phương thức thanh toán riêng cho Anthropic chỉ để prototype, thay đổi này rất đáng chú ý. Gói Pro đi kèm $20/tháng cho Agent SDK. Gói Max 20x đi kèm $200. Ghế Team Premium đi kèm $100.

Điều gì đã thay đổi vào ngày 15/6/2026

Tóm tắt: việc sử dụng Agent SDK giờ được trừ vào tín dụng hàng tháng gắn với gói Claude của bạn. Trước đây, phần này được thanh toán qua Anthropic API với số dư console riêng.

Tín dụng theo từng gói:

Gói	Tín dụng Agent SDK hàng tháng
Pro	$20
Max 5x	$100
Max 20x	$200
Team Standard, mỗi ghế	$20
Team Premium, mỗi ghế	$100
Enterprise, dựa trên mức sử dụng	$20
Ghế Enterprise Premium	$200

Các quy tắc cần nhớ:

• Thành viên ghế Enterprise Standard không nhận được tín dụng. Họ cần dùng API key hoặc nâng cấp lên ghế Premium.
• Tín dụng tính theo từng người dùng và không thể chuyển nhượng. Bạn không thể gộp tín dụng với đồng đội.
• Tín dụng chưa dùng không được chuyển sang tháng sau. Số dư còn lại sẽ được đặt lại cuối chu kỳ thanh toán.
• Cần đăng ký một lần. Tín dụng không tự bật cho đến khi bạn yêu cầu một lần. Sau đó, nó tự làm mới mỗi tháng.
• Người dùng API key không nhận được tín dụng này. Nếu bạn xác thực qua ANTHROPIC_API_KEY, bạn vẫn đang dùng mô hình thanh toán API cũ.

Tín dụng bao gồm những gì

Anthropic tách rõ phần được tính vào tín dụng Agent SDK và phần vẫn nằm trong giới hạn/gói khác.

Được bao gồm:

• Các cuộc gọi Claude Agent SDK từ dự án Python hoặc TypeScript của bạn
• Lệnh claude -p trong Claude Code, tức chế độ không tương tác dùng cho tác vụ agent dạng script
• Tích hợp GitHub Actions của Claude Code
• Ứng dụng bên thứ ba xác thực bằng Agent SDK

Không được bao gồm:

• Phiên Claude Code tương tác bạn dùng hằng ngày
• Trò chuyện trên web hoặc mobile app của Claude
• Phiên Claude Cowork

Nói cách khác, tín dụng Agent SDK dành cho workload lập trình, tự động hoặc không tương tác. Claude Code tương tác vẫn nằm trong giới hạn sử dụng hiện có của gói, phần mà Anthropic gần đây đã tăng 50% cho đến ngày 13/7. Đây là hai ngân sách riêng biệt cho hai kiểu sử dụng khác nhau.

Điểm thực tế: bạn có thể thử nghiệm agent tùy chỉnh bằng SDK mà không ảnh hưởng đến ngân sách Claude Code dùng cho việc viết code hằng ngày.

Khi bạn hết tín dụng

Khi vượt quá tín dụng hàng tháng, hành vi phụ thuộc vào cài đặt sử dụng thêm:

• Bật sử dụng thêm: phần vượt mức được tính phí theo mức API tiêu chuẩn và trừ vào phương thức thanh toán của gói.
• Tắt sử dụng thêm: request sẽ dừng khi chạm giới hạn tín dụng cho đến khi chu kỳ mới bắt đầu.

Khuyến nghị:

• Prototype: tắt sử dụng thêm để tránh hóa đơn bất ngờ.
• Production automation: bật sử dụng thêm nếu agent cần chạy liên tục.

Tín dụng luôn được dùng trước. Bạn chỉ bị tính phí vượt mức sau khi dùng hết hạn mức hàng tháng.

Cách đăng ký tín dụng Agent SDK

Tín dụng không bật mặc định. Bạn cần yêu cầu một lần.

1. Đăng nhập vào tài khoản Claude sở hữu gói đăng ký.
   • Pro/Max: tài khoản người dùng.
   • Team/Enterprise: tài khoản của từng ghế.
2. Mở phần cài đặt gói Claude Agent SDK được liên kết từ bài viết hỗ trợ chính thức của Anthropic.
3. Yêu cầu tín dụng.
4. Sau khi yêu cầu thành công, tín dụng sẽ tự làm mới mỗi tháng.

Nếu bạn dùng gói Team, mỗi thành viên phải tự yêu cầu. Quản trị viên không thể yêu cầu thay cho từng ghế.

Thiết lập Claude Agent SDK

Agent SDK có sẵn cho Python và TypeScript. Với cơ chế tín dụng theo gói, bạn xác thực thông qua Claude Code CLI thay vì dùng API key thô.

Python

Cài SDK:

pip install claude-agent-sdk

Đăng nhập Claude Code:

claude login

Lệnh này lưu thông tin xác thực cục bộ gắn với gói Claude của bạn. Python SDK sẽ tự nhận diện thông tin này, nên bạn không cần đặt ANTHROPIC_API_KEY cho luồng dùng tín dụng gói.

Ví dụ agent tối thiểu:

from claude_agent_sdk import Agent

agent = Agent(
    system_prompt="You are a code review assistant.",
)

response = agent.run("Review the diff in /tmp/patch.diff and flag concerns.")
print(response.text)

Trước đây, luồng này cần ANTHROPIC_API_KEY và bị tính phí API theo mức sử dụng. Với thay đổi mới, chi phí được trừ vào tín dụng Agent SDK của gói.

TypeScript

Cài SDK:

npm install @anthropic-ai/claude-agent-sdk

Đăng nhập Claude Code:

claude login

Ví dụ agent tối thiểu:

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

const agent = new Agent({
  systemPrompt: "You are a code review assistant.",
});

const response = await agent.run(
  "Review the diff in /tmp/patch.diff and flag concerns."
);

console.log(response.text);

Với môi trường SDK không tự tìm thấy thông tin xác thực Claude Code, ví dụ CI runner, Docker container hoặc remote dev box, bạn có thể cấu hình bằng biến môi trường. Anthropic công bố tên biến chính xác trong tài liệu Agent SDK.

Nếu claude login gặp lỗi cấu hình trước khi bạn thiết lập SDK, hướng dẫn khắc phục lỗi cấu hình doanh nghiệp custom3p không hợp lệ xử lý một nguyên nhân phổ biến.

Dùng claude -p cho workflow không tương tác

Bạn cũng có thể dùng tín dụng Agent SDK mà không cần viết SDK code: chạy claude -p trong Claude Code.

-p đưa Claude Code vào chế độ không tương tác. Bạn truyền prompt, Claude chạy trên repo hoặc input hiện tại rồi thoát. Không có phiên chat qua lại. Đây là cách phù hợp để đưa Claude Code vào CI pipeline, cron job hoặc Git hook.

Ví dụ pre-commit hook kiểm tra thay đổi rủi ro:

#!/usr/bin/env bash
# .git/hooks/pre-commit

DIFF=$(git diff --cached)

claude -p "Review this diff for security issues, secret leaks, and breaking changes. Return PASS or FAIL with reasoning:

$DIFF"

Sau ngày 15/6, mỗi lần gọi claude -p được trừ vào tín dụng Agent SDK, không phải ngân sách Claude Code tương tác. Điều này giúp bạn tự động hóa kiểm tra mà không làm cạn giới hạn dùng cho coding hằng ngày.

Workflow này có thể kết hợp với lệnh /goal cho vòng lặp tự động và file ngữ cảnh AGENTS.md để điều khiển agent ổn định hơn giữa các lần chạy.

Tích hợp GitHub Actions

Tích hợp GitHub Actions của Claude Code cũng nằm trong phần được tín dụng SDK bao gồm. Nếu bạn dùng Claude để review PR, phân loại issue hoặc tạo release notes, các workflow run đó giờ có thể được thanh toán bằng tín dụng Agent SDK của người dùng đã cài GitHub App.

Điều này hữu ích với các dự án như Clawsweeper, bot phân loại GitHub được xây dựng trên Claude Code, nơi automation chạy liên tục và chi phí thường phụ thuộc vào API key được gắn với ứng dụng.

Xây dựng agent thực tế: kết hợp SDK với Apidog

Giá trị lớn của Agent SDK nằm ở các agent không chỉ trả lời văn bản, mà còn gọi API thật, truy vấn cơ sở dữ liệu hoặc triển khai code. Để chạy ổn định, agent cần hợp đồng rõ ràng cho từng API bên ngoài mà nó gọi. Nếu không, agent có thể đoán sai request shape và bạn sẽ mất thời gian debug payload bị hallucinate.

Một workflow thực tế với Apidog:

1. Định nghĩa contract API trước trong Apidog.
   • Khai báo endpoint.
   • Khai báo request/response schema.
   • Thêm payload mẫu.
2. Xuất OpenAPI và đưa vào agent làm ngữ cảnh.
3. Dùng SDK để kết nối agent với endpoint thật.
4. Xác thực bằng Apidog CLI để kiểm tra API vẫn trả về đúng contract.

Với agent điều phối công cụ qua MCP server, workflow kiểm thử MCP server với Apidog là điểm bắt đầu phù hợp. Bạn có thể kiểm thử end-to-end các tool mà agent gọi.

Góc nhìn tổng thể hơn nằm trong hướng dẫn workflow API design-first: khi agent có contract để xác thực, công việc của developer chuyển từ sửa lỗi JSON schema phát sinh sang thiết kế contract và constraint tốt hơn.

Bạn có thể tải xuống Apidog miễn phí nếu muốn thêm lớp contract cho dự án Agent SDK.

Khi nào vẫn nên dùng API key riêng

Tín dụng theo gói là lựa chọn mặc định hợp lý cho phần lớn developer. Tuy nhiên, API key độc lập vẫn phù hợp trong một số trường hợp:

• Agent production cần ngân sách dự đoán được. Tín dụng gói bị giới hạn ở số tiền cố định. Nếu agent cần scale không giới hạn, API key theo mức sử dụng giúp finance/ops có dòng thanh toán rõ hơn.
• Truy cập dùng chung giữa nhiều người hoặc nhiều tổ chức. API key không gắn với một người dùng duy nhất.
• Ghế Enterprise Standard. Ghế này không nhận tín dụng Agent SDK. Nếu bạn cần SDK access, API key là lựa chọn còn lại.

Hướng dẫn truy cập Claude API miễn phí bao gồm các cách dùng Claude không yêu cầu gói Pro hoặc API key trả phí.

Checklist trước khi bắt đầu

• [ ] Xác nhận gói của bạn đủ điều kiện: Pro, Max 5x, Max 20x, Team Standard, Team Premium, Enterprise dựa trên mức sử dụng hoặc ghế Enterprise Premium.
• [ ] Yêu cầu đăng ký một lần để nhận tín dụng Agent SDK.
• [ ] Quyết định có bật sử dụng thêm hay không.
  • Prototype: tắt.
  • Production: bật nếu cần chạy liên tục.
• [ ] Chạy claude login.
• [ ] Cài SDK Python hoặc TypeScript.
• [ ] Chạy agent tối thiểu mà không đặt ANTHROPIC_API_KEY.
• [ ] Kiểm tra số dư tín dụng trong cài đặt tài khoản sau vài lần chạy đầu tiên.

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

Tôi có cần xóa ANTHROPIC_API_KEY cũ để tín dụng gói hoạt động không?

SDK dùng thông tin xác thực cục bộ của Claude Code khi có sẵn. Vì vậy, claude login là đủ để chuyển SDK sang thanh toán dựa trên gói. Nếu bạn vẫn cần ANTHROPIC_API_KEY cho công cụ khác, có thể giữ nguyên.

Điều gì được tính là một “request” đối với tín dụng?

Tín dụng được tính bằng đô la, không phải số request. Mỗi cuộc gọi SDK được tính theo mức giá API mà Anthropic công bố. Số dư giảm theo chi phí của từng cuộc gọi model, bao gồm tool use và context token.

Tôi có thể chia sẻ tín dụng với đồng đội không?

Không. Tín dụng tính theo từng người dùng và không thể chuyển nhượng. Mỗi ghế Team hoặc Enterprise có nhóm tín dụng riêng.

Số dư console API Anthropic cũ của tôi thì sao?

Nó vẫn tồn tại. Tín dụng gói là cơ chế thanh toán riêng. Nếu bạn có số dư trả trước trên API console, số dư đó vẫn dùng cho workload chạy bằng API key.

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

Không. Claude Code là CLI và các tiện ích mở rộng IDE chính thức của Anthropic. Agent SDK là thư viện lập trình cho Python hoặc TypeScript để xây dựng agent tùy chỉnh. Tín dụng bao gồm SDK và lệnh claude -p không tương tác trong Claude Code. Claude Code tương tác vẫn nằm trong giới hạn sử dụng thông thường của gói.

Hóa đơn GitHub Actions của tôi có thay đổi không?

Nếu Action dùng tích hợp GitHub Actions chính thức của Claude Code và tín dụng đã được yêu cầu trên tài khoản của người dùng cài đặt, các lần chạy đó sẽ được trừ vào tín dụng SDK thay vì thanh toán qua API key.

Tín dụng có hoạt động ngoài Agent SDK và claude -p không?

Không, ngoài các bề mặt được bao gồm: SDK Python/TypeScript, claude -p, GitHub Actions và ứng dụng bên thứ ba dùng Agent SDK. Các hình thức sử dụng Claude khác vẫn quay về giới hạn thông thường của gói hoặc API key, tùy nguồn request.