Как использовать API Claude Opus 4.5

CometAPI
AnnaNov 24, 2025
Как использовать API Claude Opus 4.5

Компания Anthropic выпустила Claude Opus 4.5 в конце ноября 2025 года как более функциональную и эффективную модель класса Opus, ориентированную на профессиональную разработку программного обеспечения, агентные рабочие процессы и долгосрочные задачи. Она доступна через платформу разработки Anthropic и через CometAPI и представляет новые элементы управления API (в частности, параметр трудозатрат), улучшенные инструменты для работы с компьютером, расширенное мышление и повышение эффективности токенов, что важно в производственной среде.

Ниже приведено практическое профессиональное пошаговое руководство: что изменилось, как получить доступ, как использовать новые элементы управления (усилия, расширенное мышление, использование инструментов, использование файлов/компьютера), рекомендации по затратам и оптимизации, соображения безопасности/управления и реальные шаблоны интеграции.

Что именно представляет собой Claude Opus 4.5 и почему это важно?

Claude Opus 4.5 — новейшая модель семейства Opus от Anthropic (выпущена 24–25 ноября 2025 г.), ориентированная на максимальную производительность рассуждений и кодирования, а также повышение эффективности токенов и предоставление новых элементов управления API для баланса между стоимостью и тщательностью. Anthropic позиционирует Opus 4.5 как «самую интеллектуальную модель» из всех выпущенных, ориентированную на сложные задачи разработки программного обеспечения, долго выполняющиеся агенты, автоматизацию электронных таблиц/Excel и задачи, требующие непрерывных многошаговых рассуждений.

Каковы основные обновления в Opus 4.5?

Компания Anthropic разработала Opus 4.5 для улучшения глубина рассуждений и агентный Поведение, предоставляя разработчикам лучший контроль над соотношением стоимости и задержки. Основные моменты выпуска:

  • Параметр усилия (бета): первоклассный API-регулятор, который контролирует, сколько «бюджета на размышления» Клод тратит на запрос (обычно low, medium, high). Он влияет на рассуждения, вызовы инструментов и внутренние маркеры «мышления», так что вы можете настраивать скорость и полноту для каждого вызова, а не переключаться между моделями. Это фирменная возможность Opus 4.5.
  • Лучшая оркестровка агентов и инструментов: Повышенная точность выбора инструментов, улучшенная структурированность вызовов инструментов и более надёжный рабочий процесс «инструмент-результат» для агентов по сборке и многоэтапных конвейеров. Anthropic поставляет документацию и руководство SDK для потока «использование инструментов».
  • Токен/эффективность затрат — Anthropic сообщает об уменьшении использования токенов примерно на 50% для некоторых рабочих процессов по сравнению с Sonnet 4.5, а также о меньшем количестве ошибок вызова инструментов и меньшем количестве итераций для сложных инженерных задач.
  • Расширенные мультимодальные возможности: Комплексное улучшение зрительных, рассудочных и математических способностей.
  • Окно контекста расширено до 200 тыс. токенов, что позволяет вести глубокие, продолжительные беседы и сложный анализ документов.

Какие практические возможности улучшились?

Обновление производительности

  • Улучшенная оркестровка агентов и инструментов: повышенная точность выбора инструментов, более структурированные вызовы инструментов и более надёжный рабочий процесс «инструмент-результат» для построения агентов и многоэтапных конвейеров. Anthropic поставляет документацию и руководство SDK для потока «использования инструментов». Улучшенная обработка контекста, помощники по уплотнению для длительных запусков агентов и первоклассные инструментальные SDK для регистрации и проверки инструментов делают Opus 4.5 более подходящим для построения агентов, работающих автоматически на многих этапах.
  • Расширенные мультимодальные возможности: комплексное улучшение визуальных, рассуждающих и математических способностей.
  • Окно контекста расширено до 200 тыс. токенов, что позволяет вести глубокие, продолжительные беседы и сложный анализ документов.

Кодирование и долгосрочная работа

Opus 4.5 по-прежнему ориентирован на бенчмарки для задач кодирования; он сокращает количество итераций и ошибок вызова инструментов при длительных задачах (миграция кода, рефакторинг, многоэтапная отладка). Первые отчёты и системная заметка Anthropic свидетельствуют об улучшении устойчивой производительности в инженерных бенчмарках и значительном росте эффективности конвейеров, основанных на инструментах.

In SWE-скамья, Opus 4.5 сообщает о ведущих результатах в тестах по разработке программного обеспечения (Anthropic указывает 80.9% на SWE-bench Verified в материалах о запуске), а клиенты сообщают об улучшениях в отладке, редактировании нескольких файлов и задачах с длительным горизонтом разработки кода.

Клод Опус 4.5-SWE-1

Стоимость и эффективность

Компания Anthropic разработала Opus 4.5 для улучшения глубина рассуждений и агентный поведение, предоставляя разработчикам лучший контроль над компромиссами между стоимостью и задержкой:

  • Снижение цены по сравнению с opus 4.1: $5 (вход) / $25 (выход) за миллион токенов.
  • Улучшение использования токенов: среднее сокращение потребления на 50–75% при сохранении производительности.
  • первоклассный API-регулятор, который контролирует, сколько «бюджета на размышления» Клод тратит на запрос (обычно low, medium, high). Он влияет на рассуждения, вызовы инструментов и внутренние токены «мышления», позволяя настраивать соотношение скорости и тщательности для каждого вызова, а не переключать модели. Это фирменная возможность Opus 4.5 (по сравнению с Sonnet 4.5: средний уровень затрат → на 76% меньше токенов, сопоставимая производительность; высокий уровень затрат → повышение производительности на 4.3%, снижение использования токенов на 48%).

Как получить доступ и использовать API Claude Opus 4.5?

Как я могу получить доступ и ключи?

  1. Создайте учетную запись разработчика Anthropic/Claude. Зарегистрируйтесь на портале разработчиков Claude/Anthropic и создайте ключ API через Консоль (для команд предусмотрены потоки управления организацией и администрированием). API сообщений — это основная конечная точка для взаимодействия в стиле чата и помощника.
  2. Партнеры по облаку: Opus 4.5 также доступен на основных торговых площадках Google Vertex AI, CometAPI(Платформа агрегации API ИИ, необходимо использовать ее аутентификацию)). В CometAPI вы можете получить доступ к API Claude opus 4.5 через формат Anthropic Messages и формат чата.

Как мне следует подтверждать подлинность моих запросов?

Используйте стандартные токены на предъявителя: включите Authorization: Bearer $_API_KEY Заголовок при каждом вызове API. Запросы передаются в формате JSON по протоколу HTTPS; API сообщений принимает список структурированных сообщений (система + пользователь + помощник).

Быстрый старт — Python (официальный SDK)

Установите SDK:

pip install anthropic

Минимальный пример (синхронный):

import os
from anthropic import Anthropic

# expects ANTHROPIC_API_KEY in env

client = Anthropic(api_key=os.environ)

resp = client.messages.create(
    model="claude-opus-4-5-20251101",
    messages=,
    max_tokens=512,
)

print(resp.content.text)  # SDK returns structured content blocks

В этом вызове используется канонический идентификатор модели Opus 4.5. Для конечных точек, управляемых провайдером (Vertex, CometAPI, Foundry), следуйте документации провайдера, чтобы создать клиент и предоставить URL-адрес и ключ провайдера (например, https://api.cometapi.com/v1/messages для CometAPI).

Быстрый старт — Python (CometAPI)

Вам необходимо войти в CometAPI и получить ключ.

curl 
--location 
--request POST 'https://api.cometapi.com/v1/messages' \ 
--header 'Authorization: Bearer ' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{ "model": "claude-opus-4-5-20251101", "max_tokens": 1000, "thinking": { "type": "enabled", "budget_tokens": 1000 }, "messages":  }'

Как использовать новый усилие параметр и расширенное мышление?

В чём усилие параметр и как его установить?

The усилие Параметр — это первоклассный элемент управления API, представленный в Opus 4.5, который регулирует объем внутренних вычислений и бюджет токенов, затрачиваемых моделью на создание выходных данных. Типичные значения: low, medium и high. Используйте его для баланса между задержкой и стоимостью токенов и тщательностью:

  • low — быстрые и эффективные решения для автоматизации больших объемов данных и рутинных задач.
  • medium — сбалансированное соотношение качества и стоимости для производственного использования.
  • high — глубокий анализ, многошаговое рассуждение или случаи, когда точность имеет наибольшее значение.

Антропный введен effort Для Opus 4.5 (бета). Необходимо включить заголовок бета-версии (например, effort-2025-11-24) и укажите output_config: { "effort": "low|medium|high" } (пример показан ниже). high Это поведение по умолчанию. Уменьшение усилий уменьшает использование токенов и задержку, но может немного снизить тщательность. Используйте этот вариант для задач с высокой пропускной способностью или чувствительных к задержкам.

Пример:

# Example using the beta messages API shown in Anthropic docs

from anthropic import Anthropic
import os

client = Anthropic(api_key=os.getenv("ANTHROPIC_API_KEY"))

response = client.beta.messages.create(
    model="claude-opus-4-5-20251101",
    betas=,   # required beta header

    messages=,
    max_tokens=1500,
    output_config={"effort": "medium"}  # low | medium | high

)

print(response)

Когда какой использовать: используют low для автоматизированных конвейеров (например, категоризация электронной почты), medium для стандартных помощников и high для генерации кода, глубоких исследований или задач, чувствительных к риску. Anthropic выделяет этот параметр как ключевой элемент управления для Opus 4.5.

В тесте SWE-bench:

  • В режиме «Среднее усилие»: производительность сравнима с Sonnet 4.5, но выходные токены уменьшены на 76%;
  • В режиме High Effort: производительность превышает Sonnet 4.5 примерно на 4.3 процентных пункта, а токены сокращаются на 48%.

Клод Опус 4.5-SWE-2

Что такое расширенное мышление и как его активировать?

Расширенное мышление (также называемое «расширенным мышлением» или «мыслительными блоками») позволяет модели выполнять промежуточные цепочки мыслей или пошаговые рассуждения, при необходимости сохраняя или суммируя внутренние мыслительные блоки. API Messages поддерживает это поведение, а Anthropic добавил элементы управления для сохранения предыдущих мыслительных блоков, чтобы многошаговые агенты могли повторно использовать предыдущие рассуждения без повторных дорогостоящих вычислений. Используйте расширенное мышление, когда задача требует многошагового планирования, решения долгосрочных задач или оркестровки инструментов.

Как интегрировать инструменты и построить агенты с Opus 4.5?

Одной из главных сильных сторон Opus 4.5 является улучшение использование инструмента: определите инструменты в своем клиенте, позвольте Клоду решить, когда их вызывать, запустите инструмент и верните tool_result — Клод будет использовать эти результаты в своём окончательном ответе. Anthropic предоставляет Agent SDK, которые позволяют регистрировать типизированные инструментальные функции (например, run_shell, call_api, search_docs), которые Клод может обнаружить и вызвать в процессе расширенного мышления. Платформа преобразует определения инструментов в вызываемые функции, которые модель может вызывать и получать от них результаты. Таким образом, вы можете безопасно создавать агентные рабочие процессы (с контролируемыми входами и выходами).

Ниже приведен практический шаблон и сквозной пример на Python.

Модель использования инструментов (концептуальная)

  1. Клиентские поставки tools метаданных с именем, описанием и схемой JSON (input_schema).
  2. Модель возвращает tool_use блок (структурированная инструкция модели для вызова конкретного инструмента с заданными входными данными). Ответ API stop_reason может быть tool_use.
  3. Клиент выполняет инструмент (ваш код вызывает внешний API или локальную функцию).
  4. Клиент отправляет последующее сообщение role:"user" и еще один tool_result блок контента, содержащий результаты работы инструмента.
  5. Модель использует результат инструмента и возвращает окончательный ответ или дальнейшие вызовы инструмента.

Этот поток обеспечивает безопасный контроль со стороны клиента над тем, что выполняет модель (модель предлагает вызовы инструментов; вы управляете выполнением).

Пример от начала до конца — Python (простой инструмент прогноза погоды)

# 1) Define tools metadata and send initial request

from anthropic import Anthropic
import os, json

client = Anthropic(api_key=os.environ)

tools = [
    {
        "name": "get_weather",
        "description": "Return the current weather for a given city.",
        "input_schema": {"type":"object","properties":{"city":{"type":"string"}},"required":}
    }
]

resp = client.messages.create(
    model="claude-opus-4-5-20251101",
    messages=,
    tools=tools,
    max_tokens=800,
)

# 2) Check if Claude wants a tool call

stop_reason = resp.stop_reason  # SDK field

if stop_reason == "tool_use":
    # Extract the tool call (format varies by SDK; this is schematic)

    tool_call = resp.tool_calls  # e.g., {"name":"get_weather", "input":{"city":"Tokyo"}}

    tool_name = tool_call
    tool_input = tool_call

    # 3) Execute the tool client-side (here: stub)

    def get_weather(city):
        # Replace this stub with a real weather API call

        return {"temp_c": 12, "condition": "Partly cloudy"}

    tool_result = get_weather(tool_input)

    # 4) Send tool_result back to Claude

    follow_up = client.messages.create(
        model="claude-opus-4-5-20251101",
        messages=[
            {"role":"user", "content":[{"type":"tool_result",
                                        "tool_use_id": resp.tool_use_id,
                                        "content": json.dumps(tool_result)}]}
        ],
        max_tokens=512,
    )

    print(follow_up.content.text)
else:
    print(resp.content.text)

Какую структуру агентов следует использовать для обеспечения надежности?

  • Дезинфицируйте входные данные инструментов (избегайте инъекций через подсказки).
  • Проверка выходных данных инструмента перед их обратной передачей модели (проверка схемы).
  • Ограничить область применения инструмента (принцип наименьших привилегий).
  • Используйте помощников по уплотнению (из Anthropic SDKs) для сохранения управляемости контекста в течение длительного времени.

Как мне разработать подсказки и структурировать сообщения для Opus 4.5?

Какие роли сообщений и стратегии предварительного заполнения работают лучше всего?

Используйте трехчастную схему:

  • Система (роль: система): глобальные инструкции — тон, ограждения, роль.
  • помощник (необязательно): готовые примеры или ознакомительный контент.
  • Информация о пользователе (роль: пользователь): немедленный запрос.

Заполните системное сообщение ограничениями (формат, длина, политика безопасности, схема JSON, если требуется структурированный вывод). Для агентов включите спецификации инструментов и примеры использования, чтобы Opus 4.5 мог правильно вызывать эти инструменты.

Как использовать сжатие контекста и кэширование подсказок для сохранения токенов?

  • Сжатие контекста: Сжимайте старые фрагменты разговора в краткие резюме, которые модель всё ещё может использовать. Opus 4.5 поддерживает автоматизацию для сжатия контекста без потери важных фрагментов рассуждений.
  • Оперативное кэширование: Ответы модели кэширования для повторяющихся запросов (Anthropic предоставляет шаблоны кэширования запросов для снижения задержек/стоимости).

Обе функции сокращают объем токенов при длительном взаимодействии и рекомендуются для длительных рабочих процессов агентов и помощников по производству.

Обработка ошибок и передовой опыт

Ниже приведены практические рекомендации по надежности и безопасности для производственной интеграции с Opus 4.5.

Надежность и повторные попытки

  • Ограничения скорости обработки (HTTP 429) экспоненциальный откат и джиттер (начиная с 500–1000 мс).
  • Идемпотентность: для немутирующих вызовов LLM вы можете безопасно повторить попытку, но будьте осторожны в рабочих процессах, где модель вызывает внешние побочные эффекты (вызовы инструментов) — дедупликация путем отслеживания tool_use_id или ваши собственные идентификаторы запросов.
  • Стабильность потоковой передачи: обрабатывать частичные потоки и корректно переподключаться; в случае прерывания работы предпочтительнее повторить весь запрос или возобновить работу, используя состояние на уровне приложения, чтобы избежать несогласованного взаимодействия инструментов.

Безопасность и защита

  • Быстрая инъекция и безопасность инструментов: “никогда не научится делать” Разрешите модели напрямую выполнять произвольные команды оболочки или код без проверки. Всегда проверяйте входные данные инструмента и проверяйте выходные данные. Модель предлагает вызовы инструментов, а ваш код решает, следует ли их выполнять. Системная карточка и документация Anthropic описывают ограничения выравнивания и уровни безопасности — следуйте им для доменов с высоким уровнем риска.
  • Обработка данных и соблюдение требований: Обрабатывайте запросы и входные/выходные данные инструментов, содержащие персональные данные (PII) или регулируемые данные, в соответствии с вашей юридической политикой/политикой соответствия. Используйте средства контроля VPC/Enterprise, если у вас строгие требования к резидентству данных или аудиту (Bedrock/Vertex/Foundry предлагают корпоративные варианты).

Наблюдаемость и контроль затрат

  • Метаданные запросов/ответов журнала (не необработанный конфиденциальный контент, если не разрешено) — количество токенов, effort Уровень, задержка, идентификатор модели и поставщик. Эти метрики необходимы для определения стоимости и отладки.
  • Прилагайте усилия для контроля стоимости звонка: предпочитать low усилия для рутинного суммирования или конечных точек с высоким QPS; используйте high Усилия для глубокой отладки или исследований. Отслеживайте соотношение качества и потребления токенов, чтобы выбирать значения по умолчанию для различных конечных точек.

Заключение — Когда (и как) следует выбирать Opus 4.5?

Claude Opus 4.5 — естественный выбор, если вашему продукту необходимо:

  • глубокое многошаговое рассуждение (длинные цепочки логики, исследования или отладки),
  • надежная оркестровка агентов/инструментов (сложные рабочие процессы, вызывающие внешние API) или
  • помощь в написании кода производственного уровня для больших кодовых баз.

В оперативном плане используйте усилие для настройки бюджетов на вызов; опирайтесь на шаблон использования инструментов для обеспечения безопасности выполнения и выберите облачного партнера (или напрямую через Anthropic API) в соответствии с вашими требованиями к соблюдению требований. Сравните с собственным корпусом: показатели поставщика (SWE-bench и т. д.) — полезные сигналы, но ваша реальная задача и данные определяют рентабельность инвестиций. В целях безопасности следуйте системной карте Opus 4.5 и установите ограничения на использование инструментов и обработку персональных данных.

Разработчики могут получить доступ Клод Опус 4.5 API через CometAPI. Для начала изучите возможности моделиCometAPI в Детская Площадка Подробные инструкции см. в руководстве по API. Перед доступом убедитесь, что вы вошли в CometAPI и получили ключ API. сetAPI предложить цену намного ниже официальной, чтобы помочь вам интегрироваться.

Готовы к работе?→ Зарегистрируйтесь в CometAPI сегодня !

Если вы хотите узнать больше советов, руководств и новостей об искусственном интеллекте, подпишитесь на нас VK, X и Discord!

Читать далее

500+ моделей в одном API

Скидка до 20%