Claude Code API連携完全ガイド｜外部サービス統合と実装方法【2026年版】

2026年3月15日

このトピックの全体像Claude Code 完全ガイド｜料金・使い方・法人導入の全体像連携・自動化の記事

公開日: 2026年3月15日最終更新: 2026年10月16日

執筆・編集：株式会社Nexa 編集部（下書きと機械検査はAI、公開前に人が確認）／約15分で読めます。公式ドキュメント・公式発表などの一次情報を確認したうえで執筆・更新しています。AIツールの仕様や料金は変わることがあるため、導入判断の前に各公式サイトの最新情報もご確認ください。記事の作り方と検査の方針

Claude Code × API連携を活用すれば、Slack・Notion・GitHubなど5種以上の外部サービスを最短1日で統合・自動化できます。

要点1: AnthropicのMessages API・Agent SDK・MCPの3種を使い分けることで開発効率が大きく向上する
要点2: Claude Sonnet 5のAPIコストは入力$2/MTok・出力$10/MTokで、Message Batches APIなら50%削減可能
要点3: Startティア（月間利用上限$500）から始まり、利用実績に応じて自動的に上位ティアへ移行するため、小規模な検証から始めやすい

対象: API連携でClaude Codeを業務自動化に活かしたいDX推進担当者・エンジニア

今日やること: Claude Consoleでアカウント作成・APIキーを取得し、最小コードで動作確認する

この記事の著者

株式会社Nexa 代表取締役川島陸

一橋大学経済学部卒業後、フォーティエンスコンサルティング株式会社（旧株式会社クニエ）にて法人向けAI導入支援等を経験。独立後、AI系メディア運営やDify/n8nの導入支援を経て、株式会社Nexaを創業。法人向けAI研修・AI導入支援・AI関連メディア運営を手掛ける。

詳しく見る AI顧問の無料相談

Claude Code × API連携を活用することで、これまでエンジニアに依頼していた外部サービスとの連携を、自分たちで短期間かつ低コストで構築できる時代になっています。

「APIという言葉は知っているが、Claude CodeとどのAPIをどう組み合わせればいいのかわからない」——そんな声を多くの企業のDX推進担当者から聞きます。

この記事では、Anthropic APIの種類・Claude Agent SDK・MCPの使い分けから、APIキー取得・料金・レート制限の管理、Slack/Notion/GitHubなどの実務ユースケースまで、1記事で体系的に解説します。本記事の料金・手順・パッケージ名は2026年10月16日時点でAnthropic公式ドキュメントを確認し、最新の内容に揃えています。

Claude CodeとAPIの関係を整理する

Claude CodeとAPIを理解するうえで、まず4つの概念を整理することが必要です。「Anthropic API」「Claude Code SDK」「Agent SDK」「MCP」は名称が似ていますが、それぞれ役割が異なります。

Anthropic Messages APIとは何か

Anthropic Messages APIは、Claudeモデルをプログラムから直接呼び出すためのRESTful APIです。エンドポイントは https://api.anthropic.com/v1/messages で、テキスト生成・ファイル処理・ツール呼び出しなどの機能を利用できます。

API	主な用途	特徴
Messages API	テキスト生成・会話	最も基本的なAPI。Python/TS SDKが公式提供
Message Batches API	大量リクエスト処理	50%コスト削減。非同期処理向け
Token Counting API	トークン数の事前確認	コスト管理・レート制限対策に有効
Models API	利用可能モデルの一覧	最新モデルIDの取得に使用

企業の業務自動化では、Messages APIを中心に据え、大量処理にはBatches APIを組み合わせるパターンが効果的です。

Claude Agent SDKとは何か（旧Claude Code SDK）

Anthropicは2025年9月29日、それまで「Claude Code SDK」と呼んでいたSDKを「Claude Agent SDK」に名称変更しました。Pythonパッケージはclaude-code-sdkからclaude-agent-sdkへ、TypeScriptパッケージは@anthropic-ai/claude-codeから@anthropic-ai/claude-agent-sdkへ変わっています。「Claude Code SDK」と「Claude Agent SDK」は別々に存在する2つのSDKではなく、同じ製品の旧称と現行名です。

Agent SDKは、Claude Codeを支えているのと同じ組み込みツール・エージェントループ・コンテキスト管理をライブラリとして提供し、内部でClaude Codeバイナリを実行します。Anthropicの公式ドキュメントが案内している選び方は次のとおりです。

目的	使うもの	特徴
自分のPython/TypeScriptアプリにClaude Codeのエージェントを組み込みたい	Agent SDK	組み込みツール・権限管理・セッション・フックなどをライブラリとして利用
ターミナルで対話的に開発・作業したい	Claude Code CLI	日々の対話利用に向けたターミナルインターフェース
自分でツール実行ロジックを書き、Claude APIを直接呼び出したい	Client SDK（Anthropic公式SDK）	Messages APIへの直接アクセス。ツールループは自分で実装
エージェントの実行自体をAnthropicにホストしてほしい	Managed Agents	Anthropic管理のクラウド上でエージェントループを実行するホスト型サービス

Agent SDKはPython / TypeScriptに対応しています。それ以外の言語からは、CLIを-pフラグと--output-format json付きでサブプロセス実行する方法が公式に案内されています。

Agent SDKの大きな特徴は、ファイル読み書き・コマンド実行・コード編集などのツールが最初から組み込まれている点です。自前でツール実行のロジックを実装する必要がなく、エージェントループを短いコードで構築できます。

MCP（Model Context Protocol）経由の連携との使い分け

MCPは、Claude CodeがSlack・Notion・GitHubなど外部サービスのデータをリアルタイムで参照するための標準プロトコルです。MCPサーバーが存在するサービスとの連携は、直接APIを呼び出すよりも設定が簡単です。

MCPが向いているケース:

Notionのデータベースを参照しながらコードを書く
GitHubのPRを読み込んでレビューコメントを生成する
Slackのチャンネル情報を参照して通知フォーマットを最適化する

直接API呼び出しが向いているケース:

MCPサーバーが存在しない独自の社内システムと連携する
MCPで対応していない細かなAPIエンドポイントを操作する
バッチ処理で大量のデータを一括処理する

迷った場合は「MCPサーバーが公開されているか確認 → ある場合はMCP優先、ない場合は直接API呼び出し」というルールで判断すると効率的です。

準備：APIキーの取得と初期設定

API連携を始めるには、まずAnthropicのAPIキーが必要です。取得手順と料金体系、安全な管理方法を確認しておきましょう。

Claude ConsoleでAPIキーを取得する手順

Claude Console にサインイン、またはアカウントを作成
「Settings」→「API keys」ページを開く
「Create key」をクリックし、名前・有効期限・紐づけるアカウント（個人用またはサービスアカウント）を設定
表示された生成キーをコピーして安全な場所に保管（この画面でのみ表示され、再表示はできない）

APIキーは sk-ant- で始まる文字列です。取得後は絶対にGitHub等のパブリックリポジトリにコミットしないよう注意してください。

料金プランと利用枠（Usage Tier）

Anthropic APIは従量課金制で、利用実績に応じて「Start」「Build」「Scale」の利用枠（Usage Tier）に自動区分されます。デポジットで手動アップグレードする仕組みではなく、利用履歴が積み上がると自動的に上位ティアへ移行します。各ティアには月間の利用上限（Spend Cap）が設定されています。

Tier	月間利用上限	特徴
Start	$500	検証・小規模利用向け。新規組織はまずここから
Build	$1,000	成長中のアプリケーション向け
Scale	$200,000	本番の大規模利用向け。標準ティアで最も高い上限
Custom	上限なし（個別契約）	アカウント担当者と個別に条件を取り決め

月間の利用上限に達すると、翌月1日 00:00 UTCにリセットされるまでAPI利用が一時停止します。上限引き上げは、Claude Consoleの「Rate limits」ページから申請します。

主要モデルのAPIコスト（2026年10月時点）:

モデル	入力コスト	出力コスト	用途
Claude Haiku 4.5	$1/MTok	$5/MTok	高速・低コスト。単純タスク向け
Claude Sonnet 5	$2/MTok	$10/MTok	バランス型。業務自動化の主力
Claude Opus 5.5	$4/MTok	$20/MTok	最高性能。複雑な分析・推論向け

業務自動化の多くのユースケースでは、Claude Sonnet 5が性能とコストのバランスで最適です。

APIキーを環境変数に設定する

APIキーをコードに直書きするのは厳禁です。環境変数を使った安全な管理方法を採用してください。

# macOS / Linux
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

# Windows (PowerShell)
$env:ANTHROPIC_API_KEY = "sk-ant-xxxxx"

本番環境では、AWSのSecrets ManagerやHashicorp Vaultなどのシークレット管理サービスを使うことを推奨します。

基本実装：Anthropic APIを直接呼び出す

APIキーの準備ができたら、実際にClaude APIを呼び出してみましょう。Python・TypeScriptそれぞれの最小実装例を示します。

Pythonでの実装例（最小コード）

import anthropic

# クライアント初期化（ANTHROPIC_API_KEYを環境変数から自動取得）
client = anthropic.Anthropic()

# Messages APIを呼び出す
message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "月次売上レポートのサマリーを作成してください。"}
    ]
)

print(message.content[0].text)

インストールは pip install anthropic のみで完了します。Pythonは3.10以上が必要です。

TypeScript/JavaScriptでの実装例

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

const message = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "月次売上レポートのサマリーを作成してください。" },
  ],
});

console.log(message.content[0].text);

インストールは npm install @anthropic-ai/sdk です。Node.js 20 LTS以上（サポート期間中のバージョン）が必要です。

エラーハンドリングとリトライ

本番環境では、レート制限エラー（429）や一時的なサーバーエラー（529）に対応したリトライ処理が必須です。

import anthropic
import time

client = anthropic.Anthropic()

def call_with_retry(prompt: str, max_retries: int = 3) -> str:
    for attempt in range(max_retries):
        try:
            message = client.messages.create(
                model="claude-sonnet-5",
                max_tokens=1024,
                messages=[{"role": "user", "content": prompt}]
            )
            return message.content[0].text
        except (anthropic.RateLimitError, anthropic.InternalServerError):
            if attempt < max_retries - 1:
                wait_time = 2 ** attempt  # 指数バックオフ（1秒→2秒→4秒）
                time.sleep(wait_time)
            else:
                raise

ポイント指数バックオフ（Exponential Backoff）を使ったリトライ実装は、レート制限エラーへの対処として最も効果的なパターンです。連続してリトライすると状況が悪化するため、待機時間を段階的に増やす設計が重要です。

Agent SDKで自律エージェントを構築する

Claude Agent SDKは、複数ステップのタスクを自律的に実行するエージェントを、少ないコードで構築するためのSDKです。ファイル読み書き・コマンド実行・コード編集などのツールが最初から組み込まれています。

Agent SDKの特徴とClaude Codeとの関係

Agent SDKの内部では、Claude Codeがランタイムとして動作しています。つまり、Agent SDKをインストールすると、Claude Code CLIが自動的にバンドルされます。これにより、開発者はツール実行のロジックを自分で実装する必要がなく、タスクの定義に集中できます。

Agent SDKが特に効果的なユースケース:

コードベース全体を分析してリファクタリング案を提示する
複数のAPIを連続して呼び出し、結果を統合したレポートを生成する
テストの失敗原因を分析し、コードを修正してテストを再実行する

PythonでAgent SDKを使う基本パターン

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions, ResultMessage

async def run_agent_task():
    options = ClaudeAgentOptions(
        max_turns=10,  # エージェントが実行する最大ターン数
    )

    async for message in query(
        prompt="src/reports/フォルダの全Pythonファイルを分析し、重複している処理を洗い出してください。",
        options=options
    ):
        if isinstance(message, ResultMessage):
            print(message.result)

asyncio.run(run_agent_task())

インストール: pip install claude-agent-sdk

TypeScript/JavaScriptでAgent SDKを使う基本パターン

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

const options: Options = {
  maxTurns: 10,
};

for await (const message of query({
  prompt: "package.jsonの依存関係を分析し、脆弱性のあるパッケージを特定してください。",
  options,
})) {
  if (message.type === "result" && message.subtype === "success") {
    console.log(message.result);
  }
}

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

2025年9月29日のパッケージ名変更（claude-agent-sdk v0.1）のタイミングで、Pythonのオプション型名はClaudeCodeOptionsからClaudeAgentOptionsに変わりました。TypeScript版ではClaudeCodeOptionsという型自体が廃止され、現在はOptionsという型名に統一されています。古いサンプルコードのままだと型エラーになるため、インポート名は公式ドキュメントで必ず確認してください。

Apple XcodeのAgent SDK対応（2026年の最新動向）

2026年、AppleはXcodeにClaude Agent SDKのネイティブサポートを追加しました。iOS/macOSアプリの開発者が、Xcodeの IDE内から直接Claudeのエージェント機能を呼び出せるようになっています。日本の企業向けアプリ開発においても、Claude Agent SDKを活用した開発ワークフローの効率化が今後加速すると見られています。

関連記事: Claude Code Agent・サブエージェント完全ガイド

よくある質問

Claude CodeのAPIとAnthropicのAPIは同じですか？

Claude CodeはAnthropicのAIモデル（Claude）を使って動作するツールですが、「Claude Code API」という独立したAPIは存在しません。一般にClaude Code APIと呼ばれる場合、Anthropic Messages API（モデルを直接呼び出す）またはClaude Agent SDK（旧称Claude Code SDK。Claude Codeのエージェント機能をプログラムから利用する）のいずれかを指しています。

MCP連携と直接API呼び出しはどちらを選ぶべきですか？

対象のサービスがMCPサーバーを公式提供している場合はMCPが簡単です。設定ファイルにMCPサーバーを追加するだけで、Claude Codeから自然言語で操作できます。MCPサーバーが存在しない独自システムや、細かいAPIエンドポイントの操作が必要な場合は、直接API呼び出しを使います。

企業で複数人がAPIを利用する場合の管理方法は？

Claude Consoleでワークスペース単位にAPIキーを分けて発行することを推奨します。個人のAPIキーを共有するのはセキュリティリスクがあります。また、Anthropic EnterpriseプランではSSO・監査ログ・利用制限の管理機能が提供されており、組織での本番運用に適しています。

APIのレート制限に引っかかったときの対処法は？

まず指数バックオフ付きのリトライ処理を実装することが基本です。それでも頻繁に発生する場合は、以下を検討してください：（1）Message Batches APIへの切り替え、（2）Prompt Cachingの活用でITPMを削減、（3）利用実績を積んでBuild・Scaleティアへの自動移行を待つ、（4）AnthropicのEnterpriseプランでカスタムレート制限を交渉する。

claude-code-sdkパッケージはまだ使えますか？

claude-code-sdk（Python）・@anthropic-ai/claude-code（TypeScript）は、2025年9月29日にそれぞれclaude-agent-sdk・@anthropic-ai/claude-agent-sdkへ名称変更されています。Pythonのオプション型名もClaudeCodeOptionsからClaudeAgentOptionsに、TypeScriptの型名はClaudeCodeOptionsからOptionsに変わっているため、新規の実装では必ず新しいパッケージ名・型名を使ってください（Anthropic公式の移行ガイド）。