---
title: API概要
url: https://platform.claude.com/docs/ja/api/overview
description: Claude APIで利用可能なエンドポイント、認証ヘッダー、クライアントSDK、ページネーション、レート制限、およびクラウドプラットフォームへのアクセスオプションを理解します。
---
Claude APIは`https://api.anthropic.com`にあるRESTful APIで、ClaudeモデルおよびClaude Managed Agentsへのプログラムによるアクセスを提供します。
**Claudeを初めて使いますか？** 直接的なモデルアクセスについては、[はじめに](https://platform.claude.com/docs/ja/get-started)と[Messagesの操作](https://platform.claude.com/docs/ja/build-with-claude/working-with-messages)から始めてください。マネージドエージェントインフラストラクチャについては、[Claude Managed Agentsクイックスタート](https://platform.claude.com/docs/ja/managed-agents/quickstart)を参照してください。
## 前提条件
Claude APIを使用するには、以下が必要です。
* [Claude Consoleアカウント](https://platform.claude.com)
* Consoleから取得した[APIキー](https://platform.claude.com/settings/keys)、または設定済みの[Workload Identity Federation](https://platform.claude.com/docs/ja/manage-claude/workload-identity-federation)ルール
ステップバイステップのセットアップ手順については、[はじめに](https://platform.claude.com/docs/ja/get-started)を参照してください。
## 利用可能なAPI
Claude APIには以下のAPIが含まれます。
* **[Messages API](https://platform.claude.com/docs/ja/api/messages/create)**: 会話型インタラクションのためにClaudeにメッセージを送信します（`POST /v1/messages`）
* **[Message Batches API](https://platform.claude.com/docs/ja/api/messages/batches/create)**: 大量のMessagesリクエストを非同期で処理し、コストを50%削減します（`POST /v1/messages/batches`）
* **[Token Counting API](https://platform.claude.com/docs/ja/api/messages/count_tokens)**: 送信前にメッセージ内のトークンをカウントして、コストとレート制限を管理します（`POST /v1/messages/count_tokens`）
* **[Models API](https://platform.claude.com/docs/ja/api/models/list)**: 利用可能なClaudeモデルとその詳細を一覧表示します（`GET /v1/models`）
* **[Files API](https://platform.claude.com/docs/ja/api/files/upload)**: 複数のAPI呼び出しで使用するファイルをアップロードおよび管理します（`POST /v1/files`、`GET /v1/files`）
* **[Skills API](https://platform.claude.com/docs/ja/api/skills/create)**: カスタムエージェントスキルを作成および管理します（`POST /v1/skills`、`GET /v1/skills`）
以下のAPIはベータ版です。
* **[Agents API](https://platform.claude.com/docs/ja/managed-agents/agent-setup)**: Claude Managed Agents向けに再利用可能でバージョン管理されたエージェント設定を定義します（`POST /v1/agents`、`GET /v1/agents`）
* **[Sessions API](https://platform.claude.com/docs/ja/managed-agents/sessions)**: マネージドクラウドサンドボックスでステートフルなエージェントセッションを実行します（`POST /v1/sessions`、`GET /v1/sessions/{id}/events/stream`）
* **[Environments API](https://platform.claude.com/docs/ja/managed-agents/environments)**: エージェントセッション用のサンドボックステンプレートを設定します（`POST /v1/environments`、`GET /v1/environments`）
すべてのエンドポイント、パラメータ、レスポンススキーマを含む完全なAPIリファレンスについては、ナビゲーションに記載されているAPIリファレンスページを参照してください。ベータ機能にアクセスするには、[ベータヘッダー](https://platform.claude.com/docs/ja/api/beta-headers)を参照してください。
## 認証
各認証方法とその使用タイミングの詳細については、[認証](https://platform.claude.com/docs/ja/manage-claude/authentication)を参照してください。Claude APIへのリクエストには以下のヘッダーが含まれます。
| ヘッダー | 値 | 必須 |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Authorization` | `Bearer `。``はAPIキー、または[Workload Identity Federation](https://platform.claude.com/docs/ja/manage-claude/workload-identity-federation)を通じて`POST /v1/oauth/token`から取得した短期間有効なアクセストークンです | はい（`x-api-key`が設定されている場合を除く） |
| `x-api-key` | ConsoleのAPIキー。`Authorization`のレガシーな代替手段で、引き続きサポートされています | いいえ |
| `anthropic-workspace-id` | リクエストが実行される[ワークスペース](https://platform.claude.com/docs/ja/manage-claude/workspaces)のID（例：`wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`）。[ワークスペースの選択](https://platform.claude.com/docs/ja/manage-claude/authentication#select-a-workspace)を参照してください。 | マルチワークスペースAPIキーでは必須です。その他のAPIキーではオプションです。単一のワークスペース用に作成されたキーは、ヘッダーを省略するとそのワークスペースで実行されます。Workload Identity Federationトークンでは使用されません。これらのトークンはトークン交換時にワークスペースを選択します。 |
| `anthropic-version` | APIバージョン（例：`2023-06-01`） | はい |
| `content-type` | `application/json` | はい |
[クライアントSDK](https://platform.claude.com/docs/ja/api/overview#client-sdks)を使用している場合、SDKは認証、バージョン、content-typeヘッダーを自動的に送信します。キーが必要とする場合は、`anthropic-workspace-id`を自分で渡します。APIバージョニングの詳細については、[APIバージョン](https://platform.claude.com/docs/ja/api/versioning)を参照してください。
[クラウドプラットフォーム](https://platform.claude.com/docs/ja/api/overview#claude-api-vs-cloud-platforms)を通じてClaudeにアクセスする場合、認証はクラウドプロバイダーのIAMシステムと統合されます。サポートされている認証情報タイプ、必要なヘッダー、認証オプションについては、プラットフォーム固有のドキュメントを参照してください。
### APIキーの取得
APIはWebの[Console](https://platform.claude.com/)を通じて提供されています。Consoleでは、[playground](https://platform.claude.com/playground)（`platform.claude.com/playground`）を使用してブラウザでAPIを試し、[APIキー](https://platform.claude.com/settings/keys)ページ（`platform.claude.com/settings/keys`）でAPIキーを生成できます。方法については、[Claude APIキーを取得する](https://platform.claude.com/docs/ja/get-api-key)を参照してください。各キーの種類（[キーの種類](https://platform.claude.com/docs/ja/manage-claude/authentication#key-types)を参照）と[有効期限](https://platform.claude.com/docs/ja/manage-claude/authentication#key-expiration)は、キーの作成時に選択します。Consoleの[ワークスペース](https://platform.claude.com/settings/workspaces)を使用して、環境を分離し、ユースケースごとに[支出を管理](https://platform.claude.com/docs/ja/api/rate-limits)できます。
## クライアントSDK
Anthropicは、認証、リクエストのフォーマット、エラー処理などを処理することでAPI統合を簡素化する公式SDKを提供しています。
**メリット:**
* 自動ヘッダー管理（認証、`anthropic-version`、`content-type`）
* 型安全なリクエストおよびレスポンス処理
* 組み込みのリトライロジックとエラー処理
* ストリーミングサポート
* リクエストタイムアウトと接続管理
クライアントSDKの一覧については、[クライアントSDK](https://platform.claude.com/docs/ja/cli-sdks-libraries/overview)を参照してください。
## Claude API対クラウドプラットフォーム
Claudeは、直接的なClaude APIおよびクラウドプラットフォームを通じて利用できます。インフラストラクチャ、機能の可用性、コンプライアンス要件、価格設定の好みに基づいて選択してください。
### Claude API
* 最新のモデルと機能への**直接アクセス**
* **Anthropicの請求とサポート**
* **最適な用途:** 新規統合、完全な機能アクセス、Anthropicとの直接的な関係
### クラウドプラットフォームAPI
AWS、Google Cloud、またはMicrosoft Azureを通じてClaudeにアクセスします。
* クラウドプロバイダーの請求とIAMと**統合**
* **機能の可用性はプラットフォームによって異なります:** Anthropicが運営するプラットフォームには[Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws)と[Microsoft Foundry](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)が含まれます。パートナーが運営するプラットフォームにはAmazon BedrockとGoogle Cloudが含まれます。機能の可用性とタイミングについては、各プラットフォームのページを参照してください。
* **最適な用途:** 既存のクラウドコミットメント、特定のコンプライアンス要件、統合されたクラウド請求
| プラットフォーム | プロバイダー | ドキュメント |
| ---------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Agent Platform | Google Cloud | [Google Cloud上のClaude](https://platform.claude.com/docs/ja/build-with-claude/claude-on-vertex-ai) |
| Amazon Bedrock | AWS | [Amazon Bedrock上のClaude](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock) |
| Claude Platform on AWS | AWS（Anthropic運営） | [Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws) |
| Microsoft Foundry | Microsoft Azure（Anthropic運営） | [Microsoft Foundry上のClaude](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry) |
Claude Managed Agentsは、直接的なClaude APIおよび[Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws)を通じて利用できます。プラットフォーム全体での機能の可用性については、[機能概要](https://platform.claude.com/docs/ja/build-with-claude/overview)を参照してください。
## リクエストとレスポンスの形式
### リクエストサイズの制限
| エンドポイント | 最大リクエストサイズ |
| --------------------------------------------------------------------------------------------- | ---------- |
| Messages、Token Counting | 32 MB |
| [Message Batches API](https://platform.claude.com/docs/ja/build-with-claude/batch-processing) | 256 MB |
| [Files API](https://platform.claude.com/docs/ja/build-with-claude/files) | 500 MB |
| Sessions、Agents、Environments | 32 MB |
これらの制限を超えると、413 `request_too_large`エラーが返されます。
パートナーが運営するプラットフォームには独自のリクエストサイズ制限があります。Bedrockはリクエストを20 MBに制限し、Google Cloudはリクエストを30 MBに制限します。Claude Platform on AWSは直接的なClaude APIと同じ制限を使用します。現在の値については、プラットフォームのドキュメントを参照してください。
### レスポンスヘッダー
Claude APIは、レスポンスに以下のヘッダーを含めます。
| ヘッダー | 説明 |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `request-id` | `req_018EeWyXxfu5pfWkrYcMdjWG`のような、リクエストのグローバルに一意な識別子。特定のリクエストについてサポートに連絡する際に含めてください。[リクエストID](https://platform.claude.com/docs/ja/api/errors#request-id)を参照してください。 |
| `anthropic-organization-id` | リクエストで使用されたAPIキーまたはアクセストークンが属する組織のID。 |
| `anthropic-workspace-id` | APIキーまたはアクセストークンが解決された[ワークスペース](https://platform.claude.com/docs/ja/manage-claude/workspaces)の`wrkspc_`プレフィックス付きID（例: `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`）。組織のデフォルトワークスペースである場合も含みます。認証情報がワークスペースに解決されない場合（例: Admin APIリクエスト）、または認証が完了する前にリクエストが失敗した場合は存在しません。[APIレスポンスの背後にあるワークスペースを特定する](https://platform.claude.com/docs/ja/manage-claude/workspaces#identify-the-workspace-behind-an-api-response)を参照してください。 |
レート制限ヘッダーについては、レート制限の[レスポンスヘッダー](https://platform.claude.com/docs/ja/api/rate-limits#response-headers)を参照してください。各SDKで名前によってレスポンスヘッダーを読み取る例については、[APIレスポンスの背後にあるワークスペースを特定する](https://platform.claude.com/docs/ja/manage-claude/workspaces#identify-the-workspace-behind-an-api-response)を参照してください。
Claude Platform on AWSは、標準の`request-id`ヘッダーに加えてAWSリクエストID（`x-amzn-requestid`）を追加します。デュアルID処理パターンについては、[リクエストID](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#request-ids)を参照してください。
## ページネーション
リストエンドポイントは結果をページ単位で返します。ほとんどの新しいリストエンドポイントは、このセクションで説明する`page`および`next_page`カーソルスキームを使用します。一部は異なるスキームを使用します。このセクションの最後にある注記を参照してください。`limit`クエリパラメータを使用してページサイズを制御し、`page`クエリパラメータを使用して隣接するページを取得します。各レスポンスには、ページ間を移動するためのカーソルフィールドとともに`data`配列が含まれます。
| 名前 | 場所 | 説明 |
| ----------- | ---------- | -------------------------------------------------------------------------------------------------------------- |
| `limit` | クエリパラメータ | ページごとに返すアイテムの最大数。 |
| `page` | クエリパラメータ | 前のレスポンスからの不透明なカーソル。隣接するページを取得するには、`next_page`または`prev_page`の値をここに渡します。 |
| `order` | クエリパラメータ | ソートをサポートするリストエンドポイントでの結果のソート方向（`asc`または`desc`）。`page`カーソルは、作成時の`order`でのみ有効です。 |
| `next_page` | レスポンスフィールド | 次のページのカーソル。これ以上結果がない場合は`null`。 |
| `prev_page` | レスポンスフィールド | 後方ページネーションをサポートするエンドポイント（現在は`GET /v1/sessions`）での前のページのカーソル。最初のページにいる場合は`null`。その他のリストエンドポイントではこのフィールドは省略されます。 |
前のページに戻るには、`prev_page`を`page`パラメータとして渡します。最初のページにいる場合、`prev_page`は`null`です。すべてのリストエンドポイントが`prev_page`をサポートしているわけではありません。`GET /v1/sessions`のみが`prev_page`を返します。後方ページネーションをサポートしないリストエンドポイントでは、このフィールドは`null`ではなくレスポンスから存在しません。リクエストのウォークスルーについては、[セッションの一覧表示](https://platform.claude.com/docs/ja/managed-agents/session-operations#listing-sessions)を参照してください。
SDKは、`next_page`を自動的にたどる自動ページネーションイテレーターを提供しています。たとえば、`for session in client.beta.sessions.list()` (typescript: `for await (const session of client.beta.sessions.list())`; go: `client.Beta.Sessions.ListAutoPaging()`; java: `client.beta().sessions().list().autoPager()`; csharp: `(await client.Beta.Sessions.List()).Paginate()`; php: `$client->beta->sessions->list()->pagingEachItem()`; ruby: `client.beta.sessions.list.auto_paging_each`)はすべてのセッションを順に処理します。SDKの自動ページネーションは前方向のみです。前のページに戻るには、レスポンスから`prev_page`を読み取り、ご自身で`page`パラメータとして渡してください。詳細については、[クライアントSDK](https://platform.claude.com/docs/ja/cli-sdks-libraries/overview)を参照してください。
一部のリストエンドポイントは異なるカーソルスキームを使用します。[Message Batches API](https://platform.claude.com/docs/ja/build-with-claude/batch-processing)、[Models API](https://platform.claude.com/docs/ja/api/models/list)、およびいくつかの[Admin API](https://platform.claude.com/docs/ja/manage-claude/admin-api)エンドポイントは、`page`の代わりに`after_id`および`before_id`クエリパラメータを取ります。それらのレスポンスは、`next_page`の代わりに`has_more`、`first_id`、`last_id`を返します。正確なページネーションフィールドについては、各エンドポイントのリファレンスページを参照してください。
## レート制限と可用性
### レート制限
APIは、不正使用を防止し容量を管理するために、レート制限と支出制限を適用します。制限は使用ティアに整理されています。組織は自動的にティアに配置され、時間の経過とともにより高いティアに移行できます。各ティアには以下があります。
* **支出制限**: API使用の月間最大コスト
* **レート制限**: 1分あたりの最大リクエスト数（RPM）および1分あたりの最大トークン数（TPM）
Consoleの[レート制限](https://platform.claude.com/usage/limits)ページでレート制限を、[請求](https://platform.claude.com/settings/billing)ページで支出制限を確認できます。より高いレート制限や月間支出上限が必要な場合は、レート制限ページの**ティアの引き上げをリクエスト**を使用してください。
制限、ティア、およびレート制限に使用されるトークンバケットアルゴリズムの詳細については、[レート制限](https://platform.claude.com/docs/ja/api/rate-limits)を参照してください。
### 可用性
Claude APIは、世界中の[多くの国と地域](https://platform.claude.com/docs/ja/api/supported-regions)で利用できます。お住まいの地域での可用性を確認するには、サポートされている地域のページを確認してください。
## 次のステップ
直接的なモデルインタラクションのための完全なAPI仕様
Agents、Sessions、Environmentsエンドポイント
Python、TypeScript、C#、Go、Java、PHP、Ruby
使用ティア、より高い制限のリクエスト、トークンバケットアルゴリズム