Source: https://aiprimetech.io/ja/claude-code/sdk/

[ホーム](/ja/) › [Claude Code](/ja/claude-code/) › Agent SDK

[概要](/ja/claude-code/)[インストール](/ja/claude-code/install/)[CLIリファレンス](/ja/claude-code/cli/)[料金と制限](/ja/claude-code/pricing/)[Agent SDK](/ja/claude-code/sdk/)[スキルとプラグイン](/ja/claude-code/skills/)[GitHub](/ja/claude-code/github/)[ウェブ、デスクトップ、IDE](/ja/claude-code/web-and-desktop/)[モデル](/ja/claude-code/models/)[エラー](/ja/claude-code/errors/)[オープンソース？](/ja/claude-code/open-source/)[チュートリアル](/ja/claude-code/tutorial/)[学生向け](/ja/claude-code/for-students/)[QA自動化](/ja/claude-code/qa-automation/)[Cursorとの比較](/ja/claude-code/vs-cursor/)[Codex・OpenCodeとの比較](/ja/claude-code/vs-codex/)[サブエージェント](/ja/claude-code/subagents/)[フック](/ja/claude-code/hooks/)[MCP](/ja/claude-code/mcp/)[エコシステム](/ja/claude-code/ecosystem/)[VS Code](/ja/claude-code/vscode/)[OpenRouter](/ja/claude-code/openrouter/)[レート制限](/ja/claude-code/rate-limits/)[中国語ガイド](/claude-code/zh/)

最終更新：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でアカウントを作成](/register?promo=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キーを取得](/register?promo=CLAUDECODE) [無制限プランを見る](/ja/plans/)

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

## その他のClaude Codeガイド

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