ワークスペース

ワークスペースは、組織内でのAPI使用を整理する方法を提供します。ワークスペースを使用して、一元化された請求と管理を維持しながら、異なるプロジェクト、環境、またはチームを分離します。

ワークスペースの仕組み

すべての組織には、名前の変更、アーカイブ、削除ができないデフォルトワークスペースがあります。追加のワークスペースを作成すると、メンバー、サービスアカウント、APIキー、リソース制限をそれぞれに割り当てることができます。

主な特徴:

• ワークスペース識別子はwrkspc_プレフィックスを使用します（例：wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ）。
• デフォルトでは、組織ごとに最大100個のワークスペースを作成できます（アーカイブ済みのワークスペースはカウントされません）。さらに必要な場合は、アカウントチームにお問い合わせください。
• デフォルトワークスペースは他のワークスペースと同様にwrkspc_ IDを持ちます（anthropic-workspace-idレスポンスヘッダーで返され、ワークスペースを取得API リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。で受け付けられます）が、ワークスペース一覧を取得API リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。の結果に表示されるのはinclude_default=trueを渡した場合のみです。Usage and Cost Analytics APIはその使用量とコストをそのIDで報告しますが、レガシーのUsage and Cost APIのレポートではworkspace_idがnullと表示されます（デフォルトワークスペースにバインドされたキーの場合、APIキーのscopeフィールドに実際のIDが含まれます）。
• APIキーは単一のワークスペースにスコープを限定できます。この場合、そのワークスペース内のリソースにのみアクセスできます。その他のAPIキーはワークスペースにスコープが限定されていません。これらのキーを使用する場合は、各リクエストでワークスペースIDヘッダーを送信してワークスペースを選択します。キーのユーザーまたはサービスアカウントは、そのワークスペースへのアクセス権を持っている必要があります。

Claude Codeワークスペース

組織のメンバーが初めてClaude ConsoleアカウントでClaude Codeにサインインすると、Anthropicは組織内にClaude Codeワークスペースを自動的に作成し、そのメンバーを追加します。その後Claude Codeにサインインするすべてのメンバーも同じ方法で追加されます。

Claude CodeワークスペースはClaude Codeのトラフィックを他のAPIワークロードから分離します:

• Claude Codeはサインイン時にこのワークスペースでユーザーごとのAPIキーを発行します。Consoleから手動でキーを作成することはできません。
• Claude Codeキーは、ワークスペースキーとは異なり、所有者がワークスペースまたは組織から削除されると機能しなくなります。
• Claude Codeの使用量は個別にレート制限され、管理者はClaude Consoleのレート制限で、組織の制限に対するその割合に上限を設定できます。
• ユーザーごとの月間支出制限をサポートする唯一のワークスペースです。

ワークスペースのロールと権限

メンバーは各ワークスペースで異なるロールを持つことができ、きめ細かいアクセス制御が可能です。

ロールの継承

• 組織の管理者は、すべてのワークスペースに対してワークスペース管理者のアクセス権を自動的に付与されます。
• 組織の請求メンバーは、すべてのワークスペースに対してワークスペースの請求のアクセス権を自動的に付与されます。
• 組織のユーザーと開発者は、各ワークスペースに明示的に追加する必要があります。
• サービスアカウントは、Claude Consoleのサービスアカウントページ（platform.claude.com/settings/service-accounts）でワークスペースに追加します。アカウントのメニューまたはアカウント自体のページでワークスペースに追加を選択してください。1つのワークスペース内のアカウントを確認するには、リストをワークスペースでフィルタリングします。

ワークスペースの管理

Consoleの使用

Claude Consoleのワークスペースページでワークスペースを作成および管理します。

ワークスペースの作成

1. 1

   ワークスペース設定を開く

   Claude Consoleで、ワークスペースページ（platform.claude.com/settings/workspaces）に移動します。

2. 2

   「ワークスペースを作成」ページを開く

   ワークスペースを作成をクリックして、Consoleのワークスペースを作成ページ（platform.claude.com/settings/workspaces/new）を開きます。

3. 3

   ワークスペースを設定する

   ワークスペース名を入力し、視覚的に識別するための色を選択します。

4. 4

   ワークスペースの作成を完了する

   ワークスペースを作成をクリックして確定します。

ワークスペースの詳細を編集する

ワークスペースの名前または色を変更するには:

1. リストからワークスペースを選択します。
2. その他の操作メニュー（3つのドット）を開き、詳細を編集を選択します。
3. 名前または色を更新し、変更を保存します。

ワークスペースにメンバーを追加する

1. Claude Consoleで、メンバーページ（platform.claude.com/settings/members）に移動します。
2. ワークスペースに追加をクリックします。
3. ワークスペース、追加する組織メンバー、およびそのワークスペースロールを選択します。
4. ワークスペースに追加をクリックして確定します。

ワークスペースからメンバーを削除する

1. Claude Consoleのメンバーページで、ワークスペースドロップダウンメニューからワークスペースを選択します。すべてと表示されている場合、メンバーを削除を実行すると、メンバーはワークスペースではなく組織から削除されます。
2. メンバーの行の末尾でその他の操作メニュー（3つのドット）を開き、メンバーを削除を選択します。
3. 削除をクリックして確定します。

ワークスペースの制限を設定する

ワークスペースのレート制限と支出制限は、それぞれ異なる場所で設定します:

• レート制限： Claude Consoleのレート制限で、ワークスペースドロップダウンメニューからワークスペースを選択し、モデルの横にある編集をクリックして、1分あたりのリクエスト数、入力トークン数、または出力トークン数の制限を設定します。
• 支出制限： Claude Consoleのワークスペースページで、ワークスペースを選択します。開いたパネルで支出上限をクリックして、月間支出に上限を設定し、支出が特定のしきい値に達したときのアラートを設定します。

ワークスペースをアーカイブする

ワークスペースをアーカイブするには、そのその他の操作メニュー（3つのドット）を開き、ワークスペースをアーカイブを選択します。アーカイブすると:

• レポート用に履歴データを保持します
• ワークスペースを無効化し、そのために作成されたすべてのAPIキーをアーカイブします
• 元に戻すことはできません

Admin APIの使用

Admin APIを使用してプログラムでワークスペースを管理します。

以下のSDKおよびCLIの例はデフォルトのクライアントを構築し、ANTHROPIC_API_KEY環境変数からAdmin APIキーを読み取ります。SDKはこれらのエンドポイントをclient.organization.workspacesで公開しています。SDKのリストメソッドは必要に応じて後続のページを取得するため、limitはページサイズを設定します。PHP、Ruby、curlの例は1ページを返します。

ワークスペースを作成する:

client = anthropic.Anthropic()

workspace = client.organization.workspaces.create(name="Production")

print(f"id: {workspace.id}")
print(f"name: {workspace.name}")

ワークスペースを一覧表示する:

client = anthropic.Anthropic()

workspaces = client.organization.workspaces.list(limit=10, include_archived=False)

for workspace in workspaces:
    print(f"{workspace.id}: {workspace.name}")

ワークスペースをアーカイブする:

client = anthropic.Anthropic()

workspace = client.organization.workspaces.archive("wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ")

print(f"id: {workspace.id}")
print(f"archived_at: {workspace.archived_at}")

パラメータの詳細とレスポンススキーマの全体については、ワークスペースAPIリファレンスAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。を参照してください。

ワークスペースメンバーの管理

ワークスペースにメンバーを追加する:

client = anthropic.Anthropic()

member = client.organization.workspaces.members.add(
    "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    user_id="user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_role="workspace_developer",
)

print(f"user_id: {member.user_id}")
print(f"workspace_role: {member.workspace_role}")

メンバーのロールを更新する:

client = anthropic.Anthropic()

member = client.organization.workspaces.members.update(
    "user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    workspace_role="workspace_admin",
)

print(f"user_id: {member.user_id}")
print(f"workspace_role: {member.workspace_role}")

ワークスペースからメンバーを削除する:

client = anthropic.Anthropic()

removed_member = client.organization.workspaces.members.remove(
    "user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
)

print(f"user_id: {removed_member.user_id}")

すべてのパラメータの詳細については、ワークスペースメンバーAPIリファレンスAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。を参照してください。

APIキーとリソースのスコープ

すべてのリクエストは正確に1つのワークスペースで実行され、そのワークスペース内のリソースにのみアクセスできます。どのワークスペースかはキータイプによって異なります:

• ワークスペースキー（所有者のないレガシーキー）は、作成されたワークスペースに属し、常にそこで実行されます。
• 個人キーまたはサービスアカウントキーは、そのユーザーまたはサービスアカウントとして動作します。単一ワークスペースのキーは、作成時に選択されたワークスペースで常に実行されます。ワークスペースにスコープが限定されていないキーは、各リクエストのanthropic-workspace-idヘッダーで指定されたワークスペースで実行されます。アカウントはワークスペースを使用するためにそのワークスペースへのアクセス権を持っている必要があります。

ワークスペースにスコープされるリソースには以下が含まれます:

• Files APIを通じて作成されたファイル
• Batch APIを通じて作成されたメッセージバッチ
• Skills APIを通じて作成されたスキル

一部のリソースは異なる方法で管理されます:

• MCPトンネルは、APIキーではなく、Workload Identity Federationを通じて取得したworkspace:manage_tunnels OAuthトークンで管理されます。トンネルはワークスペース内で作成され、ConsoleのMCP トンネルリストとManaged Agentサーバーピッカーは現在のワークスペース内のトンネルのみを表示します。アクティブなトンネル10個の上限は組織全体に適用されます。トンネル管理にはトンネル管理権限を持つロールが必要です。組織開発者は表示できますが変更はできません。
• ワークスペース自体と組織メンバーは、Admin APIキー、org:admin OAuthトークン、または特定のワークスペースにスコープされていない個人またはサービスアカウントキーを使用して、Admin APIを通じて組織レベルで管理されます。

組織のワークスペースIDを調べるには、ワークスペース一覧を取得API リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。エンドポイントを呼び出す（デフォルトワークスペースを含めるにはinclude_default=trueを渡します）か、Claude Consoleのワークスペースページで確認します。

APIレスポンスの背後にあるワークスペースを特定する

Claude APIレスポンスには、request-idおよびanthropic-organization-idレスポンスヘッダーとともにanthropic-workspace-idヘッダーが含まれます。その値は、リクエストのAPIキーまたはアクセストークンが解決したワークスペースのwrkspc_プレフィックス付きIDで、そのワークスペースがデフォルトワークスペースである場合も含まれます。たとえば、成功したレスポンスには次のようなヘッダーが含まれます:

HTTP/1.1 200 OK
request-id: req_018EeWyXxfu5pfWkrYcMdjWG
anthropic-organization-id: 0d0e7a3b-52f1-4c7e-9a51-3f6f2f7c1b9e
anthropic-workspace-id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ

認証情報がワークスペースに解決されない場合（たとえば、Admin APIリクエストの場合）、または401エラーなど認証が完了する前にリクエストが失敗した場合、ヘッダーは存在しません。

以下の例は、Messages APIリクエストを送信し、レスポンスヘッダーからワークスペースIDを読み取ります:

client = anthropic.Anthropic()

response = client.messages.with_raw_response.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
workspace_id = response.headers.get("anthropic-workspace-id")
print(f"Workspace ID: {workspace_id}")

Workspace ID: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ

同じアクセサーは、Claude Managed Agents APIを含む他のClaude APIエンドポイントからもヘッダーを読み取ります。たとえば、セッションを作成するレスポンスからanthropic-workspace-idを読み取って、セッションがどのワークスペースに属するかを記録します。

レスポンスからのワークスペースIDを使用すると、次のことができます:

• リクエストがどのワークスペースの使用状況、コスト、レート制限にカウントされたかを確認する
• Usage and Cost Analytics APIの行のworkspace_idフィールド（デフォルトワークスペースについてもこれと同じIDが含まれます）、およびAdmin APIのAPIキーのscopeフィールド（デフォルトワークスペースを含め、キーがバインドされているワークスペースの実際のIDが含まれます）と照合する
• Admin APIキーを使用してワークスペースを取得API リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。に渡すことで、それがデフォルトワークスペースのIDかどうかを確認する：ワークスペース一覧を取得API リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。ではinclude_default=trueを渡さない限り省略されますが、デフォルトワークスペースは"name": "Default"として返されます
• Consoleでそのワークスペースを開いて、セッション、ファイル、メッセージバッチ、スキルなどのリクエストのリソースを見つける

ワークスペースの制限

各ワークスペースにカスタムの支出制限とレート制限を設定して、過剰使用を防ぎ、公平なリソース分配を確保できます。

ワークスペースの制限を設定する

ワークスペースの制限は、組織の制限より低く（ただし高くはできません）設定できます:

• 支出制限： ワークスペースの月間支出に上限を設定します。設定するには、Claude Consoleのワークスペースページ（platform.claude.com/settings/workspaces）に移動し、ワークスペースを選択します。開いたパネルで支出上限をクリックします。
• レート制限： 1分あたりのリクエスト数、1分あたりの入力トークン数、または1分あたりの出力トークン数を制限します。設定するには、Claude Consoleのレート制限に移動し、ワークスペースドロップダウンメニューからワークスペースを選択して、モデルの横にある編集をクリックします。

レート制限とその仕組みの詳細については、レート制限を参照してください。また、Rate Limits APIを使用すると、現在の組織およびワークスペースのレート制限をプログラムで読み取り、ワークスペースのレート制限を設定することもできます。このAPIでは組織の制限を超える値も保存されますが、実際には両者のうち低い方が適用されます。

使用状況とコストの追跡

Usage and Cost Analytics APIを使用して、ワークスペースごとに使用状況とコストを追跡します：

client = anthropic.Anthropic()

rows = client.beta.organization.analytics.usage.list(
    starting_at="2026-09-01T00:00:00Z",
    ending_at="2026-09-08T00:00:00Z",
    time_bucket_width="1d",
    workspace_ids=["wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"],
    group_by=["workspace_id"],
)

for row in rows:
    print(f"{row.starting_at} {row.group.workspace_id}: {row.usage.total_tokens}")

デフォルトワークスペースの使用状況とコストは、デフォルトワークスペース自体のIDで報告されます。

一般的なユースケース

環境の分離

開発、ステージング、本番用に別々のワークスペースを作成します:

チームまたは部門の分離

コスト配分とアクセス制御のために、異なるチームにワークスペースを割り当てます:

• 開発者アクセスを持つエンジニアリングチーム
• 独自のAPIキーを持つデータサイエンスチーム
• 顧客ツール用の限定アクセスを持つサポートチーム

プロジェクトベースの組織化

特定のプロジェクトや製品のワークスペースを作成して、使用状況とコストを個別に追跡します。

ベストプラクティス

1. 1

   ワークスペース構造を計画する

   作成する前に、ワークスペースをどのように整理するかを検討します。請求、アクセス制御、使用状況追跡のニーズについて考えます。

2. 2

   意味のある名前を使用する

   ワークスペースの目的を示すように明確に名前を付けます（たとえば、「Production - Customer Chatbot」や「Dev - Internal Tools」）。

3. 3

   適切な制限を設定する

   予期しないコストを防ぎ、公平なリソース分配を確保するために、支出制限とレート制限を設定します。

4. 4

   定期的にアクセスを監査する

   適切なユーザーのみがアクセスできるように、ワークスペースのメンバーシップを定期的に確認します。

5. 5

   使用状況を監視する

   Usage and Cost Analytics APIを使用して、ワークスペースレベルの消費量を追跡します。

よくある質問

関連項目

• Admin API
• Admin APIリファレンス
• レート制限
• Usage and Cost Analytics APIおよびレガシーのUsage and Cost API