跳轉到主要內容
本節涵蓋使用貴組織已執行的閘道產品，而非 Claude 應用程式閘道。如需了解什麼是閘道、它如何位於 Claude Code 和您的提供者之間，以及如何在 Claude 應用程式閘道和其他產品之間進行選擇，請參閱 閘道概述。
任何公開 支援的 API 格式 的閘道都可以運作。Anthropic 不認可、維護或審計第三方閘道產品，也不支援透過任何閘道將 Claude Code 路由到非 Claude 模型。按照其自身文件部署閘道，然後使用下方的 推出步驟 完成 Claude Code 端的設定。

gateway 提供的功能

gateway 為您的組織提供一個地方來管理：
  • 憑證：提供商金鑰保留在伺服器端；開發人員改為持有 gateway 憑證
  • 使用情況追蹤：按開發人員或團隊歸屬使用情況，無論哪個提供商處理請求
  • 成本控制：在一個地方強制執行預算和速率限制
  • 審計日誌：記錄每個模型請求以進行合規性檢查
  • 提供商切換：在 gateway 配置中更改提供商，無需觸及開發人員機器
除了提供商切換外，所有這些都適用於上游是 Anthropic API 還是雲提供商。提供商切換而無需重新配置開發人員機器也取決於 gateway 公開單一 Anthropic 格式端點，無論上游如何；公開提供商自己格式的 gateway 將客戶端配置與該提供商綁定，並改變 Claude Code 傳送的內容以及它應用的預設值。 權衡是 gateway 成為您的組織運營的基礎設施。Claude Code 在每個版本中添加功能，不轉發這些功能的 gateway 會破壞相應的功能，因此 gateway 產品需要隨著 Claude Code 的發展而保持更新。gateway 相容性指南涵蓋要轉發的內容。

推出 gateway

當您準備好為組織推出 LLM gateway 時，無論您選擇哪個 gateway 產品，順序都是相同的：
  1. 部署 gateway 並給予它您的提供商憑證，以便它可以對它轉發的請求進行身份驗證。
  2. 為每個開發人員發行 gateway 憑證，以便使用情況歸屬於開發人員，離職時撤銷一個憑證。
  3. 透過受管設定檔和您的機密工具分發配置，以便每台機器都接收基本 URL 和憑證。當兩者都分發時，開發人員無需配置任何內容。如果您沒有設定分發，開發人員按照連接頁面自己設置變數。
  4. 讓每個開發人員檢查 Claude Code 中的配置，以便分發問題在他們依賴 gateway 之前浮出水面。
為您的組織推出 LLM gateway逐步介紹每個步驟，並顯示在每個步驟分發的配置檔案。gateway 是組織設置的一部分；有關政策強制執行、使用情況可見性和資料處理決策，請參閱為您的組織設置 Claude Code。 若要讓透過 ANTHROPIC_BASE_URL 到達的 gateway 成為受管機器唯一可以使用的目的地，請在相同的受管設定檔中將 allowedProviders 設定為 ["customEndpoint"]，並將 gateway 的 ANTHROPIC_BASE_URL 放在該檔案的 env 區塊中。Claude Code 隨後會拒絕指向其他任何地方的工作階段，包括直接指向 Anthropic 或開發人員自己的代理，並且只接受 ANTHROPIC_BASE_URL 具有您在該處設定的值。對於透過提供商特定端點變數（例如 ANTHROPIC_BEDROCK_BASE_URL）到達的 gateway，allowedProviders 項目會指定要固定的變數。需要 Claude Code v2.1.285 或更新版本。
在 Desktop 已登入 claude.ai 的情況下，使用者機器上的 Cowork 工作階段會被視為 "anthropic"。如果您在 MDM 原則或受管設定檔中未將其列入此清單，該工作階段會被拒絕。若將其列入，直接傳送至 Anthropic 的工作階段也會通過此清單。

訂閱和 gateway

當gateway 憑證變數或 apiKeyHelper 處於活動狀態時，請求會使用該憑證，而不是開發人員的 claude.ai 訂閱登錄，且訂閱的使用限制不適用於這些請求。Claude Code 在機器上保存了 claude.ai 登錄，但不會在這些請求中發送它。該流量按令牌計費給擁有 gateway 轉發的憑證的人，例如您的組織的 Anthropic Console 帳戶，或當 gateway 路由到那裡時您的 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 帳戶。 ANTHROPIC_BASE_URL 是讓 Claude Code 指向閘道的變數。僅設定該變數而未設定閘道憑證，並不會取代訂閱。請求仍會透過閘道路由，但已儲存的 claude.ai 登入仍是作用中的憑證，因此會套用其用量上限與計費。將此流量轉送給 Anthropic 的閘道必須轉送 Authorization 以及 anthropic-beta 中的 OAuth 功能；請參閱請求標頭參考。