教程

Claude API Key 申请完整教程:从注册 Anthropic Console 到第一次调用

Claude API Key 申请完整指南:Anthropic Console 注册、充值方式、API Key 生成与管理、Python/curl 第一次调用验证、用量监控、费用控制与限额设置,以及免费额度和各模型计费说明。

2026/3/153分钟 阅读ClaudeEagle

想用代码调用 Claude,或者给 Claude Code 配置 API Key,都需要先在 Anthropic Console 申请 Key。本文一步步带你完成全流程。

第一步:注册 Anthropic 账号

  1. 访问 console.anthropic.com
  2. 点击「Sign up」
  3. 用邮箱注册,或 Google/GitHub 账号直接登录
  4. 完成邮箱验证

注意:Console 账号和 claude.com(Claude 聊天)账号是分开的,但同一邮箱注册后会关联。

第二步:充值(添加支付方式)

Console 账号需要先充值才能使用 API(API 调用按量计费,不是订阅)。

  1. 登录后点击右上角头像 -> Billing
  2. 点击「Add payment method」
  3. 输入信用卡信息(支持 Visa/Mastercard,支持双币卡)
  4. 首次充值建议 $5-10 先测试

充值后可用余额马上生效,无需等待审核。

关于免费额度:新账号通常有少量免费 Token 用于测试,但额度较小(约 $5),实际生产使用需要充值。

第三步:生成 API Key

  1. 左侧菜单点击「API Keys
  2. 点击「+ Create Key
  3. 给 Key 起个名字(例如:my-app-prodclaude-code-local
  4. 点击「Create」
  5. 复制并保存 Key(只会显示一次!格式:sk-ant-api03-xxxx
API Key 格式示例: sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxx-xxxx

最佳实践

  • 不同项目用不同的 Key,便于单独撤销
  • 绝对不要把 Key 提交到 git 仓库
  • 把 Key 存在环境变量里,不要硬编码

第四步:验证 API Key(curl)

bash
export ANTHROPIC_API_KEY=sk-ant-api03-你的key

curl https://api.anthropic.com/v1/messages \
  -H 'x-api-key: '$ANTHROPIC_API_KEY \
  -H 'anthropic-version: 2023-06-01' \
  -H 'content-type: application/json' \
  -d '{
    "model": "claude-haiku-3-5",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "Hello! Say hi back in one sentence."}]
  }'

成功返回示例:

json
{
  "id": "msg_01xxx",
  "type": "message",
  "role": "assistant",
  "content": [{"type": "text", "text": "Hi there! Happy to chat with you today."}]
}

第五步:Python 调用

bash
pip install anthropic
python
import anthropic, os

client = anthropic.Anthropic(
    api_key=os.environ.get('ANTHROPIC_API_KEY')
)

message = client.messages.create(
    model="claude-haiku-3-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude!"}]
)

print(message.content[0].text)

配合 Claude Code 使用

有了 API Key,可以跳过 OAuth 登录直接用 Claude Code:

bash
export ANTHROPIC_API_KEY=sk-ant-api03-你的key
claude  # 直接启动,使用你的 API Key 计费

用量监控和费用控制

查看用量

Console -> Usage 页面,可以看到:

  • 每日/每月的 Token 消耗
  • 按模型分类的用量
  • 实时费用统计

设置用量限额(防超支)

Console -> Billing -> Usage limits

Monthly spend limit: $50 # 每月最多花 $50 Alert threshold: $30 # 到 $30 时发邮件提醒

强烈建议新用户设置限额,避免意外超支。

各模型价格参考(2026)

模型输入(/百万 Token)输出(/百万 Token)
claude-haiku-3-5$0.80$4.00
claude-sonnet-4-6$3.00$15.00
claude-opus-4-6$15.00$75.00

日常测试建议用 Haiku,成本最低,1000 次对话大约 $0.05。

常见问题

Q:充值后还是报 401? 检查 API Key 是否完整复制,格式为 sk-ant-api03- 开头。

Q:中国大陆可以注册吗? 可以注册,但部分地区需要代理访问 console.anthropic.com。

Q:API Key 泄露了怎么办? 立即去 Console -> API Keys 页面点击「Revoke」撤销,然后重新生成。

Q:Console 账号和 Claude Pro 订阅的区别? Console 是 API 按量计费,适合开发者调用 API。Claude Pro 是订阅制,适合直接在 claude.ai 聊天或用 Claude Code。


来源:Anthropic Console 官方文档

相关文章推荐

教程Claude API Vision 图像理解完全指南:图片分析、截图解读与多图处理Claude API 视觉能力(Vision)完整使用指南:支持的图像格式(PNG/JPEG/GIF/WebP)与大小限制、Base64 编码图像传入方式、URL 直接引用图像、多张图片同时分析、图像与文字混合输入、典型应用场景(截图调试/图表解读/文档扫描/UI分析)、图像 Token 计算方式和成本优化,以及 Python/TypeScript 完整代码示例。2026/3/20教程Claude API 流式输出完全指南:Server-Sent Events 实时响应实战Claude API 流式输出(Streaming)完整教程:为什么用流式输出(用户体验提升50%+)、Server-Sent Events 协议原理、Python/Node.js/curl 三种实现方式、stream=True 的事件类型(message_start/content_block_delta/message_stop)、流式 Tool Use 的特殊处理、在 FastAPI/Express/Next.js 中实现流式 API 端点,以及流式输出的错误处理和超时配置。2026/3/20教程Anthropic Node.js SDK 完全指南:TypeScript/JavaScript 接入 Claude APIAnthropic 官方 Node.js SDK(@anthropic-ai/sdk)完整教程:安装与初始化、基础对话调用、流式输出(stream)、图像输入(Base64/URL)、Tool Use 函数调用、系统提示、消息历史管理、Prompt Caching 配置、错误处理最佳实践(指数退避重试),以及 TypeScript 类型系统深度使用,适合 Node.js / Next.js / NestJS 开发者快速上手。2026/3/20教程Anthropic Python SDK 完全指南:从安装到生产级集成的最佳实践Anthropic Python SDK 完整使用指南:安装配置、同步与异步客户端、流式输出、工具调用(Tool Use)、视觉 API、Prompt Caching、错误处理与重试、Token 用量追踪、httpx 客户端自定义,以及在 Django/FastAPI/Flask 框架中的集成最佳实践。2026/3/16教程大模型 Token 是什么?如何估算成本并减少 API 费用大模型 Token 完整解析:Token 定义与中英文计算规律、API 费用双向计费机制、上下文长度与成本关系,以及 5 个降低 API 费用的方法(选对模型/批量 API 省 50%/Prompt 缓存省 90%/控制输出长度/管理对话上下文),附 Anthropic Console 成本监控指南。2026/3/13教程Claude API 接入完全教程:从零开始调用 Claude,Python/Node.js 实战(2026)Claude API 从零接入完整教程:Console 注册与 API Key 获取、核心接口概览、Python/Node.js SDK 安装与首次调用、多轮对话、流式输出、System Prompt 配置、REST 直调、模型选择、Token 成本控制与批量 API 省费技巧。2026/3/13