Blog

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

Ashley Innocent

Ashley Innocent

14 tháng 5 2026

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

Apidog cho doanh nghiệp

Triển khai tại chỗ

SSO & RBAC

Tuân thủ SOC 2

Khám phá Apidog Enterprise

Anthropic cho phép bạn chạy Claude Agent SDK trên gói đăng ký Claude hiện có của bạn bắt đầu từ ngày 15 tháng 6 năm 2026. Trước đây, việc xây dựng bất kỳ thứ gì bằng Agent SDK yêu cầu một khóa API riêng với thanh toán trả theo mức sử dụng, bổ sung vào những gì bạn đã trả cho Claude Pro hoặc Max. Kể từ ngày 15 tháng 6 trở đi, gói Claude hàng tháng của bạn sẽ bao gồm một số dư tín dụng dành riêng cho việc sử dụng Agent SDK. Không yêu cầu khóa API.

Nếu bạn từng muốn xây dựng một tác nhân tùy chỉnh (một bot triển khai, một trợ lý nghiên cứu, một công cụ phân loại) nhưng không muốn cung cấp một thẻ thanh toán riêng cho Anthropic chỉ để tạo nguyên mẫu, thì đây là thay đổi quan trọng. Gói đăng ký Pro của bạn giờ đây đi kèm với 20 đô la/tháng sử dụng Agent SDK. Gói Max 20x đi kèm 200 đô la. Ghế Team Premium đi kèm 100 đô la.

nút

Điều gì đã thay đổi vào ngày 15 tháng 6 năm 2026

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

Dưới đây là tín dụng theo từng gói, được lấy trực tiếp từ thông báo của Anthropic:

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

Một vài quy tắc quan trọng:

Những gì tín dụng bao gồm và những gì không bao gồm

Anthropic đã phân chia điều này một cách cẩn thận. Hãy đọc kỹ; ranh giới giữa “được bao gồm” và “không được bao gồm” là yếu tố quyết định hóa đơn của bạn có thực sự thay đổi hay không.

Được bao gồm bởi tín dụng Agent SDK:

Không được bao gồm (những mục này vẫn được trừ từ gói Claude thông thường của bạn hoặc vẫn riêng biệt):

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

Đây là một lựa chọn thiết kế có ý nghĩa. Điều đó có nghĩa là bạn có thể thử nghiệm với một tác nhân tùy chỉnh được xây dựng trên SDK mà không ảnh hưởng đến ngân sách bạn sử dụng cho việc viết mã hàng ngày thông qua Claude Code.

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

Tín dụng bao gồm một số tiền cố định mỗi tháng. Điều gì xảy ra khi bạn vượt quá mức đó phụ thuộc vào một cài đặt:

Đối với công việc tạo nguyên mẫu, hãy để tính năng sử dụng thêm bị tắt. Bạn sẽ nhận được tín hiệu dừng rõ ràng và tránh được các hóa đơn bất ngờ. Đối với các hệ thống tự động hóa cấp sản xuất cần chạy liên tục, hãy bật tính năng này.

Tín dụng luôn được sử dụng trước. Bạn sẽ không phải trả phí vượt mức cho đến khi hết hạn mức hàng tháng của mình.

Cách đăng ký

Tín dụng không được bật theo mặc định. Việc đăng ký chỉ cần thực hiện một lần và sẽ có hiệu lực trong các chu kỳ thanh toán, nhưng bạn phải thực hiện nó một lần.

  1. Đăng nhập vào tài khoản Claude sở hữu gói đăng ký (tài khoản người dùng trên Pro/Max, hoặc tài khoản ghế trên Team/Enterprise).
  2. Truy cập 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. Sau đó, tín dụng sẽ tự động làm mới mỗi tháng.

Nếu bạn có nhiều ghế trong gói Team, mỗi người dùng phải yêu cầu độc lập. Quản trị viên không thể yêu cầu thay mặt cho thành viên ghế.

Thiết lập SDK trong Python hoặc TypeScript

Agent SDK có sẵn cả trong Python và TypeScript. Cả hai đều xác thực theo cùng một cách với gói của bạn: thông qua Claude Code CLI thay vì khóa API thô.

Python

Cài đặt:

pip install claude-agent-sdk

Xác thực bằng cách đăng nhập vào Claude Code trước:

claude login

Điều này lưu trữ thông tin xác thực gắn liền với gói cục bộ. Python SDK sẽ tự động nhận diện chúng; bạn không cần đặt ANTHROPIC_API_KEY cho việc sử dụng dựa trên gói.

Một tác nhân tối thiểu trông như thế này:

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, cùng một cuộc gọi sẽ yêu cầu ANTHROPIC_API_KEY và thanh toán API theo mức sử dụng. Giờ đây, nó sẽ được trừ vào tín dụng gói của bạn.

TypeScript

Cài đặt:

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

Xác thực thông qua cùng một lần đăng nhập Claude Code:

claude login

Một tác nhân tối thiểu trong TypeScript:

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);

Đối với các môi trường mà SDK không thể tự động tìm thấy thông tin xác thực của Claude Code (CI runners, Docker containers, remote dev boxes), bạn có thể đặt chúng làm 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 đăng nhập Claude Code của bạn gặp lỗi cấu hình trước khi bạn thiết lập SDK, khắc phục lỗi cấu hình doanh nghiệp custom3p không hợp lệ sẽ giải quyết nguyên nhân phổ biến nhất.

Quy trình làm việc claude -p

Có một cách thứ hai để sử dụng tín dụng Agent SDK mà không cần viết mã: lệnh `claude -p` trong Claude Code.

`-p` đưa Claude Code vào chế độ không tương tác. Bạn cung cấp cho nó một lời nhắc, nó thực thi đối với kho lưu trữ của bạn và thoát. Không có phiên tương tác qua lại. Đây là cách bạn đưa Claude Code vào các pipeline CI, cron job và Git hook.

Một ví dụ đơn giản: một hook pre-commit yêu cầu Claude gắn cờ các 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:\n\n$DIFF"

Mỗi lần gọi `claude -p` sau ngày 15 tháng 6 sẽ được trừ vào tín dụng Agent SDK của bạn, không phải ngân sách Claude Code tương tác của bạn. Điều này có nghĩa là bạn có thể kết nối nó vào các quy trình làm việc tự động mà không phải lo lắng về việc sử dụng hết các giới hạn bạn cần cho việc viết mã hàng ngày.

Điều này kết hợp tốt với lệnh /goal cho các vòng lặp tự động, và với các tệp ngữ cảnh AGENTS.md để điều khiển tác nhân một cách đáng tin cậy qua các lần chạy.

Tích hợp GitHub Actions

Tích hợp GitHub Actions của Claude Code là công việc thứ ba được tín dụng SDK bao gồm. Nếu bạn đã kết nối Claude vào việc xem xét PR, phân loại vấn đề hoặc tạo ghi chú phát hành, thì các lần chạy quy trình làm việc đó giờ đây sẽ được thanh toán bằng tín dụng Agent SDK của bất kỳ người dùng nào đã cài đặt GitHub App.

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

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

Giá trị thực của Agent SDK là dành cho các tác nhân không chỉ phản hồi văn bản; các tác nhân gọi API thực, truy vấn cơ sở dữ liệu, triển khai mã. Để điều đó hoạt động đáng tin cậy, tác nhân cần một hợp đồng được xác định cho mỗi API bên ngoài mà nó chạm tới. Nếu không có, tác nhân sẽ đoán hình dạng yêu cầu và bạn sẽ dành thời gian gỡ lỗi để sửa các tải trọng bị ảo giác.

Đây là nơi Apidog phù hợp với quy trình làm việc:

  1. Định nghĩa hợp đồng API trước tiên trong Apidog. Chỉ định các điểm cuối, lược đồ yêu cầu/phản hồi và tải trọng ví dụ. Điều này trở thành nguồn chân lý.
  2. Xuất OpenAPI và chuyển nó cho tác nhân của bạn làm ngữ cảnh.
  3. Sử dụng SDK để kết nối tác nhân với các điểm cuối thực. Tác nhân gọi API của bạn bằng cách sử dụng các lược đồ mà nó biết là chính xác.
  4. Xác thực bằng Apidog CLI. Mỗi lần chạy tác nhân có thể xác minh rằng API vẫn trả về những gì hợp đồng đã cam kết.

Đối với các tác nhân điều phối các công cụ khác thông qua máy chủ MCP, quy trình làm việc kiểm thử máy chủ MCP với Apidog là hướng dẫn phù hợp. Bạn sẽ có được phạm vi kiểm thử từ đầu đến cuối trên các công cụ mà tác nhân của bạn gọi.

Bức tranh lớn hơn nằm trong hướng dẫn quy trình làm việc API ưu tiên thiết kế: khi tác nhân có một hợp đồng để xác thực, thời gian của bạn với tư cách là một nhà phát triển sẽ chuyển sang việc viết các hợp đồng và ràng buộc tốt hơn, thay vì đuổi theo các lỗi lược đồ JSON trong đầu ra của tác nhân.

Tải xuống Apidog miễn phí nếu bạn muốn lớp hợp đồng hỗ trợ các dự án Agent SDK của mình.

Khi bạn vẫn muốn một khóa API riêng

Tín dụng dựa trên gói là lựa chọn mặc định phù hợp cho hầu hết các nhà phát triển. Vẫn có những trường hợp khóa API độc lập có ý nghĩa:

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

Danh sách kiểm tra rõ ràng trước khi bạn bắt đầu

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

Tôi có cần xóa ANTHROPIC_API_KEY cũ của mình để tín dụng gói hoạt động không? SDK sử dụng thông tin xác thực cục bộ của Claude Code khi chúng tồn tại, có nghĩa là `claude login` là đủ để chuyển SDK sang thanh toán dựa trên gói. Nếu bạn có `ANTHROPIC_API_KEY` được đặt trong môi trường của mình cho các công cụ khác, hãy giữ nguyên; SDK sẽ ưu tiên xác thực gói khi có.

Điều gì được tính là một “yêu cầu” đối với tín dụng? Tín dụng được tính bằng đô la, không phải số yêu cầu. Mỗi cuộc gọi SDK được tính phí theo cùng mức giá mà Anthropic công bố cho việc sử dụng API; số dư tín dụng của bạn giảm đi bằng chi phí của mỗi cuộc gọi mô hình, bao gồm việc sử dụng công cụ và token ngữ cảnh. Không có phí riêng cho mỗi yêu cầu nào khác.

Tôi có thể chia sẻ tín dụng của mình với đồng đội không? Không. Tín dụng dành cho mỗi 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 sẽ ra sao? Nó vẫn ở đó. Tín dụng gói là một cơ chế thanh toán riêng biệt. Nếu bạn có số dư trả trước trên console API của mình, điều đó vẫn hoạt động cho bất kỳ khối lượng công việc API key nào.

Agent SDK có giống với Claude Code không? Không. Claude Code là CLI và các tiện ích mở rộng IDE chính thức mà Anthropic cung cấp. Agent SDK là một thư viện lập trình (Python hoặc TypeScript) để xây dựng các tác nhân tùy chỉnh. Tín dụng bao gồm SDK cộng với 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 gói thông thường của bạn.

Hóa đơn GitHub Actions của tôi có thay đổi không? Nếu Action của bạn sử 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, thì các lần chạy đó giờ đây sẽ được trừ vào tín dụng SDK thay vì thanh toán bằng bất kỳ khóa API nào.

Tín dụng có hoạt động bên ngoài Agent SDK và `claude -p` không? Không đối với bốn bề mặt được bao gồm (SDK trong Python/TS, `claude -p`, GitHub Actions, ứng dụng Agent SDK của bên thứ ba). Bất kỳ việc sử dụng Claude nào khác sẽ trở lại giới hạn thông thường của gói bạn hoặc khóa API của bạn, tùy thuộc vào nơi yêu cầu bắt nguồn.

nút

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API

Đăng ký miễn phíTải xuống