Claude Agent SDKとは？Claude Codeとの違い・導入手順・商用利用の注意点を解説

APIを叩いて回答をもらうところまでは作れた。けれど、ファイルを読ませ、コマンドを実行させ、結果を見て次の判断をさせる部分を自前で書くと、途端に大がかりになる。

この繰り返し処理を丸ごと引き受けるのがClaude Agent SDKです。Claude Codeを動かしている仕組みそのものを、PythonとTypeScriptのライブラリとして呼び出せます。

ここでは公式ドキュメントにもとづき、何ができるのか、Claude Codeや他の選択肢とどう違うのか、導入手順、そして製品に組み込む際に確認すべき規約までを整理します。

確認したいポイント	結論	詳細
Claude Agent SDKとは？	Claude Codeをライブラリ化したもの	同じエージェントループとツール、コンテキスト管理をPythonとTypeScriptから呼び出せる仕組み
Claude Codeとどう違う？	対話用か、製品に組み込むか	CLIは日々の対話作業向け。SDKは自社の処理やCI、製品の中にエージェントを埋め込む用途に向く
導入に必要なものは？	対応環境とAPIキーだけ	Node.js 18以降またはPython 3.10以降と、コンソールで発行したAPIキーがあれば始められる
商用利用の注意点は？	商用規約と表記の制限がある	Anthropicの商用利用規約が適用され、認証方式やClaude Codeの名称利用には決まりがある

この記事でわかること

• Claude Agent SDKの位置づけと、旧称からの変更点
• Claude Code・Client SDK・Managed Agentsとの使い分けの基準
• ツールと権限モードの組み合わせによる、任せる範囲の設計
• インストールから最初のエージェントを動かすまでの具体的な手順
• 製品へ組み込む前に確認すべき利用規約と表記のルール

▼ 自社サービスへのAIエージェント組み込みを検討中の方へ 動くものを作ることと、業務で使える形にすることの間には距離があります。権限設計や運用の設計が必要になります。 ネクストスケールでは、要件の整理から実装、運用の立ち上げまで一貫して支援しています。 ▶ 無料相談はこちら（株式会社ネクストスケール）

Claude Agent SDKはClaude Codeの中身をライブラリとして使う仕組み

最初に、このSDKが何を肩代わりしてくれるのかを押さえておきます。ここが分かると、他の選択肢との違いも見えてきます。

エージェントループを自分で書かずに済む

エージェントとは、自分で手順を組み立て、ファイルを読む、コマンドを走らせるといったツールを呼びながら課題を片付けるプログラムを指します。

このSDKは、Claude Codeを支えているのと同じツール群、エージェントループ、コンテキスト管理を、そのままライブラリとして提供します。 モデルを呼び、ツールを実行し、結果を受けて次を判断するという繰り返しを、自分で実装する必要がありません。

コンテキストが上限に近づいたときの圧縮や、再試行の扱いも内側で処理されます。書くのは、何をさせたいかという指示と、どこまで許すかという設定だけです。

標準で使えるツール

ツールの実装も不要です。ファイルの読み書きと編集、コマンドの実行、ウェブ検索といった機能が最初から用意されています。

そのほか、公式が挙げている機能は次のとおりです。

• フック：処理の要所で独自のコードを差し込む
• サブエージェント：限定した作業のために専用のエージェントを立てる
• MCP：外部のツールやデータソースにつなぐ
• 権限：どのツールを自動で動かし、どれに承認を求めるかを決める
• セッション：やり取りをまたいで文脈を保ち、再開や分岐を行う
• スキルやコマンド、メモリ：プロジェクト配下の設定ファイルから読み込む
• プラグイン：スキルやフック、MCPサーバーをまとめて配布する

旧称から改名されている点に注意

このSDKは、以前はClaude Code SDKという名前でした。 改名にともなってパッケージ名や読み込み先、設定用のオブジェクト名も変わっています。

検索で見つかる解説記事には、旧名称のままのものが残っています。旧パッケージを前提にしたコードをそのまま貼っても動かないため、記事の日付とパッケージ名は必ず確認してください。

エージェント型ツールの考え方そのものはAIエージェントとは何かで整理しています。

関連記事：Claudeでスライド作成する4つの方法｜PowerPoint連携とプロンプトのコツを解説

Claude CodeやClient SDKとの使い分けを先に決める

Anthropicは似た用途の選択肢を複数用意しています。どれを選ぶかで開発量が変わるため、着手前に整理しておくと無駄がありません。

4つの選択肢の違い

公式ドキュメントは、目的別に次の4つを挙げています。

• Agent SDK：ツールの繰り返し処理を自分で書かずにエージェントを作りたい場合。自分のプログラムの中でループが動く
• Claude Code CLI：ターミナルでの対話的な開発や、その場限りの作業を行う場合
• Client SDK：APIを直接呼び、ツールの繰り返し処理も自分で実装したい場合
• Managed Agents：実行環境やセッションの基盤を自前で持たずに、長時間動くエージェントを走らせたい場合。Anthropic側が環境ごと動かす別製品

判断の軸はシンプルです。人が画面の前にいるならCLI、プログラムの中に組み込むならSDK、実行基盤ごと任せたいならManaged Agentsという分け方になります。

CLIそのものの導入手順はClaude Codeのインストール方法で扱っています。

APIを直接呼ぶ場合との分かれ目

最も迷いやすいのが、Client SDKとの比較です。違いは、ツールの繰り返し処理を誰が書くかという1点に集約されます。

1回の応答がほしいだけ、あるいは処理の流れを完全に自分で制御したいのであれば、APIを直接呼ぶほうが素直です。逆に、判断と実行を何度も往復させたいのであれば、Agent SDKを使ったほうが実装量は大きく減ります。

PythonとTypeScript以外で使いたい場合

ライブラリとして提供されているのはこの2言語だけです。他の言語から同じ仕組みを使いたい場合は、CLIを子プロセスとして起動し、出力形式をJSONに指定する方法が案内されています。

既存のシステムがJavaやGoで書かれている場合は、この方式を前提に設計を検討することになります。

▼ どの構成が適しているか判断したい方へ 選択肢を誤ると、実装量も運用コストも大きく変わります。要件から逆算した構成の見極めが必要です。 自社のシステム構成に合わせた技術選定から、ご相談いただけます。 ▶ 無料相談はこちら（株式会社ネクストスケール）

関連記事：Claude APIとは？Anthropic発モデルの料金・使い方・活用のポイントを解説

ツールと権限の組み合わせで任せる範囲を決める

設計で最も重要なのが、エージェントに何を許すかという部分です。ここが緩いと事故につながり、厳しすぎると作業が完了しません。

ツールの組み合わせ

公式ドキュメントは、代表的な組み合わせを3段階で示しています。

• 読み取りと検索だけを許可：コードの解析や調査に使う。ファイルは変更されない
• 読み取りと編集を許可：解析に加えて修正まで行わせる
• コマンド実行まで許可：テストの実行や修正の検証まで含めた自動化を行う

最初は読み取りだけから始め、必要が明確になった範囲だけ広げるのが安全な進め方です。 検証段階でいきなりコマンド実行まで許可すると、想定外の変更に気づくのが遅れます。

権限モードで承認の挟み方を決める

ツールの指定とは別に、どこまで自動で進めるかを決める設定があります。ファイルの変更を自動で承認する指定にすれば人の確認を挟まずに進みますが、そのぶん結果の確認は後追いになります。

許可するツールの一覧と、この権限モードは組み合わせで評価されます。 片方だけを絞っても意図した制御にならないため、両方をそろえて設計してください。

MCPで外部システムにつなぐ

社内のデータベースや業務システムを扱わせたい場合は、MCPを通じて接続します。標準のツールに加えて、自社固有の処理を呼び出せるようになります。

接続の規格そのものはMCP（Model Context Protocol）とは、コードベースの解析を効率化する具体例はSerena MCPの導入方法で扱っています。

プロジェクトの設定ファイルを読み込ませる

Claude Codeで使っている設定ファイルを、SDKからも読み込めます。ただし既定では読み込まれないため、設定の読み込み元を明示的に指定する必要があります。 手元では効いていた指示がSDK側で無視される、という現象はここが原因のことが多い部分です。

関連記事：Claude Codeのインストール方法｜Mac・Windows別の手順とエラー対処を解説

導入手順はインストールとAPIキーの設定で完了する

環境構築は数分で終わります。手順に沿って進めれば、最初のエージェントはその日のうちに動かせます。

前提となる環境

必要なのはNode.js 18以降、またはPython 3.10以降です。あわせて、コンソールでAPIキーを発行できるアカウントを用意します。

Claude Codeを別途インストールする必要は基本的にありません。 どちらのパッケージにも実行用のバイナリが同梱されているためです。

パッケージのインストール

TypeScriptとPythonで、それぞれ次のコマンドを実行します。

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

pip install claude-agent-sdk

Pythonは仮想環境を作ってから入れる形が案内されています。TypeScript側は、トップレベルでの待機処理を使うためにモジュール形式の指定を加えておくと扱いやすくなります。

APIキーの設定

コンソールで発行したキーを、エージェントを動かすシェルの環境変数に設定します。

export ANTHROPIC_API_KEY=your-api-key

注意したいのは、SDKが設定ファイルを自動では読み込まない点です。 キーをファイルに置いて管理している場合は、SDKを呼ぶ前に自分で読み込ませる必要があります。

Amazon Bedrock、Google Cloud、Microsoftの基盤を経由する構成にも対応しています。いずれも環境変数の指定で切り替える形で、エージェント側のコードは変わりません。すでにクラウド環境を運用している企業では、この経路が選択肢になります。

最初のエージェントを動かす

公式のクイックスタートでは、わざと不具合を仕込んだファイルを用意し、それを見つけて直させる流れが紹介されています。中心となるのは、指示と設定を渡してループを開始する関数です。

指示は自然言語で書き、どのツールを使うかはモデル側が判断します。 実行すると、考えている内容と呼び出したツールが順に出力され、最後に結果が返ります。

実際のコード例は公式のクイックスタートに掲載されています。更新が続く領域のため、着手時は一次情報を確認してください。

▼ 検証から本番実装まで進めたい方へ サンプルを動かすところまでは進んでも、自社の業務に合わせた実装で止まってしまうという相談を多くいただきます。 要件定義から実装、運用設計までまとめてお引き受けできます。 ▶ 無料相談はこちら（株式会社ネクストスケール）

導入時につまずきやすい箇所

公式が注意点として挙げている項目のうち、実際に問い合わせが多い3つを整理します。

バイナリが同梱されないケース

通常は実行用のバイナリが一緒に入りますが、環境によっては含まれません。Python側では、環境に合った配布物ではなくソース形式で入った場合に起こります。 ARM版のWindowsが例として挙げられています。

TypeScript側では、任意の依存関係を省略する指定でインストールした場合に同じ状態になります。どちらの場合も、Claude Codeを別途導入して参照させる形で回避できます。

APIキーが読み込まれない

キーが見つからないという内容のエラーが出た場合、まず確認するのはエージェントを実行しているシェルに環境変数が設定されているかです。

繰り返しになりますが、SDKは設定ファイルを自動では読み込みません。 ローカルでは動いていたのにCI上で失敗する、という場合はここを疑うのが近道です。

旧パッケージの記述が残っている

改名前の名称で書かれた記事を参照していると、読み込み文や設定オブジェクトの名前が合いません。旧パッケージは非推奨とされているため、新しい名称に置き換えたうえで移行の手順を確認してください。

本番環境で動かすための設計

検証で動いたものを、そのまま業務に載せることはできません。人が見ていない場所で動く前提の設計が必要になります。

実行環境を隔離する

コマンド実行を許可する構成では、隔離した環境で動かすのが基本です。コンテナなどを使い、必要なファイルとコマンドだけをエージェントに見せる構成にしておけば、想定外の操作が起きても影響範囲が閉じます。

公式ドキュメントにも、コンテナやクラウド、CIへの配置を扱った項目が用意されています。自社の実行基盤に合わせて構成を選んでください。

コストと利用状況を把握する

エージェントは、1回の依頼で何度もモデルを呼びます。そのため、通常のAPI利用と比べて費用の見通しが立てにくくなります。 想定する業務量で試算し、上限の管理をどうするかを先に決めておく必要があります。

利用状況を記録する仕組みも用意されているため、どの処理にどれだけかかっているかを追える状態にしておくと、改善の判断がしやすくなります。

扱うデータの範囲を決める

業務システムに接続する構成では、どのデータまで読ませてよいかという線引きが必要です。認証情報や個人情報を含む領域を対象から外す設計は、実装より前に決めておく事項になります。

生成AIを業務に組み込む際の情報管理の考え方は生成AI利用時のセキュリティ対策で整理しています。

製品に組み込む前に確認すべき規約と表記のルール

自社サービスの機能としてエージェントを提供する場合、技術面とは別に確認すべき事項があります。日本語の解説記事ではあまり触れられていない部分です。

適用される利用規約

このSDKの利用には、Anthropicの商用利用規約が適用されます。 自社の顧客やエンドユーザーに提供する製品やサービスに組み込む場合も、同じ規約の下に置かれます。

なお、個別の構成要素や依存関係については、それぞれのライセンス表記が優先される場合があります。組み込みを検討する段階で、法務部門と共有しておくのが安全です。

認証方式の制限

見落としやすいのが認証まわりの決まりです。事前の承認がない限り、第三者の開発者が自社製品でclaude.aiのログインや利用枠を提供することは認められていません。

エンドユーザーの契約をそのまま流用する設計は取れないため、APIキーによる認証を前提に組み立てる必要があります。課金の持ち方が変わるので、事業設計にも影響する部分です。

ブランド表記のルール

製品内でClaudeに言及する場合の表記にも決まりがあります。公式が示している内容は次のとおりです。

• 使える表記：「Claude Agent」、エージェント一覧の中であれば「Claude」、既存の名称がある場合は「自社名 Powered by Claude」といった形
• 使えない表記：「Claude Code」や「Claude Code Agent」、Claude Codeを模した装飾やアスキーアート

製品はあくまで自社のブランドを保ち、Anthropicの製品そのものに見えないようにすることが求められています。 画面の設計を進める前に確認しておけば、後からの作り直しを避けられます。

最新の規約と表記の条件はAgent SDKの公式ドキュメントに記載されています。判断に迷う場合は、開発元へ直接確認することも案内されています。

▼ 自社プロダクトへの組み込みをご検討中の方へ 規約や認証方式の制約は、事業設計そのものに関わります。実装が進んでから気づくと手戻りが大きくなります。 技術面と規約面の両方を踏まえた構成のご提案から承っています。 ▶ 無料相談はこちら（株式会社ネクストスケール）

社内でエージェント開発を進めるための体制づくり

最後に、組織としてどう取り組むかという観点を整理します。技術の習得だけでは、成果につながらないことが多いためです。

対象業務を絞って試す

最初から複雑な業務を任せようとすると、権限設計と品質確認の両方でつまずきます。手順が決まっていて、結果の正しさを判定しやすい作業から始めるのが現実的です。

コードの静的な確認、定型レポートの作成、ログの一次切り分けといった作業が候補になります。効果が見えたら、判断の余地がある領域へ広げていきます。

人材の制約を前提に考える

独立行政法人情報処理推進機構のDX動向2025では、日本企業の85.1%でDXを推進する人材が不足していると報告されています。エージェント開発は既存の開発業務と並行して進めることが多く、後回しになりやすい領域です。

社内に知見が蓄積するまでの立ち上がりを外部で補う判断も、選択肢のひとつになります。

開発そのものを委託する場合の判断軸はAI受託開発の依頼先の選び方、エンジニア以外も含めた底上げは法人向け生成AI研修、自然言語での開発の進め方はバイブコーディングの進め方でそれぞれ扱っています。

まとめ

Claude Agent SDKは、Claude Codeを動かしている仕組みをPythonとTypeScriptから呼び出せるライブラリです。ツールの繰り返し処理やコンテキスト管理を自分で書かずに、自律的に動くエージェントを組み立てられます。

導入に必要なのは対応する実行環境とAPIキーだけで、Claude Codeを別途入れる必要は基本的にありません。設計で最も重要なのは、許可するツールと権限モードの組み合わせです。読み取りだけの構成から始め、必要が見えた範囲だけ広げてください。

自社サービスに組み込む場合は、商用利用規約が適用される点、claude.aiのログインを転用できない点、そしてClaude Codeという名称を使えない点を先に確認しておくと、後からの手戻りを避けられます。

▼ AIエージェント開発をご検討中の方へ 検証で終わらせず、業務で使える形にするところまでが本番です。設計と運用の両輪でご支援します。 現状の課題整理から実装、定着支援まで、まずは無料相談でお聞かせください。 ▶ 無料相談はこちら（株式会社ネクストスケール）