你的第一次 API 调用
API 让 你的 程序与 Claude 通信。三个步骤：获取密钥、安装 SDK、发送消息。
1. 获取 API 密钥
在 Anthropic Console 中创建一个。然后将它设置为环境变量，这样它就永远不会出现在你的代码里：
export ANTHROPIC_API_KEY="sk-ant-..."
:::warning 切勿提交你的密钥 将密钥保存在环境变量或密钥管理器中——永远不要放进源代码管理。参见 安全。 :::
2. 安装 SDK
- Python
- TypeScript
- cURL
pip install anthropic
npm install @anthropic-ai/sdk
无需安装任何东西——你只需要 curl。
3. 发起调用
每个请求都是一个 messages 列表。模型以 content 回复。
- Python
- TypeScript
- cURL
import anthropic
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY from the environment
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[
{"role": "user", "content": "In one sentence, what is an API?"}
],
)
print(message.content[0].text)
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic(); // reads ANTHROPIC_API_KEY from the environment
const message = await client.messages.create({
model: "claude-sonnet-4-6",
max_tokens: 1024,
messages: [
{ role: "user", content: "In one sentence, what is an API?" },
],
});
console.log(message.content[0].text);
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": 1024,
"messages": [
{"role": "user", "content": "In one sentence, what is an API?"}
]
}'
刚才发生了什么
model— 使用哪个 Claude。不要盲目硬编码；参见 选择模型。max_tokens— 回复长度的上限（以 token 计）。它 不 设置上下文窗口。messages— 目前为止的对话。该 API 是 无状态的：要继续一次对话，每次都要把全部历史发回去。system（可选）— 一条顶层指令，为本次调用设定 Claude 的角色。