Claude Platform Docs
Messages入門

取得您的 Claude API 金鑰

在 Claude Console 中尋找、建立及管理您用於 Claude API 的 API 金鑰。

Claude API 的「API key」（API 金鑰，也稱為 Anthropic API 金鑰）存放於 Claude Console 中。若要檢視您現有的金鑰或建立新金鑰，請前往 Settings → API keys。

選擇金鑰類型

建立金鑰時，您需要選擇其類型，這會決定該金鑰能做什麼、可在哪裡使用，以及何時停止運作。個人金鑰（personal key）以您的身分運作，若您離開組織便會停止運作。服務帳戶金鑰（service account key）代表一個服務帳戶，可供 CI 管線、正式環境服務或代理程式等工作負載使用。請將個人金鑰用於您自己的開發工作，而任何共用的用途則使用服務帳戶金鑰。

您也可以建立工作區金鑰（workspace key），這是一種沒有擁有者的舊版金鑰：它屬於您建立它時所在的工作區，且在建立者離開後仍會繼續運作。建議優先使用個人金鑰或服務帳戶金鑰，因為當其關聯的帳戶從組織中移除時，這些金鑰會自動停止運作。

建立 API 金鑰

  1. 登入 Claude Console

    前往 platform.claude.com 並登入；若您尚未擁有帳戶，請先建立一個。

  2. 開啟 API 金鑰頁面

    前往 Settings → API keys。

  3. 建立金鑰

    點擊 Create key，為金鑰命名，選擇到期時間，並將 Linked account 設定為您自己或某個服務帳戶。您也可以選擇一個工作區來限定金鑰的適用範圍。

  4. 複製並儲存金鑰

    Console 只會在建立時顯示一次完整金鑰（以 sk-ant- 開頭）。請將其複製並儲存在安全的地方，例如機密管理工具（secrets manager）。若您遺失金鑰，將無法在 Console 中再次檢視。請改為建立新的金鑰。

如果 API 金鑰頁面上的 Create key 按鈕呈停用狀態，可能是您的角色不允許您在該處建立金鑰。請要求組織管理員變更您的角色，或為您的工作負載建立服務帳戶金鑰。

使用您的 API 金鑰

將金鑰設定為環境變數：

export ANTHROPIC_API_KEY="sk-ant-api03-..."

用戶端 SDK 會自動讀取 ANTHROPIC_API_KEY。直接發送的 HTTP 請求則在 x-api-key 標頭中傳送金鑰。如果您的 API 金鑰可用於多個工作區，您還必須在每個 Claude API 請求中傳送 anthropic-workspace-id 標頭，如選擇工作區所示。關於 Admin API，請參閱 API 金鑰與 Admin API。

若要發出您的第一個請求，請依照快速入門操作，並參閱驗證以了解完整內容，包括透過 Workload Identity Federation 取得的短期憑證。

API 金鑰與 Admin API

Admin API 包含以程式化方式管理您組織 API 金鑰的端點，例如擷取 API 金鑰與列出 API 金鑰。這些端點供組織管理員自動化金鑰管理之用。它們接受 Admin API 金鑰、具有 org:admin 範圍的 OAuth 權杖，或未限定於特定工作區的個人金鑰或服務帳戶金鑰；工作區金鑰無法在此使用。這些端點絕不會回傳金鑰的機密值，只會回傳部分遮蔽的提示。

Was this page helpful?