Claude может взаимодействовать с компьютерными средами через инструмент компьютерного управления, который обеспечивает возможности снятия скриншотов и управление мышью/клавиатурой для автономного взаимодействия с рабочим столом.
Компьютерное управление в настоящее время находится в бета-версии и требует бета-заголовка:
"computer-use-2025-11-24" (Claude Opus 4.5)"computer-use-2025-01-24" (Claude 4 модели и Claude Sonnet 3.7 (устарело))Компьютерное управление — это бета-функция, которая позволяет Claude взаимодействовать с окружением рабочего стола. Этот инструмент предоставляет:
Хотя компьютерное управление может быть дополнено другими инструментами, такими как bash и текстовый редактор для более комплексных рабочих процессов автоматизации, компьютерное управление конкретно относится к возможности инструмента компьютерного управления видеть и управлять окружением рабочего стола.
Компьютерное управление доступно для следующих моделей Claude:
| Модель | Версия инструмента | Бета-флаг |
|---|---|---|
| Claude Opus 4.5 | computer_20251124 | computer-use-2025-11-24 |
| Claude 4 модели | computer_20250124 | computer-use-2025-01-24 |
| Claude Sonnet 3.7 (устарело) | computer_20250124 | computer-use-2025-01-24 |
Claude Opus 4.5 представляет версию инструмента computer_20251124 с новыми возможностями, включая действие масштабирования для детального осмотра регионов экрана. Claude 4 модели используют обновленные версии инструментов, оптимизированные для новой архитектуры. Claude Sonnet 3.7 (устарело) представляет дополнительные возможности, включая функцию мышления для лучшего понимания процесса рассуждения модели.
Старые версии инструментов не гарантированно совместимы с новыми моделями в обратном направлении. Всегда используйте версию инструмента, которая соответствует вашей версии модели.
Компьютерное управление — это бета-функция с уникальными рисками, отличными от стандартных функций API. Эти риски возрастают при взаимодействии с интернетом. Чтобы минимизировать риски, рассмотрите возможность принятия мер предосторожности, таких как:
В некоторых случаях Claude может следовать командам, найденным в содержимом, даже если это противоречит инструкциям пользователя. Например, инструкции Claude на веб-страницах или содержащиеся в изображениях могут переопределить инструкции или привести к ошибкам Claude. Мы рекомендуем принять меры предосторожности, чтобы изолировать Claude от конфиденциальных данных и действий, чтобы избежать рисков, связанных с внедрением подсказок.
Мы обучили модель сопротивляться этим внедрениям подсказок и добавили дополнительный уровень защиты. Если вы используете наши инструменты компьютерного управления, мы автоматически запустим классификаторы на ваших подсказках, чтобы отметить потенциальные случаи внедрения подсказок. Когда эти классификаторы выявляют потенциальные внедрения подсказок на скриншотах, они автоматически направляют модель на запрос подтверждения пользователя перед переходом к следующему действию. Мы понимаем, что эта дополнительная защита не будет идеальной для каждого случая использования (например, для случаев использования без участия человека), поэтому, если вы хотите отказаться и отключить ее, пожалуйста, свяжитесь с нами.
Быстро начните работу с нашей эталонной реализацией компьютерного управления, которая включает веб-интерфейс, контейнер Docker, примеры реализации инструментов и цикл агента.
Примечание: Реализация была обновлена для включения новых инструментов как для Claude 4 моделей, так и для Claude Sonnet 3.7. Убедитесь, что вы получили последнюю версию репозитория для доступа к этим новым функциям.
Пожалуйста, используйте эту форму для предоставления отзывов о качестве ответов модели, самом API или качестве документации — мы не можем дождаться услышать от вас!
Вот как начать работу с компьютерным управлением:
Бета-заголовок требуется только для инструмента компьютерного управления.
Приведенный выше пример показывает все три инструмента, используемые вместе, что требует бета-заголовка, поскольку он включает инструмент компьютерного управления.
Мы называем повторение шагов 3 и 4 без ввода пользователя "циклом агента" — то есть Claude отвечает запросом использования инструмента, а ваше приложение отвечает Claude результатами оценки этого запроса.
Claude может взаимодействовать с компьютерными средами через инструмент компьютерного использования, который предоставляет возможности снятия скриншотов и управления мышью/клавиатурой для автономного взаимодействия с рабочим столом.
Компьютерное использование в настоящее время находится в бета-версии и требует бета-заголовка:
"computer-use-2025-11-24" (Claude Opus 4.5)"computer-use-2025-01-24" (Claude 4 модели и Claude Sonnet 3.7 (устарело))Компьютерное использование — это бета-функция, которая позволяет Claude взаимодействовать с окружением рабочего стола. Этот инструмент предоставляет:
Хотя компьютерное использование может быть дополнено другими инструментами, такими как bash и текстовый редактор для более комплексных рабочих процессов автоматизации, компьютерное использование конкретно относится к возможности инструмента компьютерного использования видеть и управлять окружением рабочего стола.
Компьютерное использование доступно для следующих моделей Claude:
| Модель | Версия инструмента | Бета-флаг |
|---|---|---|
| Claude Opus 4.5 | computer_20251124 | computer-use-2025-11-24 |
| Claude 4 модели | computer_20250124 | computer-use-2025-01-24 |
| Claude Sonnet 3.7 (устарело) | computer_20250124 | computer-use-2025-01-24 |
Claude Opus 4.5 представляет версию инструмента computer_20251124 с новыми возможностями, включая действие масштабирования для детального изучения областей экрана. Claude 4 модели используют обновленные версии инструментов, оптимизированные для новой архитектуры. Claude Sonnet 3.7 (устарело) представляет дополнительные возможности, включая функцию мышления для лучшего понимания процесса рассуждения модели.
Старые версии инструментов не гарантируют обратную совместимость с более новыми моделями. Всегда используйте версию инструмента, которая соответствует вашей версии модели.
Компьютерное использование — это бета-функция с уникальными рисками, отличными от стандартных функций API. Эти риски возрастают при взаимодействии с интернетом. Чтобы минимизировать риски, рассмотрите возможность принятия мер предосторожности, таких как:
В некоторых случаях Claude будет следовать командам, найденным в содержимом, даже если это противоречит инструкциям пользователя. Например, инструкции Claude на веб-страницах или содержащиеся в изображениях могут переопределить инструкции или привести к ошибкам Claude. Мы рекомендуем принять меры предосторожности, чтобы изолировать Claude от конфиденциальных данных и действий, чтобы избежать рисков, связанных с внедрением подсказок.
Мы обучили модель противостоять этим внедрениям подсказок и добавили дополнительный уровень защиты. Если вы используете наши инструменты компьютерного использования, мы автоматически запустим классификаторы на ваших подсказках, чтобы отметить потенциальные случаи внедрения подсказок. Когда эти классификаторы выявляют потенциальное внедрение подсказок на скриншотах, они автоматически направляют модель на запрос подтверждения пользователя перед выполнением следующего действия. Мы понимаем, что эта дополнительная защита не будет идеальной для каждого случая использования (например, для случаев использования без участия человека), поэтому если вы хотите отказаться и отключить это, пожалуйста, свяжитесь с нами.
Начните быстро с нашей эталонной реализацией компьютерного использования, которая включает веб-интерфейс, контейнер Docker, примеры реализации инструментов и цикл агента.
Примечание: Реализация была обновлена, чтобы включить новые инструменты как для Claude 4 моделей, так и для Claude Sonnet 3.7. Убедитесь, что вы получили последнюю версию репозитория, чтобы получить доступ к этим новым функциям.
Пожалуйста, используйте эту форму, чтобы предоставить отзыв о качестве ответов модели, самом API или качестве документации — мы не можем дождаться услышать от вас!
Вот как начать работу с компьютерным использованием:
Бета-заголовок требуется только для инструмента компьютерного использования.
Приведенный выше пример показывает все три инструмента, используемые вместе, что требует бета-заголовка, поскольку он включает инструмент компьютерного использования.
Мы называем повторение шагов 3 и 4 без ввода пользователя "циклом агента" — то есть Claude отвечает запросом использования инструмента, а ваше приложение отвечает Claude результатами оценки этого запроса.
Компьютерное использование требует изолированной вычислительной среды, где Claude может безопасно взаимодействовать с приложениями и веб-сайтами. Эта среда включает:
Виртуальный дисплей: Виртуальный сервер дисплея X11 (использующий Xvfb), который отображает интерфейс рабочего стола, который Claude будет видеть через скриншоты и управлять с помощью действий мыши/клавиатуры.
Окружение рабочего стола: Легкий пользовательский интерфейс с менеджером окон (Mutter) и панелью (Tint2), работающий на Linux, который предоставляет согласованный графический интерфейс для взаимодействия Claude.
Приложения: Предустановленные приложения Linux, такие как Firefox, LibreOffice, текстовые редакторы и менеджеры файлов, которые Claude может использовать для выполнения задач.
Реализации инструментов: Код интеграции, который переводит абстрактные запросы инструментов Claude (например, "переместить мышь" или "сделать скриншот") в фактические операции в виртуальной среде.
Цикл агента: Программа, которая обрабатывает связь между Claude и окружением, отправляя действия Claude в окружение и возвращая результаты (скриншоты, выходные данные команд) обратно Claude.
Когда вы используете компьютерное использование, Claude не подключается напрямую к этой среде. Вместо этого ваше приложение:
Для безопасности и изоляции эталонная реализация запускает все это внутри контейнера Docker с соответствующими сопоставлениями портов для просмотра и взаимодействия с окружением.
Мы создали эталонную реализацию, которая включает все необходимое для быстрого начала работы с компьютерным использованием:
Ядро компьютерного использования — это "цикл агента" — цикл, в котором Claude запрашивает действия инструмента, ваше приложение их выполняет и возвращает результаты Claude. Вот упрощенный пример:
async def sampling_loop(
*,
model: str,
messages: list[dict],
api_key: str,
max_tokens: int = 4096,
tool_version: str,
thinking_budget: int | None = None,
max_iterations: int = 10, # Добавьте ограничение итераций, чтобы предотвратить бесконечные циклы
):
"""
Простой цикл агента для взаимодействия Claude с компьютерным использованием.
Эта функция обрабатывает взаимодействие между:
1. Отправкой сообщений пользователя Claude
2. Claude запрашивающим использование инструментов
3. Вашим приложением, выполняющим эти инструменты
4. Отправкой результатов инструментов обратно Claude
"""
# Настройте инструменты и параметры API
client = Anthropic(api_key=api_key)
beta_flag = "computer-use-2025-01-24" if "20250124" in tool_version else "computer-use-2024-10-22"
# Настройте инструменты — вы должны уже иметь их инициализированными где-то еще
tools = [
{"type": f"computer_{tool_version}", "name": "computer", "display_width_px": 1024, "display_height_px": 768},
{"type": f"text_editor_{tool_version}", "name": "str_replace_editor"},
{"type": f"bash_{tool_version}", "name": "bash"}
]
# Основной цикл агента (с ограничением итераций, чтобы предотвратить неконтролируемые затраты API)
iterations = 0
while True and iterations < max_iterations:
iterations += 1
# Настройте необязательный параметр мышления (для Claude Sonnet 3.7)
thinking = None
if thinking_budget:
thinking = {"type": "enabled", "budget_tokens": thinking_budget}
# Вызовите API Claude
response = client.beta.messages.create(
model=model,
max_tokens=max_tokens,
messages=messages,
tools=tools,
betas=[beta_flag],
thinking=thinking
)
# Добавьте ответ Claude в историю разговора
response_content = response.content
messages.append({"role": "assistant", "content": response_content})
# Проверьте, использовал ли Claude какие-либо инструменты
tool_results = []
for block in response_content:
if block.type == "tool_use":
# В реальном приложении вы бы выполнили инструмент здесь
# Например: result = run_tool(block.name, block.input)
result = {"result": "Tool executed successfully"}
# Отформатируйте результат для Claude
tool_results.append({
"type": "tool_result",
"tool_use_id": block.id,
"content": result
})
# Если инструменты не использовались, Claude готов — верните финальные сообщения
if not tool_results:
return messages
# Добавьте результаты инструментов в сообщения для следующей итерации с Claude
messages.append({"role": "user", "content": tool_results})Цикл продолжается до тех пор, пока Claude не ответит без запроса каких-либо инструментов (завершение задачи) или не будет достигнут максимальный предел итераций. Эта защита предотвращает потенциальные бесконечные циклы, которые могут привести к неожиданным затратам на API.
При использовании инструмента компьютерного использования вы должны включить соответствующий бета-флаг для вашей версии модели:
Мы рекомендуем попробовать эталонную реализацию перед чтением остальной части этой документации.
Вот несколько советов о том, как получить лучшее качество выходных данных:
After each step, take a screenshot and carefully evaluate if you have achieved the right outcome. Explicitly show your thinking: "I have evaluated step X..." If not correct, try again. Only when you confirm a step was executed correctly should you move on to the next one.<robot_credentials>. Использование компьютерного использования в приложениях, требующих входа, увеличивает риск плохих результатов из-за внедрения подсказок. Пожалуйста, ознакомьтесь с нашим руководством по смягчению внедрений подсказок перед предоставлением модели учетных данных для входа.Если вы неоднократно сталкиваетесь с четким набором проблем или заранее знаете задачи, которые Claude должен будет выполнить, используйте системную подсказку, чтобы предоставить Claude явные советы или инструкции о том, как успешно выполнить задачи.
Когда один из инструментов, определенных Anthropic, запрашивается через API Claude, создается системная подсказка, специфичная для компьютерного использования. Она похожа на системную подсказку использования инструмента, но начинается с:
You have access to a set of functions you can use to answer the user's question. This includes access to a sandboxed computing environment. You do NOT currently have the ability to inspect files or interact with external resources, except by invoking the below functions.
Как и при обычном использовании инструмента, предоставленное пользователем поле system_prompt по-прежнему соблюдается и используется при построении объединенной системной подсказки.
Мы создали эталонную реализацию, которая включает всё необходимое для быстрого начала работы с компьютерным использованием:
Основой компьютерного использования является "цикл агента" - цикл, в котором Claude запрашивает действия инструментов, ваше приложение их выполняет и возвращает результаты Claude. Вот упрощённый пример:
async def sampling_loop(
*,
model: str,
messages: list[dict],
api_key: str,
max_tokens: int = 4096,
tool_version: str,
thinking_budget: int | None = None,
max_iterations: int = 10, # Add iteration limit to prevent infinite loops
):
"""
A simple agent loop for Claude computer use interactions.
This function handles the back-and-forth between:
1. Sending user messages to Claude
2. Claude requesting to use tools
3. Your app executing those tools
4. Sending tool results back to Claude
"""
# Set up tools and API parameters
client = Anthropic(api_key=api_key)
beta_flag = "computer-use-2025-01-24" if "20250124" in tool_version else "computer-use-2024-10-22"
# Configure tools - you should already have these initialized elsewhere
tools = [
{"type": f"computer_{tool_version}", "name": "computer", "display_width_px": 1024, "display_height_px": 768},
{"type": f"text_editor_{tool_version}", "name": "str_replace_editor"},
{"type": f"bash_{tool_version}", "name": "bash"}
]
# Main agent loop (with iteration limit to prevent runaway API costs)
iterations = 0
while True and iterations < max_iterations:
iterations += 1
# Set up optional thinking parameter (for Claude Sonnet 3.7)
thinking = None
if thinking_budget:
thinking = {"type": "enabled", "budget_tokens": thinking_budget}
# Call the Claude API
response = client.beta.messages.create(
model=model,
max_tokens=max_tokens,
messages=messages,
tools=tools,
betas=[beta_flag],
thinking=thinking
)
# Add Claude's response to the conversation history
response_content = response.content
messages.append({"role": "assistant", "content": response_content})
# Check if Claude used any tools
tool_results = []
for block in response_content:
if block.type == "tool_use":
# In a real app, you would execute the tool here
# For example: result = run_tool(block.name, block.input)
result = {"result": "Tool executed successfully"}
# Format the result for Claude
tool_results.append({
"type": "tool_result",
"tool_use_id": block.id,
"content": result
})
# If no tools were used, Claude is done - return the final messages
if not tool_results:
return messages
# Add tool results to messages for the next iteration with Claude
messages.append({"role": "user", "content": tool_results})Цикл продолжается до тех пор, пока Claude не ответит без запроса каких-либо инструментов (завершение задачи) или не будет достигнут максимальный предел итераций. Эта защита предотвращает потенциальные бесконечные циклы, которые могут привести к неожиданным затратам на API.
При использовании инструмента компьютерного использования вы должны включить соответствующий флаг бета-версии для вашей версии модели:
Мы рекомендуем попробовать эталонную реализацию перед чтением остальной части этой документации.
Вот несколько советов о том, как получить лучшее качество результатов:
After each step, take a screenshot and carefully evaluate if you have achieved the right outcome. Explicitly show your thinking: "I have evaluated step X..." If not correct, try again. Only when you confirm a step was executed correctly should you move on to the next one.<robot_credentials>. Использование компьютерного использования в приложениях, требующих входа, увеличивает риск плохих результатов из-за внедрения подсказок. Пожалуйста, ознакомьтесь с нашим руководством по смягчению внедрения подсказок перед предоставлением модели учётных данных для входа.Если вы неоднократно сталкиваетесь с чётким набором проблем или заранее знаете задачи, которые Claude должна будет выполнить, используйте системную подсказку, чтобы предоставить Claude явные советы или инструкции о том, как успешно выполнить задачи.
Когда один из инструментов, определённых Anthropic, запрашивается через API Claude, генерируется системная подсказка, специфичная для компьютерного использования. Она похожа на системную подсказку использования инструментов, но начинается с:
You have access to a set of functions you can use to answer the user's question. This includes access to a sandboxed computing environment. You do NOT currently have the ability to inspect files or interact with external resources, except by invoking the below functions.
Как и при обычном использовании инструментов, предоставленное пользователем поле system_prompt по-прежнему соблюдается и используется при построении объединённой системной подсказки.
Инструмент компьютерного использования поддерживает эти действия:
Основные действия (все версии)
[x, y]Расширенные действия (computer_20250124)
Доступны в моделях Claude 4 и Claude Sonnet 3.7:
Расширенные действия (computer_20251124)
Доступны в Claude Opus 4.5:
computer_20250124enable_zoom: true в определении инструмента. Принимает параметр region с координатами [x1, y1, x2, y2], определяющими верхний левый и нижний правый углы области для проверки.| Параметр | Требуется | Описание |
|---|---|---|
type | Да | Версия инструмента (computer_20251124, computer_20250124 или computer_20241022) |
name | Да | Должно быть "computer" |
display_width_px | Да | Ширина дисплея в пикселях |
display_height_px | Да | Высота дисплея в пикселях |
display_number | Нет | Номер дисплея для окружений X11 |
Держите разрешение дисплея на уровне 1280x800 (WXGA) или ниже для лучшей производительности. Более высокие разрешения могут вызвать проблемы с точностью из-за изменения размера изображения.
Важно: Инструмент компьютерного использования должен быть явно выполнен вашим приложением - Claude не может выполнить его напрямую. Вы несёте ответственность за реализацию захвата снимков экрана, движений мыши, вводов с клавиатуры и других действий на основе запросов Claude.
| Параметр | Требуется | Описание |
|---|---|---|
type | Да | Версия инструмента (computer_20251124, computer_20250124 или computer_20241022) |
name | Да | Должно быть "computer" |
display_width_px | Да | Ширина дисплея в пикселях |
display_height_px | Да | Высота дисплея в пикселях |
display_number | Нет | Номер дисплея для окружений X11 |
Держите разрешение дисплея на уровне 1280x800 (WXGA) или ниже для лучшей производительности. Более высокие разрешения могут вызвать проблемы с точностью из-за изменения размера изображения.
Важно: Инструмент компьютерного использования должен быть явно выполнен вашим приложением - Claude не может выполнить его напрямую. Вы несёте ответственность за реализацию захвата снимков экрана, движений мыши, вводов с клавиатуры и других действий на основе запросов Claude.
Claude Sonnet 3.7 представила новую возможность "мышления", которая позволяет вам увидеть процесс рассуждения модели при работе со сложными задачами. Эта функция помогает вам понять, как Claude подходит к проблеме, и может быть особенно ценна для отладки или образовательных целей.
Чтобы включить мышление, добавьте параметр thinking в ваш запрос API:
"thinking": {
"type": "enabled",
"budget_tokens": 1024
}Параметр budget_tokens указывает, сколько токенов Claude может использовать для мышления. Это вычитается из вашего общего бюджета max_tokens.
Когда мышление включено, Claude вернёт свой процесс рассуждения как часть ответа, что может помочь вам:
Вот пример того, как может выглядеть вывод мышления:
[Thinking]
I need to save a picture of a cat to the desktop. Let me break this down into steps:
1. First, I'll take a screenshot to see what's on the desktop
2. Then I'll look for a web browser to search for cat images
3. After finding a suitable image, I'll need to save it to the desktop
Let me start by taking a screenshot to see what's available...| Параметр | Требуется | Описание |
|---|---|---|
type | Да | Версия инструмента (computer_20251124, computer_20250124 или computer_20241022) |
name | Да | Должно быть "computer" |
display_width_px | Да | Ширина дисплея в пикселях |
display_height_px | Да | Высота дисплея в пикселях |
display_number | Нет | Номер дисплея для окружений X11 |
Держите разрешение дисплея на уровне 1280x800 (WXGA) или ниже для лучшей производительности. Более высокие разрешения могут вызвать проблемы с точностью из-за изменения размера изображения.
Важно: Инструмент компьютерного использования должен быть явно выполнен вашим приложением - Claude не может выполнить его напрямую. Вы несёте ответственность за реализацию захвата снимков экрана, движений мыши, вводов с клавиатуры и других действий на основе запросов Claude.
Инструмент компьютерного использования можно комбинировать с другими инструментами для создания более мощных рабочих процессов автоматизации. Это особенно полезно, когда вам нужно:
| Параметр | Обязательный | Описание |
|---|---|---|
type | Да | Версия инструмента (computer_20251124, computer_20250124 или computer_20241022) |
name | Да | Должно быть "computer" |
display_width_px | Да | Ширина дисплея в пикселях |
display_height_px | Да | Высота дисплея в пикселях |
display_number | Нет | Номер дисплея для окружений X11 |
Держите разрешение дисплея на уровне 1280x800 (WXGA) или ниже для оптимальной производительности. Более высокие разрешения могут вызвать проблемы с точностью из-за изменения размера изображения.
Важно: Инструмент компьютерного использования должен быть явно выполнен вашим приложением — Claude не может выполнить его напрямую. Вы несёте ответственность за реализацию захвата скриншота, движений мыши, вводов с клавиатуры и других действий на основе запросов Claude.
Claude Sonnet 3.7 представил новую возможность "мышления", которая позволяет вам увидеть процесс рассуждения модели при работе над сложными задачами. Эта функция помогает вам понять, как Claude подходит к решению проблемы, и может быть особенно ценна для отладки или образовательных целей.
Чтобы включить мышление, добавьте параметр thinking в ваш запрос API:
"thinking": {
"type": "enabled",
"budget_tokens": 1024
}Параметр budget_tokens указывает, сколько токенов Claude может использовать для мышления. Это вычитается из вашего общего бюджета max_tokens.
Когда мышление включено, Claude вернёт свой процесс рассуждения как часть ответа, что может помочь вам:
Вот пример того, как может выглядеть вывод мышления:
[Thinking]
Мне нужно сохранить картинку кота на рабочий стол. Давайте разберём это на этапы:
1. Сначала я сделаю скриншот, чтобы увидеть, что находится на рабочем столе
2. Затем я буду искать веб-браузер для поиска изображений кошек
3. После нахождения подходящего изображения мне нужно будет сохранить его на рабочий стол
Давайте начнём со скриншота, чтобы увидеть, что доступно...Инструмент компьютерного использования можно комбинировать с другими инструментами для создания более мощных рабочих процессов автоматизации. Это особенно полезно, когда вам нужно:
Эталонная реализация предназначена для помощи вам в начале работы с компьютерным использованием. Она включает все компоненты, необходимые для того, чтобы Claude использовал компьютер. Однако вы можете создать своё собственное окружение для компьютерного использования в соответствии с вашими потребностями. Вам потребуется:
tool_use с использованием ваших реализаций инструментовИнструмент компьютерного использования реализован как инструмент без схемы. При использовании этого инструмента вам не нужно предоставлять схему ввода, как с другими инструментами; схема встроена в модель Claude и не может быть изменена.
При реализации инструмента компьютерного использования могут возникнуть различные ошибки. Вот как их обработать:
Функциональность компьютерного использования находится в бета-версии. Хотя возможности Claude передовые, разработчики должны знать об её ограничениях:
left_mouse_down, left_mouse_up и новая поддержка клавиш-модификаторов. Выбор ячейки может быть более надёжным при использовании этих детальных элементов управления и комбинировании клавиш-модификаторов с щелчками.Всегда тщательно проверяйте и верифицируйте действия компьютерного использования Claude и журналы. Не используйте Claude для задач, требующих идеальной точности или конфиденциальной информации пользователя без надзора человека.
Функциональность компьютерного использования находится в бета-версии. Хотя возможности Claude передовые, разработчики должны знать об её ограничениях:
left_mouse_down, left_mouse_up и новая поддержка клавиш-модификаторов. Выбор ячейки может быть более надёжным при использовании этих детальных элементов управления и комбинировании клавиш-модификаторов с щелчками.Всегда тщательно проверяйте и верифицируйте действия компьютерного использования Claude и журналы. Не используйте Claude для задач, требующих идеальной точности или конфиденциальной информации пользователя без надзора человека.
Computer use follows the standard tool use pricing. When using the computer use tool:
System prompt overhead: The computer use beta adds 466-499 tokens to the system prompt
Computer use tool token usage:
| Model | Input tokens per tool definition |
|---|---|
| Claude 4.x models | 735 tokens |
| Claude Sonnet 3.7 (deprecated) | 735 tokens |
Additional token consumption:
If you're also using bash or text editor tools alongside computer use, those tools have their own token costs as documented in their respective pages.
Функциональность компьютерного использования находится в бета-версии. Хотя возможности Claude передовые, разработчики должны знать об её ограничениях:
left_mouse_down, left_mouse_up и новая поддержка клавиш-модификаторов. Выбор ячейки может быть более надёжным при использовании этих детальных элементов управления и комбинировании клавиш-модификаторов с щелчками.Всегда тщательно проверяйте и верифицируйте действия компьютерного использования Claude и журналы. Не используйте Claude для задач, требующих идеальной точности или конфиденциальной информации пользователя без надзора человека.
Computer use follows the standard tool use pricing. When using the computer use tool:
System prompt overhead: The computer use beta adds 466-499 tokens to the system prompt
Computer use tool token usage:
| Model | Input tokens per tool definition |
|---|---|
| Claude 4.x models | 735 tokens |
| Claude Sonnet 3.7 (deprecated) | 735 tokens |
Additional token consumption:
If you're also using bash or text editor tools alongside computer use, those tools have their own token costs as documented in their respective pages.
Мы по-прежнему рекомендуем принять меры предосторожности, чтобы изолировать Claude от конфиденциальных данных и действий, чтобы избежать рисков, связанных с внедрением подсказок.
Наконец, пожалуйста, информируйте конечных пользователей о соответствующих рисках и получайте их согласие перед включением компьютерного управления в ваших собственных продуктах.
import anthropic
client = anthropic.Anthropic()
response = client.beta.messages.create(
model="claude-sonnet-4-5", # или другая совместимая модель
max_tokens=1024,
tools=[
{
"type": "computer_20250124",
"name": "computer",
"display_width_px": 1024,
"display_height_px": 768,
"display_number": 1,
},
{
"type": "text_editor_20250728",
"name": "str_replace_based_edit_tool"
},
{
"type": "bash_20250124",
"name": "bash"
}
],
messages=[{"role": "user", "content": "Save a picture of a cat to my desktop."}],
betas=["computer-use-2025-01-24"]
)
print(response)1. Предоставьте Claude инструмент компьютерного управления и подсказку пользователя
2. Claude решает использовать инструмент компьютерного управления
stop_reason значение tool_use, сигнализирующее о намерении Claude.3. Извлеките входные данные инструмента, оцените инструмент на компьютере и верните результаты
user содержащим блок содержимого tool_result.4. Claude продолжает вызывать инструменты компьютерного управления до завершения задачи
stop_reason значением tool_use и вы должны вернуться к шагу 3.Мы по-прежнему рекомендуем принять меры предосторожности, чтобы изолировать Claude от конфиденциальных данных и действий, чтобы избежать рисков, связанных с внедрением подсказок.
Наконец, пожалуйста, информируйте конечных пользователей о соответствующих рисках и получайте их согласие перед включением компьютерного использования в ваших собственных продуктах.
import anthropic
client = anthropic.Anthropic()
response = client.beta.messages.create(
model="claude-sonnet-4-5", # или другая совместимая модель
max_tokens=1024,
tools=[
{
"type": "computer_20250124",
"name": "computer",
"display_width_px": 1024,
"display_height_px": 768,
"display_number": 1,
},
{
"type": "text_editor_20250728",
"name": "str_replace_based_edit_tool"
},
{
"type": "bash_20250124",
"name": "bash"
}
],
messages=[{"role": "user", "content": "Save a picture of a cat to my desktop."}],
betas=["computer-use-2025-01-24"]
)
print(response)1. Предоставьте Claude инструмент компьютерного использования и подсказку пользователя
2. Claude решает использовать инструмент компьютерного использования
stop_reason значение tool_use, сигнализирующее о намерении Claude.3. Извлеките входные данные инструмента, оцените инструмент на компьютере и верните результаты
user содержащим блок содержимого tool_result.4. Claude продолжает вызывать инструменты компьютерного использования до завершения задачи
tool_use stop_reason и вы должны вернуться к шагу 3.enable_zoom| Нет |
Включить действие масштабирования (computer_20251124 только). Установите true, чтобы позволить Claude масштабировать определённые регионы экрана. По умолчанию: false |
enable_zoom| Нет |
Включить действие масштабирования (computer_20251124 только). Установите true, чтобы позволить Claude масштабировать определённые регионы экрана. По умолчанию: false |
enable_zoom| Нет |
Включить действие масштабирования (computer_20251124 только). Установите true, чтобы позволить Claude масштабировать определённые регионы экрана. По умолчанию: false |
curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: computer-use-2025-01-24" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 2000,
"tools": [
{
"type": "computer_20250124",
"name": "computer",
"display_width_px": 1024,
"display_height_px": 768,
"display_number": 1
},
{
"type": "text_editor_20250728",
"name": "str_replace_based_edit_tool"
},
{
"type": "bash_20250124",
"name": "bash"
},
{
"name": "get_weather",
"description": "Get the current weather in a given location",
"input_schema": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state, e.g. San Francisco, CA"
},
"unit": {
"type": "string",
"enum": ["celsius", "fahrenheit"],
"description": "The unit of temperature, either 'celsius' or 'fahrenheit'"
}
},
"required": ["location"]
}
}
],
"messages": [
{
"role": "user",
"content": "Find flights from San Francisco to a place with warmer weather."
}
],
"thinking": {
"type": "enabled",
"budget_tokens": 1024
}
}'enable_zoom| Нет |
Включить действие масштабирования (computer_20251124 только). Установите true, чтобы позволить Claude увеличивать определённые области экрана. По умолчанию: false |
curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: computer-use-2025-01-24" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 2000,
"tools": [
{
"type": "computer_20250124",
"name": "computer",
"display_width_px": 1024,
"display_height_px": 768,
"display_number": 1
},
{
"type": "text_editor_20250728",
"name": "str_replace_based_edit_tool"
},
{
"type": "bash_20250124",
"name": "bash"
},
{
"name": "get_weather",
"description": "Get the current weather in a given location",
"input_schema": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state, e.g. San Francisco, CA"
},
"unit": {
"type": "string",
"enum": ["celsius", "fahrenheit"],
"description": "The unit of temperature, either 'celsius' or 'fahrenheit'"
}
},
"required": ["location"]
}
}
],
"messages": [
{
"role": "user",
"content": "Find flights from San Francisco to a place with warmer weather."
}
],
"thinking": {
"type": "enabled",
"budget_tokens": 1024
}
}'Установите вычислительное окружение
Создайте виртуальный дисплей или подключитесь к существующему дисплею, с которым будет взаимодействовать Claude. Это обычно включает установку Xvfb (X Virtual Framebuffer) или аналогичной технологии.
Реализуйте обработчики действий
Создайте функции для обработки каждого типа действия, которое может запросить Claude:
def handle_computer_action(action_type, params):
if action_type == "screenshot":
return capture_screenshot()
elif action_type == "left_click":
x, y = params["coordinate"]
return click_at(x, y)
elif action_type == "type":
return type_text(params["text"])
# ... обработка других действийОбработайте вызовы инструментов Claude
Извлеките и выполните вызовы инструментов из ответов Claude:
for content in response.content:
if content.type == "tool_use":
action = content.input["action"]
result = handle_computer_action(action, content.input)
# Вернуть результат Claude
tool_result = {
"type": "tool_result",
"tool_use_id": content.id,
"content": result
}Реализуйте цикл агента
Создайте цикл, который продолжается до завершения задачи Claude:
while True:
response = client.beta.messages.create(...)
# Проверьте, использовал ли Claude какие-либо инструменты
tool_results = process_tool_calls(response)
if not tool_results:
# Больше нет использования инструментов, задача завершена
break
# Продолжить разговор с результатами инструментов
messages.append({"role": "user", "content": tool_results})Узнайте больше об использовании инструментов и создании пользовательских инструментов