Начало работы с Claude Agent SDK

Узнайте, как создавать приложения AI Agent с помощью Claude Agent SDK

Начало работы с Claude Agent SDK ¶

Claude Agent SDK — это официальный инструментарий разработки от Anthropic для создания AI Agent приложений на основе моделей Claude. В отличие от Claude Code (CLI инструмент), SDK предназначен для разработчиков и позволяет интегрировать возможности Claude в ваши собственные приложения.

Что такое Claude Agent SDK?¶

Claude Agent SDK предоставляет строительные блоки для создания приложений, которые могут:

Понимать инструкции на естественном языке и выполнять сложные задачи
Использовать инструменты (поиск, выполнение кода, файловые операции и т.д.)
Поддерживать контекст разговора для многоходовых взаимодействий
Подключаться к внешним сервисам (через MCP серверы)

Установка SDK ¶

Python SDK ¶

pip install anthropic

TypeScript SDK ¶

npm install @anthropic-ai/sdk

Быстрый старт ¶

Базовый вызов сообщения ¶

from anthropic import Anthropic

# Через API QCode.cc
client = Anthropic(
    base_url="https://api.qcode.cc/claude/v1",
    api_key="cr_your_api_key"
)

message = client.messages.create(
    model="claude-opus-4-7-20250514",
    max_tokens=4096,
    messages=[
        {"role": "user", "content": "Объясните, что такое RESTful API"}
    ]
)

print(message.content[0].text)

Потоковый ответ ¶

with client.messages.stream(
    model="claude-opus-4-7-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Напишите функцию быстрой сортировки на Python"}
    ]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Использование инструментов (Tool Use)¶

Tool Use — это ключевая возможность Agent, позволяющая модели вызывать внешние инструменты.

Определение инструментов ¶

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.qcode.cc/claude/v1",
    api_key="cr_your_api_key"
)

# Определение инструмента поиска
tools = [
    {
        "name": "search_web",
        "description": "Поиск информации в интернете",
        "input_schema": {
            "type": "object",
            "properties": {
                "query": {
                    "type": "string",
                    "description": "Поисковый запрос"
                }
            },
            "required": ["query"]
        }
    }
]

# Отправка сообщения с инструментами
message = client.messages.create(
    model="claude-opus-4-7-20250514",
    max_tokens=4096,
    messages=[
        {"role": "user", "content": "Вычислите (15 + 25) * 2"}
    ],
    tools=tools
)

# Обработка вызовов инструментов
for content in message.content:
    if content.type == "text":
        print(content.text)
    elif content.type == "tool_use":
        print(f"Вызов инструмента: {content.name}")

Настройка QCode.cc ¶

import os

# Метод 1: Переменная окружения
os.environ["ANTHROPIC_BASE_URL"] = "https://api.qcode.cc/claude/v1"
os.environ["ANTHROPIC_API_KEY"] = "cr_your_key"

client = Anthropic()  # Автоматическое чтение переменных окружения

# Метод 2: Прямое подключение к Шэньчжэню (рекомендуется для Китая)
client = Anthropic(
    base_url="http://103.236.53.153/api/claude/v1",
    api_key="cr_your_key"
)

Следующие шаги ¶

Справочник API - Полная документация по параметрам API
Руководство по выбору модели - Выбор подходящей модели
MCP серверы - Подключение внешних сервисов для расширения возможностей

← Предыдущая

subagents

Интеграция с VS Code

🚀

Начните с QCode — Claude Code & Codex

Один тариф для Claude Code и Codex, низкая задержка в Азии

Посмотреть тарифы → Создать аккаунт

Команда 3+?

Enterprise: выделенный домен + управление ключами + защита от бана, от ¥250/чел/мес

Enterprise →