「Workspace」(ワークスペース)は、組織内でのAPI使用を整理する方法を提供します。ワークスペースを使用すると、請求と管理を一元化したまま、異なるプロジェクト、環境、またはチームを分離できます。
すべての組織には、名前の変更、アーカイブ、削除ができないデフォルトワークスペースがあります。追加のワークスペースを作成すると、それぞれにAPIキー、メンバー、リソース制限を割り当てることができます。
主な特徴:
wrkspc_プレフィックスを使用します(例: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)組織のメンバーがClaude ConsoleアカウントでClaude Codeに初めてサインインすると、Anthropicは自動的に組織内にClaude Codeワークスペースを作成し、そのメンバーを追加します。その後Claude Codeにサインインするすべてのメンバーも同じ方法で追加されます。
Claude Codeワークスペースは、Claude Codeのトラフィックを他のAPIワークロードから分離します:
Claude Codeワークスペースをアーカイブすると、組織全体でConsole請求を通じたClaude Codeのサインインが無効になります。
メンバーは各ワークスペースで異なるロールを持つことができ、きめ細かなアクセス制御が可能です。
| ロール | 権限 |
|---|---|
| Workspace User | Anthropic Workbenchのみ使用可能 |
| Workspace Limited Developer | APIキーの作成と管理、APIの使用。セッショントレースビューへのアクセスやファイルのダウンロードは不可。 |
| Workspace Developer | APIキーの作成と管理、APIの使用 |
| Workspace Admin | ワークスペースの設定とメンバーに対する完全な制御 |
| Workspace Billing | ワークスペースの請求情報の表示(組織の請求ロールから継承) |
Workspace Billingロールは手動で割り当てることはできません。組織の請求ロールを持っていることから継承されます。
ワークスペースを作成できるのは組織管理者のみです。組織のユーザーと開発者は、管理者によってワークスペースに追加される必要があります。
Claude Consoleでワークスペースを作成および管理します。
ワークスペース設定を開く
Claude Consoleで、Settings > Workspacesに移動します。
ワークスペースを作成する
Create workspaceをクリックします。
ワークスペースを設定する
ワークスペース名を入力し、視覚的に識別するための色を選択します。
ワークスペースを作成する
Createをクリックして確定します。
Consoleでワークスペースを切り替えるには、左上隅のWorkspacesセレクターを使用します。
ワークスペースの名前や色を変更するには:
デフォルトワークスペースの名前変更や削除はできません。
メンバーを削除するには、名前の横にあるゴミ箱アイコンをクリックします。
組織管理者と請求メンバーは、それらの組織ロールを保持している間はワークスペースから削除できません。
Limitsタブでは、以下を設定できます:
ワークスペースをアーカイブするには、省略記号メニュー(...)をクリックしてArchiveを選択します。アーカイブすると:
ワークスペースをアーカイブすると、そのワークスペース内のすべてのAPIキーが直ちに失効します。この操作は元に戻せません。Claude Codeワークスペースをアーカイブすると、組織のメンバーはConsole請求を通じてClaude Codeにサインインできなくなります。
Admin APIを使用して、ワークスペースをプログラムで管理します。
Admin APIエンドポイントには、標準のAPIキーとは異なるAdmin APIキー(sk-ant-admin...で始まる)が必要です。プロビジョニング方法については、Admin APIキーの作成を参照してください。
# ワークスペースを作成
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{"name": "Production"}'
# ワークスペースを一覧表示
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
# ワークスペースをアーカイブ
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"パラメータの詳細とレスポンススキーマの完全な情報については、Workspaces APIリファレンスを参照してください。
ワークスペースのメンバーを追加、更新、または削除します:
# ワークスペースにメンバーを追加
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{
"user_id": "user_xxx",
"workspace_role": "workspace_developer"
}'
# メンバーのロールを更新
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{"workspace_role": "workspace_admin"}'
# ワークスペースからメンバーを削除
curl -X DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"パラメータの詳細については、Workspace Members APIリファレンスを参照してください。
APIキーは特定のワークスペースにスコープされます。ワークスペース内でAPIキーを作成すると、そのワークスペース内のリソースにのみアクセスできます。
ワークスペースにスコープされるリソースには以下が含まれます:
一部のリソースはワークスペースAPIキーでは管理できません:
workspace:manage_tunnels OAuthトークンで管理されます。トンネルはワークスペース内に作成され、ConsoleのMCP tunnelsリストとManaged Agentサーバーピッカーには現在のワークスペースのトンネルのみが表示されます。アクティブなトンネル10個の上限は組織全体に適用されます。トンネル管理にはトンネル管理権限を持つロールが必要です。組織の開発者は表示できますが、変更はできません。プロンプトキャッシュも、Claude API、Claude Platform on AWS、およびMicrosoft Foundryではワークスペースごとに分離されます。Amazon BedrockとGoogle Cloudでは、プロンプトキャッシュは組織ごとに分離されます。
組織のワークスペースIDを取得するには、List Workspacesエンドポイントを使用するか、Claude Consoleで確認してください。
各ワークスペースにカスタムの支出制限とレート制限を設定して、過剰な使用を防ぎ、公平なリソース配分を確保できます。
組織の制限より低い(ただし高くはない)ワークスペース制限を設定できます:
レート制限とその仕組みの詳細については、レート制限を参照してください。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"デフォルトワークスペースに帰属する使用量とコストは、workspace_idの値がnullになります。
開発、ステージング、本番用に個別のワークスペースを作成します:
| ワークスペース | 目的 |
|---|---|
| 開発 | 低いレート制限でのテストと実験 |
| ステージング | 本番に近い制限での本番前テスト |
| 本番 | 完全なレート制限と監視を備えた本番トラフィック |
コスト配分とアクセス制御のために、異なるチームにワークスペースを割り当てます:
特定のプロジェクトや製品用にワークスペースを作成し、使用量とコストを個別に追跡します。
ワークスペース構造を計画する
ワークスペースを作成する前に、どのように整理するかを検討してください。請求、アクセス制御、使用量追跡のニーズについて考えましょう。
意味のある名前を使用する
目的が分かるようにワークスペースに明確な名前を付けます(例: 「Production - Customer Chatbot」、「Dev - Internal Tools」)。
適切な制限を設定する
予期しないコストを防ぎ、公平なリソース配分を確保するために、支出制限とレート制限を設定します。
定期的にアクセスを監査する
適切なユーザーのみがアクセスできるように、ワークスペースのメンバーシップを定期的に確認します。
使用量を監視する
Usage and Cost APIを使用して、ワークスペースレベルの消費を追跡します。
Was this page helpful?