SpyBara
Go Premium

agent-sdk/overview.md 2026-10-21 23:02 UTC to 2026-10-22 22:58 UTC

This page contains 17 additions and 17 deletions.

2026
Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

Agent SDK の概要

Claude Code をライブラリとして使用して、本番環境対応の AI エージェントを構築します

エージェントは、独自のステップを計画し、ファイルを読み取る、コマンドを実行する、またはコードを編集するツールを呼び出すことでタスクを完了するアプリケーションです。Agent SDK は、Claude Code を強化する同じツール、エージェントループ、およびコンテキスト管理を提供し、Python と TypeScript でプログラム可能です。

Agent SDK と他の Claude ツールの比較

Agent SDK、CLI、Client SDK、および Managed Agents は、エージェントを実行するのは誰か、何が組み込まれているか、どのようにアクセスするかが異なります。構築して実行する方法に合致する行を見つけてください。

対象 使用するツール 取得内容
Claude Code のエージェントを自分で操作するプロセスで、独自の Python または TypeScript アプリケーションに埋め込む Agent SDK Claude Code バイナリを実行するライブラリで、組み込みツール、権限、セッション、hooks などの Claude Code の機能を備えています。
ターミナルから対話的な開発またはワンオフタスクを実行する Claude Code CLI 日常的な対話的使用のために構築されたターミナルインターフェース。
独自のコードから Claude API を直接呼び出す Client SDK クライアント SDK 言語のいずれからでも Claude API に直接アクセスできます。ツールループを自分で記述するか、クライアント SDK のベータ版ツールランナーに駆動させることができます。
Anthropic がエージェントをホストし、Claude API を通じて構成する Managed Agents エージェントループを実行するホストされたエージェントハーネスで、Anthropic が管理するクラウドサンドボックスまたは独自のインフラストラクチャ上のセルフホストサンドボックスのセッションを備えています。言語用の SDK、ant CLI、または REST API から使用できます。

Python または TypeScript 以外の言語から同じエージェントループを駆動するには、-p フラグと --output-format json を使用して CLI をサブプロセスとして実行してください。

機能

これらの Claude Code 機能は SDK で利用可能です。

機能 機能 詳細を学ぶ
組み込みツール ファイルの読み取り、書き込み、編集、コマンド実行、ウェブ検索 ツールリファレンス
Hooks エージェントライフサイクルの重要なポイントでカスタムコードを実行 Hooks
Subagents 特定のサブタスク用に特化したエージェントを生成 Subagents
MCP Model Context Protocol を介して外部ツールとデータソースを接続 MCP
権限 どのツールが自動的に実行されるか、どのツールが承認を必要とするかを制御 権限
セッション 複数の交換にわたってコンテキストを維持し、後で再開またはフォーク セッション
Skills、コマンド、メモリ プロジェクトの .claude/ と ~/.claude/ から自動的に読み込み、Claude Code と同じ Skills、コマンド、メモリ、設定読み込み
Plugins Skills、エージェント、hooks、MCP サーバーをパッケージ化し、ローカルパスで読み込み Plugins

はじめに

クイックスタートに従って、SDK をインストールし、API キーを設定し、既存のコード内のバグを見つけて修正するエージェントを構築してください。

[!NOTE]

事前に承認されていない限り、Anthropic は、Agent SDK 上に構築されたエージェントを含む、サードパーティの開発者が claude.ai ログインまたはレート制限を提供することを許可していません。代わりに、クイックスタートで説明されている API キー認証方法を使用してください。

変更ログ

SDK の更新、バグ修正、および新機能の完全な変更ログを表示します。

バグの報告

Agent SDK でバグまたは問題が発生した場合：

ブランドガイドライン

Claude Agent SDK を統合するパートナーの場合、Claude ブランドの使用はオプションです。製品で Claude を参照する場合：

許可されています：

  • 「Claude Agent」（ドロップダウンメニューに推奨）
  • 「Claude」（既に「Agents」というラベルが付いたメニュー内の場合）
  • 「{YourAgentName} Powered by Claude」（既存のエージェント名がある場合）

許可されていません：

  • 「Claude Code」または「Claude Code Agent」
  • Claude Code ブランドの ASCII アートまたは Claude Code を模倣する視覚要素

製品は独自のブランドを維持し、Claude Code または任意の Anthropic 製品のように見えるべきではありません。ブランドコンプライアンスに関する質問については、Anthropic 営業チームに連絡してください。

ライセンスと利用規約

Claude Agent SDK の使用は、Anthropic の商用利用規約によって管理されます。これは、Claude Agent SDK を使用して、独自のカスタマーおよびエンドユーザーに利用可能にする製品およびサービスを強化する場合を含みます。ただし、特定のコンポーネントまたは依存関係が、そのコンポーネントの LICENSE ファイルに示されているように異なるライセンスの対象である場合を除きます。

次のステップ

これらのリソースは、Agent SDK を使用して構築するための、より深い技術的詳細とサンプルプロジェクトをカバーしています。