CC逆引きリファレンス

Agent SDK とは

9. エージェント

コマンド / 機能

@anthropic-ai/claude-code-sdk

カスタムエージェント構築フレームワーク

概要

Claude Agent SDK(Claude Code SDK)は、Claude Code の機能をプログラムから利用してカスタムエージェントを構築するためのフレームワークです。TypeScript/Python で自律的に動作する AI エージェントを作成できます。

設定例

// TypeScript での基本的な使用例
import { ClaudeCode } from "@anthropic-ai/claude-code-sdk";

const agent = new ClaudeCode({
  model: "claude-sonnet-4-5-20250929",
  systemPrompt: "あなたはコードレビューの専門家です。",
  tools: ["Read", "Grep", "Glob"],
});

// エージェントにタスクを実行させる
const result = await agent.run(
  "src/ 以下のコードをレビューして問題点を報告して"
);
console.log(result);

// インストール
// npm install @anthropic-ai/claude-code-sdk

こんな時に使う

  • カスタム AI エージェントを構築したい時
  • CI/CD パイプラインに AI を組み込みたい時
  • 自動化ワークフローを構築したい時
  • 特定ドメインに特化したエージェントを作りたい時

使い方

  1. 1npm install @anthropic-ai/claude-code-sdk でインストール
  2. 2ClaudeCode インスタンスを作成
  3. 3model、systemPrompt、tools を設定
  4. 4agent.run() でタスクを実行

Tips

  • Claude Code のツール(Read, Write, Edit, Bash, Grep 等)をそのまま利用可能
  • TypeScript と Python の SDK が公式提供されている
  • systemPrompt でエージェントの役割・制約を定義
  • tools でエージェントが使用できるツールを制限可能