Claude Platform Docs
Messages入门

获取您的 Claude API 密钥

在 Claude Console 中查找、创建和管理用于 Claude API 的 API 密钥。

用于 Claude API 的 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- 开头）。请复制它并将其保存在安全的地方，例如密钥管理器中。如果您丢失了密钥，将无法在 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?