Claude Agent SDK とは何か、旧 Claude Code SDK からの改称

Claude Agent SDK は、旧称 Claude Code SDK の現行名です。公式ドキュメントは次のように位置付けています。Claude Code と同じツール群を、Python と TypeScript から呼び出せるライブラリ。エージェントループとコンテキスト管理も同じ土台を使えます。

Claude Code は CLI として日々の対話に使う製品です。Agent SDK は自社プロダクトや業務プロセスに埋め込むためのライブラリです。同じ内部の仕組みを土台にできます。対話端末として使うか、コードから呼び出すかを選べます。

制作の現場で意味を持つのは後者の使い方です。案件ごとに人が Claude Code を立ち上げて回すやり方から離れられます。自社の管理画面や Slack、フォームの背後に Agent SDK 製のエージェントを常駐させます。案件が入るたびに自動で走ります。

クリエイティブブリーフの工程がエージェント SDK に向く理由

クリエイティブブリーフの工程は、生成AIツール単体では自動化しづらい部分が残ります。ブリーフを読む。案件の資料を集める。ブランドの規約に照らす。複数の生成ツールを順に呼ぶ。生成物を並べて命名する。この段取りは単発の指示で終わる仕事ではありません。判断と実行が交互に入る作業です。

Anthropic の公式ドキュメントは、エージェントの中核に四段階のループを挙げています。コンテキストを集める。行動する。成果を検証する。反復する。ブリーフを起点にした制作の工程は、この四段階にそのまま当てはまります。案件フォルダから情報を集める。制作指示に書き換える。出力をブランド基準に照合する。外れた箇所を直す。人が案件ごとに繰り返している段取りを、そのままエージェントの仕事に書き出せます。

CLI の Claude Code でも同じことはできます。ただし業務プロセスに組み込むなら、コードから呼べる形の方が扱いやすい。Agent SDK はこの橋渡しの役割を担います。

Claude Agent SDK 使い方の基本：インストールと最初のエージェント

Agent SDK は Python と TypeScript の二言語で提供されています。TypeScript の場合は npm から入ります。

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

Python の場合は pip から入ります。認証は ANTHROPIC_API_KEY の環境変数を通します。Claude.ai のログイン認証は第三者製品には解放されていません。API キー認証で組みます。

最も小さいエージェントは TypeScript ならこの形です。

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "案件フォルダのブリーフを読み、要点を三行で返して",
  options: { maxTurns: 3 }
})) {
  console.log(message);
}

query 関数に指示と選択肢を渡します。Agent SDK は Claude Code と同じエージェントループを回します。必要ならファイルを読みます。コマンドを実行します。途中経過をメッセージとして返します。ここに Skills や MCP、Hooks、サブエージェントの設定を足していきます。エージェントを厚くしていく手順は次の節から順に見ていきます。

ブリーフを受け取る：フォームと Slack を束ねる

エージェントに最初に担わせる仕事はブリーフの受け取りです。実務では入口が複数に散っています。Google フォーム。Slack。メール。Google Drive の資料。Agent SDK は Model Context Protocol（MCP）のクライアントとして動きます。公式に用意されている MCP サーバーを登録するだけで、これらの入口を一つのエージェントから触れます。

query の選択肢の mcpServers に MCP サーバー設定を渡します。Slack のチャンネルや Drive のフォルダ、社内の課題管理ツールをエージェントが呼び出せます。ブリーフが Slack で降ってきても Drive のフォームに書き込まれても、同じエージェントが同じ流れで拾えます。

ここまでで案件の入口が一箇所に集まります。担当者は「案件が入りました、拾ってください」と一声かけるだけで済みます。エージェントが該当のチャンネルとフォルダを探しに行きます。ブリーフの本文と添付を集めてきます。

制作指示に書き換える：ブランド Skill と Skills の役割

ブリーフを拾った次は制作指示に書き換える段取りです。ここで効くのが Skills の仕組みです。Skills はプロジェクトの .claude/skills/ フォルダに置いたフォルダ群です。SKILL.md に手順を書きます。必要なスクリプトや素材を並べておきます。Agent SDK は Claude Code と同じ規則で自動的に読み込みます。公式ドキュメントは次のように記しています。Skills、コマンド、メモリはプロジェクトの .claude/ とユーザーの ~/.claude/ から自動で読み込まれる。

制作の現場で用意すべき Skill は大きく三つです。一つ目はブランド規約の Skill。色や書体、トーン、NG表現を並べます。二つ目は案件の型ごとの制作指示テンプレートを束ねた Skill。記事や SNS、動画、印刷物の型を並べます。三つ目は命名規則と納品フォーマットを書いた Skill です。

この三つを置いておくと、エージェントは自走できるようになります。ブリーフを読みます。案件の型を選びます。ブランド規約に沿った制作指示を書き出します。ファイルを規定の場所に置くところまで自分でたどれます。

Skills はチームで共有する資産として設計されています。Git で管理して案件を横断して使い回します。担当者が変わっても同じ結果が出る状態を維持できます。

生成モデルを MCP 経由で呼ぶ：画像・動画・コピー

制作指示ができたら生成モデルを呼ぶ段に入ります。Agent SDK は MCP を通じて外部モデルを呼び出せます。画像生成や動画生成、音声合成のツールをエージェントの手駒として並べられます。制作物の型ごとにどのモデルを呼ぶかを Skill 側に書いておきます。エージェントは案件に応じてモデルを選びます。指示を渡します。出力を受け取ります。

SNSの投稿画像の案件を例にします。画像生成モデルを MCP で登録しておきます。Skill には「Instagram の正方形と縦長、訴求は三パターン、各二案」と書いておきます。ブリーフを受けたエージェントはこの Skill を参照します。画像生成モデルを十二回呼び、命名規則に沿って書き出します。動画の案件なら、映像生成モデルと Remotion のような編集の枠組みを組み合わせます。テンプレートに中身を差し込む形で本数を積み上げます。

一つのエージェントに複数のモデルを持たせるのが要点です。案件ごとにツールを立ち上げ直す運用では、量が増えたときに持たなくなります。Agent SDK は生成モデルの選定と呼び出しを、エージェントの内部の判断として扱えます。

検証と承認：Hooks と Permissions で人の判断を残す

生成が終わった直後に効くのが Hooks と Permissions の仕組みです。Hooks はエージェントの前後に任意のシェルコマンドを差し込む仕組みです。ファイル書き出しの直後にブランド色と書体の照合を走らせられます。指定の枚数と比率を満たしているかも検算できます。人の目が入る前に自動で回せます。

Permissions は、呼び出せるツールを自動と承認待ちに分ける仕組みです。公式ドキュメントの説明はこう書かれています。どのツールを自動で走らせ、どのツールに承認を求めるかを制御する。制作の現場で意味を持つのは二点あります。外部モデルの課金呼び出しと、クライアントに直接送るチャンネルへの投稿を、承認待ちに寄せられる点です。

この二つを組み合わせます。生成の速度は保ちつつ、人の判断が必要な工程だけを人に残せます。ブランドチームの確認は「エージェントが拾えなかった外れ」に絞れます。

検証が通った後の納品準備も、同じ枠組みで続きます。命名規則の Skill を参照してファイル名を整えます。納品フォーマットの Skill を参照して解像度と圧縮を揃えます。Hooks で書き出しの直後に指定のフォルダへ移します。クライアントへの通知は Slack やメールの MCP を通じて直接投げる形が組めます。ただし Permissions で承認待ちに設定しておきます。担当者が最後に一度目を通してから送る運用が安全です。生成の速さを、確認の粗さと引き換えにしない設計が要になります。

サブエージェントで案件を並列化する

案件が複数同時に走るときはサブエージェントの仕組みが効きます。公式ドキュメントはこう説明しています。特化した子エージェントを立てて絞った作業を任せる。Agent SDK では、リード役のエージェントが案件全体を管理する構成が組めます。素材ごとに子エージェントを立てます。並行で処理させます。結果をリードが統合します。

十本のショート動画を一つの案件で作る場面を考えます。十本を順に処理しません。十本ぶんの子エージェントを並行で走らせます。書き出しが終わったものから素材フォルダに並ぶ設計にできます。処理の待ち時間が案件全体の所要時間として積み重ならない点が利点です。ただしモデル呼び出しには課金と枠の制約があります。並行度は Permissions と併せて調整します。

現場で組むときの判断基準

Agent SDK を制作の現場に入れる判断は、次の三つが揃うところで下すのが順当です。一つ目は制作物の型がある程度決まっていて量産の要件があること。二つ目はブランド規約と制作の癖が Skill として書き出せる状態にあること。三つ目は案件の入口が MCP から触れる場所に整理されていること。Slack や Google フォーム、Drive の資料が該当します。

逆に、案件ごとに完全な一点物を作る現場では合いません。ブランドの基準がまだ言語化されていない現場も同じです。Agent SDK を入れる前に、その土台を整える工程が先に来ます。エージェントは、揃っている型を高速に展開するときに効きます。揃っていない型を代わりに揃えてくれるわけではありません。

Claude Code の CLI から入る順番が扱いやすいです。対話で工程を確かめ、固まった部分から Agent SDK に移します。

関連する制作の型は Claude Code をクリエイティブに使う実装ガイド が土台です。画像量産は Claude Code で画像バッチを回す運用 にまとめました。動画量産は Claude Code で動画バッチを回す運用 にあります。外部ツール連携は Claude と Recraft を MCP で接続する と Claude と Canva を MCP でつなぐ運用 を参照してください。

Managed Agents との使い分け

Anthropic は Agent SDK と別に Managed Agents も提供しています。ホスト型のサービスです。実行環境とサンドボックスは Anthropic 側で管理されます。呼び出しは REST API を通します。長時間走る非同期の処理や、自社でインフラを持たない場面での選択肢になります。

制作の現場から見ると違いははっきりしています。Agent SDK は自社のマシンやサーバーの中でエージェントを走らせます。案件フォルダや社内のファイルに直接触れられる利点があります。Managed Agents はサンドボックスの中で走ります。社内のファイルへのアクセスは MCP や API 経由に限られます。案件の素材を手元で扱う現場は Agent SDK が向きます。遠隔で走らせたいバッチ処理は Managed Agents が向きます。この使い分けが順当です。

FAQ

Q1. claude agent sdk 使い方として最初に着手すべき工程はどこですか

A. ブリーフの受け取りと制作指示への書き換えの二工程です。ここが自動化されると案件の立ち上がりが速くなります。生成ツールの呼び出しに集中できます。生成モデルの呼び出しから入ると前後の段取りが残ります。体感の効果が薄くなります。

Q2. Claude Code の CLI と Agent SDK は、どちらから入るのが良いですか

A. Claude Code の CLI から入るのが順当です。対話で工程を確かめ、固まった手順を Skill として書き出します。業務プロセスに組み込む段階で Agent SDK に移す順番になります。この順番が失敗のやり直しが少なく済みます。

Q3. TypeScript と Python のどちらを選ぶのが良いですか

A. 社内の他のエージェントや業務システムが動いている言語に合わせるのが順当です。両方の SDK は同じ機能を提供しています。選択の基準は、既存のコードと運用の親和性に置きます。

Q4. 生成モデルを直接 API で呼ぶ構成と、MCP 経由で呼ぶ構成の違いは何ですか

A. MCP 経由はモデルの追加と入れ替えが Skill と設定ファイルの変更で済みます。直接 API で呼ぶ構成は、コードの中にモデルの呼び出しが埋まります。モデルを変える度にコードの書き換えが要ります。案件で扱うモデルが増えていく現場では、MCP 経由が扱いやすくなります。

Q5. Agent SDK で組んだエージェントの動作を、あとから追跡できますか

A. Agent SDK にはセッションの仕組みがあります。エージェントの対話履歴を保存できます。後から再開したり、別のセッションとして枝分かれさせたりできます。運用の記録として、案件ごとにセッションを分ける形が扱いやすいです。

情報源