搭配 Google Cloud 上的 Claude 模型（由 Anthropic 管理）使用 Claude Code

先決條件

• 一個已完成帳戶設定的 Google Cloud 專案
• 每個執行 Claude Code 的 Google 帳戶或服務帳戶，都需在該專案上具備 roles/claude.user IAM 角色
• 您的專案 ID 以及以 wrkspc_ 開頭的工作區 ID
• gcloud CLI，如果您是以 Google 帳戶登入，而非使用服務帳戶金鑰檔案

設定 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 或 fastMode 設定將其開啟
• Remote Control 與雲端工作階段
• 來自 claude.ai 的 MCP 連接器
• 頻道
• /design-sync 與 /import 命令
• 伺服器管理設定。若要為您的團隊強制套用設定，請改為在每台電腦上使用受管設定

疑難排解

• 確認 CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD 為 1
• 確認 claude --version 輸出 2.1.307 或更新版本
• 從您的 shell 與設定檔中移除 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 的其他方式，以及代理伺服器與閘道設定
• 模型設定：模型別名、固定模型版本，以及限制使用者可選擇的模型