Google Cloud 上の Claude モデル（Anthropic 管理）で Claude Code を使用する

前提条件

• アカウントのセットアップが完了している Google Cloud プロジェクト
• Claude Code を実行する各 Google アカウントまたはサービスアカウントに対する、そのプロジェクトの roles/claude.user IAM ロール
• プロジェクト ID と、wrkspc_ で始まるワークスペース ID
• サービスアカウントキーファイルではなく Google アカウントでサインインする場合は、gcloud CLI

Claude Code をセットアップする

gcloud auth application-default login

{
  "env": {
    "CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD": "1",
    "ANTHROPIC_GOOGLE_CLOUD_PROJECT": "my-project-id",
    "ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID": "wrkspc_01ABCDEFGHIJKLMN"
  }
}

チーム向けに Claude Code をセットアップする

モデルバージョンを固定する

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

環境変数

利用できない Claude Code の機能

• Fast mode: /fast や fastMode 設定でオンにすることはできません
• Remote Control とクラウドセッション
• claude.ai の MCP コネクタ
• チャネル
• /design-sync コマンドと /import コマンド
• サーバー管理設定。チームに設定を強制するには、代わりに各マシンで管理設定を使用してください

トラブルシューティング

• CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD が 1 であることを確認します
• claude --version が 2.1.307 以降を出力することを確認します
• シェルと設定ファイルから CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_FOUNDRY、CLAUDE_CODE_USE_ANTHROPIC_AWS を削除します

No workspace ID found

No project was given

Could not load Google Cloud credentials

Google Cloud credentials expired or invalid

Google Cloud authentication failed

• プロジェクト: /status で、GCP project の行に自分のプロジェクトが表示されていることを確認します。別のプロジェクトが表示されている場合、またはその行がない場合は、No project was given の手順に従います
• ワークスペース: /status で、Workspace ID の行に自分のワークスペース ID が表示されていることを確認します。別の ID が表示されている場合は、No workspace ID found の手順に従います
• IAM ロール: Claude Code を実行する Google アカウントまたはサービスアカウントが、GCP project の行に表示されているプロジェクトで roles/claude.user または roles/claude.admin を持っていることを確認します。ロールを付与するには、サービスの付与コマンドを使用するか、プロジェクト管理者に付与を依頼してください
• サービス: GCP project の行に表示されているプロジェクトで claude.googleapis.com サービスが有効になっていることを確認します。有効にするには、サービスのアカウントセットアップ手順に従うか、プロジェクト管理者に有効化を依頼してください

関連リソース

• Google Cloud 上の Claude モデル（Anthropic 管理）: アカウントのセットアップ、IAM ロール、請求、データ保持、機能のサポート
• エンタープライズデプロイの概要: Claude Code を導入するその他の方法、およびプロキシとゲートウェイのセットアップ
• モデル設定: モデルエイリアス、モデルバージョンの固定、ユーザーが選択できるモデルの制限