Bedrock 和 Vertex 整合
設定 Claude Code 以支援 Amazon Bedrock 和 Google Vertex AI,並透過代理伺服器連接。
模型配置
預設情況下,Claude Code 使用 claude-3-7-sonnet-20250219
。您可以使用以下環境變數來覆寫此設定:
您也可以使用全域配置來設定這些變數:
請參閱我們的模型名稱參考以了解所有供應商提供的可用模型。
使用第三方 API
無論您使用哪個 API 供應商,Claude Code 都需要同時存取 Claude 3.7 Sonnet 和 Claude 3.5 Haiku 模型。
連接到 Amazon Bedrock
如果您想要透過代理伺服器存取 Claude Code,可以使用 ANTHROPIC_BEDROCK_BASE_URL
環境變數:
如果您沒有啟用提示快取,還需要設定:
需要標準的 AWS SDK 憑證(例如,~/.aws/credentials
或相關環境變數如 AWS_ACCESS_KEY_ID
、AWS_SECRET_ACCESS_KEY
)。要設定 AWS 憑證,請執行:
請聯絡 Amazon Bedrock 以啟用提示快取,以降低成本並提高速率限制。
使用者需要在其 AWS 帳戶中同時擁有 Claude 3.7 Sonnet 和 Claude 3.5 Haiku 模型的存取權限。如果您有模型存取角色,且這些模型尚未可用,您可能需要申請存取權限。由於推論設定檔需要跨區域功能,因此需要在每個區域都能存取 Bedrock。
連接到 Google Vertex AI
如果您想要透過代理伺服器存取 Claude Code,可以使用 ANTHROPIC_VERTEX_BASE_URL
環境變數:
如果您沒有啟用提示快取,還需要設定:
Vertex AI 上的 Claude Code 目前僅支援 us-east5
區域。請確保您的專案在此特定區域有配額分配。
使用者需要在其 Vertex AI 專案中同時擁有 Claude 3.7 Sonnet 和 Claude 3.5 Haiku 模型的存取權限。
需要透過 google-auth-library 配置標準的 GCP 憑證。要設定 GCP 憑證,請執行:
為獲得最佳體驗,請聯絡 Google 以提高速率限制。
透過代理伺服器連接
當使用 LLM 代理伺服器(如 LiteLLM)搭配 Claude Code 時,您可以使用以下環境變數和配置來控制身份驗證行為。請注意,這些設定可以與 Bedrock 和 Vertex 特定設定混合使用。
環境變數
ANTHROPIC_AUTH_TOKEN
:Authorization
和Proxy-Authorization
標頭的自訂值(您設定的值將以Bearer
為前綴)ANTHROPIC_CUSTOM_HEADERS
:您想要添加到請求中的自訂標頭(採用Name: Value
格式)HTTP_PROXY
:設定 HTTP 代理伺服器 URLHTTPS_PROXY
:設定 HTTPS 代理伺服器 URL
如果您偏好使用檔案而不是環境變數進行配置,可以將這些變數添加到全域 Claude 配置(在 ~/.claude.json)的 env
物件中。
全域配置選項
apiKeyHelper
:用於獲取 API 金鑰的自訂 shell 腳本(在啟動時執行一次,並在每個工作階段期間快取)