レッスン7：Agent SDKで自社専用AIシステムを作る — PoCから本番運用・コスト設計・信頼性パターンまで

Claude Code & Cowork 業務実装マスター【企業のAI内製・自動化】

0 / 11 完了（0%）

「ChatGPTやClaudeを社内で使ってはいるが、結局は人がコピペして橋渡ししている」——多くの企業が、この“半自動”の壁にぶつかっています。問い合わせの一次対応、見積書の生成、社内ドキュメントの横断検索。どれも「AIが自律的に最後までやってくれたら」と思うのに、対話画面の中だけでは業務システムにつながらず、人の手が残る。

この壁を越える道具が Claude Agent SDK です。これは、Claude Code を支えているのと同じエージェント基盤（自律的にツールを呼び、複数ステップのタスクを最後まで遂行するループ）を、あなたの会社のシステムに組み込めるかたちで提供する開発キットです。本レッスンでは、Agent SDK で何が作れるか、PoCから本番への現実的な道筋、コスト設計、信頼性パターン、そして「内製すべきか・ベンダーに頼むか」の判断軸までを、2026年6月時点の事実に忠実に解説します。

結論を先に。Agent SDK は「Claudeを自社の業務フローに埋め込み、自律実行させる」ための土台です。成功の鍵は推論モデルの賢さではなく、(1)正確なデータ接続(観測)、(2)信頼できるツール接続(行動)、(3)評価セットによる品質担保の3点。そして必ずコスト上限・停止条件・人間承認を設計に組み込むこと。SDK自体はリトライや予算上限を“自動では”提供しないため、ここを設計しないと暴走コストを招きます。

Agent SDKで実際に何が作れるのか

Agent SDK の本質は「Claudeにツールを渡し、ゴールを与えると、自分で手順を考えて実行する」ループを自社アプリに組み込めることです。Claude Code が SWE-bench で首位級の実力を見せているのと同じエンジンを、CLIの外で使うイメージです。具体的には次のようなシステムが現実的なターゲットになります。

社内ナレッジ横断アシスタント：自社DBやドキュメントをツールとして接続し、問い合わせに根拠付きで回答。MCP経由で社内データへ read アクセスさせる。
業務処理の自動化エージェント：受信メールの分類→該当データの照合→ドラフト生成→人間承認待ち、までを一気通貫で。
レポート・分析の自動生成：複数システムからデータを集約し、定型レポートを定時生成。
開発・運用の社内エージェント：コード生成、設定変更、監視アラートの一次トリアージ。

チャットUI上で完結する“相談相手”が欲しいだけなら、非エンジニア向けの Claude Cowork や Workspaceコネクタで十分なことも多い。Agent SDK は「自社プロダクトや独自業務フローに、エージェントを部品として組み込みたい」場合の選択肢だと整理しておきましょう。

PoCから本番への現実的な道筋

いきなりSDKでフルスクラッチ実装に走るのは失敗のもとです。リスクとコストのバランスが良いのは、段階を踏む進め方です。

ノーコード/対話でPoC：まず Cowork や対話で「そもそもClaudeはこの業務を解けるのか」を検証。プロンプトと必要なデータだけで成立性を確認する。
評価セットを先に作る：本番品質を担保する最大の近道は、評価専用テストセット(入力と期待される振る舞いの組)を用意すること。「何をもって合格か」を数値で固定してから実装に入る。
SDKで本番実装：複雑な業務フローや独自統合が必要になった段階でSDKへ移行。一般に1〜3ヶ月の開発期間を見込む。社内に最低1名のエンジニアがいることが前提。
段階リリース：人間承認を必須にした“半自律”で本番投入し、評価セットの合格率を見ながら自律度を上げる。

実装で最大の罠は、賢い「推論層」だけを磨いてしまうこと。実際の安定性を決めるのは、入力データの正確性(観測)と、ツール接続の信頼性(行動)です。「Claudeが賢いか」より「Claudeに正しいデータと正しい道具を渡せているか」を疑ってください。

コスト設計 — 2026年6月15日の課金変更を踏まえて

2026年6月15日より、Anthropicはサブスクの自動化利用を刷新しました。Agent SDK や claude -p などのプログラム自動化利用は、従来プランの対話制限とは分離され、別枠の「月次クレジット」で計上されます(対話の使用制限はインタラクティブ利用のために予約される)。本番の自動化はAPIキー利用への移行が公式に推奨されています。コスト設計では次を押さえます。

論点	設計の勘所
課金の枠	自動化(SDK/claude -p)はサブスクのクレジット枠 or APIキー従量。本番はAPIキーが基本。
プロンプトキャッシュ	長い共通プレフィックス(システム指示・ツール定義・参照資料)をキャッシュし入力コストを圧縮。キャッシュはワークスペース単位で分離され、組織内のデータ分離が保たれる。
キャッシュの作法	キャッシュ・ブレークポイントは「チェックポイント」として置き、後続リクエストが直近のキャッシュを参照できるよう、変動する部分は末尾に寄せる。プレフィックスがずれるとキャッシュは効かない。
モデル選択	難所はOpus 4.8やFable 5、定型処理はHaiku 4.5へ振り分け。1モデル固定にしない。
上限設定	後述の予算・ターン上限を必ず明示。SDKは既定で上限なし。

プロンプトキャッシュの設計次第で入力コストは大きく変わります。仕組みは MCP完全ガイドや Claude APIとClaude Codeのコースも併読すると理解が深まります。

信頼性パターン — リトライとサーキットブレーカ

ここが本番運用の生命線です。重要な事実として、Agent SDKは組み込みのリトライ機能も、既定のターン/予算上限も持ちません。max_turns は既定で無制限、予算上限はオプション。つまり何も設計しなければ、エージェントは延々とループし続けられます。実際に、リトライ上限の欠落が原因で大量のセッションが連続失敗を繰り返し、莫大なAPIコールを浪費した事例も報告されています。

必ず入れるべき4つの制御点

予算サーキットブレーカ：見積コストの2倍を超えたらリクエストを即停止する、といったトークン/コスト上限を設ける。
進捗ベースの停止：同じ引数で同じツールを2回連続呼んだら「進んでいない」と判断して止める(無限ループ検知)。
明示的な完了シグナル：もっとも綺麗な終了は、エージェント自身が end_task 等の構造化された完了マーカーを出すこと。「終わった」を曖昧にしない。
ターン上限：max_turns を必ず設定。1リクエストあたりの最大往復回数を固定する。

リトライで“やってはいけない”こと

サーキットブレーカが落ちたとき、黙って自動リトライしてはいけません。ループするエージェントへの自動リトライはコストを掛け算で膨らませます。代わりに、ユーザー起点の再開(resume)を求めるか、Human-in-the-loopのレビューキューに回す設計にします。「失敗したら人に上げる」を既定にすることが、暴走を防ぐ最大の防御です。

内製か、ベンダー活用か、それともマネージドか

もう一つの大きな分岐は実装形態です。2026年4月にAnthropicが提供を始めた Claude Managed Agents を使えば、サンドボックスや状態管理を自前で構築せずに本番投入できます。自前のSDK実装(セルフホスト)と並べて判断します。

選択肢	向くケース	留意点
SDK自前実装(内製)	独自業務フロー/既存システムへの深い統合が必要。社内にエンジニアがいる。	サンドボックス・状態管理・信頼性パターンを自分で作り込む必要。1〜3ヶ月。
Managed Agents	本番インフラを自前で持たず素早く立ち上げたい。	マネージド型のコスト構造を理解して採用。
ベンダー伴走	評価設計・権限設計・統制まで含めて確実に立ち上げたい。	要件定義と評価指標を丸投げしない。社内に運用知見を残す。

判断の軸はシンプルです。差別化の中核(独自の業務ロジックやデータ)は内製で握り、土台(サンドボックス・統制・足回り)はマネージドやベンダーに寄せる。すべてを内製するのも、すべて丸投げするのも非効率です。導入前に「権限設計・ログ・人間承認・停止手順・PoC評価指標」の5点を必ず整理しておきましょう。

企業統制で見落としがちな点

エージェントが社内データやAPIに実アクセスする以上、統制は必須です。MCP 2.4仕様(2026)では、高リスクなツール呼び出しのMFA、MCP Admin Console経由のリアルタイム監査ログ、同意ワークフロー、企業レベルの集中管理デプロイが用意されています。エージェントに与える権限は最小に絞り、書き込み(write)系は人間承認を挟むのが基本です。統制全体の考え方はエンタープライズ導入の記事も参照してください。

よくある質問

Agent SDKとClaude Code、Coworkはどう違いますか？

Claude Code は開発者向けCLIで、すぐ使えるエージェント。Cowork は非エンジニア向けGUIで成果物作成に強い(中身はClaude Codeと同じエンジン)。Agent SDK は、その同じエージェント基盤を自社システムに部品として組み込むための開発キット、という位置づけです。詳しくは Claude Codeでできることをどうぞ。

本番運用はサブスクのままで大丈夫ですか？

2026年6月15日以降、自動化利用は別枠の月次クレジットに分離されました。本番の自動化はAPIキー利用への移行が公式推奨です。負荷が読めない本番はAPIキー従量を基本に考えてください。

SDKがリトライを持たないなら、どう信頼性を担保しますか？

予算サーキットブレーカ、進捗ベース停止、明示的な完了シグナル、ターン上限の4点を自分で実装します。そして失敗時は自動リトライせず、人間レビューに回すのが鉄則です。

最初の一歩は何をすべきですか？

いきなりSDKではなく、対話やCoworkでPoCし、評価セットを作ること。「Claudeがこの業務を解けるか」と「合格の定義」を先に固めてから実装に進みます。

まとめ

Agent SDK は、Claudeの賢さを「自社業務を最後までやり切る自律システム」に変える土台です。ただし主役はモデルの推論力ではなく、正確なデータ接続・信頼できるツール接続・評価セットの3点。そして本番では、コスト上限と停止条件、人間承認を設計に組み込むことが絶対条件です。SDKが上限やリトライを自動提供しないからこそ、ここを設計できるかが本番運用の分かれ目になります。

次のステップ

本レッスンは「Claudeで業務自動化を作る」コースの一部です。続けて学ぶなら以下へ。

体系的に学ぶ：Claude業務自動化コース2026 / 全コース一覧
関連レッスン：Claude APIとClaude Code / Claude Fable 5 マスター / Claude Code 新機能2026
自社の適性を測る：導入診断 / 学習ロードマップ
実務で使う：プロンプト集 / みんなのプロンプト / 用語集

「自社のどの業務をAgent SDKで自動化できるか」を具体的に設計したい場合は、メール購読特典の「プロンプト50選PDF」で土台を作りつつ、株式会社LUCRISのClaude導入支援(PoC設計・評価セット作成・統制設計の伴走)もご検討ください。

このコース「Claude Code & Cowork 業務実装マスター【企業のAI内製・自動化】」の全レッスン