ワークスペース

「workspaces」（ワークスペース）は、組織内でのAPI使用を整理する手段を提供します。ワークスペースを使用すると、請求と管理を一元化したまま、異なるプロジェクト、環境、またはチームを分離できます。

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

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

主な特徴：

• ワークスペース識別子はwrkspc_プレフィックスを使用します（例：wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ）
• デフォルトでは組織あたり最大100個のワークスペース（アーカイブ済みのワークスペースはカウントされません）。さらに必要な場合はアカウントチームにお問い合わせください
• Default Workspaceは他のワークスペースと同様にwrkspc_ IDを持ちます（anthropic-workspace-idレスポンスヘッダーで返され、Get Workspaceで受け付けられます）が、List Workspacesの結果には表示されず、APIキー、使用量レポート、コストレポートではそのworkspace_idにnullが表示されます。これは全ワークスペース対象のAPIキーでも同様です（APIキーのscopeフィールドで両者を区別できます。Default Workspaceにバインドされたキーの場合、このフィールドには実際の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の使用量は個別にレート制限され、管理者はSettings > Workspacesで組織の制限に占める割合に上限を設定できます。
• ユーザーごとの月間支出制限をサポートする唯一のワークスペースです。

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

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

ロールの継承

• 組織管理者は、すべてのワークスペースに対するWorkspace Adminアクセスを自動的に受け取ります
• 組織の請求メンバーは、すべてのワークスペースに対するWorkspace Billingアクセスを自動的に受け取ります
• 組織のユーザーと開発者は、各ワークスペースに明示的に追加する必要があります
• サービスアカウントは、Settings → Service accountsのサービスアカウントのページ、またはワークスペースのService accountsタブからワークスペースに追加します

ワークスペースの管理

Consoleの使用

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

ワークスペースの作成

1. 1

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

   Claude Consoleで、Settings > Workspacesに移動します。

2. 2

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

   Create workspaceをクリックします。

3. 3

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

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

4. 4

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

   Createをクリックして確定します。

ワークスペースの詳細の編集

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

1. リストからワークスペースを選択します。
2. 省略記号メニュー（...）をクリックし、Edit detailsを選択します。
3. 名前または色を更新し、変更を保存します。

ワークスペースへのメンバーの追加

1. ワークスペースのMembersタブに移動します。
2. Add to Workspaceをクリックします。
3. 組織のメンバーを選択し、ワークスペースロールを割り当てます。
4. 追加を確認します。

メンバーを削除するには、名前の横にあるゴミ箱アイコンをクリックします。

ワークスペース制限の設定

各ワークスペースの設定では、これらが2つのタブに分かれています：

• レート制限： Rate limitsタブで、モデルティアごとに1分あたりのリクエスト数、入力トークン、または出力トークンの制限を設定します
• 支出制限： Spend limitsタブで、月間支出の上限を設定し、支出が特定のしきい値に達したときのアラートを設定します

ワークスペースのアーカイブ

ワークスペースをアーカイブするには、省略記号メニュー（...）をクリックし、Archiveを選択します。アーカイブすると：

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

Admin APIの使用

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

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

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

client = anthropic.Anthropic()

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

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

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

client = anthropic.Anthropic()

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

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

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

client = anthropic.Anthropic()

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

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

パラメータの詳細とレスポンススキーマの全容については、Workspaces APIリファレンスを参照してください。

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

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

client = anthropic.Anthropic()

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

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

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

client = anthropic.Anthropic()

member = client.beta.organization.workspaces.members.update(
    "user_01XyDMpzjS89pFZXqSFUBDr6",
    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.beta.organization.workspaces.members.remove(
    "user_01XyDMpzjS89pFZXqSFUBDr6",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
)

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

パラメータの詳細の全容については、Workspace Members APIリファレンスを参照してください。

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

すべてのリクエストは厳密に1つのワークスペースで実行され、そのワークスペース内のリソースにのみアクセスできます。どのワークスペースになるかはキーの種類によって決まります：

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

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

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

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

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

組織のワークスペースIDを調べるには、List Workspacesエンドポイントを呼び出すか、Claude Consoleで確認してください。

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

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

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",
    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 APIレポートや、APIキーなどのAdmin APIオブジェクトのworkspace_idフィールドと照合する（どちらもDefault Workspaceに対してはnullを報告し、APIキーは全ワークスペース対象のキーに対しても同様にnullを報告します。APIキーのscopeフィールドで両者を区別でき、1つのワークスペースにバインドされたキーの場合はそのワークスペースの実際のIDが含まれます）
• Admin APIキーを使用してGet Workspaceに渡すことで、それがDefault WorkspaceのIDかどうかを確認する。List Workspacesでは省略されますが、Default Workspaceは"name": "Default"として返されます
• Consoleでそのワークスペースを開き、セッション、ファイル、メッセージバッチ、スキルなど、リクエストのリソースを見つける

ワークスペース制限

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

ワークスペース制限の設定

ワークスペース制限は、組織の制限より低く設定できます（高く設定することはできません）：

• 支出制限： ワークスペースの月間支出に上限を設定します。Claude ConsoleのワークスペースのSpend limits設定タブで設定します。
• レート制限： 1分あたりのリクエスト数、1分あたりの入力トークン数、または1分あたりの出力トークン数を制限します。Claude ConsoleのワークスペースのRate limits設定タブで設定します。

レート制限とその仕組みの詳細については、レート制限を参照してください。また、Rate Limits APIを使用して、現在の組織およびワークスペースのレート制限をプログラムで読み取ることもできます。

使用量とコストの追跡

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

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Default Workspaceに帰属する使用量とコストは、workspace_idの値がnullになります。

一般的なユースケース

環境の分離

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

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

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

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

プロジェクトベースの整理

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

ベストプラクティス

1. 1

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

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

2. 2

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

   目的が明確にわかるようにワークスペースに名前を付けてください（例：「Production - Customer Chatbot」や「Dev - Internal Tools」）。

3. 3

   適切な制限を設定する

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

4. 4

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

   ワークスペースのメンバーシップを定期的に見直し、適切なユーザーのみがアクセスできるようにしてください。

5. 5

   使用量を監視する

   Usage and Cost APIを使用して、ワークスペースレベルの消費量を追跡してください。

FAQ

関連項目

• Admin API
• Admin APIリファレンス
• レート制限
• Usage and Cost API