Руководство разработчика Claude Agent SDK
Claude Code SDK официально переименован в Claude Agent SDK с расширенными возможностями для создания AI-агентов. Руководство охватывает быстрый старт Python/TypeScript, основные концепции и корпоративные практики.
Что такое Claude Agent SDK
seo_agent_sdk.rename_title
seo_agent_sdk.rename_desc
seo_agent_sdk.why_rename_title
seo_agent_sdk.why_rename_desc
Единый интерфейс инструментов
Использует ту же систему инструментов и цикл агента, что и Claude Code. Бесшовное переключение между локальным и облачным деплоем.
Готов к продакшену
Встроенный retry, управление сессиями, потоковый вывод и другие корпоративные функции работают «из коробки».
Многоязычная поддержка
Официальные SDK для Python и TypeScript с симметричным API и исчерпывающей документацией.
Основные концепции
Инструменты (Tools)
Функции, вызываемые агентом. Объявляются декораторами с автогенерацией JSON Schema для понимания и вызова Клодом.
Цикл агента
Claude думает → выбирает инструмент → выполняет → наблюдает результат → продолжает думать. Цикл до завершения задачи.
Память / Контекст
Единое управление кратковременной (история диалога) и долговременной (файлы/БД) памятью.
Разрешения
Тонкое управление правами: файловая система, сеть, выполнение кода, внешние API — каждый аспект настраивается отдельно.
Быстрый старт на Python
Первый Claude Agent за три шага, полностью совместимо с прокси QCode.cc.
Шаг 1: Установка SDK
pip install anthropic-agent-sdkШаг 2: Создание агента
from anthropic_agent_sdk import Agent, tool
@tool
def get_weather(city: str) -> str:
"""Get current weather for a city"""
return f"Weather in {city}: 22°C, sunny"
agent = Agent(
model="claude-opus-4-7",
tools=[get_weather],
base_url="https://api.qcode.cc", # QCode.cc proxy
api_key="your-api-key",
)
result = agent.run("What's the weather in Beijing and Shanghai?")
print(result.output)Шаг 3: Пользовательские инструменты
from anthropic_agent_sdk import Agent, tool
import requests
@tool
def search_web(query: str, max_results: int = 5) -> list[dict]:
"""Search the web and return results"""
# Your search implementation here
response = requests.get(f"https://api.search.example.com?q={query}&n={max_results}")
return response.json()["results"]
@tool
def read_file(path: str) -> str:
"""Read contents of a local file"""
with open(path, "r") as f:
return f.read()
agent = Agent(
model="claude-opus-4-7",
tools=[search_web, read_file],
base_url="https://api.qcode.cc",
api_key="your-api-key",
system="You are a helpful research assistant.",
)
result = agent.run("Search for recent news about Claude Agent SDK and summarize")
print(result.output)Быстрый старт на TypeScript
Разработка Claude Agent в Node.js / Bun с полной поддержкой типов.
Шаг 1: Установка SDK
npm install @anthropic-ai/agent-sdkШаг 2: Создание агента
import { Agent, tool } from '@anthropic-ai/agent-sdk';
const getWeather = tool({
name: 'get_weather',
description: 'Get current weather for a city',
parameters: { city: { type: 'string' } },
execute: async ({ city }) => `Weather in ${city}: 22°C, sunny`,
});
const agent = new Agent({
model: 'claude-opus-4-7',
tools: [getWeather],
baseURL: 'https://api.qcode.cc',
apiKey: process.env.ANTHROPIC_API_KEY,
});
const result = await agent.run("What's the weather in Beijing?");
console.log(result.output);Шаг 3: Полный пример
import { Agent, tool } from '@anthropic-ai/agent-sdk';
const searchWeb = tool({
name: 'search_web',
description: 'Search the web for information',
parameters: {
query: { type: 'string', description: 'Search query' },
maxResults: { type: 'number', description: 'Max results', default: 5 },
},
execute: async ({ query, maxResults = 5 }) => {
const res = await fetch(`https://api.search.example.com?q=${query}&n=${maxResults}`);
const data = await res.json();
return data.results;
},
});
const agent = new Agent({
model: 'claude-opus-4-7',
tools: [searchWeb],
baseURL: 'https://api.qcode.cc',
apiKey: process.env.ANTHROPIC_API_KEY,
systemPrompt: 'You are a helpful research assistant.',
maxTurns: 10,
});
// Streaming support
for await (const event of agent.stream("Research the latest AI agent frameworks")) {
if (event.type === 'text') process.stdout.write(event.text);
}Agent SDK vs Managed Agents
| seo_agent_sdk.vs_col_feature |
seo_agent_sdk.vs_col_sdk
|
seo_agent_sdk.vs_col_managed
|
|---|---|---|
| seo_agent_sdk.vs_row1_feature | Самостоятельный хостинг (локально/свой сервер) | Облако Anthropic |
| seo_agent_sdk.vs_row2_feature | Ручное управление инстансами | Автоматическое эластичное масштабирование |
| seo_agent_sdk.vs_row3_feature | Прототипирование, нестандартные сценарии | Корпоративный продакшен-деплой |
Использование через QCode.cc
Установите ANTHROPIC_BASE_URL на эндпоинт QCode.cc — все функции Agent SDK будут стабильно работать без VPN.
# Python SDK
ANTHROPIC_BASE_URL=https://api.qcode.cc
ANTHROPIC_API_KEY=your-qcode-api-key
# TypeScript SDK
ANTHROPIC_BASE_URL=https://api.qcode.cc
ANTHROPIC_API_KEY=your-qcode-api-key
# Or set inline
agent = Agent(
base_url="https://api.qcode.cc",
api_key="your-qcode-api-key",
)Все модели Claude (Opus 4.7/Sonnet 4.6/Haiku 4.5) доступны
Полная поддержка вызовов инструментов (Function Calling)
Поддержка потокового вывода (Streaming)
Полная совместимость с Managed Agents API
Начните создавать AI-агентов прямо сейчас
Зарегистрируйтесь на QCode.cc для стабильного доступа к Claude API с поддержкой всех функций Agent SDK.