Claude CodeをGoogle Cloud経由で使う設定|3つの変数

この記事の要点
- Google Cloud 経由の Claude には2種類ある。今回は Anthropic が運営する版(Claude Models on Google Cloud)の設定
- やることは Google へのログインと、設定ファイルに3つの変数を書くだけ。Anthropic のアカウントへのログインは要らない
- 高速モードやリモート操作など一部の機能は使えない。チームで使うなら管理設定とモデルの固定もセットで
会社が Google Cloud と契約していると、「AI の利用料もクラウドの請求にまとめたい」という声が出ます。Claude Code は、Google Cloud のプロジェクトを通して Claude のモデルを使えます。
ただし Google Cloud 経由の Claude には 2種類 あり、設定が違います。この記事では、公式ドキュメント「Claude Code with Claude Models on Google Cloud (Anthropic managed)」(2026年11月15日確認)にもとづいて、新しく加わった Anthropic が運営する版 の設定手順をまとめます。
結論:Google Cloud 経由の Claude は2種類ある
まず、自社がどちらを契約しているかを確かめます。 公式ドキュメントの説明を整理すると次のとおりです。
| 種類 | 運営しているのは | Claude Code の設定 |
|---|---|---|
| Claude Models on Google Cloud(Anthropic managed) | Anthropic | この記事の手順(CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD) |
| Agent Platform(旧 Vertex AI)の Claude | Claude Code Vertex AI設定 の手順 |
前者は、Anthropic が動かしている Claude API に、Google Cloud のプロジェクトを通して入る形です。認証は Google Cloud の仕組み(IAM)で行い、支払いは Google Cloud Marketplace にまとまります。
始める前にそろえる物
準備は4つです。 どれも Google Cloud 側の管理者と一緒に確かめると早く進みます。
- アカウントの準備を済ませた Google Cloud のプロジェクト
- Claude Code を動かす Google アカウント(またはサービスアカウント)ごとに、そのプロジェクトでの roles/claude.user の権限
- プロジェクトID と、wrkspc_ で始まる ワークスペースID
- Google アカウントでログインする場合は gcloud コマンド
Claude Code は v2.1.307 以降 が必要です。claude --version で確かめ、古ければ claude update で上げます。
設定の3ステップ
1. Google Cloud にログインする
自分の Google アカウントで使う場合は、次を実行して roles/claude.user を持つアカウントでログインします。すでに gcloud auth login 済みでも、この操作は別に必要です。
gcloud auth application-default login
自動実行(CI)ではサービスアカウントの鍵ファイルを使い、GOOGLE_APPLICATION_CREDENTIALS にその場所を入れます。逆に、自分のアカウントで使うときにこの変数が残っていると、そちらが優先されるので外しておきます。
2. 設定ファイルに3つの変数を書く
自分用の設定ファイル(ホームフォルダの .claude/settings.json)の env に、次の3つを書きます。値は自社のものに置き換えます。
{
"env": {
"CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD": "1",
"ANTHROPIC_GOOGLE_CLOUD_PROJECT": "my-project-id",
"ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID": "wrkspc_01ABCDEFGHIJKLMN"
}
}
Anthropic のアカウントにログインする必要はありません。 ログイン中でも、ログアウトしなくて大丈夫です。
3. 起動して確かめる
claude を起動し、/status を打ちます。「API provider」の行に on Google Cloud と出て、ワークスペースID・プロジェクト・場所が並べば成功です。最後に短い依頼を1つ送り、返事が来れば権限まで問題ありません。
主な環境変数
| 変数 | 必須 | 役割 |
|---|---|---|
| CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD | 必須 | 1 にすると、この経路でモデルを呼ぶ |
| ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID | 必須(下の BASE_URL を使う時を除く) | ワークスペースID |
| ANTHROPIC_GOOGLE_CLOUD_PROJECT | 推奨 | プロジェクトID。無いと GOOGLE_CLOUD_PROJECT を使う |
| ANTHROPIC_GOOGLE_CLOUD_LOCATION | 任意 | 場所。既定は global |
| ANTHROPIC_GOOGLE_CLOUD_BASE_URL | 任意 | 社内の中継(LLMゲートウェイ)を通すときの宛先 |
| CLAUDE_CODE_SKIP_ANTHROPIC_GOOGLE_CLOUD_AUTH | 任意 | 中継側が Google の認証を付けるときに 1 |
社内の中継を通す考え方は Claude CodeのLLMゲートウェイとは? で解説しています。
チームで使うときの2つのポイント
1つ目は、設定を管理設定で配ることです。 上の env を、各パソコンの管理設定(会社が配る設定ファイル)に入れます。権限は一人ずつに付け、各自が自分のパソコンでログインの操作をします。配り方は Claude Code の管理設定とは? にまとめています。
2つ目は、モデルの版を固定することです。 固定しないと、Claude Code を更新した日に全員が新しいモデルへ一斉に切り替わります。env に ANTHROPIC_DEFAULT_OPUS_MODEL・ANTHROPIC_DEFAULT_SONNET_MODEL などを足し、試した版の名前を書いておきます。
この経路で使えない主な機能
一部の機能は使えません。 公式ドキュメントが挙げている代表的なものです。
- 高速モード(/fast)
- リモート操作(Remote Control)とクラウドでの作業
- claude.ai でつないだ MCP コネクター
- チャンネル
- /design-sync と /import のコマンド
- サーバーから配る管理設定(各パソコンに置く管理設定は使える)
ほかの経路との比較は Claude Code の機能はどれで使える? で一覧にしています。
うまくいかないとき
| 表示・症状 | 直し方 |
|---|---|
| ログインを求められる/on Google Cloud と出ない | 変数が 1 か、版が 2.1.307 以上かを確認。Bedrock・Foundry・AWS 版の切り替え変数が残っていれば消す |
| No workspace ID found | ワークスペースIDの変数を入れて再起動 |
| No project was given | プロジェクトIDの変数を入れて再起動 |
| Could not load Google Cloud credentials | ステップ1のログインをやり直す |
| Google Cloud authentication failed | /status のプロジェクトとワークスペースIDが正しいか、権限(roles/claude.user)とサービス(claude.googleapis.com)が有効かを確認 |
変数を変えたら、Claude Code の再起動が必要です。
まとめ
- Google Cloud 経由の Claude は Anthropic 運営版 と Google 運営版(旧 Vertex AI) の2種類
- Anthropic 運営版は、Google へのログイン+3つの変数 で使える
- チームでは 管理設定で配り、モデルの版を固定 する
- 高速モードなど 使えない機能 があるので、事前に確認する
出典
- Claude Code 公式ドキュメント「Claude Code with Claude Models on Google Cloud (Anthropic managed)」
- Claude 公式ドキュメント「Claude Models on Google Cloud (Anthropic managed)」
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


