anthropics/claude-agent-sdk-python

これは何？

主な機能

• 01非同期のquery()関数からClaude Codeのレスポンスをストリーミングで取得できます。
• 02ClaudeSDKClientで複数ターンの対話セッションを実行できます。
• 03Pythonのデコレーターを使い、プロセス内MCPサーバーとしてカスタムツールを定義できます。
• 04エージェントループの特定のタイミングで実行されるPythonフックを登録できます。
• 05許可・禁止するツールのリストと権限モードで、ツールの利用権限を制御できます。

ユースケース

• Pythonアプリケーションや社内ツールにClaudeのコーディングエージェントを組み込む。
• ドメイン固有のPython関数を、Claudeが呼び出せるツールとして追加する。
• フックを使って特定のシェルコマンドをブロックするなど、ポリシーを適用する。
• プロジェクトディレクトリに対してClaude Codeを実行する自動化ワークフローを構築する。

クイックスタート

1. 1

   SDKをPyPIからインストールします

   pip install claude-agent-sdk
2. 2

   READMEのクイックスタートコードをPythonファイルとして保存し、anyioで実行します

使う前に知っておきたいこと

• !利用にはMITライセンスだけでなく、AnthropicのCommercial Terms of Serviceが適用されます。
• !Python 3.10以降が必要です。
• !Claudeにクエリを送信するには、Anthropicのサービスへのアクセスと認証情報が必要です。

トピック

よくある質問

claude-agent-sdk-python とは？

query()、対話型クライアント、プロセス内のカスタムツールとフックを備えた、Claude Code上でエージェントを構築するためのPython SDKです。 Claude Agent SDK for Pythonを使うと、PythonアプリケーションからプログラムでClaude Codeを操作できます。pipでインストールし、query()を呼び出してプロンプトを送信し、ストリーミングされるレスポンスメッセージを順に処理できます。または、ClaudeSDKClientを使って双方向の複数ターンの会話を行えます。

claude-agent-sdk-python は無料で使えますか？ライセンスは？

claude-agent-sdk-python は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

claude-agent-sdk-python は今もメンテナンスされていますか？

活発にメンテナンス中。claude-agent-sdk-python の最終コミットは 2026年10月19日 です。

claude-agent-sdk-python は何に使えますか？

Pythonアプリケーションや社内ツールにClaudeのコーディングエージェントを組み込む。 ドメイン固有のPython関数を、Claudeが呼び出せるツールとして追加する。 フックを使って特定のシェルコマンドをブロックするなど、ポリシーを適用する。 プロジェクトディレクトリに対してClaude Codeを実行する自動化ワークフローを構築する。

claude-agent-sdk-python のインストール方法は？

SDKをPyPIからインストールします: pip install claude-agent-sdk READMEのクイックスタートコードをPythonファイルとして保存し、anyioで実行します

claude-agent-sdk-python はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/anthropics/claude-agent-sdk-python