如何获取 Claude API 密钥

你可以从 Anthropic 的 Claude 控制台获取 Claude API 密钥，以直接访问 API，也可以创建 AI Prime Tech 账户，通过这个独立网关进行访问。请先选择提供商：其密钥、计费方式和基础 URL 必须匹配。以下步骤涵盖这两种途径，并说明如何在发送首次请求前检查网关密钥。

选择在哪里获取 Claude API 密钥

API 密钥用于标识支付请求费用的账户或项目。Claude 聊天登录和 API 密钥的用途不同。如果你需要聊天界面或订阅功能，请比较 Claude API 访问与订阅 ，然后再购买 API 用量。

AI Prime Tech 独立运营，与 Anthropic 无关联，也未获得 Anthropic 的认可。请选择符合你的集成、计费和支持需求的途径；两者的账户和密钥相互独立。

从官方 Claude 控制台获取密钥

1. 登录 Claude 控制台 ，然后选择你将使用的工作区。
2. 查看账户的 API 计费和用量限制。完成控制台要求为你的账户进行的所有设置。
3. 打开 API 密钥，为你的应用创建密钥，并在密钥显示时妥善保存。
4. 按照 Anthropic 的 官方快速入门指南 发送直接请求。采用此途径时，请使用官方端点；下方的网关示例使用 AI Prime Tech 密钥。

创建 AI Prime Tech 密钥

1. 注册 AI Prime Tech ，并完成注册过程中显示的验证步骤。
2. 请选择 预付 API 额度 以按量计费，或查看 Claude 限时套餐。付款前，请检查当前优惠、适用模型和限制。如果你想先评估服务， 试用指南 会列出当前的新用户优惠及其条件。
3. 在控制台中打开“API 密钥”，为此应用创建密钥。检查所选分组及所有密钥限制，确保它们与你购买的 Claude 访问权限相匹配。
4. 将密钥复制到本地环境变量或密钥管理器中。为每个应用使用单独的密钥，以便识别用量，并在替换某个密钥时无需更改所有集成。

创建密钥和付款并不能证明集成能够正常工作。请先使用该密钥检查模型目录，再向你打算使用的模型发送一个小型请求。

验证密钥和可用的模型 ID

在 macOS、Linux 或 WSL 上，在当前终端中设置网关密钥。在本地将占位符替换为你自己的密钥；不要让密钥出现在共享脚本和截图中。

export ANTHROPIC_API_KEY="YOUR_GATEWAY_KEY"

在 Windows PowerShell 上，使用以下环境变量语法：

$env:ANTHROPIC_API_KEY = "YOUR_GATEWAY_KEY"

请求模型列表。这是一个目录请求，不会生成模型回复。以下命令适用于兼容 Bash 的 shell：

curl --fail-with-body --silent --show-error \
  https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY"

对于 PowerShell：

$headers = @{ Authorization = "Bearer $env:ANTHROPIC_API_KEY" }
(Invoke-RestMethod "https://aiprimetech.io/v1/models" -Headers $headers).data | Select-Object id

成功的响应会列出该密钥可用的模型 ID。选择一个 Claude 模型，并将其 id 原样复制到 CLAUDE_MODEL。模型访问权限可能取决于密钥的分组和权限；仅收到目录响应并不能保证上游模型能够完成请求。

export CLAUDE_MODEL="PASTE_A_CLAUDE_MODEL_ID_FROM_THE_RESPONSE"
# PowerShell alternative:
# $env:CLAUDE_MODEL = "PASTE_A_CLAUDE_MODEL_ID_FROM_THE_RESPONSE"

连接智能体之前，请确认密钥使用的是与你所选访问方式对应的分组。 智能体设置检查清单 会将该项检查与相应的工具指南衔接起来。

发送首次 Python 请求

在项目环境中安装 Anthropic Python SDK，将示例保存为 test_claude.py，然后在已设置密钥和模型的终端中运行它。此请求使用你所选的模型，并受账户计费规则或套餐约束。

python -m pip install anthropic

import os
import anthropic

# Set CLAUDE_MODEL to an exact Claude model ID returned for your key.
client = anthropic.Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://aiprimetech.io",
)
message = client.messages.create(
    model=os.environ["CLAUDE_MODEL"],
    max_tokens=64,
    messages=[{"role": "user", "content": "Reply with hello."}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

python test_claude.py

对于此 SDK，网关基础 URL 为 https://aiprimetech.io 不带 /v1；SDK 会构建 Messages API 路径。使用 OpenAI 兼容格式的客户端通常使用 https://aiprimetech.io/v1。请参阅 Anthropic Python SDK 指南 或 OpenAI 兼容 API 指南 以获取应用所需的格式。

收到响应后，查看控制台中的请求和用量详情。对于 CLI，请继续参阅 Claude Code API 密钥设置；对于 IDE，请按照 Cursor 指南.

如果你的 Claude API 密钥无法使用

在哪里查找和管理密钥

在签发密钥的提供商控制台中打开“API 密钥”。使用其中提供的复制、显示和撤销功能。如果无法获取可用的密钥值，请创建替代密钥，并在更新应用后撤销旧密钥。

不要将密钥放入版本控制系统、公开问题帖或浏览器端 JavaScript 中。如果密钥泄露，请更换密钥并检查其使用情况。浏览器会话 Cookie 不能代替 API 密钥。

Claude API 密钥免费吗？

创建密钥和支付模型使用费用是两个独立步骤。Anthropic 的当前账户条款可在其 Console 中查看。在 AI Prime Tech 上， 试用指南 会显示当前可用的新用户优惠； 充值页面 和 套餐页面 会显示常规付费选项。

请检查资格要求及注册时显示的优惠。临时额度或试用并不意味着可以无限期免费使用。

常见问题

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。