ワークスペース

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

ワークスペースの仕組み

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

主な特徴：

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

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

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

ロールの継承

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

ワークスペースの管理

コンソール経由

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で作成されたスキル

ワークスペースの制限

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

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

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

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

レート制限とその仕組みの詳細については、レート制限を参照してください。

使用量とコストの追跡

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: $ADMIN_API_KEY"

デフォルトワークスペースに帰属する使用量とコストは、workspace_idにnull値を持ちます。

一般的なユースケース

環境の分離

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

チームまたは部門の分離

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

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

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

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

ベストプラクティス

FAQ

関連項目

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