ワークスペース

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



ワークスペースの仕組み

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

主な特徴：

• ワークスペース識別子は wrkspc_ プレフィックスを使用します（例：wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ）
• 組織ごとに最大100個のワークスペース（アーカイブされたワークスペースはカウントされません）
• デフォルトワークスペースにはIDがなく、リストエンドポイントには表示されません
• APIキーは単一のワークスペースにスコープされ、そのワークスペース内のリソースにのみアクセスできます



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アクセスを自動的に受け取ります
• 組織のユーザーと開発者は、各ワークスペースに明示的に追加される必要があります



ワークスペースの管理



Consoleの使用

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



ワークスペースの作成



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

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

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



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

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

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



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

Limitsタブでは、以下を設定できます：

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



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

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

• レポート用に履歴データが保持されます
• ワークスペースと関連するすべてのAPIキーが無効化されます
• 元に戻すことはできません



Admin APIの使用

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

# ワークスペースを作成
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# ワークスペースを一覧表示
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# ワークスペースをアーカイブ
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

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



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

ワークスペースのメンバーを追加、更新、または削除します：

# ワークスペースにメンバーを追加
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# メンバーのロールを更新
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"workspace_role": "workspace_admin"}'

# ワークスペースからメンバーを削除
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

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



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

APIキーは特定のワークスペースにスコープされます。ワークスペースでAPIキーを作成すると、そのワークスペース内のリソースにのみアクセスできます。

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

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

一部のリソースは組織レベルで管理され、ワークスペースAPIキーでは管理できません：

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



ワークスペースの制限

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



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

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

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

レート制限とその仕組みの詳細については、レート制限を参照してください。また、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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

デフォルトワークスペースに帰属する使用量とコストは、workspace_idの値がnullになります。



一般的なユースケース



環境の分離

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



チームまたは部門の分離

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

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



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

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



ベストプラクティス



FAQ



関連項目

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