从注册到第一个 API 请求，15 分钟跑通 Claude

上周又有朋友来问我”Claude API 怎么用”，我发现每次都要重讲一遍，干脆整理成文。

这篇是完全按照”一个新手第一次碰 Claude API”的真实顺序来的，我自己按表计了时——从注册到第一个请求跑出来，熟手 5 分钟，生手大概 15 分钟。

Step 1：到 console.anthropic.com 注册

这个地址要认准。不是 claude.ai（那是聊天产品），是 console.anthropic.com（开发者后台）。

国内用户一个现实问题：注册需要一个能接收短信验证码的手机号，国内号码是收不到的，需要一个海外号或者能收海外短信的虚拟号。这不是 Claude 的问题，是 Anthropic 现在的注册门槛。解决方案我就不在这里展开了，网上方案很多。

注册完之后登录，左侧菜单找 Billing，先把付款方式加上。没有付款方式的账号有免费额度但很少，几次测试就花完了。

Step 2：创建一个 API Key

Dashboard 左侧 API Keys → Create Key，给它起个名字比如 local-dev，点生成。

关键：这个 key 只会显示一次。复制下来立刻存好，页面关了就看不到了，只能重新生成。

存到哪？别存到代码里。我见过不止三个朋友把 key 直接 commit 到 GitHub 公开仓库的——有人 20 分钟内就收到 Anthropic 的告警邮件说 key 已经泄漏自动禁用了，运气好没扣钱；有人没这么走运，被人刷了 300 多刀。

Step 3：把 key 存到环境变量

Mac/Linux，在 ~/.zshrc 或 ~/.bashrc 加一行：

1	export ANTHROPIC_API_KEY="sk-ant-xxx..."

然后 source ~/.zshrc。

Windows PowerShell：

1	[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY","sk-ant-xxx...","User")

重开一下 terminal。

验证：echo $ANTHROPIC_API_KEY（Windows 是 echo $env:ANTHROPIC_API_KEY），能打出 sk-ant- 开头的字符串就 OK。

Step 4：第一个 curl 请求

测通这个说明网络+key 都没问题：

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

正常情况下你会看到一个 JSON 返回，里面 content[0].text 就是 Claude 的回答。

跑不通？往下看 Step 7 的排错清单。

Step 5：Python 版

我假设你装了 Python 3.10+。

1	pip install anthropic

写一个 hello.py：

from anthropic import Anthropic

client = Anthropic()  # 会自动读 ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=200,
    messages=[
        {"role": "user", "content": "用三句话介绍一下 Anthropic"}
    ]
)

print(response.content[0].text)
print(f"\n---\n输入 tokens: {response.usage.input_tokens}")
print(f"输出 tokens: {response.usage.output_tokens}")

python hello.py，看到回答就成了。注意最后两行——这是我强烈建议你第一天就加上去的，永远打印 token 用量，后面我会讲为什么。

Step 6：Node.js 版

1	npm install @anthropic-ai/sdk

hello.mjs：

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

const response = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 200,
  messages: [{ role: "user", content: "用三句话介绍一下 Anthropic" }],
});

console.log(response.content[0].text);
console.log(`input: ${response.usage.input_tokens} / output: ${response.usage.output_tokens}`);

node hello.mjs。

Step 7：报错了怎么办

按出现频率排：

401 Unauthorized：key 错了。检查环境变量是不是真的生效了，有没有多余的空格或引号。最常见是 Windows 下 SetEnvironmentVariable 之后没重开 terminal。

429 Too Many Requests：限流。免费账号和刚加付款方式的账号初始限额很低。查 Anthropic console 里的 Limits 页面，看你当前等级。等几分钟重试，或者充值提升等级。

400 Invalid Request：参数有问题。最常见是 model 名字写错（比如写成 claude-4.6-sonnet 这种倒过来的），或者 max_tokens 忘了填，或者 messages 里 role 不是 user/assistant。错误返回 JSON 里通常会告诉你具体哪个字段有问题，认真看一眼。

500 / 529：Anthropic 自己的问题或者过载。重试，或者上 status.anthropic.com 看看。

ConnectionError：网络问题。国内访问需要稳定的出口，不然会很痛苦。

那个我刚开始不知道的计费小坑

讲几个官方文档写了但你不读就发现不了的事：

输出比输入贵 5 倍。Sonnet 4.6 输入 3 美元/百万 tokens，输出 15 美元/百万 tokens。意思是你生成 1000 字的成本比你输入 1000 字高得多。所以如果你在做”让 Claude 大段生成”的任务，成本主要在输出端。我有个朋友第一周账单爆了，就是因为他让 Claude 一次性生成 30K tokens 的长文，一天 200 次。

缓存 tokens 单独计费，但便宜很多。同一段 prompt（比如系统提示词）重复用的时候，Anthropic 允许你缓存它，缓存命中的 token 只收 10% 的价钱。我在这篇 prompt caching 深度指南里写得很细，如果你的系统 prompt 长、且重复调用——比如 RAG、客服 bot、Agent workflow——一定要配置它，能省 60% 以上。

**max_tokens 不是”期望输出”是”最多输出”**。但你设 8000 和设 200 的成本差异只体现在实际生成了多少——没生成的不收费。所以设大点没事。但如果你不设限，模型可能真的给你写 8000，一次把你一天的预算吃光。

batch API 打 50% 折扣。如果你不需要实时响应、可以异步等几小时，用 batch API 价格直接砍半。批量跑总结、分类、翻译这种活非常适合。

跑通之后的下一步

第一个请求跑通之后我建议你做三件事：

一是把 print(response.usage) 这行代码作为永久习惯留着。成本意识是用 API 的第一课。

二是去试试 streaming 模式（client.messages.stream(...)），用户体验完全不一样。

三是搞清楚 Claude 的三档模型价格差异，按任务选型——三档选型这篇我详细写过。

想系统学 Claude？

跑通 API 之后，强烈建议立刻学prompt caching 深度配置，这是省钱的第一优先级。想搭真正的产品，Agent SDK 架构设计这篇从 0 讲到可上线。想知道什么时候该用 API 什么时候用桌面端，四个入口对比能给你清晰答案。