ワークスペース

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

ワークスペースの仕組み

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

主な特性：

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

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

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

ロール継承

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

ワークスペースの管理

Claude 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 Files API経由で作成
• Message Batches Batch API経由で作成
• Skills 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