Claude Code用語集｜Claude Agent SDKとは

Claude Agent SDKは、PythonやTypeScriptのプログラムからClaudeのエージェント機能を使うためのライブラリです。SDKと聞くと難しそうな印象を持つかもしれませんが、普段Claude Codeをターミナルで使っているなら直接関係ありません。Agent SDKが何をするものか、Claude Codeや他のSDKとどこが違うのかを見ていきます。

一言でいうと

Claude Agent SDKは、自分で作ったプログラムにClaudeを組み込んで使うためのライブラリです。PythonかTypeScriptでコードを書いて、プログラムの中からClaudeに指示を出したり、結果を受け取ったりできます。

CLI（コマンドラインインターフェース）で黒い画面に文字を打ち込んで使うのがClaude Code。一方、Agent SDKはプログラムのコードの中にClaudeを組み込む使い方です。どちらも裏側では同じClaudeが動いていますが、使い方が違います。

SDKとは「プログラムから機能を呼び出すための部品集」のこと。Agent SDKはその部品を使って、Claudeのエージェント機能（ツールの実行や文脈の管理など）を自分のプログラムから使えるようにしたものです。

普段Claude Codeをターミナルで対話しながら使っているだけなら、今はAgent SDKを知らなくても困りません。

どこでこの言葉を見かけるか

Agent SDKという言葉は、Anthropicの公式ドキュメントや開発系の技術記事で見かけることが多いです。「自分のアプリにClaudeの機能を組み込みたい」という文脈で登場します。

たとえば、Pythonのパッケージを探していて claude-agent-sdk という名前を見つけたり、TypeScriptの @anthropic-ai/claude-agent-sdk というパッケージ名に出くわしたりすることがあります。

なお、Agent SDKはもともと「Claude Code SDK」という名前で公開され、のちに現在の名前に変更されました。旧名のまま書かれた記事も見かけますが、指しているものは同じです。

Claude Codeを普段使いしている分には、このSDKを直接操作することはありません。ドキュメントの隅に載っているのを見かけて「これ何？」と思った、というのが出会いの典型的なパターンです。

Claude CodeとAgent SDKの違い

一番混同しやすいのがこの2つです。

Claude Codeは、人がターミナル（WindowsならコマンドプロンプトやPowerShell）から直接操作して使う対話型のCLIツールです。画面に向かって指示を書き、その場で結果が返ってくる使い方をします。

Agent SDKは、自分で作ったプログラムの中にClaudeを組み込んで使うライブラリです。プログラムが自動的にClaudeに指示を出し、結果を受け取る流れになります。

どちらも裏側は同じClaudeが動いています。用途が違うだけで、どちらが優れているという話ではありません。

	Claude Code	Agent SDK
何をするもの	ターミナルで対話するCLIツール	プログラムに組み込むライブラリ
使い方	画面に指示を書いて使う	Python/TypeScriptのコードから呼ぶ
向いている用途	その場で作業を進めたい時	自動処理やパイプラインを作りたい時
コーディング	不要	PythonかTypeScriptが必要

裏側の仕組みとしては、Agent SDKはClaude Codeを支えるツール、エージェントループ、コンテキスト管理をプログラムから使えるようにしたものです。公式ドキュメントでは、TypeScript SDKについてはネイティブClaude Codeバイナリを任意依存として同梱するため、別途Claude Codeをインストールしなくても使えると説明されています。

似ている名前との違い（Client SDK・Managed Agents）

Agent SDKの周辺には、名前が似ているものがいくつかあります。それぞれ役割が違うので押さえておきましょう。

Client SDKは、Anthropic公式のAPI通信ライブラリです。Pythonの anthropic パッケージやTypeScriptの @anthropic-ai/sdk がこれに当たります。APIにリクエストを送って回答を受け取る、という基本的な通信機能を提供します。ただし、ツールの実行ループ（ツールを使って→結果を見て→次の行動を決める、の繰り返し）は自分で書く必要があります。

Agent SDKは、ツール実行ループやコンテキスト管理など、Claude Codeに近いエージェント実行の仕組みをプログラムから使いやすくしたライブラリです。Client SDKがAPI通信の基本部品だとすれば、Agent SDKはエージェントとして動かす部分まで扱いやすくしたもの、と考えると分かりやすいです。

Managed Agentsは、サーバーレスでAnthropic側がホストしてくれる仕組みです。自分でプロセスを動かさずにエージェントを使えます。2026年4月時点ではベータ版です。

	役割	コードの必要性	実行環境
Client SDK	API通信	必要	自前のサーバーやPC
Agent SDK	エージェント構築	必要	自前のサーバーやPC
Managed Agents	エージェント構築	必要	Anthropic側でホスト

Agent SDKとManaged Agentsの使い分けは、実行環境を自分で制御したいかAnthropic任せにしたいかで決まります。

Amazon BedrockやGoogle Vertex AI経由でも使えるため、AWSやGCPを既に使っている場合も導入しやすい設計です。

自分に今必要かどうかの判断

Agent SDKが必要かどうかは、やりたいことでほぼ決まります。

必要な時：
– 自作のアプリにClaudeを組み込みたい
– 自動処理のパイプラインを作りたい
– エージェントをプログラムから操作したい
– PythonかTypeScriptでコードを書く前提がある

不要な時：
– 普段の作業でClaude Codeを使うだけ
– ターミナルで対話しながら作業を進めている
– プログラミングを伴う自動化は今のところ考えていない

まずはClaude Codeを使いこなしてから、必要が生じたらSDKを検討する流れで十分です。

プログラミング不要でできることと、コードを書く必要があることの境界を意識しておくと、自分に何が必要か判断しやすくなります。

初心者が混乱しやすい点

よくある誤解をいくつか挙げておきます。

「SDKを入れないとClaude Codeが使えない」
→ 間違いです。Claude Codeは単独で動きます。Agent SDKは別物です。

「Agent SDK＝エージェントチーム機能」
→ 違います。名前が似ているだけで別の仕組みです。エージェントチーム機能はClaude Codeの中の機能で、Agent SDKとは関係ありません。

「SDKの方が高度で優れている」
→ 目的が違うだけで優劣の話ではありません。ターミナルで使うならClaude Code、プログラムに組み込むならAgent SDK、と用途に応じた選び方をします。

「SDKを入れればすぐ使える機能」
→ 違います。Agent SDKを使うにはPythonかTypeScriptでコードを書く前提があります。インストールするだけで何かが変わるわけではありません。

認証方法はAPIキーのほか、Amazon Bedrock、Google Vertex AI、Azure AI Foundryなどの外部プロバイダー経由があります。Claude Codeのログイン方法とAgent SDKの認証方法は混同しやすいので、初心者は「Agent SDKではAPIキーやクラウド経由の認証を使う」と覚えておくと安全です。

まとめ

Claude Agent SDKは、プログラムからClaudeのエージェント機能を使うためのライブラリです。普段Claude Codeをターミナルで使っているだけなら、今は意識しなくても大丈夫。Client SDK（API通信）とAgent SDK（エージェント構築）の違い、Managed Agents（サーバーレス）との使い分けが分かっていれば、ドキュメントや技術記事でこの言葉を見かけても混乱せずに済むはずです。

Agent SDKを使いたくなった時は、PythonかTypeScriptでコードを書く前提があることを押さえておけば、自分に必要かどうかの判断軸になります。

Claude Codeでどこまでできる？