ワークスペース

ワークスペース - Claude API Docs

ワークスペースは、組織内での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で組織の制限に対するその割り当て上限を設定できます。
ユーザーごとの月間支出制限をサポートする唯一のワークスペースです。

Claude Codeワークスペースをアーカイブすると、組織全体でConsole請求を通じたClaude Codeへのサインインが無効になります。

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

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

ロール	権限
Workspace User	Workbenchのみ使用可能
Workspace Limited Developer	APIキーの作成と管理、APIの使用。セッショントレースビューへのアクセスやファイルのダウンロードは不可。
Workspace Developer	APIキーの作成と管理、APIの使用
Workspace Admin	ワークスペースの設定とメンバーに対する完全な制御
Workspace Billing	ワークスペースの請求情報の閲覧（組織のbillingロールから継承）

ロールの継承

組織管理者は、すべてのワークスペースに対してWorkspace Adminアクセスを自動的に受け取ります
組織のbillingメンバーは、すべてのワークスペースに対してWorkspace Billingアクセスを自動的に受け取ります
組織のユーザーと開発者は、各ワークスペースに明示的に追加される必要があります

Workspace Billingロールは手動で割り当てることはできません。組織のbillingロールを持つことから継承されます。

ワークスペースの管理

ワークスペースを作成できるのは組織管理者のみです。組織のユーザーと開発者は、管理者によってワークスペースに追加される必要があります。

Consoleの使用

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

ワークスペースの作成

ワークスペース設定を開く
Claude Consoleで、Settings > Workspacesに移動します。
ワークスペースを作成する
Create workspaceをクリックします。
ワークスペースを設定する
ワークスペース名を入力し、視覚的に識別するための色を選択します。
ワークスペースを作成する
Createをクリックして確定します。

Consoleでワークスペースを切り替えるには、左上隅のWorkspacesセレクターを使用します。

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

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

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

デフォルトワークスペースの名前変更や削除はできません。

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

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

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

組織管理者とbillingメンバーは、それらの組織ロールを保持している間はワークスペースから削除できません。

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

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

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

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

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

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

ワークスペースをアーカイブすると、そのワークスペース内のすべてのAPIキーが即座に無効化されます。この操作は元に戻せません。Claude Codeワークスペースをアーカイブすると、組織のメンバーはConsole請求を通じてClaude Codeにサインインできなくなります。

Admin APIの使用

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

Admin APIエンドポイントには、標準のAPIキーとは異なるAdmin APIキー（sk-ant-admin...で始まる）が必要です。adminロールを持つ組織メンバーのみが、Claude Consoleを通じてAdmin APIキーをプロビジョニングできます。

cURL

# ワークスペースを作成
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

# ワークスペースにメンバーを追加
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を通じて管理されます。

プロンプトキャッシュも、Claude API、Claude Platform on AWS、およびMicrosoft Foundry（Claudeは現在ベータ版）ではワークスペースごとに分離されます。Amazon BedrockおよびVertex AIでは、プロンプトキャッシュは組織ごとに分離されます。

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

ワークスペースの制限

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

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

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

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

デフォルトワークスペースには制限を設定できません
設定されていない場合、ワークスペースの制限は組織の制限と一致します
ワークスペースの制限の合計がそれを超えていても、組織全体の制限は常に適用されます

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

使用量とコストの追跡

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

cURL

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キーを持つデータサイエンスチーム
顧客向けツールへの限定的なアクセスを持つサポートチーム

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

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

ベストプラクティス

ワークスペース構造を計画する
ワークスペースを作成する前に、どのように整理するかを検討してください。請求、アクセス制御、使用量追跡のニーズについて考えましょう。
意味のある名前を使用する
ワークスペースの目的が明確にわかるように名前を付けます（例：「Production - Customer Chatbot」、「Dev - Internal Tools」）。
適切な制限を設定する
予期しないコストを防ぎ、公平なリソース配分を確保するために、支出制限とレート制限を設定します。
定期的にアクセスを監査する
ワークスペースのメンバーシップを定期的に確認し、適切なユーザーのみがアクセスできるようにします。
使用量を監視する
Usage and Cost APIを使用して、ワークスペースレベルの消費量を追跡します。

ワークスペース

ワークスペース

ワークスペースの仕組み

Claude Codeワークスペース

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

ロールの継承

ワークスペースの管理

Consoleの使用

ワークスペースの作成

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

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

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

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

Admin APIの使用

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

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

ワークスペースの制限

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

使用量とコストの追跡

一般的なユースケース

環境の分離

チームまたは部門の分離

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

ベストプラクティス

FAQ

関連項目

ワークスペースの仕組み

Claude Codeワークスペース

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

ロールの継承

ワークスペースの管理

Consoleの使用

ワークスペースの作成

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

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

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

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

Admin APIの使用

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

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

ワークスペースの制限

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

使用量とコストの追跡

一般的なユースケース

環境の分離

チームまたは部門の分離

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

ベストプラクティス

FAQ

デフォルトワークスペースとは何ですか？

Claude Codeワークスペースとは何ですか？

ワークスペースに制限はありますか？

組織ロールはワークスペースアクセスにどのように影響しますか？

ワークスペースで割り当てられるロールはどれですか？

組織管理者またはbillingメンバーのワークスペースロールは変更できますか？

組織ロールが変更されると、ワークスペースアクセスはどうなりますか？

ユーザーがワークスペースから削除されると、APIキーはどうなりますか？

関連項目