---
title: OAuthリファレンス
url: https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference
description: エンドポイント、クライアント認証、リクエストパラメータ、スコープ、トークンレスポンス、失効、有効期間、リダイレクトURIのルール、およびエラー。
---

<Warning>
  Claude Platform OAuthはBeta Serviceです。これは、[商用利用規約](https://www.anthropic.com/legal/commercial-terms)や[サービス固有の規約](https://www.anthropic.com/legal/service-specific-terms)など、Anthropicとの契約に基づいて提供されるリリース前のソフトウェアです。エンドポイント、パラメータ、および動作はベータ期間中に変更される可能性があります。本番環境での使用には適さない場合があります。
</Warning>

このページでは、[Claude Platform OAuth](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/overview)のエンドポイント、パラメータ、検証ルール、およびエラーの対応関係をまとめています。手順の解説については、[Linked billing](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/organization-billing-connections)を参照してください。

## エンドポイント

| エンドポイント                               | URL                                                                     |
| ------------------------------------- | ----------------------------------------------------------------------- |
| 発行者（Issuer）                           | `https://identity.anthropic.com/users`                                  |
| ディスカバリードキュメント                         | `https://identity.anthropic.com/users/.well-known/openid-configuration` |
| 署名鍵（JWKS）                             | ディスカバリードキュメント内の`jwks_uri`（`identity.anthropic.com`でホスト）                 |
| 認可エンドポイント（サインインおよび同意ページ）              | `https://auth.claude.com/oauth/authorize`                               |
| プッシュ型認可リクエスト（PAR）エンドポイント              | `https://auth.claude.com/v1/oauth/par`                                  |
| トークンエンドポイント                           | `https://auth.claude.com/v1/oauth/token`                                |
| 失効エンドポイント                             | `https://auth.claude.com/v1/oauth/revoke`                               |
| Claude API（ユーザープロファイルおよび顧客に請求するリクエスト） | `https://api.anthropic.com`                                             |

署名鍵はハードコードせず、ディスカバリードキュメントから読み取ってください。ディスカバリードキュメントにはPARエンドポイントおよび失効エンドポイントが記載されていないため、この表のURLを使用してください。

## ディスカバリードキュメントの値

| フィールド                                   | 値                                                |
| --------------------------------------- | ------------------------------------------------ |
| `issuer`                                | `https://identity.anthropic.com/users`           |
| `authorization_endpoint`                | `https://auth.claude.com/oauth/authorize`        |
| `token_endpoint`                        | `https://auth.claude.com/v1/oauth/token`         |
| `jwks_uri`                              | `https://identity.anthropic.com/users/jwks.json` |
| `response_types_supported`              | `code`                                           |
| `grant_types_supported`                 | `authorization_code`、`refresh_token`             |
| `code_challenge_methods_supported`      | `S256`                                           |
| `token_endpoint_auth_methods_supported` | `private_key_jwt`                                |
| `id_token_signing_alg_values_supported` | `ES256`                                          |
| `scopes_supported`                      | `openid`、`email`                                 |
| `subject_types_supported`               | `public`、`pairwise`                              |

Linked billingの場合、`auth.claude.com`は、顧客が`billing:attribution`とともに`offline_access`を承認した場合にのみリフレッシュトークンを返します。[請求接続のOAuthトークン](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection)を参照してください。

## クライアント認証

`auth.claude.com`は、`private_key_jwt`方式（[RFC 7523](https://www.rfc-editor.org/rfc/rfc7523)）でコンフィデンシャルクライアントを認証します。PARエンドポイント、トークンエンドポイント、および失効エンドポイントへのすべてのリクエストで、これらのパラメータを送信してください。認証情報をURLのクエリ文字列で送信しないでください。`auth.claude.com`はそれを拒否します。

| パラメータ                   | 値                                                                                                                                                     |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `client_id`             | OAuthアプリのクライアントID                                                                                                                                     |
| `client_assertion_type` | `urn:ietf:params:oauth:client-assertion-type:jwt-bearer`                                                                                              |
| `client_assertion`      | [クライアントアサーションのクレーム](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#client-assertion-claims)に記載のクレームを含む、IDプロバイダーが発行したJWT |

### クライアントアサーションのクレーム

「client assertion」（クライアントアサーション）には以下のすべてのクレームが含まれている必要があり、そのヘッダーにはJWKS内の鍵の`kid`が含まれている必要があります。

| クレーム  | 要件                                                                                                                                               |
| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `iss` | [Workload Identity Federation](https://platform.claude.com/docs/ja/manage-claude/workload-identity-federation)を通じて登録したものと完全に一致する、IDプロバイダーの発行者URL |
| `sub` | アプリのクライアント認証設定でサブジェクトパターンを設定している場合、そのパターンに一致する値                                                                                                  |
| `aud` | 正確に1つのオーディエンス：アプリのクライアント認証設定にある値。`auth.claude.com`は、複数のオーディエンスを含むアサーションを拒否します。                                                                   |
| `iat` | IDプロバイダーがJWTを発行した時刻                                                                                                                              |
| `exp` | 有効期限。`iat`から1時間以内である必要があります。可能な場合はより短い有効期間を使用してください。アサーションを傍受した者は、有効期限が切れるまでそれを使用できます。                                                           |

アサーションのペイロードの例：

```json
{
  "iss": "https://idp.example.com",
  "sub": "workload:prod:claude-integration-backend",
  "aud": "YOUR_CONFIGURED_AUDIENCE",
  "iat": 1791230000,
  "exp": 1791230300
}
```

サブジェクトパターンとクレームの条件は、バックエンドが許す限り狭く設定してください。`auth.claude.com`は、それらに一致するIDプロバイダーからのJWTであれば、どれでもアプリの認証として受け入れます。

## 認可リクエストのパラメータ

これらのパラメータは、`request_uri`を除き、プッシュ型認可リクエストのJSONボディで送信してください。

| パラメータ                    | Linked billing | 説明                                                                                                                                                                         |
| ------------------------ | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `response_type`          | 必須             | 値`code`                                                                                                                                                                    |
| `client_id`              | 必須             | OAuthアプリのクライアントID                                                                                                                                                          |
| `redirect_uri`           | 必須             | 登録済みのリダイレクトURIと完全に一致するURI（最大2048文字）                                                                                                                                        |
| `scope`                  | 必須             | 請求接続の場合は`billing:attribution`または`billing:attribution offline_access`。[スコープ](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#scopes)を参照してください。 |
| `state`                  | 必須             | コールバック時に確認する、ランダムな使い捨ての値（最大2048文字）                                                                                                                                         |
| `code_challenge`         | 必須             | `BASE64URL(SHA256(code_verifier))`。`code_verifier`は43〜128文字                                                                                                                |
| `code_challenge_method`  | 必須             | 値`S256`                                                                                                                                                                    |
| `connection_type`        | 必須             | 値`organization_shared`。この値は、請求のための組織接続を要求します。                                                                                                                              |
| `connection_auth_target` | 必須             | 接続のリクエストがルーティングされる組織。Linked billingでは、`platform`（OAuthアプリのオーナー）を送信してください。                                                                                                  |
| `user_profile_id`        | 必須             | 顧客を表す、組織内のアクティブなユーザープロファイルのID                                                                                                                                              |
| `request_uri`            | 必須             | PARエンドポイントが返した値。`client_id`とともに、他のパラメータを付けずに認可エンドポイントに送信します。                                                                                                               |

PARエンドポイントは、`request_uri`と`expires_in`（600秒）を含むHTTP 201を返します。

## スコープ

| カテゴリ | スコープ                      | 説明                                                                                                                                                                                                                                                       | 接続タイプ                 | クライアントタイプ |
| ---- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | --------- |
| 一般   | `offline_access`          | 要求された他のスコープを表すリフレッシュトークンをアプリに付与します。`organization_shared`接続では、`billing:attribution`とともにのみ送信してください。                                                                                                                                                        | `organization_shared` | コンフィデンシャル |
| 請求   | `billing:attribution`     | 顧客の指示によって行うClaude APIリクエストを、その顧客のClaude組織に請求できる接続。単独で送信するか、リフレッシュトークンも取得する場合は`offline_access`とともに送信してください。[請求接続のOAuthトークン](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection)を参照してください。 | `organization_shared` | コンフィデンシャル |
| 請求   | `org:billing_attribution` | 非推奨：`billing:attribution`を使用してください。                                                                                                                                                                                                                      | `organization_shared` | コンフィデンシャル |

## トークンリクエストとレスポンス

トークンリクエストは、JSONボディで`https://auth.claude.com/v1/oauth/token`に送信してください。

| パラメータ                                                  | 値                                                                                                                 |
| ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| `grant_type`                                           | `authorization_code`                                                                                              |
| `code`                                                 | コールバックで受け取ったコード                                                                                                   |
| `redirect_uri`                                         | 認可リクエストで送信したものと同じ`redirect_uri`                                                                                   |
| `code_verifier`                                        | PKCEのコードベリファイア                                                                                                    |
| `client_id`、`client_assertion_type`、`client_assertion` | [クライアント認証](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#client-authentication)と同様 |

トークンレスポンスには以下のフィールドが含まれます：

| レスポンスフィールド                 | Linked billing                                                                                                                    |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `access_token`             | [接続のアクセストークン](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection) |
| `token_type`               | `Bearer`                                                                                                                          |
| `expires_in`               | 最大`3600`                                                                                                                          |
| `scope`                    | `workspace:inference`                                                                                                             |
| `connection_id`            | 接続ID（例：`ocon_EXAMPLE`）。保存してください。                                                                                                  |
| `refresh_token`            | 顧客が`offline_access`を承認した場合にのみ返されます                                                                                                |
| `refresh_token_expires_in` | `refresh_token`が期限切れになるまでの秒数。`refresh_token`がない場合は存在しません。                                                                         |

リフレッシュするには、`grant_type`を`refresh_token`に設定し、`refresh_token`と[クライアント認証](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#client-authentication)のパラメータを送信してください。請求接続のリフレッシュは、[請求接続のOAuthトークン](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection)のルールに従います。

## 請求接続のOAuthトークン

請求接続の場合、トークンエンドポイントは接続のアクセストークンを返します。このトークンは、アプリの`connection_token_workspace_id`設定で指定されたワークスペースにおいて、アプリの[オペレーターサービスアカウント](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#terms)として認証されます。`/v1/messages`および`/v1/chat/completions`では、このトークンを使用したリクエストはその接続の顧客に請求され、それ以外には請求されません。顧客が`offline_access`も承認した場合、トークンエンドポイントはリフレッシュトークンも返し、`refresh_token`グラントによって両方のトークンが更新されます。設定と手順の解説については、Linked billingページの[接続ごとのOAuthトークン](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/organization-billing-connections#oauth-tokens-for-each-connection)を参照してください。

どちらのグラントも、[トークンリクエストとレスポンス](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#token-request-and-response)のパラメータを[クライアント認証](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#client-authentication)とともに受け取ります。リフレッシュでは`scope`パラメータを送信してはなりません。トークンレスポンスには以下のフィールドが含まれます：

| レスポンスフィールド                 | 値                                                          |
| -------------------------- | ---------------------------------------------------------- |
| `access_token`             | 接続のアクセストークン                                                |
| `token_type`               | `Bearer`                                                   |
| `expires_in`               | アクセストークンが期限切れになるまでの秒数（最大`3600`）                            |
| `scope`                    | 常に`workspace:inference`                                    |
| `connection_id`            | 接続ID（例：`ocon_EXAMPLE`）。`authorization_code`グラントのみがこれを返します。 |
| `refresh_token`            | 接続のリフレッシュトークン。顧客が`offline_access`を承認した場合にのみ返されます。          |
| `refresh_token_expires_in` | `refresh_token`が期限切れになるまでの秒数                               |

リフレッシュのたびに、新しい`access_token`と新しい`refresh_token`が返されます。送信したリフレッシュトークンは置き換えられ、以前のアクセストークンは数分以内に使用できなくなります。レスポンスを受け取れなかったリクエストを再実行するために、置き換えられたリフレッシュトークンを、それを置き換えたリフレッシュから30秒以内であれば、もう一度だけ送信できます。その2回目のリクエストは別の新しいペアを返し、受け取れなかったレスポンスのペアを取り消します。最新のペアのみを使用してください。置き換えられたトークンを使用した3回目のリクエストは`invalid_grant`を受け取り、30秒を過ぎてから届いた2回目のリクエストも同様です。30秒以内であれば、そのようなリクエストは何も取り消しません。30秒を過ぎると、そのようなリクエストは接続のすべてのトークンを取り消し、接続を終了します。リフレッシュのルールとエラーについては、[トークンをリフレッシュする](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/organization-billing-connections#refresh-the-connection)を参照してください。

以下のいずれのイベントでも、現在のアクセストークンを含む接続のトークンが取り消されます：

* 顧客またはあなたがリンクを解除した。
* 顧客が同じユーザープロファイルに対して異なるスコープの新しい認可リクエストを承認し、あなたがその承認のコードを交換した。新しい接続が以前の接続に置き換わります。
* トークンが動作するワークスペースがアーカイブされた。

Claude APIが接続のアクセストークンを使用したリクエストをどのように請求するかについては、[接続のアクセストークンでClaudeを呼び出す](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/organization-billing-connections#call-claude-with-a-connections-access-token)を参照してください。

## 失効

失効リクエストは、JSONまたはフォームエンコードされたボディで`https://auth.claude.com/v1/oauth/revoke`に送信してください。このエンドポイントは[RFC 7009](https://www.rfc-editor.org/rfc/rfc7009)に準拠しており、接続IDおよびユーザープロファイルIDも受け付けます。

[クライアント認証](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#client-authentication)のパラメータと、この表のパラメータのうち正確に1つを送信してください。クライアントアサーションの`aud`は、失効URLではなく、アプリのクライアント認証設定にある値です。

| パラメータ             | 終了するもの                                                                                              |
| ----------------- | --------------------------------------------------------------------------------------------------- |
| `connection_id`   | アプリの接続の1つ。`ocon_` IDとして指定します                                                                        |
| `user_profile_id` | 1つのユーザープロファイル上にあるアプリのすべての接続。`uprof_` IDとして指定します                                                     |
| `token`           | Linked billingの場合は、代わりに`connection_id`または`user_profile_id`を送信してください。アクセストークンを送信しても接続が終了しない可能性があります。 |

`auth.claude.com`は`token_type_hint`を受け付けますが、無視します。

エンドポイントは、HTTP 200と、リクエストによって終了した接続のIDを返します：

```json
{
  "revoked_connection_ids": ["ocon_EXAMPLE"]
}
```

トークンまたはIDが不明であるか別のアプリに属している場合、接続がすでに終了している場合、またはリクエストによってトークンは終了したが接続は終了しなかった場合、リストは空になります。レスポンスにはどれであるかは示されません。

請求接続が終了した後、Claude APIはその顧客に請求するリクエストを`user_profile_not_billable`で拒否し、接続のOAuthトークンは機能しなくなります。非推奨の`org:billing_attribution`スコープで承認された接続のアクセストークンには、終了後は依存しないでください。直ちに機能しなくなる場合もあれば、期限切れになるまで機能する場合もあります。

## 有効期間

| 項目                         | 有効期間                          |
| -------------------------- | ----------------------------- |
| PARエンドポイントからの`request_uri` | 10分、使い捨て                      |
| 認可コード                      | 5分、使い捨て                       |
| `access_token`             | 最大1時間                         |
| `refresh_token`            | コード交換から最大1年。リフレッシュしても延長されません。 |

これらは現在の値です。固定値に依存せず、各レスポンスから`expires_in`と`refresh_token_expires_in`を読み取ってください。

## リダイレクトURIのルール

* 各`redirect_uri`は、アプリに登録されたURIと完全に一致する必要があります。`auth.claude.com`はワイルドカードやプレフィックスによる照合を使用しません。
* すべてのリダイレクトURIはHTTPSを使用する必要があり、フラグメントを含めてはなりません。`localhost`、`127.0.0.1`、または`[::1]`上のローカル開発用URIはHTTPを使用できます。
* `http://localhost:*/callback`のように、ポートとしてアスタリスクを指定して登録されたローカル開発用URIは、任意のポートに一致します。
* アプリごとに最大10個のリダイレクトURIを登録できます。
* `auth.claude.com`は、`redirect_uri`が登録済みのURIと一致する場合にのみ、エラーをリダイレクトURIに送信します。それ以外の`redirect_uri`の場合、`auth.claude.com`はブラウザをリダイレクトしません。

## エラー

### リダイレクト時のエラー

`auth.claude.com`は、リダイレクトURIのクエリパラメータ`error`、`error_description`、および`state`としてエラーを返します。これらは標準のOAuth 2.0エラー（[RFC 6749](https://www.rfc-editor.org/rfc/rfc6749)）ですが、Anthropic固有の`user_profile_already_linked`は例外です。

| エラー                           | 発生条件                                                                                                                           | ユーザーに表示する内容                                                                                                                                                                                                                                                                                   |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `access_denied`               | その人物が拒否した、またはこのリクエストを承認できない。請求接続の場合、その人物はClaude組織の管理者である必要があります。                                                               | 接続が完了しなかったことを説明し、その人物が拒否したと決めつけないでください。請求接続の場合は、Linked billingガイドの[リダイレクトURIが`error=access_denied`を受け取る](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/organization-billing-connections#access-denied)に従ってください。そこには原因と、その人物に伝えるべき内容が記載されています。それ以外の場合は、その人物にあなたに連絡するよう依頼してください。 |
| `server_error`                | `auth.claude.com`がリクエストの処理に失敗した。                                                                                               | ユーザーに再試行するよう依頼してください。                                                                                                                                                                                                                                                                         |
| `user_profile_already_linked` | Linked billingのみ。顧客の組織が、別のユーザープロファイルを通じてすでにアプリにリンクされている。各顧客組織はアプリへの接続を1つしか持てません。`auth.claude.com`はすでに管理者に対し、あなたに連絡するよう依頼しています。 | その組織がすでにアプリにリンクされていることを説明してください。                                                                                                                                                                                                                                                              |

`request_uri`が期限切れになっているか、すでに使用済みである場合、`auth.claude.com`はエラーページを表示し、ブラウザをアプリにリダイレクトしません。新しいプッシュ型認可リクエストでフローを最初からやり直してください。

### PARエンドポイントおよびトークンエンドポイントからのエラー

これらのエンドポイントは、`error`と`error_description`を含むJSONボディを返します。

| エラー                           | 発生条件                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invalid_request`             | 必須パラメータが欠けているか無効である。例えば、`state`やPKCEチャレンジが欠けている、または`user_profile_id`が組織内のアクティブなユーザープロファイルのIDではない。                                                                                                                                                                                                                                                                                                                                                                                            |
| `invalid_client`              | `auth.claude.com`がアプリを認証できなかった。クライアントIDが不明であるか、クライアントアサーションの検証に失敗した。アサーションの`iss`、`sub`、および`aud`をアプリのクライアント認証設定と照合し、IDプロバイダーがJWKS内の鍵で署名したことを確認してください。                                                                                                                                                                                                                                                                                                                                         |
| `invalid_scope`               | 要求されたスコープが、このアプリまたはこの接続タイプに許可されていない。[請求接続のトークン](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection)の場合、これは、リフレッシュが受け付けない`scope`パラメータを送信したこと、または`billing:attribution`がアプリに登録されなくなったことも意味します。コード交換時には、後者の原因によってコードが消費されます。                                                                                                                                                                                                     |
| `invalid_grant`               | コードが期限切れになっている、すでに使用済みである、または`redirect_uri`や`code_verifier`と一致しない。リフレッシュの場合は、リフレッシュトークンが期限切れになっているか、もはや有効ではない。[トークンをリフレッシュする](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/organization-billing-connections#refresh-the-connection)に従ってください。                                                                                                                                                                                                                                 |
| `unauthorized_client`         | アプリがこのリクエスト用に設定されていない。Linked billingの場合は、まずアプリのオペレーターサービスアカウントとそのワークスペースを確認してください。[コード交換が`unauthorized_client`を返す](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/organization-billing-connections#code-exchange-unauthorized-client)を参照してください。[請求接続のトークン](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection)の場合、`error_description`に原因が示されます（例：ワークスペースがない）。この拒否によってコードが消費されることはなく、リフレッシュトークンが取り消されることもありません。 |
| `user_profile_already_linked` | Linked billingのみ、トークンエンドポイントから。承認からこのリクエストまでの間に、ユーザープロファイルが別の顧客組織を通じてアプリにリンクされた、または顧客の組織が別のユーザープロファイルを通じてリンクされた。                                                                                                                                                                                                                                                                                                                                                                             |

`auth.claude.com`がリクエストにレート制限を適用した場合、障害が発生している場合、または不明な`grant_type`や上限を超える長さのパラメータを受け取った場合は、異なる形式のエラーを返し、それはJSONではない可能性があります。再試行はHTTP 429および5xxレスポンスの場合にのみ、バックオフを伴って行ってください。その他のステータスはリクエストの不備として扱ってください。請求接続のリフレッシュの場合は、一般的なバックオフではなく[トークンをリフレッシュする](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/organization-billing-connections#refresh-the-connection)に従ってください。レスポンスに`retry-after`ヘッダーがある場合は、少なくともその時間だけ待ってください。次のリクエストは自身のコードから送信し、HTTPクライアントライブラリの自動再試行に依存しないでください。そのようなレスポンスに対しては自動再試行が実行されない可能性があります。すでに使用されたリフレッシュトークンを再度送信すると接続が終了する可能性があるため、[トークンをリフレッシュする](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/organization-billing-connections#refresh-the-connection)では再試行が安全な場合についても説明しています。

### 失効エンドポイントからのエラー

`auth.claude.com`が拒否するほとんどのリクエストについて、失効エンドポイントはHTTP 400と、`error`および`error_description`を含むJSONボディを返します。

| エラー                   | 発生条件                                                                                                                                                                                                                                                                            |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invalid_request`     | 必須パラメータが欠けているか無効である（例：`client_id`が欠けている）。リクエストが`token`、`connection_id`、`user_profile_id`のいずれも送信していない、または複数を送信している。IDの形式が不正である（例：プレフィックスが誤っている）。認証情報または`token`がURLのクエリ文字列に含まれている。ユーザープロファイルの接続数が1回のリクエストで処理するには多すぎる。リクエストによってそのうちの一部が終了している可能性があるため、残りは`connection_id`で終了してください。 |
| `invalid_client`      | `auth.claude.com`がアプリを認証できなかった。確認すべき内容については、[PARエンドポイントおよびトークンエンドポイントからのエラー](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#errors-from-the-par-and-token-endpoints)の`invalid_client`を参照してください。                                                   |
| `unauthorized_client` | アプリがこのリクエスト用に設定されていない。Anthropicのアカウントチームにお問い合わせください。                                                                                                                                                                                                                            |

次の表のレスポンスは異なる形式を使用しており、JSONではない可能性があります。ボディがJSONの場合、`error`は文字列ではなくオブジェクトです。

| ステータス | 発生条件                                | 対処方法                                                                                                                                                                                                               |
| ----- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 400   | パラメータが上限を超える長さである。                  | リクエストを修正してください。再試行しないでください。                                                                                                                                                                                        |
| 429   | あなたのIPアドレスから失敗したリクエストが多すぎる。         | バックオフを伴って再試行してください。                                                                                                                                                                                                |
| 500   | `auth.claude.com`がリクエストの処理に失敗した。    | バックオフを伴って再試行してください。繰り返し発生する場合は、Anthropicのアカウントチームにお問い合わせください。                                                                                                                                                      |
| 501   | Anthropicが組織に対してこのエンドポイントを有効にしていない。 | 再試行しないでください。Anthropicのアカウントチームにお問い合わせください。                                                                                                                                                                         |
| 503   | リクエストが完了しなかった。終了したものは終了したままです。      | 同じパラメータと新しいクライアントアサーションを使用して、バックオフを伴って再試行してください。再試行によって残りが完了し、そのリストには以前のリクエストで終了した接続は含まれません。`user_profile_id`を送信した場合は、1日以内に再試行してください。それを過ぎると、再試行は空のリストとともに200を返し、何も完了しない可能性があります。各`connection_id`による再試行はいつでも機能します。 |

### 請求エラー

これらは、`billing_policy.bill_to`を`"user_profile"`に設定した、または[請求接続のアクセストークン](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection)で認証するClaude APIリクエストに適用されます。Claude APIは、拒否されたリクエストについてはどちらの組織にも請求しません。402および403のレスポンスはいずれも再試行できません。ただし、新しい接続の直後10秒以内に発生した`user_profile_not_billable`による拒否は例外です。

| ステータス | エラータイプとコード                                                | 発生条件                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----- | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400   | `invalid_request_error`                                   | リクエストが`user-profiles-billing-2026-10-01`ベータヘッダーなしで`billing_policy`を送信している。または、`billing_policy`オブジェクトにフィールドが欠けているか無効なフィールドがある。請求接続のアクセストークンを使用する場合、`bill_to`は省略できます。または、リクエストが許可された組み合わせ以外でコード実行を使用している。                                                                                                                                                                                               |
| 400   | `invalid_request_error`、`user_profile_required`           | `bill_to`が`"user_profile"`であり、リクエストにユーザープロファイルIDが含まれておらず、かつ請求接続のアクセストークンで認証していない。                                                                                                                                                                                                                                                                                                                     |
| 400   | `invalid_request_error`（エラーコードなし）                         | リクエストが請求接続のアクセストークンで認証しており、`bill_to`を`"self"`に設定しているか、トークンが限定されているもの以外のユーザープロファイルを指定している。これら2つの拒否はいずれも、何が問題かを`error.message`で示します。                                                                                                                                                                                                                                                                    |
| 401   | `authentication_error`                                    | リクエストが、期限切れになった、リフレッシュによって置き換えられた、または接続が終了した請求接続のアクセストークンで認証している。メッセージには、トークンが期限切れになったのか取り消されたのかが示されます。現在のアクセストークンでリクエストを再送信するか、接続が終了している場合は顧客を再度リンクしてください。接続が終了した後、そのアクセストークンを使用した新しいリクエストはそれぞれ、この401または403 `user_profile_not_billable`のいずれかを、順序不定で受け取る可能性があります。                                                                                                                                     |
| 402   | `billing_error`、`linked_organization_spend_limit_reached` | 顧客組織が、あなたのOAuthアプリ用または組織全体用に自ら設定した支出制限に達した。組織にリクエストの支払いに充てられるクレジットがない場合にも、Claude APIは同じコードを送信します。レスポンスにはいずれであるかは示されない。両方の制限とクレジット残高を確認するよう顧客に依頼してください。それぞれを設定する場所と変更すべき内容については、Linked billingの[想定されるエラー](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/organization-billing-connections#expected-errors)を参照してください。                                                                     |
| 402   | `billing_error`、`linked_organization_billing_unavailable` | 顧客組織自身のAnthropicアカウントに問題があるため、Anthropicが現在その顧客組織に請求できない。組織のクレジットが尽きた場合、Claudeがすでに開始した応答も同じコードで終了します。顧客にAnthropicでの請求ステータスを確認するよう依頼してください。                                                                                                                                                                                                                                                             |
| 403   | `permission_error`（エラーコードなし）                              | Anthropicが組織に直接請求していないため、あなたに代わって顧客に請求することができない。                                                                                                                                                                                                                                                                                                                                                      |
| 403   | `permission_error`、`user_profile_not_billable`            | ユーザープロファイルに顧客組織への接続がない、管理者またはバックエンドが接続を終了した、顧客組織がAPIの使用量についてAnthropicに直接支払っていない（前払いクレジットと請求書払いはいずれも直接の支払いとみなされます）、またはリクエストがアプリのサービスアカウントとして認証されていない。レスポンスにはどれであるかは示されない。接続のアクセストークンも、接続が終了した後にこのエラーを受け取る可能性があります。それぞれについて確認すべき内容は、[`user_profile_not_billable`の原因](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/organization-billing-connections#user-profile-not-billable)を参照してください。 |
| 503   | `overloaded_error`                                        | Claude APIが、顧客に請求できるかどうかを一時的に確認できない。リクエストを再試行してください。レスポンスに`retry-after`ヘッダーが含まれている場合は、その時間だけ待ってから再試行してください。                                                                                                                                                                                                                                                                                           |

`/v1/messages`では、エラーコードは`error.details.error_code`にあります。`/v1/chat/completions`では、`error.type`は常に`invalid_request_error`であり、`error.code`にはAnthropicのエラータイプ（例：`permission_error`や`billing_error`）が含まれ、レスポンスにはエラーコードが含まれないため、HTTPステータスと`error.code`で照合してください。

## 標準規格

| 標準規格                                                             | 適用箇所                                                                                               |
| ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| [OAuth 2.0（RFC 6749）](https://www.rfc-editor.org/rfc/rfc6749)    | 認可コードフロー、トークンエンドポイント、およびエラーレスポンス                                                                   |
| [PKCE（RFC 7636）](https://www.rfc-editor.org/rfc/rfc7636)         | すべての認可リクエストで`S256`とともに必須                                                                           |
| [プッシュ型認可リクエスト（RFC 9126）](https://www.rfc-editor.org/rfc/rfc9126) | Linked billingでは必須。                                                                                |
| [トークン失効（RFC 7009）](https://www.rfc-editor.org/rfc/rfc7009)       | 失効エンドポイント。接続IDおよびユーザープロファイルIDも受け付け、終了した接続のIDを返します                                                  |
| [JWTクライアント認証（RFC 7523）](https://www.rfc-editor.org/rfc/rfc7523)  | PARエンドポイント、トークンエンドポイント、および失効エンドポイントでの`private_key_jwt`クライアント認証、および顧客に請求するリクエストのためのサービスアカウントのトークン交換 |

## これらのページで使用される用語

以下の意味は、Claude Platform OAuthにのみ適用されます。

| 用語                           | 意味                                                                                                                                                                                                                                                                                      |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude組織                     | Anthropicの組織アカウント。あなたの会社は1つ持っており、請求のために組織をリンクする各顧客も同様に持っています。                                                                                                                                                                                                                           |
| 管理者                          | 管理者または請求のロールを持つClaude組織のメンバー。                                                                                                                                                                                                                                                           |
| OAuthアプリ                     | `auth.claude.com`に対して製品を識別する、Claude組織内の登録。クライアントID、名前、ロゴ、ホームページURL、リダイレクトURI、およびサポートする接続タイプを持ちます。                                                                                                                                                                                       |
| 接続タイプ                        | 接続を承認する主体：組織全体を代表する管理者（`organization_shared`、Linked billing用）。                                                                                                                                                                                                                          |
| IDプロバイダー                     | バックエンド向けに短期間有効なJWTに署名し、その公開鍵をJSON Web Key Set（JWKS）として公開する、自社インフラストラクチャ内のサービス。クラウドプロバイダーのワークロードIDサービスや、独自のOIDC準拠の発行者などがあります。これらのページにおいて、「IDプロバイダー」は常にこのサービスを指し、Anthropicを指すものではありません。                                                                                                   |
| クライアントアサーション                 | IDプロバイダーが署名し、バックエンドがOAuthアプリを認証するために送信する、短期間有効なJWT。これは`private_key_jwt`クライアント認証方式（RFC 7523）です。                                                                                                                                                                                          |
| プッシュ型認可リクエスト（PAR）            | バックエンドが認可パラメータを`auth.claude.com`に直接送信し、ブラウザのリダイレクトで使用する`request_uri`を受け取るリクエスト（RFC 9126）。                                                                                                                                                                                               |
| Workload Identity Federation | 組織がIDプロバイダーを登録するためのClaude Consoleの機能。これにより、AnthropicはJWKS内の鍵で署名されたJWTを受け入れます。                                                                                                                                                                                                           |
| ディスカバリードキュメント                | Anthropicの発行者、エンドポイント、および署名鍵を記載したOIDCドキュメント。                                                                                                                                                                                                                                            |
| ユーザープロファイル                   | 顧客の1人を表すために、自社のClaude組織内に作成するレコード。請求接続は、ユーザープロファイルを顧客のClaude組織に紐付けます。                                                                                                                                                                                                                   |
| サービスアカウント                    | Claude組織内の人間以外のアカウント。Linked billingの場合、OAuthアプリは1つのサービスアカウント（そのオペレーターサービスアカウント）に紐付けられ、バックエンドは顧客に請求するリクエストを送信する際にそのサービスアカウントとして認証します。                                                                                                                                                    |
| 接続のOAuthトークン                 | `auth.claude.com`が請求接続に対して返すアクセストークン、および顧客が`offline_access`も承認した場合に返すリフレッシュトークン。アクセストークンはオペレーターサービスアカウントとして認証され、その接続のユーザープロファイルにのみ請求できます。[請求接続のOAuthトークン](https://platform.claude.com/docs/ja/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection)を参照してください。 |
