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

公開 更新 著者 永上裕之導入とルール
雲の上の窓口を通って、パソコンのAIとクラウドがつながっているイメージ

この記事の要点

  • 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)の ClaudeGoogleClaude Code Vertex AI設定 の手順

前者は、Anthropic が動かしている Claude API に、Google Cloud のプロジェクトを通して入る形です。認証は Google Cloud の仕組み(IAM)で行い、支払いは Google Cloud Marketplace にまとまります。

始める前にそろえる物

準備は4つです。 どれも Google Cloud 側の管理者と一緒に確かめると早く進みます。

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 などを足し、試した版の名前を書いておきます。

この経路で使えない主な機能

一部の機能は使えません。 公式ドキュメントが挙げている代表的なものです。

ほかの経路との比較は 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 の再起動が必要です。

まとめ

出典

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事