ホーム › Claude Code › Agent SDK
概要インストールCLIリファレンス料金と制限Agent SDKスキルとプラグインGitHubウェブ、デスクトップ、IDEモデルエラーオープンソース?チュートリアル学生向けQA自動化Cursorとの比較Codex・OpenCodeとの比較サブエージェントフックMCPエコシステムVS CodeOpenRouterレート制限中国語ガイド
最終更新:2026年10月11日

Claude Code SDKからClaude Agent SDKへ

ターミナルで動くものと同じエージェントループを、ライブラリとして利用できます。コーディングツールにとどまらない幅広い用途で使われていることが明らかになったため、AnthropicはClaude Code SDKをClaude Agent SDKに改称しました。

TLDR

  • Python: pip install claude-agent-sdk;TypeScript: npm install @anthropic-ai/claude-agent-sdk.
  • ファイル操作ツール、bash、サブエージェント、MCPを備えた完全なエージェントを、権限確認のコールバック付きでコードから制御できます。
  • SDKはCLIと同様にANTHROPIC_BASE_URLとANTHROPIC_API_KEYを読み取るため、ゲートウェイ経由の課金が適用されます。

Claude Codeを自動化する二つの方法

手軽な方法は、CLIのprintモードです — claude -p どの言語からでも、JSON形式で出力できます。すべての機能を利用するにはAgent SDKを使います。ループ、ツールセット、フック、権限を、自分で制御できるオブジェクトとして公開しています。

Python

import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Edit", "Bash"],
        max_turns=8,
    )
    async for message in query(
        prompt="add type hints to utils.py and run the tests",
        options=options,
    ):
        print(message)

anyio.run(main)

TypeScript

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

for await (const message of query({
  prompt: "find and fix the flaky test in this repo",
  options: { allowedTools: ["Read", "Edit", "Bash"], maxTurns: 8 },
})) {
  console.log(message);
}

ゲートウェイに接続して実行する

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
python agent.py

SDKは同じClaude Codeランタイムを起動するため、必要なのは環境変数だけです。ゲートウェイの料金体系が最も重要になるのは、長時間実行するエージェントです。自律的なループは時間あたり数百回の呼び出しを行うことがあり、定額プランなら、その費用を見積もりから固定額に変えられます。

printモードに対してSDKが追加する機能

  • 権限コールバック — 自分のコードから各ツール呼び出しを承認または拒否できます。
  • プロセス内MCPサーバーによるカスタムツールで、エージェントが独自の関数を呼び出せます。
  • ツールイベント、セッションのライフサイクル、エラーに対するフック。
  • シェル経由の実行やテキスト解析をせずに、サブエージェントと構造化出力を利用できます。

まずは無料で試す

新規アカウントには $5分の無料APIクレジット を、コード CLAUDECODE で提供します。SonnetでClaude Codeを一晩試すのに十分な額です。その後は額面の7.69231倍のクレジットを利用できます。

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

コードCLAUDECODEでアカウントを作成

よくある質問

Claude Code SDKはAnthropic SDKと同じですか?

いいえ。Anthropic SDKはMessages APIを直接呼び出します。Claude Agent SDK(旧Claude Code SDK)は、その上でツール、ファイル、bash、サブエージェントを含むエージェント全体を実行します。

Agent SDKはどの言語に対応していますか?

公式に対応しているのはPythonとTypeScriptです。それ以外の言語でも、JSON出力を使ってCLIのprintモードを操作できます。

SDKはカスタムベースURLで動作しますか?

はい。CLIと同様に、環境からANTHROPIC_BASE_URLとANTHROPIC_API_KEYを継承します。

ゲートウェイでClaude Codeを実行

同じモデルを環境変数の設定だけで利用できます。額面の7.69231倍のクレジット、または定額無制限プランを選べます。 新規アカウント:コードCLAUDECODEで$5分の無料APIクレジット。

APIキーを取得 無制限プランを見る

AI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。

その他のClaude Codeガイド

Claude Code:完全ガイドClaude Codeのインストール方法Claude Code CLIドキュメント:コマンドとフラグClaude Codeの料金と制限を解説Claude CodeのスキルとプラグインGitHubでのClaude Code:App、Action、@claudeClaude Codeにウェブインターフェースはある?ウェブ、デスクトップ、IDEを解説Claude Codeが使用するモデルと変更方法Claude Codeのエラーと修正方法Claude Codeはオープンソースですか?Claude Codeチュートリアル:初めての実践セッション学生向けClaude:Claude Code、API、教育向け提供で実際に得られるものQA自動化にClaude Codeを使う方法Claude CodeとCursorの比較:どちらをいつ使うか、そして両方を併用する方法Claude Code vs Codex vs OpenCode:ターミナルエージェントの比較Claude Codeのサブエージェント:仕組み、定義方法、エージェントチームClaude Codeのフック:エージェントの動作を決定論的に制御するClaude CodeのMCP:サーバー接続、スコープ、リモートMCPと実例Claude Codeのエコシステム:ルーター、フレームワーク、プラグインと、それらをまとめたリストVS Codeで使うClaude Code:拡張機能、ターミナル経由の利用、エラーClaude CodeでOpenRouterを使う方法(使わないほうがよい場合も)Claudeのレート制限エラー:「API error: rate limit reached」の意味と解決方法Claude Codeの使い方:インストールから日常的な利用まで