Claude Media
Claude APIでWorkspace単位のレート制限を設定する手順
Anthropicチュートリアル

Claude APIでWorkspace単位のレート制限を設定する手順

Claude ConsoleでWorkspaceごとにAPIレート制限を組織全体の上限より低く絞る設定手順と、Default Workspaceが対象外になる等の制約を解説します。

読了目安 約9分

はじめに — Workspace単位のレート制限で何ができるか

Claude APIのレート制限は組織(Organization)単位で決まりますが、Workspaceごとに組織の上限より低い独自のレート制限を設定できます。複数のチームやプロジェクトが同じ組織のAPIキーを共有している場合、1つのWorkspaceが暴走してトークンを使い切り、他のWorkspaceのリクエストが巻き添えで詰まる事態を防げます。

前提として、Workspaceの作成・編集はOrganization管理者(admin)権限が必要です。開発者(developer)やユーザーロールのメンバーはWorkspace内でAPIキーを発行・使用できますが、レート制限自体の設定はできません。ロールの継承関係やAPIキーのスコープの詳細はClaude Workspacesのロール継承とAPIキーのスコープで扱っています。

ステップ1: Workspaceを開く

Claude Consoleにサインインし、Settings > Workspacesに移動します。すでにあるWorkspaceの一覧が表示されるので、レート制限を設定したいWorkspaceを選択します。まだWorkspaceが無い場合はCreate workspaceから作成します(名前と識別用のカラーを設定するだけの単純な手順です)。

Claude Console → Settings → Workspaces → 対象のWorkspaceを選択

Claude Codeを組織で使っている場合、メンバーが初めてConsoleアカウントでサインインした時点でClaude Code workspaceが自動作成されます。このWorkspaceはClaude Codeのトラフィックを他のAPI利用と分離する専用枠で、レート制限も別枠で管理されます。管理者は同じSettings > Workspacesから、Claude Code workspaceの利用が組織全体の上限に対してどれだけ使えるかを制限できます。

ステップ2: Rate limitsタブで制限値を設定する

Workspace設定はRate limitsタブとSpend limitsタブの2つに分かれています。レート制限を設定するのは前者です。

Rate limitsタブでは、モデルティア(Opus 5 / Sonnet 5 / Haiku 4.5などのグループ)ごとに、以下3種類の上限を個別に設定できます。

  • リクエスト数/分(RPM)
  • 入力トークン数/分(ITPM)
  • 出力トークン数/分(OTPM)

たとえば組織全体の上限が入力トークン500万トークン/分・出力トークン100万トークン/分だとして、1つのWorkspaceを入力トークン300万トークン/分に制限したとします。組織全体の上限が常に優先されるため、Workspace側の設定値の合計が組織の上限を超えていても、実際に使えるのは組織の上限までです。

ステップ3: 制限が反映されたことを確認する

設定を保存したら、そのWorkspaceのAPIキーで実際にリクエストを送り、レスポンスヘッダーの anthropic-ratelimit-tokens-limit の値が新しい設定値になっているかを確認します。

curl -sD - https://api.anthropic.com/v1/messages \
  -H "x-api-key: $WORKSPACE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":100,"messages":[{"role":"user","content":"hi"}]}' \
  -o /dev/null | grep -i "anthropic-ratelimit\|anthropic-workspace-id"

anthropic-workspace-id ヘッダーで、リクエストが意図したWorkspaceに紐づいているかも合わせて確認できます。このヘッダーはAPIキーやアクセストークンが実際に解決されたWorkspaceのIDを返すため、複数Workspaceにまたがるキーを使っている場合に「想定と違うWorkspaceの制限が効いている」ことに気づく手がかりになります。なお認証が完了する前に失敗したリクエスト(401エラーなど)では、このヘッダー自体が返りません。プログラムから設定値を確認したい場合は、Admin API配下のRate Limits API(/v1/organizations/workspaces/{workspace_id}/rate_limits)で読み取れます。ただしこのAPIは読み取り専用で、設定変更はConsoleのRate limitsタブからしかできません。Admin APIキーまたは org:admin スコープのOAuthトークンが必要で、Workspace個別のAPIキーではこのエンドポイントを呼び出せません。Admin APIでWorkspace自体の作成・メンバー管理まで自動化したい場合はClaude Admin APIでワークスペース管理を実装するを参照してください。

どんな分割にレート制限を組み合わせるか

Workspace自体は用途を問わず作れますが、レート制限を絞る価値が特に大きいのは次のような分割です。

分割パターンWorkspace例レート制限の絞り方
環境分離Workspace例Development / Staging / Productionレート制限の絞り方Developmentは低めのRPM・ITPMに絞り、実験的なコードが本番の枠を圧迫しないようにする。Stagingは本番相当の値に近づけ、Productionはフル上限のまま監視を厚くする
チーム・部門分離Workspace例Engineering / Data Science / Supportレート制限の絞り方部門ごとにコスト按分とアクセス制御を分けたうえで、サポートチームのような限定的な用途には低めのITPM/OTPMを設定する
プロジェクト単位Workspace例製品・案件ごとのWorkspaceレート制限の絞り方利用量とコストを個別に追跡したいときに分割し、想定トラフィックに応じてレート制限を設定する

開発環境のWorkspaceに低いレート制限をかけておくと、テストコードの無限ループやバグによる大量リクエストが、本番用Workspaceの枠を消費する事故を未然に防げます。Workspace名は「Production - Customer Chatbot」のように用途が一目で分かる形にしておくと、後から制限値を見直す際に迷いません。

よくあるつまずき

  • Default Workspaceに制限を設定しようとしてタブが無い: Default Workspaceにはレート制限の上書きを設定できません。組織の上限をそのまま使う専用の枠として扱われています。個別に絞りたい場合は、対象のトラフィックを別のWorkspaceへ移す必要があります
  • 設定したのに制限が効いていないように見える: リミッタータイプ(RPM / ITPM / OTPM)ごとに個別設定なので、たとえばITPMだけ設定してRPMを設定し忘れると、RPM側は組織の上限のまま動きます。3種類とも意図通りに設定されているか確認します
  • Workspace制限の合計が組織の上限を超えている: 複数のWorkspaceに設定した制限の合計が組織全体の上限を超えていても、組織全体の上限は常に優先されます。個々のWorkspaceの表示上の数値だけを見て「合計でこれだけ使える」と誤認しないよう注意します
  • Claude Code workspaceの制限を他のWorkspaceと同じ感覚で設定する: Claude Code workspaceはユーザーごとの月間支出上限に対応する唯一のWorkspaceです。チーム単位ではなく個人単位でコストを抑えたい場合は、Spend limitsタブの月間上限機能も併用します

運用を続けるうえでのベストプラクティス

Workspace構造とレート制限は一度作って終わりではなく、継続的な見直しが前提です。公式ドキュメントが挙げるベストプラクティスをレート制限の文脈に落とすと、次の5点になります。

  1. Workspace構造を先に設計する: 課金・アクセス制御・利用状況の追跡という3つの観点を先に決めてから作成する。後から分割し直すとAPIキーの再発行やメンバーの付け替えが発生する
  2. 命名規則を統一する: 「Production - Customer Chatbot」のように用途が分かる名前にしておくと、レート制限の見直し時にどのWorkspaceを優先すべきか判断しやすい
  3. 適切な制限値を設定する: 想定外のコストと不公平な資源配分を防ぐため、Rate limitsタブとSpend limitsタブの両方を組み合わせて設定する
  4. アクセス権限を定期的に監査する: メンバーシップを定期的に見直し、不要なアクセス権を持つメンバーがいないか確認する
  5. 利用状況を監視する: Workspace単位の消費量はUsage and Cost APIで追跡できる。レート制限に頻繁に当たっているWorkspaceが分かれば、制限値の引き上げかキャッシュ活用による効率化かを判断する材料になる

Claude Code workspaceのように自動生成されるWorkspaceも、この見直しサイクルの対象に含めます。組織のメンバーが増えるたびにこのWorkspaceの実利用量も増えるため、他のプロジェクト用Workspaceを圧迫していないかを定期的に確認する価値があります。

まとめ

Workspace単位のレート制限は、Claude ConsoleのSettings > Workspaces → 対象Workspace → Rate limitsタブから、モデルティアごとにRPM・ITPM・OTPMを個別設定します。Default Workspaceには設定できず、未設定のWorkspaceは組織の上限をそのまま継承し、組織全体の上限は個々のWorkspace設定の合計に関わらず常に優先されます。

設定後は anthropic-ratelimit-tokens-limit ヘッダーか、読み取り専用のRate Limits APIで反映を確認します。設定変更そのものはConsole上でしかできませんが、反映確認だけはAPI経由に置き換えられます。

複数チームで1つの組織のAPIキーを共有している場合、この設定を入れておくことで、1チームの利用急増が他チームのリクエストを巻き添えにする事態を未然に防げます。開発・ステージング・本番のように環境ごとにWorkspaceを分けている組織では、開発環境の制限を低めに保つことが、事故を未然に防ぐ最も費用対効果の高い設定です。

この記事を共有:XはてブLinkedIn

関連する記事

Anthropic をもっと見る →