Infrastructure

Vertex AIのClaudeが404になる本当の理由

新しいGCPプロジェクトでVertex AIのClaudeを呼んだら、設定は正しいのに全部404。原因はプロジェクトごとの規約承諾で、モデル名と認証情報は合っていました。同じ文面でも原因が違う404の、見分け方を書きます。

2026.10.11 公開読むのに約 7分約 4,400字
この記事の内容
  1. モデル名の間違いに見える404
  2. 見えることと呼べることの違い
  3. 関門はModel Gardenの規約承諾
  4. 押しても直らない2つのボタン
  5. メタデータにある有効化のリンク
  6. プロジェクトとモデルごとの承諾
  7. 反映の途中に起きる成功と失敗の混在
  8. 404と429の区別
  9. 疎通チェック

新しいGCPプロジェクトを立てて、Vertex AI経由でClaudeを呼び出したところ、どの呼び出しも404が返ってきました。設定は何度見ても正しく、認証情報もリージョンもモデル名も合っています。エラーメッセージは「指定したモデルが見つからないか、プロジェクトにアクセス権がない」と読めます。最初はモデル名の打ち間違いを疑いましたが、違いました。Vertexで動かすClaudeは、プロジェクトごとにModel Gardenで規約の承諾を通す必要があります。これを通していないと、設定が完璧でも404が返り続けます。新しいプロジェクトでいきなり404が出たときは、モデル名より先にModel Gardenの承諾状況を確かめるのが近道でした。

モデル名の間違いに見える404

Vertex経由のClaudeで404が返ると、たいていはモデル名の打ち間違いを疑いますが、今回はモデル名が合っていても404が返り続けました。

この404では、エラーメッセージに判断を引っ張られました。返ってくるのは「Publisher model ... was not found or your project does not have access to it」で、モデル名の打ち間違いにも読めます。ところが、まったく同じモデル名が、許諾済みの別プロジェクトでは200で通ります。私たちも一度、claude-sonnet-4-6を存在しないモデル名だと誤診しましたが、許諾済みのプロジェクトで叩くと200が返りました。モデル名が原因でもプロジェクトの許諾が原因でもメッセージは同じなので、文面では区別できません。許諾済みの別プロジェクトから同じリクエストを送って200が返れば、モデル名は正しく、問題はプロジェクト側にあると切り分けられます。

見えることと呼べることの違い

モデルの情報を取得するGET(.../publisherModels/claude-opus-5)は、承諾していないプロジェクトでも、承諾済みのプロジェクトと同一のメタデータを返します。モデルの一覧や仕様まで取れるのでアクセス権があるように見えますが、同じプロジェクトで生成APIを呼ぶと404のままでした。メタデータが取れたことに安心して、呼び出しの404を設定ミスだと考えると、正しい設定を何度も見直すはめになります。いまは呼べるかどうかを、生成のリクエストを一度送って確かめています。

関門はModel Gardenの規約承諾

許諾そのものは、ログとウェブ検索に関する同意をModel Gardenの画面で一度クリックするだけです。しかしこの承諾をAPIから通す方法は見つかりませんでした。承諾用に見えるcheckPublisherModelEulaAcceptanceとacceptPublisherModelEulaはどちらも404のHTMLを返し、gcloud ai model-garden modelsにもGAのサブコマンドがありません。Marketplaceの注文としても出てこず、請求先アカウントの注文数は0でした。会社としての意思表示にあたるので自動化はせず、代表に上げて中身を読んだうえでConsoleからクリックしてもらっています。承諾が済むまではglobalとus-east5のどちらに投げても404でした。急ぐときはCLOUD_ML_REGION=us-east5を指定すれば先に揃いますが、リージョンは1つしか指定できないので全モデルがus-east5へ移ります。20分ほど待てば安定するので、ふだんは待っています。

押しても直らない2つのボタン

Model Gardenの「Vertex AI APIを有効にする」ボタンと、gcloud services enable anthropic-904.cloudpartnerservices.goog の2つは、試しても何も変わりませんでした。ボタンを押すと周辺のAPIが14本ほど一緒に有効になりますが、肝心のAnthropic関連は監査ログに1件も残りません。コマンドのほうは実行自体は成功するものの、Claudeの呼び出しには関係しませんでした。両方のプロジェクトで gcloud services list --enabled を突き合わせると、動いているプロジェクトではこのサービスが有効になっていませんでした。「有効にした」と言われても404のままなら、まず2つのenableを疑って、監査ログで本当に効いたかを確認します。

メタデータにある有効化のリンク

有効化のためのURLは、モデルのメタデータの supportedActions.requestAccess.references.global.uri に入っていました。推測で組み立てなくても、どのモデルのどの承諾画面へ行けばいいかがメタデータで分かります。URLの mp= に入るパートナーIDは claude-opus-5 が anthropic-904、claude-sonnet-4-6 が anthropic-884 と違っていて、手で組むと別のモデルの承諾画面を開きかねません。

プロジェクトとモデルごとの承諾

承諾はプロジェクトごとに要るうえ、同じプロジェクトの中でもモデルごとに分かれています。大きいモデルを承諾しても、小さいモデルには別の承諾画面があり、通していなければ404のままです。主に使うモデル1本だけを叩くチェックでは、小さいモデルの承諾漏れがあっても緑になります。設定に並んでいるモデルを全部叩いて、どれか1つでも404なら落とすチェックにしておけば、承諾漏れが見つかります。

404を見たら確かめること
許諾済みの別プロジェクトで同じ呼び出し200ならモデル名は正しく、プロジェクト側の問題
404か、429(クォータゼロ)か429はクォータゼロの状態で、承諾とは原因が違う
使うモデルを全部叩く1本だけだと、モデルごとの承諾漏れを見逃す
同じ呼び出しを何度か叩く一部だけ成功なら、承諾済みで反映の途中
エラーメッセージが同じでも原因は複数あるので、表の上から順に1つずつ確かめます。

反映の途中に起きる成功と失敗の混在

承諾した直後に同じ呼び出しが成功したり失敗したりして戸惑いましたが、これは承諾がリージョンごとに順に反映されるためです。複数のリージョンへ振り分けるglobalエンドポイントでは、承諾直後に200が7回、404が8回と、反映済みのリージョンとまだのリージョンが混ざる間は約50% の確率で落ちました。約20分後には20回すべて200が返っています。ここで「1回叩いて404だから未承諾」と判断すると、押したばかりの承諾ボタンをもう一度押すよう促すことになってしまいます。そこで何度か叩いて、全部通れば合格、一部だけ通れば反映の途中、全部失敗なら未承諾、と分けるようにしました。

承諾直後のエンドポイント結果
us-east5(単一リージョン)最初から安定して200
global(複数リージョンに振り分け)最初は約50%で失敗、20分ほどで安定
まだ反映されていないリージョン404が続く
us-east5は承諾の直後から200が返り、globalだけが20分ほど成功と失敗を繰り返しました。

404と429の区別

自分がやった誤診もあります。あるとき404を見て「許諾が切れた」と早合点しましたが、実際には許諾は生きていて、原因は互いに関係のない3つでした。リージョン側は9回中9回が429で、online_prediction_input_tokens_per_minute_per_base_model のクォータがゼロのために止まっており、承諾とは関係のない、404とは別の状態です。global の404は、CLIがリージョン名から機械的に組んだ、実在しないホスト global-aiplatform.googleapis.com 宛てだったのが原因で、正しくは接頭辞なしの aiplatform.googleapis.com でした。ステータスコードを「どれも通らない」とひとまとめにすると原因を取り違えるため、エンドポイントごとに404と429を分けて記録し、ホスト名の誤りも含めて1件ずつ原因を確かめました。

3つ目は、同じバイト列のリクエストが同じ404を返し続けることでした。CLIの実際のリクエスト(77KB)は10回中10回が404で、同じJSONの空白の入れ方だけを変えると、10回とも200が返りました。CLIが出す「このモデルは使えません。管理者に有効化を頼んでください」という表示も、中身はただの HTTP 404 の言い換えで、権限も課金も関係ありませんでした。

疎通チェック

この一件のあと、基盤のチェックを一つ足しました。それまでのfacts_check.shは環境変数にCLAUDE_CODE_USE_VERTEX=1とプロジェクト名が入っているのを見て○を出すだけで、呼び出しが1本も通らない間も○のままでした。足したのはvertex_check.pyです。settings.jsonのうちclaudeで始まる値を全部拾い、主モデルのclaude-opus-5もANTHROPIC_SMALL_FAST_MODELに入れたclaude-sonnet-4-6も、rawPredictにmax_tokensを1にしたいちばん短いリクエストで実際に叩き、200が返るかを見る疎通チェックです。

判定には、反映の途中の節で定義した3つの分け方をそのまま使います。モデルごとに5回叩いて、一部だけ通ったときは「反映の途中、押し直し不要」と表示して待機し、全部404のときだけ承諾のリンクを出すようにしました。これで承諾漏れを、モデル名の間違いや反映の途中と取り違えることがなくなりました。なお、設定の確認とは別枠で定期的に回す決まりにしています。

この躓きは新しいGCPプロジェクトを立てて初めてVertexのClaudeを使うたびに必ず一度は発生します。一度通せばそのプロジェクトでは出ませんが、プロジェクトを増やせばまたモデルごとの承諾からやり直しになります。

最初の一回で手順を知っておけば、次に設定は合っているのに呼び出しが全部404になっても、モデル名や認証情報を無駄に疑わずに切り分けられます。以後のプロジェクトにもこの疎通チェックは必ず入れることにしました。常駐の処理を戻すresume_after_vertex.shも、設定の値は見ずに実際に叩いて200が返ったことを条件にしています。足したチェックは1本だけですが、承諾漏れがあれば本番より先にこのチェックで落ちるようになりました。

最後に宣伝です。弊社がAIをお客様の業務に組み込むときも、つながっている前提では進めず、実際に1回呼んで200が返ってきた結果で判断しています。