【Bug已解决】Unable to Use Claude 3.5 Sonet Model on Vertex AI - Error 400: Project Not Allowed 解决方案

【Bug已解决】Unable to Use Claude 3.5 Sonet Model on Vertex AI - Error 400: Project Not Allowed 解决方案一、现象长什么样你在 Google Cloud 的 Vertex AI 上调用 Claude 3.5 Sonnetclaude-3-5-sonnet却收到Error 400: Project Not Allowed或PermissionDenied/FAILED_PRECONDITION: Project ... is not allowed to use model ...你的 GCP 项目本身能跑其他 Vertex 模型如 Gemini唯独 Claude 不行有时报的是模型在该区域不可用有时是项目未获授权你确认 API 已启用、服务账号有权限但 Claude 仍被拒用gcloud ai models list可能根本看不到 Claude 模型。一句话Claude 模型在 Vertex AI 上不是启用 Vertex AI API 就能用而是需要单独的模型使用授权——你的项目还没被批准使用 Claude于是 400 Project Not Allowed。二、背景Vertex AI 是 Google Cloud 的 AI 平台它提供了部分 Anthropic 模型Claude 系列作为第一方可调用模型。但 Claude on Vertex 的可用性受两层控制区域region限制Claude 模型只在特定 Vertex 区域开放如us-east5、us-central1等且随版本变化项目级授权allowlist使用 Claude on Vertex 通常需要你的 GCP 项目先通过申请/签约获得使用资格。这不是单纯 IAM 权限而是 Google 与 Anthropic 合作下的模型分发授权。所以项目能跑 Gemini不意味着项目能跑 Claude。报Project Not Allowed几乎就是第二种——授权缺失。三、根因根因是项目未被授权在 Vertex AI 上使用 Claude 模型或请求打到了未开放该模型的区域调用 Vertex Claude 模型 - Vertex 网关校验 (project, region, model) - 项目不在 Claude 使用 allowlist - 400 Project Not Allowed - 或 region 未开放该 Claude 模型 - 400 / 404这不是代码 bug而是账号/授权配置问题。任何 SDK 调用anthropic.AnthropicVertex、或google-cloud-aiplatform的Endpoint.predict都会得到同样的拒绝因为拒绝发生在 Google 侧网关早于你的请求到达模型。四、最小可运行复现from dataclasses import dataclass from typing import Dict dataclass class _VertexGate: allowed_projects: set None allowed_regions: set None def __post_init__(self): self.allowed_projects self.allowed_projects or {proj-gemini-only} self.allowed_regions self.allowed_regions or {us-central1} def check(self, project: str, region: str, model: str) - None: # 模拟 Google 侧网关授权校验 if claude in model.lower() and project not in self.allowed_projects: raise PermissionError(400: Project Not Allowed (Claude 未授权)) if region not in self.allowed_regions: raise PermissionError(f400: region {region} 未开放模型 {model}) def main(): gate _VertexGate() try: gate.check(proj-gemini-only, us-central1, claude-3-5-sonnet) except PermissionError as e: print(ERR:, e) # 400: Project Not Allowed if __name__ __main__: main()运行后项目未在 allowlist 时抛Project Not Allowed与真实表现一致。五、解决方案第一层最小直接修复最小修复是为项目申请 Claude on Vertex 的使用授权并确认区域正确在 Google Cloud 控制台确认 Vertex AI API 已启用通过 Anthropic 或 Google Cloud 的合作入口申请 Claude 模型在 Vertex 的使用资格通常是填表/签约批准后项目进入 allowlist调用时使用开放 Claude 的区域参考官方文档当前支持的区域例如us-east5、us-central1等用正确的模型 ID例如claude-3-5-sonnet-v220241022这类带版本的 ID。import os from anthropic import AnthropicVertex client AnthropicVertex( project_idos.environ[GCP_PROJECT], regionos.environ[GCP_REGION], # 必须是开放 Claude 的区域 ) msg client.messages.create( modelclaude-3-5-sonnet-v220241022, max_tokens256, messages[{role: user, content: hi}], )六、解决方案第二层结构化改进把Vertex 调用前置校验抽成策略在代码侧尽早暴露授权/区域不对而不是等 400from dataclasses import dataclass, field from typing import Set dataclass(frozenTrue) class ClaudeVertexProjectPolicy: Vertex AI 调用策略尽早校验项目授权与区域避免 400 Project Not Allowed。 规则 - region 必须在开放 Claude 的区域集合内 - project 需在 allowlist运行前由外部写入配置 - model 使用带版本的官方 ID allowed_regions: Set[str] field(default_factorylambda: { us-central1, us-east5, europe-west1, }) allowlisted_projects: Set[str] field(default_factoryset) def precheck(self, project: str, region: str, model: str) - None: if claude in model.lower() and project not in self.allowlisted_projects: raise PermissionError( f项目 {project} 未获授权在 Vertex 使用 Claude 请先申请 Claude on Vertex 使用资格 ) if region not in self.allowed_regions: raise PermissionError( f区域 {region} 未开放 Claude 模型请用 {sorted(self.allowed_regions)} ) def pick_model_id(self, base: str, version: str) - str: return f{base}{version} def demo() - None: policy ClaudeVertexProjectPolicy(allowlisted_projects{proj-ok}) policy.precheck(proj-ok, us-central1, claude-3-5-sonnet) print(policy.pick_model_id(claude-3-5-sonnet-v2, 20241022)) if __name__ __main__: demo()把allowlisted_projects从部署配置注入CI/启动阶段就校验避免线上才爆 400。七、解决方案第三层断言 / CI 守护import pytest from your_module import ClaudeVertexProjectPolicy def test_region_must_be_allowed(): policy ClaudeVertexProjectPolicy() with pytest.raises(PermissionError): policy.precheck(proj-ok, asia-east1, claude-3-5-sonnet) def test_project_must_be_allowlisted(): policy ClaudeVertexProjectPolicy(allowlisted_projectsset()) with pytest.raises(PermissionError): policy.precheck(proj-x, us-central1, claude-3-5-sonnet) def test_allowlisted_passes(): policy ClaudeVertexProjectPolicy(allowlisted_projects{proj-ok}) # 不应抛错 policy.precheck(proj-ok, us-central1, claude-3-5-sonnet) def test_model_id_versioned(): policy ClaudeVertexProjectPolicy() assert policy.pick_model_id(claude-3-5-sonnet-v2, 20241022).endswith(20241022)CI 里加一条用gcloud auth后的权限做 dry-run 校验或读取配置确保项目/区域/模型 ID 合规。八、排查清单项目是否单独申请了 Claude on Vertex 的使用授权这不等于启用 Vertex AI API。调用区域是否开放 Claude参考官方当前支持区域列表。模型 ID 是否用带版本的官方格式如claude-3-5-sonnet-v220241022同一项目能跑 Gemini 但 Claude 报 400几乎可锁定是授权问题。服务账号 IAM 是否有Vertex AI User角色是否在代码侧做了 region/project 预校验避免线上才爆九、小结在 Vertex AI 上调用 Claude 3.5 Sonnet 收到 400 Project Not Allowed根因不是代码而是项目尚未获得Claude on Vertex的使用授权或请求打到了未开放该模型的区域。这与能否跑 Gemini 无关——Claude 走单独的 allowlist。最小修复是申请授权、使用开放区域与带版本模型 ID结构化做法是抽成ClaudeVertexProjectPolicy在调用前校验项目授权与区域最后用 pytest 守护区域/授权前置校验把 400 消灭在请求发出之前。