Claude API Key 怎么申请和使用：密钥、首次调用与报错排查

先找到正确的密钥入口

从 Claude API 认证文档进入 Console，在 API keys 设置中创建密钥。注意当前组织和工作区，密钥的权限与归属会影响能访问的资源。

给测试用途的密钥起一个容易辨认的名称，并在可用时设置合适的到期时间。完整密钥不要放进前端代码、截图、公开仓库或聊天记录。若已经泄露，应在控制台撤销并替换；仅删除本地文件不能让泄露的密钥失效。

用环境变量保存配置

在运行程序的环境中设置 ANTHROPIC_API_KEY，值填你自己创建的密钥；再设置 AIZX_TEST_MODEL，值使用账户当前可访问的完整模型 ID。下面不写死模型名称，避免把已更名或无权限的模型当作通用入口。

安装官方 Python SDK：

1python3 -m pip install anthropic

如果使用项目虚拟环境，应先激活对应环境，确保安装和运行使用同一个 Python。不要把环境变量的值提交到 Git。

发起一次最小请求

将下面代码保存为 claude_check.py。SDK 从环境变量读取密钥；本例仅发送一条短文本，用来检查认证、模型权限和响应解析，不代表性能测试。

1import os
2from anthropic import Anthropic
3
4client = Anthropic()
5reply = client.messages.create(
6    model=os.environ["AIZX_TEST_MODEL"],
7    max_tokens=128,
8    messages=[{"role": "user", "content": "请用一句中文解释 API。"}],
9)
10for block in reply.content:
11    if block.type == "text":
12        print(block.text)

运行 python3 claude_check.py。看到文本后，到 Console 核对请求用量与费用归属。一次成功只证明这组配置在这个时刻能够调用，不证明长期稳定、所有模型可用或没有费用。

示例结构依据 Claude API 入门文档。执行请求可能产生 API 费用，先核对官方 API 价格。

报错时先看状态码和错误正文

401： 优先检查密钥是否复制完整、已撤销或已过期，以及当前进程有没有读到新配置。
402： 检查开发平台账单或支付信息。
403： 核对组织、工作区和目标资源权限。
404： 检查接口路径和模型等资源标识，不要只盲目换密钥。
429： 阅读错误正文，区分速率限制与额度/支出限制，再决定等待还是处理账单；不能把所有 429 都当作服务器故障。
500、504、529： 对照服务状态并保留请求 ID，避免密集重复重试。

错误语义以官方错误说明为准。转述问题时可提供状态码、时间、模型 ID 和脱敏的错误内容，完整密钥不属于排错材料。

接通后再测速度和成本

先固定模型、提示词和输出长度，再使用 API 测速记录多次样本。想比较服务商，结合中转站价格核对计费单位；模型名称或一次响应不能单独证明上游身份。

本文示例按官方文档整理，未展示真实密钥或付费调用实测。来源核对于 2026 年 9 月 9 日。更多计费边界见会员与 API 的区别。