Ваш первый вызов API
API позволяет вашей программе общаться с Claude. Три шага: получить ключ, установить SDK, отправить сообщение.
1. Получите API-ключ
Создайте его в консоли Anthropic. Затем задайте его как переменную окружения, чтобы он никогда не оказывался в вашем коде:
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— ограничение длины ответа (в токенах). Оно не задаёт контекстное окно.messages— диалог на текущий момент. API не сохраняет состояние: чтобы продолжить чат, отправляйте всю историю заново каждый раз.system(необязательно) — инструкция верхнего уровня, задающая роль Claude для этого вызова.
Далее
- Выберите подходящую модель и оцените стоимость → Выбор модели · Токены и стоимость
- Стримьте ответы и ведите диалог → Стриминг и многоходовые диалоги
- Позвольте Claude вызывать ваши функции → Использование инструментов
- Готовые к продакшену сниппеты → Сниппеты API