教程

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 Cache Diagnostics 教程:定位 Prompt Cache Miss 的真正原因Claude Cache Diagnostics 解决 prompt cache miss 难排查问题。通过传入上一次 response id,API 会比较请求 fingerprint,告诉你 model/system/tools/messages 哪个部分破坏了缓存 prefix。2026/6/6教程Claude MCP Tunnels 指南:不用开放入站端口,也能把私有 MCP 服务接给 ClaudeMCP Tunnels 是 Anthropic 面向企业内网 MCP 服务的 beta 能力,通过 outbound-only 连接、cloudflared、proxy、inner TLS 和 OAuth,让 Claude 安全访问私有工具与数据源。2026/6/6教程Claude Mid-conversation System Messages 使用指南:长会话不再破坏 Prompt CacheClaude Opus 4.8 新增 mid-conversation system messages,可在长会话中途追加系统级指令,不改顶层 system prompt,从而保持缓存 prefix 命中,降低 Agent 循环成本。2026/6/6教程Claude Citations 完整指南:让 AI 回答带可验证引用,适合 RAG 与文档问答Claude Citations 官方能力中文整理:如何启用 citations.enabled、支持的文档类型、PDF 页码引用、文本字符索引、custom content block 索引、RAG chunk 粒度控制、与 Prompt Caching 兼容性和 Structured Outputs 不兼容限制。2026/5/21教程Claude Batch Processing 完整指南:批量处理任务如何节省 50% API 成本Claude Batch Processing 官方能力中文整理:为什么批处理能省钱、如何创建 batch、custom_id 设计、轮询状态、下载结果、处理失败请求,以及适合大规模分类、摘要、翻译、数据清洗的任务模式。2026/5/21教程Claude Prompt Caching 完整指南:降低长上下文成本与延迟的 API 实战Claude Prompt Caching 官方能力中文整理:适合缓存的内容、cache_control 使用方法、缓存断点策略、长文档和工具定义复用、成本/延迟收益、常见坑和生产环境落地建议。2026/5/21