---
title: 取得您的 Claude API 金鑰
url: https://platform.claude.com/docs/zh-TW/get-api-key
description: 在 Claude Console 中尋找、建立及管理您用於 Claude API 的 API 金鑰。
---

Claude API 的 API 金鑰（也稱為 Anthropic API 金鑰）位於 Claude Console 中。若要檢視您現有的金鑰或建立新金鑰，請前往 Console 中的 [API 金鑰](https://platform.claude.com/settings/keys)頁面（`platform.claude.com/settings/keys`）。

## 選擇金鑰類型

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

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

## 建立 API 金鑰

<Steps>
  <Step title="登入 Claude Console">
    前往 [platform.claude.com](https://platform.claude.com/) 的 Claude Console 並登入；如果您還沒有帳戶，請建立一個。
  </Step>

  <Step title="開啟 API 金鑰頁面">
    在 Claude Console 中，前往 [API 金鑰](https://platform.claude.com/settings/keys)頁面（`platform.claude.com/settings/keys`）。
  </Step>

  <Step title="建立金鑰">
    點擊 **Create key**，為金鑰命名，選擇[到期時間](https://platform.claude.com/docs/zh-TW/manage-claude/authentication#key-expiration)，並將 **Linked account** 設定為您自己或某個服務帳戶。您也可以在 Console 中選擇一個[工作區](https://platform.claude.com/settings/workspaces)來限定金鑰的範圍。
  </Step>

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

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

## 使用您的 API 金鑰

將金鑰設定為環境變數：

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

[用戶端 SDK](https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/overview) 會自動讀取 `ANTHROPIC_API_KEY`。直接的 HTTP 請求會在 `x-api-key` 標頭中傳送金鑰。如果您的 API 金鑰可在多個工作區中使用，您還必須在每個 Claude API 請求中傳送 `anthropic-workspace-id` 標頭，如[選擇工作區](https://platform.claude.com/docs/zh-TW/manage-claude/authentication#select-a-workspace)中所示。關於 Admin API，請參閱 [API 金鑰與 Admin API](https://platform.claude.com/docs/zh-TW/get-api-key#api-keys-and-the-admin-api)。

若要發出您的第一個請求，請依照[快速入門](https://platform.claude.com/docs/zh-TW/get-started)操作，並參閱[驗證](https://platform.claude.com/docs/zh-TW/manage-claude/authentication)以了解完整內容，包括透過 Workload Identity Federation 取得的短期憑證。

## API 金鑰與 Admin API

[Admin API](https://platform.claude.com/docs/zh-TW/api/organization) 包含以程式方式管理您組織 API 金鑰的端點，例如 [Retrieve API Key](https://platform.claude.com/docs/zh-TW/api/organization/api_keys/retrieve) 和 [List API Keys](https://platform.claude.com/docs/zh-TW/api/organization/api_keys/list)。這些端點供組織管理員自動化金鑰管理使用。它們接受 [Admin API 金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api-keys)、具有 `org:admin` 範圍的 OAuth 權杖，或未限定於特定工作區的個人金鑰或服務帳戶金鑰；工作區金鑰無法在此使用。這些端點絕不會傳回金鑰的機密值，只會傳回部分遮蔽的提示。

<Note>
  Admin API 無法找回遺失的金鑰，也無法提供您用來呼叫 Claude API 的金鑰。若要取得可用的 API 金鑰，請在 Claude Console 的 [API 金鑰](https://platform.claude.com/settings/keys)頁面（`platform.claude.com/settings/keys`）上建立一個。
</Note>