如果您的組織使用 AWS Bedrock、Google Cloud Vertex AI 或 LLM 閘道來存取 Claude,您可以使用 Claude for Excel、Claude for PowerPoint、Claude for Word 和 Claude for Outlook 附加元件,而無需 Claude 帳戶。附加元件透過您組織的基礎結構連接,因此您的提示和回應會保留在現有的信任邊界內。
有四條連接路徑,取決於您的組織如何存取 Claude:
LLM 閘道:附加元件將請求傳送到您的閘道(LiteLLM、Portkey、Kong 等),該閘道將其路由到您選擇的提供者。這與 Claude Code 使用的模式相同。如果您的組織已經透過 LLM 閘道執行 Claude Code,您可以將 Office 附加元件指向同一端點—無需新的基礎結構。
Bedrock 直接:附加元件透過 Microsoft Entra ID 進行驗證,並直接呼叫 AWS Bedrock,中間沒有閘道。
Vertex AI 直接:附加元件透過 Google OAuth 進行驗證,並直接呼叫 Vertex AI。
Foundry 直接:附加元件透過您的 Azure AI Foundry 資源直接進行驗證,使用其 API 金鑰。
您的 IT 管理員在部署期間選擇路徑。作為終端使用者,無論您的組織使用哪條路徑,體驗都是相同的。
需求
需求因連接路徑而異。
所有路徑:
已安裝 Claude for Excel、Claude for PowerPoint、Claude for Word 或 Claude for Outlook(來自 Microsoft AppSource 或由您的管理員部署)
具有 Entra ID 的 Microsoft 365(用於管理員同意,以及在直接雲端路徑中用於權杖發行)
Microsoft Graph 管理員同意 Mail.ReadWrite、Calendars.Read、People.Read 和 User.Read(透過 Anthropic 的應用程式或您自己的 Entra 應用程式註冊)。
LLM 閘道:
來自您 IT 團隊的閘道 URL 和 API 權杖
Bedrock 直接:
一個 AWS 帳戶,在目標區域中啟用了 Claude 模型存取
一個 IAM OIDC 身份提供者和角色,配置為信任 Microsoft Entra ID 權杖
Vertex AI 直接:
一個 Google Cloud 專案,已啟用 Vertex AI API,且在目標區域中具有 Claude 模型存取
一個 Google OAuth 用戶端,配置有附加元件的重新導向 URI
Foundry 直接:
一個 Azure AI Foundry 資源,至少部署了一個 Claude 模型(Claude Opus 4.6、Opus 4.5、Sonnet 4.6 或 Sonnet 4.5)
部署名稱必須保留為預設模型 ID(例如 claude-opus-4-6);尚不支援自訂部署名稱。適配器按模型 ID 進行探測,因此重新命名的部署將無法找到。
資源的 API 金鑰,來自 Azure Portal → 您的 Foundry 資源 → 金鑰和端點 → 金鑰 1
您組織的 IT 團隊管理這些資源。如果您沒有所需的認證,請聯絡他們—Anthropic 無法為您提供或重設它們。
網路允許清單
附加元件需要到達特定網域才能運作。哪些網域取決於您的組織是直接使用 Anthropic API (1P) 還是使用第三方平台 (3P)。與您的網路或安全團隊分享適用的表格,以便他們可以將這些網域加入允許清單。
重要:在所有配置中—包括第三方—您的提示和 Claude 的回應僅傳送到您選擇的推理提供者(您的閘道、Bedrock、Vertex AI 或 Azure AI Foundry)。下面列出的指向 Anthropic 的網域(例如 pivot.claude.ai)用於附加元件的介面、功能配置和操作遙測。它們不攜帶提示或回應內容。
Anthropic API (1P)
如果您組織中的人員使用 Claude 帳戶登入,且推理前往 api.anthropic.com,請使用此表格。
網域 | 需要時機 | 用途 |
pivot.claude.ai | 始終 | 附加元件主機。提供工作窗格 UI 並代理分析、圖示搜尋、技能下載和遙測。 |
claude.ai | 始終 | Anthropic OAuth 登入和功能旗標評估。 |
api.anthropic.com | 始終 | Claude 推理 API、檔案上傳、程式碼執行容器和 MCP 連接器登錄。 |
appsforoffice.microsoft.com | 始終 | Microsoft Office.js 執行時指令碼。每個 Office 附加元件都需要。 |
o1158394.ingest.us.sentry.io | 選用 | 當機和錯誤報告。封鎖此項只會降低診斷功能;附加元件仍可正常運作。 |
mcp-proxy.anthropic.com | 如果使用 MCP 連接器 | MCP 連接器工具呼叫的代理。 |
bridge.claudeusercontent.com | 如果跨應用程式工作 | 跨應用程式功能的 WebSocket 橋接。 |
第三方平台 (3P)
如果貴組織中的人員使用 Microsoft Entra ID 登入,且推論會傳送到您的 LLM 閘道、Bedrock 或 Vertex AI,請使用此表格。
網域 | 需要時機 | 用途 |
pivot.claude.ai | 一律 | 附加元件主機。提供工作窗格 UI,並代理分析、圖示搜尋和遙測。 |
claude.ai/api/ | 一律 | 功能旗標評估。無需登入;附加元件只會從此處擷取其設定。 |
appsforoffice.microsoft.com | 一律 | Microsoft Office.js 執行階段指令碼 (每個 Office 附加元件都需要)。 |
login.microsoftonline.com | 一律 | 透過巢狀應用程式驗證進行 Microsoft Entra ID 登入。讀取管理員佈建的閘道設定,並為直接雲端驗證簽發權杖。 |
o1158394.ingest.us.sentry.io | 選用 | 當機和錯誤報告。封鎖此項只會降低診斷功能;附加元件仍可正常運作。 |
您的 LLM 閘道 URL | 如果使用 LLM 閘道 | 貴組織的 LLM 閘道 (LiteLLM、Portkey、Kong 等)。推論會傳送到此處,而不是 api.anthropic.com。 |
sts.amazonaws.com | 如果直接使用 Bedrock | AWS STS。將 Entra ID 權杖交換為暫時 Bedrock 認證。 |
bedrock-runtime.<region>.amazonaws.com | 如果直接使用 Bedrock | Bedrock 推論端點。將 <region> 取代為您設定的 AWS 區域 (例如 us-east-1)。 |
accounts.google.com | 如果直接使用 Vertex AI | Google OAuth 同意畫面。 |
oauth2.googleapis.com | 如果直接使用 Vertex AI | Google OAuth 權杖交換和重新整理。 |
aiplatform.googleapis.com | 如果直接使用 Vertex AI | Vertex AI 全域推論端點。 |
<region>-aiplatform.googleapis.com | 如果直接使用 Vertex AI | Vertex AI 區域推論端點。將 <region> 取代為您設定的 GCP 區域 (例如 us-east5)。 |
<resource>.services.ai.azure.com
| 如果直接使用 Foundry | Azure AI Foundry 推論端點。將 <resource> 替換為您的資源名稱。 |
為第三方使用部署增益集 (IT 管理員)
使用 claude-in-office 外掛程式在整個組織中設定和部署增益集。此工具可處理佈建雲端資源 (如果使用 Bedrock 或 Vertex AI 直接連線)、產生增益集資訊清單,以及在單一引導式流程中取得管理員同意。
使用設定精靈
安裝外掛程式並執行互動式設定精靈:
claude plugin marketplace add anthropics/financial-services-plugins
claude plugin install claude-in-office@financial-services-plugins
/claude-in-office:setup
精靈會引導您完成連線路徑:
LLM 閘道:收集您的閘道 URL 和權杖、決定要使用的 API 格式、產生資訊清單,以及處理 Azure 管理員同意。
Bedrock 直接連線:建立 IAM OIDC 身分識別提供者和角色、產生資訊清單,以及處理 Azure 管理員同意。
Vertex AI 直接連線:引導您建立 Google OAuth 用戶端、產生資訊清單,以及處理 Azure 管理員同意。
Foundry 直接連線:擷取
azure_resource_name和azure_api_key,然後產生資訊清單。
精靈完成後,增益集即可部署至整個租用戶。
注意:Bedrock 和 Vertex AI 路徑需要 Node.js 來產生和驗證資訊清單。精靈會檢查它,如果遺失則提示您安裝。
您可以在 claude-in-office 工作階段中使用下列命令:
命令 | 功能 |
| 互動式精靈—佈建雲端資源、管理員同意、寫入資訊清單 |
| 產生自訂增益集資訊清單 XML |
| 為增益集的應用程式註冊產生 Azure 管理員同意 URL |
| 透過 Microsoft Graph 擴充屬性寫入每位使用者的設定 |
| 引導您建立啟動端點—每位使用者的 MCP 伺服器、技能和動態設定 |
| 診斷部署問題—過期設定、連線失敗、遺失增益集 |
自訂推論標頭
如果您的推論端點或其前面的任何代理需要額外標頭 (例如,用於成本計算的內部應用程式 ID),請將 inference_headers 設定為標頭名稱/值配對的 JSON 物件。增益集會將這些標頭附加到它傳送的每個模型推論要求,因此您不需要單獨的標頭注入代理。
這適用於閘道、Amazon Bedrock 和 Google Vertex AI 部署。
範例:inference_headers={"x-application-id":"app123"}
您可以在資訊清單 (全組織) 或啟動端點回應 (每位使用者) 中設定 inference_headers。
精靈佈建的內容
精靈會根據您的連線路徑自動建立資源。以下是它設定的內容:
LLM 閘道:無雲端資源可佈建。精靈會收集您的閘道 URL 和權杖,然後產生資訊清單。
Bedrock 直接連線:建立信任 Microsoft Entra ID 權杖的 IAM OIDC 身分識別提供者、具有 bedrock:InvokeModel 和 bedrock:InvokeModelWithResponseStream 權限的角色,以及限定於 Claude 增益集應用程式 ID 的信任原則。
Vertex AI 直接連線:引導您在 GCP 主控台中建立 Google OAuth 用戶端 (此步驟無法透過 CLI 自動化)、啟用 Vertex AI API,以及擷取用戶端 ID 和密碼以供資訊清單使用。
Foundry 直接連線:無雲端資源可佈建;精靈會收集資源名稱和 API 金鑰以供資訊清單使用。
使用 Microsoft Entra 擴充屬性的每位使用者設定
如果某些值因使用者而異 (例如,不同的閘道權杖或不同團隊的不同 AWS 角色),精靈可以透過 Microsoft Graph 擴充屬性寫入每位使用者的設定。在初始設定後,使用每位使用者的金鑰執行 /claude-in-office:update-user-attrs。
使用啟動端點的每位使用者設定
如果某些值因使用者而異,或每位使用者的值需要伺服器端邏輯 (例如,MCP 伺服器清單、技能、推論標頭或從您的密碼存放區提供的短期閘道權杖),請改為設定啟動端點。在資訊清單中設定 bootstrap_url 為您託管的 HTTPS 端點;增益集會使用使用者的 Entra 權杖呼叫它,並套用您傳回的任何 JSON。執行 /claude-in-office:bootstrap 以取得要求/回應合約和處理常式支架。
部署至 Microsoft 365
精靈產生您的資訊清單後:
開啟 Microsoft 365 管理中心,然後移至 設定 > 整合應用程式 > 上傳自訂應用程式。
選取「Office 增益集」作為應用程式類型,然後上傳 manifest.xml (如果您要部署 Outlook,也上傳 manifest-outlook.xml) 檔案。
選擇誰會取得增益集:
如果所有使用者共用相同的設定,請選取「整個組織」。
如果您在上一個步驟中寫入了每位使用者的屬性,請指派給 特定使用者/群組,完全符合已設定的人員。其他任何人開啟增益集時都不會有設定。
接受權限並完成部署。
傳播到使用者最多需要 24 小時(通常快得多)。加入項目在部署後會出現在 Excel、PowerPoint、Word 和 Outlook 的 首頁 > 加入項目 中。
注意:先從試驗群組開始以確認加入項目正常運作,然後擴大指派範圍。您稍後可以變更指派而無需重新部署。
部署到 Outlook
Outlook 需要與 Excel、PowerPoint 和 Word 不同的資訊清單檔案。Microsoft 對郵件應用程式使用不同的加入項目結構描述,因此兩者無法合併為一個檔案。當您告訴設定精靈您要部署到 Outlook 時,它會產生第二個名為 manifest-outlook.xml 的檔案,並與 manifest.xml 並排放置。在 Microsoft 365 系統管理中心中,按照下一節所述的相同步驟,將每個檔案作為自己的自訂應用程式上傳。
授予 Microsoft Graph 同意
注意:Amazon Bedrock 目前不支援 Claude for Outlook。Bedrock 仍支援 Claude for Excel、PowerPoint 和 Word。
Claude for Outlook 透過 Microsoft Graph 讀取郵件和行事曆資料,這需要全域系統管理員的一次性租用戶範圍授予。這與上述整合應用程式部署分開。請讓全域系統管理員在已登入您 Microsoft 365 租用戶的瀏覽器中開啟下方的系統管理員同意連結:
系統管理員會看到 Microsoft 權限畫面,列出 Mail.ReadWrite、Calendars.Read、People.Read、User.Read 和 offline_access
他們按一下「接受」後,組織中的所有使用者都可以使用 Claude for Outlook,無需額外的 Microsoft 提示。此授予立即生效;只有上述加入項目推出最多需要 24 小時。
如果略過此步驟,每個使用者在 Claude 首次嘗試讀取郵件或行事曆資料時都會看到「需要系統管理員核准」訊息。
注意:第三方平台上的 Claude for Outlook 目前僅支援 Claude Opus 4.7。當使用者使用 Claude 帳戶登入時,Outlook 中提供其他 Claude 模型。
部署加入項目後,您的使用者可以按照下列步驟進行連線。
終端使用者的連線指示
LLM 閘道
開啟 Excel、PowerPoint、Word 或 Outlook,然後啟動 Claude 加入項目。
在登入畫面上,選取「企業閘道」。
輸入您的 IT 小組提供的 閘道 URL 和 API 權杖。
閘道 URL:您的 LLM Proxy 的 HTTPS 基底 URL(例如 https://llm-gateway.yourcompany.com)。
API 權杖:您的 Proxy 預期的持有人權杖。加入項目在每個要求中以 Authorization: Bearer <token> 標頭傳送此權杖。
加入項目透過向閘道傳送測試要求來檢查連線。如果成功,您會看到主應用程式體驗。
您的認證儲存在本機瀏覽器的 localStorage 中,位於加入項目的沙箱 iframe 內。它們不會同步到 Anthropic 的伺服器。由於 Office 加入項目在 Microsoft 應用程式內的沙箱 iframe 中執行,它無法像 Claude Code 那樣使用您的作業系統金鑰鏈 — 因此,只輸入閘道發行的權杖,而不是原始雲端提供者認證。
Bedrock、Vertex AI 或 Foundry 直接
開啟 Excel、PowerPoint、Word 或 Outlook,然後啟動 Claude 加入項目。
使用您提供者的方法進行驗證:
Bedrock 或 Vertex AI:使用您的 Microsoft 工作帳戶登入。加入項目使用您的 Entra ID 權杖向您的雲端提供者進行驗證 — 不需要單獨的雲端認證。
Foundry:如果您的系統管理員預先填入了 Azure 資源名稱和 API 金鑰,加入項目會自動連線。否則,輸入您的 IT 小組提供的值並選取「連線」。
加入項目讀取您的系統管理員佈建的設定,並直接連線到 Bedrock 或 Vertex AI。
如果您在登入時看到錯誤,請向您的 IT 小組確認您的帳戶在指派給加入項目的群組中。
變更或更新您的連線
如果您的 API 權杖過期或您的 IT 小組給您新的 URL,請前往加入項目側邊欄中的「設定」,輸入新值,然後選取「測試連線」。
IT 小組的閘道需求
Office 加入項目支援與 Claude Code 相同的三種 API 格式。在您的加入項目資訊清單中設定 gateway_api_format,以告訴加入項目您的閘道使用哪種格式。
CORS 需求
加入項目的工作窗格從 https://pivot.claude.ai 載入。因此,對您閘道的每個要求都是跨來源的,瀏覽器會無聲地捨棄任何缺少 CORS 標頭的回應。
您的閘道必須在每個回應上傳回 Access-Control-Allow-Origin: https://pivot.claude.ai(或 *):GET、POST、OPTIONS 和所有錯誤回應。僅在 OPTIONS 預檢上設定它是不夠的。對於預檢,傳回 Access-Control-Allow-Headers: *。
必要的端點
您的閘道必須公開的端點取決於它使用的 API 格式。在您的資訊清單中設定 gateway_api_format 以符合。
gateway_api_format: anthropic (預設)
端點 | 描述 |
POST /v1/messages | 傳送訊息給 Claude。支援串流和非串流回應。 |
GET /v1/models | 列出可用的模型。 |
gateway_api_format: bedrock
端點 | 描述 |
POST /model/{model-id}/invoke | 傳送訊息並接收完整回應。 |
POST /model/{model-id}/invoke-with-response-stream | 傳送訊息並接收串流回應。 |
原生 Bedrock InvokeModel 直通。gateway_url 必須指向直通前綴(例如,https://litellm.example.com/bedrock)。
gateway_api_format: vertex
端點 | 說明 |
POST /projects/{project}/locations/{region}/publishers/anthropic/models/{model-id}:rawPredict | 傳送訊息並接收完整回應。 |
POST /projects/{project}/locations/{region}/publishers/anthropic/models/{model-id}:streamRawPredict | 傳送訊息並接收串流回應。 |
原生 Vertex 直通。gateway_url 必須包含 API 版本段(例如,https://litellm.example.com/vertex_ai/v1)。同時需要 gcp_project_id 和 gcp_region,以便附加元件可以建立路徑。
必需標頭
對於 anthropic 和 vertex 格式,閘道必須將 anthropic-version 請求標頭轉發給上游提供者。
對於 bedrock 格式,SDK 會將 anthropic_version 放在請求本體中 — 閘道必須將其保留在該處。
未能轉發標頭或保留本體欄位可能會導致功能降低或阻止附加元件正常運作。
授權標頭
附加元件可以在 x-api-key 或 Authorization 標頭中傳送您的閘道授權權杖。
模型探索
登入時,附加元件會嘗試透過 GET /v1/models 探索可用的 Claude 模型。如果您的閘道在該路徑上未公開模型清單,附加元件會改為提示使用者手動輸入模型 ID。
與 Claude Code 閘道設定的差異
方面 | Claude Code | Claude for Excel、PowerPoint、Word 和 Outlook |
認證儲存 | OS 鑰匙圈或環境變數 | 瀏覽器 localStorage(沙箱 iframe) |
驗證設定 | 環境變數、設定檔、協助程式指令碼 | 在附加元件 UI(閘道)中手動輸入、Entra ID(直接雲端)或 Azure API 金鑰(Foundry) |
權杖重新整理 | 支援用於輪換的協助程式指令碼 | 在設定中手動重新輸入(閘道)或透過 Entra ID 自動進行(直接雲端) |
自訂模型名稱 | 可透過環境變數設定 | 在 v1 中不可設定 |
使用 LiteLLM 的範例閘道設定
警告:LiteLLM PyPI 版本 1.82.7 和 1.82.8 遭到竊取認證的惡意軟體入侵。請勿安裝這些版本。如果您已經安裝了它們:
移除套件
輪換受影響系統上的所有認證
遵循 BerriAI/litellm#24518 中的補救步驟
LiteLLM 是第三方代理服務。Anthropic 不認可、維護或審計 LiteLLM 的安全性或功能。本指南僅供參考之用,可能會過時。請自行決定是否使用。
許多組織使用 LiteLLM 作為其閘道。以下是用於將 Office 附加元件請求路由到 Anthropic、Bedrock 或 Vertex 的最小 litellm_config.yaml。
直接路由到 Anthropic
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: claude-sonnet-4-5-20250929
api_key: os.environ/ANTHROPIC_API_KEY
litellm_settings:
drop_params: true
路由到 Amazon Bedrock
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: bedrock/anthropic.claude-sonnet-4-5-20250929-v1:0
aws_region_name: us-east-1
litellm_settings:
drop_params: true
路由到 Google Cloud Vertex AI
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: vertex_ai/claude-sonnet-4-5-20250929
vertex_project: your-gcp-project-id
vertex_location: us-east5
litellm_settings:
drop_params: true
路由到 Azure
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: azure_ai/claude-sonnet-4-5-20250929
api_base: https://your-resource.services.ai.azure.com/anthropic
api_key: os.environ/AZURE_API_KEY
extra_headers:
x-api-key: os.environ/AZURE_API_KEY
litellm_settings:
drop_params: true
如需詳細的設定說明,請參閱 LiteLLM 的 Anthropic 格式文件。
Anthropic 收集的內容
即使推理透過您自己的基礎設施進行,該外掛程式也會與 pivot.claude.ai 通訊以載入其介面,並與 claude.ai/api/ 通訊以評估功能旗標。這些連線會傳輸操作遙測資料(例如使用了哪些功能、效能計時和錯誤率),以便 Anthropic 可以維護和改進外掛程式體驗。它們不會傳輸您的提示或 Claude 的回應。
Anthropic 根據 AWS Bedrock、Google Cloud Vertex AI 或 Microsoft Azure 的條款收集資訊,與 Anthropic 與客戶的協議一致。Anthropic 無法存取客戶的 AWS、Google 或 Microsoft 執行個體,包括其中包含的提示或輸出。Anthropic 不會使用此類內容訓練生成模型,也不會將其用於其他目的。Anthropic 可以存取中繼資料(例如工具使用、權杖計數和類似項目),並將此類中繼資料用於分析和產品改進目的。
如需了解您的組織閘道或雲端提供者記錄的詳細資訊,請聯絡您的 IT 團隊。
若要將完整稽核軌跡(包括提示、工具輸入、工具輸出和文件參考)路由到您自己的基礎設施,請參閱 為 Office 代理程式設定自訂 OpenTelemetry 收集器。
這與使用 Claude 帳戶登入的差異
當您使用 Claude 帳戶登入時,外掛程式會直接連線到 Anthropic。當您透過第三方平台連線時,外掛程式會改為將推理要求傳送到您的組織基礎設施,而您的 IT 團隊會控制該流量的路由和記錄方式。
某些依賴 Claude 帳戶的功能尚未透過第三方平台提供,但我們正在努力新增支援:
功能 | Claude 帳戶 | 第三方平台 |
與您的試算表、簡報或文件聊天 | ✓ | ✓ |
讀取和編輯儲存格、投影片、公式和文件文字 | ✓ | ✓ |
連接器(S&P、FactSet 等) | ✓ | ✓ |
跨應用程式工作 | ✓ | — |
技能 | ✓ | ✓ |
檔案上傳 | ✓ | ✓ |
網路搜尋 | ✓ | 僅限 Vertex |
如果您的團隊需要這些功能,請與您的 Claude 管理員討論哪種登入方式適合您的組織。
將 MCP 連接器新增至第三方外掛程式
MCP 連接器現已在 Claude for Excel、PowerPoint 和 Word 中受支援。作為管理員,您可以按照此處的文件在外掛程式資訊清單中設定 MCP 閘道:MCP 伺服器。如果您偏好使用啟動程序端點,可以按照此處的文件設定 MCP 連接器:mcp_servers。
將技能新增至第三方外掛程式
技能現已在 Claude for Excel、PowerPoint 和 Word 中受支援。Anthropic 財務服務技能預設為可用。其他技能可由管理員新增或由個人手動新增。
管理員可以使用啟動程序端點新增技能,請按照此處的文件進行:skills。
個人可以手動上傳本機技能(.zip、.skill 或 SKILL.md 檔案),並個別管理它們。選取「+」按鈕,然後選取「技能」→「上傳技能」即可上傳技能。
將檔案上傳新增至第三方外掛程式
檔案上傳現已在 Claude for Excel、PowerPoint 和 Word 中受支援。個人可以選取「+」按鈕,然後選取「新增檔案或相片」來上傳檔案。
疑難排解
「連線被拒絕」或網路錯誤
無法從使用者的網路到達閘道 URL 或雲端端點。驗證 URL 是否正確、服務是否正在執行,以及是否沒有防火牆或 VPN 限制阻止連線。檢查上方的「網路允許清單」部分,以確認所有必要的網域都被允許。
401 未授權或「無效的權杖」
驗證權杖無效或已過期。對於閘道連線,請與您的 IT 團隊確認權杖。對於直接雲端連線,驗證使用者的 Entra ID 帳戶是否在指派的群組中,以及 OIDC 信任或 OAuth 用戶端是否設定正確。對於 Foundry,在 Azure 入口網站 → 金鑰和端點中重新產生金鑰。
403 禁止或「存取被拒絕」
權杖有效但缺少正確的權限。對於 Bedrock,驗證 IAM 角色是否具有 bedrock:InvokeModel 權限。對於 Vertex,驗證服務帳戶是否具有 aiplatform.endpoints.predict 權限。對於閘道,請與您的 IT 管理員檢查權杖的範圍。對於 Foundry,檢查資源的網路規則,或確認金鑰屬於正確的資源。
404 找不到
附加元件無法到達預期的 API 路徑。對於閘道,請驗證 URL 是基礎 URL(例如,https://litellm-server:4000)—不要在 URL 欄位中包含 /v1/messages。
500 或其他伺服器錯誤
閘道或雲端提供者遇到內部錯誤。檢查您的閘道日誌(例如,如果使用 LiteLLM,請執行 docker logs litellm)以查看上游提供者錯誤。重新嘗試請求,如果問題持續存在,請聯絡您的 IT 管理員。
「沒有可用的模型」
附加元件找不到 Claude 模型。對於閘道,您的閘道可能不會在 GET /v1/models 公開模型清單。您的 IT 團隊可以設定閘道以提供模型清單,或提供特定的模型 ID 供您手動輸入。對於 Bedrock 或 Vertex,請確認您的帳戶和區域中至少啟用了一個 Claude 模型(Claude Sonnet 4.5 或更新版本)。對於 Foundry,請確認至少在資源(模型目錄)中部署了一個 Claude 模型。
串流回應失敗或掛起
驗證您的閘道是否支援伺服器傳送事件 (SSE) 傳遞。某些代理設定會移除或緩衝 SSE 連線,這會防止串流回應到達附加元件。
我預期的功能無法使用
連接器、技能、檔案上傳和跨應用程式工作目前無法透過第三方平台使用。如果您需要這些功能,請詢問您的管理員是否可以改用 Claude 帳戶登入。
