Source: https://aiprimetech.io/zh/learn/how-to-get-a-claude-api-key/

[首页](/zh/) / [学习](/zh/learn/) / 如何获取 Claude API 密钥 

# 如何获取 Claude API 密钥 

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

## 选择在哪里获取 Claude API 密钥 

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

  | 途径  | 密钥创建位置  | 计费与端点  

 | Anthropic 直连 | [Claude 控制台](https://platform.claude.com/) | Anthropic 账户和 API 计费；api.anthropic.com 

 | AI Prime Tech | [创建账户](/register)，然后在控制台中打开“API 密钥” | 网关额度或符合条件的限时套餐；aiprimetech.io  

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

## 从官方 Claude 控制台获取密钥  
- 

登录 [Claude 控制台](https://platform.claude.com/) ，然后选择你将使用的工作区。  
- 

查看账户的 API 计费和用量限制。完成控制台要求为你的账户进行的所有设置。  
- 

打开 [API 密钥](https://platform.claude.com/settings/keys)，为你的应用创建密钥，并在密钥显示时妥善保存。  
- 

按照 Anthropic 的 [官方快速入门指南](https://platform.claude.com/docs/en/get-started) 发送直接请求。采用此途径时，请使用官方端点；下方的网关示例使用 AI Prime Tech 密钥。   

## 创建 AI Prime Tech 密钥  
- 

[注册 AI Prime Tech](/register) ，并完成注册过程中显示的验证步骤。  
- 

请选择 [预付 API 额度](/zh/topup/) 以按量计费，或查看 [Claude 限时套餐](/zh/plans/)。付款前，请检查当前优惠、适用模型和限制。如果你想先评估服务， [试用指南](/zh/learn/claude-api-free-trial/) 会列出当前的新用户优惠及其条件。  
- 

在控制台中打开“API 密钥”，为此应用创建密钥。检查所选分组及所有密钥限制，确保它们与你购买的 Claude 访问权限相匹配。  
- 

将密钥复制到本地环境变量或密钥管理器中。为每个应用使用单独的密钥，以便识别用量，并在替换某个密钥时无需更改所有集成。   

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

## 验证密钥和可用的模型 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"
```

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

## 发送首次 Python 请求 

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

复制

```
python -m pip install anthropic
```

test_claude.py复制

```
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 指南](/zh/learn/anthropic-python-sdk/) 或 [OpenAI 兼容 API 指南](/zh/learn/openai-compatible-claude-api/) 以获取应用所需的格式。 

收到响应后，查看控制台中的请求和用量详情。对于 CLI，请继续参阅 [Claude Code API 密钥设置](/zh/learn/claude-code-api-key-setup/)；对于 IDE，请按照 [Cursor 指南](/zh/learn/use-claude-api-with-cursor/). 

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

  | 症状  | 检查事项  

 | 401 或 API_KEY_REQUIRED | 确认已在当前终端中设置环境变量，并且请求将密钥发送给其签发提供商。 

 | 403 或访问被拒绝 | 检查密钥状态、所选分组、账户权限及请求的模型。 

 | 找不到模型或模型不受支持 | 从密钥的模型列表中复制准确的 ID。如果模型在列表中但仍无法使用，请联系支持团队，提供请求错误和 ID，不要提供密钥。 

 | 余额不足或没有符合条件的套餐 | 检查控制台余额、套餐有效期及密钥的访问分组。 

 | 404 或 HTML 响应 | 检查主机名、API 格式和路径。如果客户端会自动添加 /v1，请勿重复添加。 

 | 429、500 或 529 | 检查响应，必要时降低并发量，并按照 [API 错误指南](/zh/learn/claude-api-errors-troubleshooting/).  

## 在哪里查找和管理密钥 

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

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

## Claude API 密钥免费吗？ 

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

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

## 常见问题 

 如何获取 Claude API 密钥？

在 [Claude 控制台](https://platform.claude.com/settings/keys) 中创建密钥，以直接访问 Anthropic，或者 [注册 AI Prime Tech](/register)，选择合适的网关访问方式，并在控制台中创建密钥。请使用签发该密钥的提供商所对应的端点。 在哪里可以找到我的 Claude API 密钥？

在签发密钥的提供商控制台中打开“API 密钥”，并使用其中提供的密钥管理功能。请安全保存密钥值；如果无法找回，请创建替代密钥并撤销旧密钥。 可以获取免费的 Claude API 密钥吗？

创建密钥本身并不会为 API 请求提供使用额度。请查看签发提供商的当前条款。AI Prime Tech 的 [试用指南](/zh/learn/claude-api-free-trial/) 列出了当前的新用户优惠及条件。 Claude Pro 或 Max 订阅可以支付此网关的费用吗？

不可以。AI Prime Tech 有自己的账户、密钥和计费体系。请参阅 [API 访问与订阅的区别](/zh/learn/claude-api-vs-subscription/) ，以选择所需的产品。 应该使用哪个模型 ID？

使用网关密钥请求 GET /v1/models，并选择为该密钥返回的准确 Claude 模型 ID。完成一次小规模的 Messages 请求，验证该模型在你的访问权限下能否正常使用。  

几分钟内开始使用 Claude

获取 API 密钥，无需 Anthropic 账户，也无需加入候补名单。[获取你的 API 密钥](/register) 

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

## 更多 Claude API 指南

[Claude API 定价详解](/zh/learn/claude-api-pricing-explained/)[使用 Claude API 最便宜的方式](/zh/learn/cheapest-way-to-use-claude-api/)[通过 Claude API 不限量使用 Cursor](/learn/use-claude-api-with-cursor/)[不限量访问 Claude Code](/zh/learn/use-claude-api-with-claude-code/)[Claude API 网关与 Anthropic 直连对比](/zh/learn/claude-api-vs-anthropic-direct/)[通过 OpenAI SDK 使用 Claude：OpenAI 兼容端点、流式传输、工具与限制](/zh/learn/openai-compatible-claude-api/)[Claude 模型详解：Claude Opus、Sonnet、Haiku 与 Fable 的模型对比——全部 Claude API 模型、Anthropic 模型名称与价格（2026）](/zh/learn/claude-api-models-compared/)[使用加密货币支付 Claude API 费用](/zh/learn/claude-api-with-crypto-payment/)[无需候补名单即可访问 Claude API](/zh/learn/claude-api-without-waitlist/)[如何减少 Claude 词元用量](/zh/learn/how-to-reduce-claude-token-usage/)[通过 Claude API 不限量使用 Cline](/zh/learn/use-claude-api-with-cline/)[通过 Claude API 不限量使用 Roo Code](/zh/learn/use-claude-api-with-roo-code/)[在 JetBrains IDE 中不限量使用 Claude](/zh/learn/use-claude-api-with-jetbrains/)[通过网关在 Aider 中使用 Claude：ANTHROPIC_API_BASE、配置文件、架构师模式与问题修复](/zh/learn/use-claude-api-with-aider/)[在 VS Code 中不限量使用 Claude](/zh/learn/use-claude-api-with-vscode/)[OpenCode 的 Claude 配置：opencode.json 设置、模型与常见错误](/zh/learn/use-claude-api-with-opencode/)[通过网关在 Hermes Agent 中使用 Claude：自定义提供商配置、成本控制与问题修复](/zh/learn/run-hermes-agent-with-claude-api/)[使用 Claude 不限量运行 OpenClaw](/zh/learn/run-openclaw-with-claude-api/)[兼容 Anthropic 的 API 意味着什么](/zh/learn/anthropic-compatible-api/)[Claude Code API 密钥 — ANTHROPIC_API_KEY：如何获取、配置，以及何时应改用 claude setup-token](/zh/learn/claude-code-api-key-setup/)[Claude Code API 成本 — 定价与降低成本的方法](/zh/learn/claude-code-api-costs/)[Claude API 错误详解：服务器错误 500、过载 529、速率限制 429、错误请求 400 — 以及各自的修复方法](/zh/learn/claude-api-errors-troubleshooting/)[如何购买 Claude API 额度](/zh/learn/buy-claude-api-credits/)[Claude 免费 API：有免费的 Claude API 密钥吗？2026 年究竟有哪些内容免费？](/zh/learn/claude-api-free-trial/)[Claude API 与 Claude Pro/Max 订阅——如何选择](/zh/learn/claude-api-vs-subscription/)[通过自定义提供商使用 Codex CLI：config.toml、GPT 与 Claude 模型、IDE 扩展与问题修复](/zh/learn/use-claude-api-with-codex/)[将 Claude 连接到 n8n](/zh/learn/use-claude-api-with-n8n/)[通过 LiteLLM 路由到 Claude](/zh/learn/use-claude-api-with-litellm/)[在 Kilo Code 中使用 Claude](/zh/learn/use-claude-api-with-kilo-code/)[通过网关在 GitHub Copilot Chat 中使用 Claude：自定义端点配置、智能体模式与问题修复](/zh/learn/use-claude-api-with-github-copilot/)[通过网关将 Zed 连接到 Claude](/zh/learn/use-claude-api-with-zed/)[将 Cherry Studio 连接到 Claude](/zh/learn/use-claude-api-with-cherry-studio/)[LangChain 中的 ChatAnthropic：导入、base_url、流式传输、工具和错误](/zh/learn/use-claude-api-with-langchain/)[Anthropic Python SDK：安装、设置 base_url、流式传输和错误处理](/zh/learn/anthropic-python-sdk/)[通过 Vercel AI SDK 使用 Claude：createAnthropic baseURL、流式传输和问题修复](/zh/learn/use-claude-api-with-vercel-ai-sdk/)[使用 Claude 运行 Factory Droid](/zh/learn/use-claude-api-with-factory-droid/)[Claude Code API 详解](/zh/learn/claude-code-api/)[将 Claude API 集成到您的应用中](/zh/learn/claude-api-integration/)[如何不限量使用 Claude](/zh/learn/get-unlimited-claude-usage/)[不限量 Claude API 访问意味着什么](/zh/learn/unlimited-claude-api-access/)