/setup-vertex

勤務先のGoogle Cloud経由でClaude Codeを使う人向け

会社のGoogle Cloud経由でClaude Codeを動かしたいとき、認証・どのプロジェクトを使うか・どの地域のサーバーを使うか・どのClaudeモデルに固定するか、を順番に質問してくれる対話セットアップ。それが /setup-vertex です。Anthropicに直接お金を払うのではなく、勤務先がすでに契約しているGoogle Cloud（GCP）の課金枠でClaude Codeを使う人のためのコマンドだと思ってください。

地味だけど、これが無いと設定値を手で1個ずつ並べる羽目になります。

噛み砕くと

新しい職場に入った初日、総務の人が「うちのアカウントはこれ、座席はここ、社内システムのログインはこの方法ね」と一通り案内してくれますよね。/setup-vertex はそのGoogle Cloud版の案内係です。「どの方法でログインする？」「あなたのプロジェクトはこれで合ってる？」「この地域のサーバーを使う？」「呼べるClaudeはこれ、固定する？」を画面の質問に答えるだけで埋めてくれます。

答えた結果は設定ファイルに自分で書き込まれるので、こちらが設定値を手打ちで覚えておく必要はありません。

大事な前提：このコマンドは普通のコマンド一覧には出てこない

/setup-vertex は、CLAUDE_CODE_USE_VERTEX=1 という設定値が入っているときだけコマンド一覧に現れます。まだVertex AIを一度も使っていない初回は、claude を起動した直後のログイン画面から 3rd-party platform（外部サービス経由でログイン）→ Google Vertex AI の順に選ぶと、同じ案内係に入れます。「コマンド一覧に無い」と慌てる前に、まずここを思い出してください。

「料理ブログ」を例に、実際の手順を見る

勤務先のGoogle Cloud経由で、料理ブログのサイトをClaude Codeに手伝ってもらいながら作る、という想定で順番に追います。Google Cloud側の準備（後述）が済んでいる前提です。

ステップ1: Claude Codeのバージョンを確認する

この案内係はある程度新しいClaude Codeにしか入っていません。公式が v2.1.98以上を要求しているので、まず手元のバージョンを見ます。

$ claude --version

表示された数字が 2.1.98 より小さければ、先に更新します。ここで初心者がやりがちな勘違いがあって、「コマンド一覧に /setup-vertex が無い＝バグ」と思い込むケース。古いと案内係そのものが存在しません。

ステップ2: 初回はログイン画面から入る

まだVertex AIを使ったことがないなら、素直に起動します。

$ claude

ログインを聞かれたら 3rd-party platform を選び、続けて Google Vertex AI を選びます。これで案内係が立ち上がります。

ステップ3: ログイン方法を選ぶ

最初に「Google Cloudへのログインをどうやる？」を3つの中から選びます。gcloud に入っているApplication Default Credentials、サービスアカウントのキーファイル、すでにこのパソコンの設定に入っている認証情報、の3択です。社内マニュアルに「これを使え」と書かれているはずなので、それに合わせます。

ステップ4: プロジェクトと地域の確認、モデルの固定

ここから先は画面の質問に沿って進む一続きの流れです。案内係があなたのプロジェクトと地域を自動で見つけ、そのプロジェクトで呼べるClaudeモデルを確かめ、使うモデルを固定（pin）させてくれます。料理ブログなら「Claude Sonnet 4.6に固定」のように選ぶイメージです。モデルを固定する場面では、長文をまとめて扱える1M（100万）の大きな枠を選ぶ選択肢も出ます。

ステップ5: 設定が自動で書き込まれる

選び終えると、結果はユーザー設定ファイルの env 欄に保存されます。つまり、こちらが設定値を手で並べて覚えておく作業は不要です。ここが手作業との一番大きな差です。

ステップ6: 後から変えたくなったら、また叩く

一度サインインした後は、CLAUDE_CODE_USE_VERTEX=1 が入った状態でいつでも /setup-vertex を叩けます。料理ブログ用から経理用のプロジェクトに切り替えたい、地域を変えたい、固定するモデルを変えたい、そんなときに同じ案内係が開きます。

つまり /setup-vertex は何をしてくれるのか

• やってくれる: Claude Code側のログイン・プロジェクト・地域・モデル固定を質問形式で埋め、設定ファイルへ自動保存する
• やってくれない: Google Cloud側の準備（後述の課金・API有効化・モデルへのアクセス申請・権限・利用枠）は肩代わりしない
• 意味が薄い場面: Anthropicに直接サブスク契約してClaude Codeを使っている人。Google Cloud経由ではないので、このコマンドはそもそも出てきません

使いどころ3シナリオ（具体題材で再現）

シナリオ1: 会社のGoogle Cloudで料理ブログ開発を始める初日

勤務先がGoogle Cloudで一括課金していて、個人サブスクは使わない方針。料理レシピを載せるサイトを作る最初の日に、まず claude を起動してログイン画面から案内係に入り、ログイン方法・プロジェクト・地域・モデルを一気に決めます。ここを通しておかないと、後の開発作業がそもそも認証で止まります。

シナリオ2: 料理ブログ用から在庫管理アプリ用のプロジェクトに切り替える

同じ会社の中で、料理ブログ用のプロジェクトと在庫管理アプリ用のプロジェクトが別々に切られているケース。在庫管理側の作業に移るとき、/setup-vertex をもう一度叩いて、使うプロジェクトと地域を在庫管理用に差し替えます。課金の付け先がプロジェクトごとに変わるので、ここを間違えると別の部署の枠を食ってしまいます。

シナリオ3: 固定するClaudeモデルを新しいものに上げたい

料理ブログのレシピ生成で、もっと新しいClaudeモデルを試したくなったとき。/setup-vertex を叩き直して、案内係に「このプロジェクトで呼べるモデル」を再確認させ、固定先を新しいモデルに変えます。長いレシピ集をまとめて読ませたいなら、このタイミングで1Mの大きな枠を選ぶ手もあります。

初心者が踏みやすい落とし穴

• コマンド一覧に出てこなくて焦る。CLAUDE_CODE_USE_VERTEX=1 が入っていないと現れません。初回はログイン画面の 3rd-party platform → Google Vertex AI から入ります。
• 古いClaude Codeで案内係ごと存在しない。公式はv2.1.98以上を要求しています。claude --version で先に確認してください。
• Google Cloud側の準備までやってくれると思い込む。課金の有効化・Vertex AI APIの有効化・Model Gardenでのモデルアクセス申請・権限・利用枠は、すべてGoogle Cloud側で別途やる必要があります。
• 初回専用だと勘違いする。サインイン後も、ログイン情報・プロジェクト・地域・モデル固定を変えたいときにいつでも叩けます。
• AWS版の /setup-bedrock と混同する。あちらはAmazon Web Services経由用で、CLAUDE_CODE_USE_BEDROCK=1 のときに出る別コマンドです。Vertex版には「プロジェクト」の設定が加わるのが違い。
• プロジェクトの取り違えで別部署の課金枠を使う。Google Cloudの前提はプロジェクトごとに1回ずつ。どのプロジェクトを選んでいるかは毎回確認するクセをつけてください。
• 設定値を自分でも手打ちしてしまう。案内係が設定ファイルの env 欄へ自動保存するので、二重に手で並べると食い違いの元になります。

書き方

/setup-vertex

やってみるとこうなる

入力

/setup-vertex

出力例

ログイン方法を3つ（gcloudの共通ログイン情報／サービスアカウントのキーファイル／既に入っている認証情報）から選ぶ画面が開き、続けてプロジェクトと地域の確認、呼べるClaudeモデルの確認と固定、と一続きで進む。選んだ結果はユーザー設定ファイルの env 欄に自動保存される

関連項目

• /setup-bedrock（セットアップベッドロック）
• /model（モデル）
• settings.json（セッティングス・ジェイソン）
• /login（ログイン）

公式ドキュメント

https://code.claude.com/docs/en/google-vertex-ai#sign-in-with-vertex-ai