Claude Agent SDK

2026-03-30

整理日: 2026-03-16

#プログラミング #AI #ClaudeCode #リファレンス

概要

Claude Agent SDK（旧Claude Code SDK）は、Claude Codeを動かしているのと同じエージェント機能をプログラムから使えるSDK。

Anthropicが公式に提供しており、Python / TypeScript で利用可能。

構造図

flowchart TD
    A["Claude Codeを動かしているのと同じエージェント機能"]
    A --> B["Anthropicが公式に提供しており、Python /.."]
    style B fill:#c05746,color:#fff,stroke:none

アーキテクチャ

┌─────────────────────────────────────────────────────┐
│                    Anthropic API                     │
└─────────────────────────────────────────────────────┘
                          ▲
                          │
        ┌─────────────────┴─────────────────┐
        │         Claude Agent SDK          │
        │  - エージェントループ              │
        │  - ツール（Read, Write, Bash等）   │
        │  - コンテキスト管理                │
        │  - サブエージェント                │
        └─────────────────┬─────────────────┘
                          │
        ┌─────────────────┼─────────────────┐
        ▼                 ▼                 ▼
   Claude Code       Claudian         自作アプリ
   (CLI)           (Obsidian)        (SDK利用)

同じエンジン、違うインターフェースという関係。

含まれるツール（Claude Codeと同じ）

| ツール | 機能 | |--------|------| | Read | ファイル読み込み | | Write | ファイル作成 | | Edit | 精密な編集 | | Bash | ターミナルコマンド実行 | | Glob | パターンでファイル検索 | | Grep | ファイル内容検索 | | WebSearch | Web検索 | | WebFetch | Webページ取得 | | MCP | 外部ツール接続（拡張可能） |

使い方

インストール

# Python
pip install claude-agent-sdk

# Node.js
npm install @anthropic-ai/claude-agent-sdk

認証

Claude Code CLIで認証済みなら、そのまま共有される。

Python サンプル

from claude_agent_sdk import query

async for message in query(
    prompt="このフォルダのPythonファイルを整理して",
    options={
        "allowedTools": ["Read", "Write", "Edit", "Bash", "Glob"],
        "workingDirectory": "/path/to/project"
    }
):
    print(message)

TypeScript サンプル

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

for await (const message of query({
  prompt: "READMEを日本語に翻訳して",
  options: { allowedTools: ["Read", "Write", "Edit"] }
})) {
  console.log(message);
}

特徴

エージェントループ: gather context → take action → verify work → repeat
自動コンテキスト管理: コンテキストが溢れないよう自動圧縮
サブエージェント: 並列処理やコンテキスト分離が可能
カスタムツール: 自分で定義したツールを追加可能
フック: 処理の前後に独自ロジックを挟める

活用例

| アプリ | 用途 | |--------|------| | [[Claudian]] | ObsidianにClaude Codeを埋め込む | | 日報自動生成 | Gitログから日報作成 | | ノート整理Bot | フォルダ走査、重複削除、タグ付け | | コードレビューBot | PR差分を読んでレビュー | | ローカルRAG | 自分のドキュメントを検索・要約 |

公式リンク

更新履歴

2026-01-13: 初回作成（Claudianの仕組み調査から）

概要

構造図