Ferramenta de uso de computador

Modelo	Versão da ferramenta	Sinalizador Beta
Claude Opus 4.5	`computer_20251124`	`computer-use-2025-11-24`
Modelos Claude 4	`computer_20250124`	`computer-use-2025-01-24`
Claude Sonnet 3.7 (descontinuado)	`computer_20250124`	`computer-use-2025-01-24`

Modelo	Versão da ferramenta	Sinalizador Beta
Claude Opus 4.5	`computer_20251124`	`computer-use-2025-11-24`
Modelos Claude 4	`computer_20250124`	`computer-use-2025-01-24`
Claude Sonnet 3.7 (descontinuado)	`computer_20250124`	`computer-use-2025-01-24`

O uso de computador é um recurso beta com riscos únicos distintos dos recursos padrão da API. Esses riscos são aumentados ao interagir com a internet. Para minimizar riscos, considere tomar precauções como:

Use uma máquina virtual dedicada ou contêiner com privilégios mínimos para evitar ataques diretos ao sistema ou acidentes.
Evite dar ao modelo acesso a dados sensíveis, como informações de login de conta, para evitar roubo de informações.
Limite o acesso à internet a uma lista de permissões de domínios para reduzir a exposição a conteúdo malicioso.
Peça a um humano para confirmar decisões que possam resultar em consequências significativas no mundo real, bem como qualquer tarefa que exija consentimento afirmativo, como aceitar cookies, executar transações financeiras ou concordar com termos de serviço.

Em algumas circunstâncias, Claude seguirá comandos encontrados em conteúdo mesmo que conflitem com as instruções do usuário. Por exemplo, instruções Claude em páginas da web ou contidas em imagens podem substituir instruções ou fazer com que Claude cometa erros. Sugerimos tomar precauções para isolar Claude de dados e ações sensíveis para evitar riscos relacionados a injeção de prompt.

Treinamos o modelo para resistir a essas injeções de prompt e adicionamos uma camada extra de defesa. Se você usar nossas ferramentas de uso de computador, executaremos automaticamente classificadores em seus prompts para sinalizar possíveis instâncias de injeções de prompt. Quando esses classificadores identificarem possíveis injeções de prompt em capturas de tela, eles automaticamente direcionarão o modelo a pedir confirmação do usuário antes de prosseguir com a próxima ação. Reconhecemos que essa proteção extra não será ideal para todos os casos de uso (por exemplo, casos de uso sem um humano no loop), portanto, se você gostaria de desativar e desativar, por favor entre em contato conosco.

Ainda sugerimos tomar precauções para isolar Claude de dados e ações sensíveis para evitar riscos relacionados a injeção de prompt.

Por fim, informe aos usuários finais os riscos relevantes e obtenha seu consentimento antes de ativar o uso de computador em seus próprios produtos.

Modelo	Versão da ferramenta	Sinalizador Beta
Claude Opus 4.5	`computer_20251124`	`computer-use-2025-11-24`
Modelos Claude 4	`computer_20250124`	`computer-use-2025-01-24`
Claude Sonnet 3.7 (descontinuado)	`computer_20250124`	`computer-use-2025-01-24`

Use uma máquina virtual dedicada ou contêiner com privilégios mínimos para evitar ataques diretos ao sistema ou acidentes.
Evite dar ao modelo acesso a dados sensíveis, como informações de login de conta, para evitar roubo de informações.
Limite o acesso à internet a uma lista de permissões de domínios para reduzir a exposição a conteúdo malicioso.
Peça a um humano para confirmar decisões que possam resultar em consequências significativas no mundo real, bem como qualquer tarefa que exija consentimento afirmativo, como aceitar cookies, executar transações financeiras ou concordar com termos de serviço.

Ainda sugerimos tomar precauções para isolar Claude de dados e ações sensíveis para evitar riscos relacionados a injeção de prompt.

Por fim, informe aos usuários finais os riscos relevantes e obtenha seu consentimento antes de ativar o uso de computador em seus próprios produtos.

import anthropic

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-sonnet-4-5",  # or another compatible model
    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)

Modelo	Versão da ferramenta	Sinalizador Beta
Claude Opus 4.5	`computer_20251124`	`computer-use-2025-11-24`
Modelos Claude 4	`computer_20250124`	`computer-use-2025-01-24`
Claude Sonnet 3.7 (descontinuado)	`computer_20250124`	`computer-use-2025-01-24`

Use uma máquina virtual dedicada ou contêiner com privilégios mínimos para evitar ataques diretos ao sistema ou acidentes.
Evite dar ao modelo acesso a dados sensíveis, como informações de login de conta, para evitar roubo de informações.
Limite o acesso à internet a uma lista de permissões de domínios para reduzir a exposição a conteúdo malicioso.
Peça a um humano para confirmar decisões que possam resultar em consequências significativas no mundo real, bem como qualquer tarefa que exija consentimento afirmativo, como aceitar cookies, executar transações financeiras ou concordar com termos de serviço.

Ainda sugerimos tomar precauções para isolar Claude de dados e ações sensíveis para evitar riscos relacionados a injeção de prompt.

Por fim, informe aos usuários finais os riscos relevantes e obtenha seu consentimento antes de ativar o uso de computador em seus próprios produtos.

Modelo	Versão da Ferramenta	Sinalizador Beta
Claude Opus 4.5	`computer_20251124`	`computer-use-2025-11-24`
Modelos Claude 4	`computer_20250124`	`computer-use-2025-01-24`
Claude Sonnet 3.7 (descontinuado)	`computer_20250124`	`computer-use-2025-01-24`

Use uma máquina virtual dedicada ou contêiner com privilégios mínimos para evitar ataques diretos ao sistema ou acidentes.
Evite dar ao modelo acesso a dados sensíveis, como informações de login de conta, para evitar roubo de informações.
Limite o acesso à internet a uma lista de permissões de domínios para reduzir a exposição a conteúdo malicioso.
Peça a um humano para confirmar decisões que possam resultar em consequências significativas no mundo real, bem como qualquer tarefa que exija consentimento afirmativo, como aceitar cookies, executar transações financeiras ou concordar com termos de serviço.

Treinamos o modelo para resistir a essas injeções de prompt e adicionamos uma camada extra de defesa. Se você usar nossas ferramentas de uso de computador, executaremos automaticamente classificadores em seus prompts para sinalizar possíveis instâncias de injeção de prompt. Quando esses classificadores identificam possíveis injeções de prompt em capturas de tela, eles automaticamente direcionam o modelo a pedir confirmação do usuário antes de prosseguir com a próxima ação. Reconhecemos que essa proteção extra não será ideal para todos os casos de uso (por exemplo, casos de uso sem um humano no loop), portanto, se você gostaria de desativar e desligar, por favor entre em contato conosco.

Ainda sugerimos tomar precauções para isolar Claude de dados e ações sensíveis para evitar riscos relacionados a injeção de prompt.

Finalmente, por favor informe aos usuários finais os riscos relevantes e obtenha seu consentimento antes de ativar o uso de computador em seus próprios produtos.

import anthropic

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-sonnet-4-5",  # or another compatible model
    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)

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})

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})

Parâmetro	Obrigatório	Descrição
`type`	Sim	Versão da ferramenta (`computer_20251124`, `computer_20250124`, ou `computer_20241022`)
`name`	Sim	Deve ser "computer"
`display_width_px`	Sim	Largura da exibição em pixels
`display_height_px`	Sim	Altura da exibição em pixels
`display_number`	Não	Número de exibição para ambientes X11
`enable_zoom`	Não	Ativar ação de zoom (`computer_20251124` apenas). Defina como `true` para permitir que Claude amplie regiões específicas da tela. Padrão: `false`

Parâmetro	Obrigatório	Descrição
`type`	Sim	Versão da ferramenta (`computer_20251124`, `computer_20250124`, ou `computer_20241022`)
`name`	Sim	Deve ser "computer"
`display_width_px`	Sim	Largura da exibição em pixels
`display_height_px`	Sim	Altura da exibição em pixels
`display_number`	Não	Número de exibição para ambientes X11
`enable_zoom`	Não	Ativar ação de zoom (`computer_20251124` apenas). Defina como `true` para permitir que Claude amplie regiões específicas da tela. Padrão: `false`

[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...

Parâmetro	Obrigatório	Descrição
`type`	Sim	Versão da ferramenta (`computer_20251124`, `computer_20250124`, ou `computer_20241022`)
`name`	Sim	Deve ser "computer"
`display_width_px`	Sim	Largura da exibição em pixels
`display_height_px`	Sim	Altura da exibição em pixels
`display_number`	Não	Número de exibição para ambientes X11
`enable_zoom`	Não	Ativar ação de zoom (`computer_20251124` apenas). Defina como `true` para permitir que Claude amplie regiões específicas da tela. Padrão: `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
    }
  }'

Parâmetro	Obrigatório	Descrição
`type`	Sim	Versão da ferramenta (`computer_20251124`, `computer_20250124`, ou `computer_20241022`)
`name`	Sim	Deve ser "computer"
`display_width_px`	Sim	Largura da tela em pixels
`display_height_px`	Sim	Altura da tela em pixels
`display_number`	Não	Número de exibição para ambientes X11
`enable_zoom`	Não	Ativar ação de zoom (`computer_20251124` apenas). Defina como `true` para permitir que Claude amplie regiões específicas da tela. Padrão: `false`

[Thinking]
Preciso salvar uma foto de um gato na área de trabalho. Deixe-me dividir isso em etapas:

1. Primeiro, vou tirar uma captura de tela para ver o que está na área de trabalho
2. Depois vou procurar um navegador da web para procurar imagens de gatos
3. Depois de encontrar uma imagem adequada, precisarei salvá-la na área de trabalho

Deixe-me começar tirando uma captura de tela para ver o que está disponível...

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
    }
  }'

Configurar seu ambiente de computação
Crie uma exibição virtual ou conecte-se a uma exibição existente com a qual Claude interagirá. Isso normalmente envolve configurar Xvfb (X Virtual Framebuffer) ou tecnologia similar.

Implementar manipuladores de ação

Crie funções para lidar com cada tipo de ação que Claude pode solicitar:

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"])
    # ... handle other actions

Processar chamadas de ferramenta do Claude

Extraia e execute chamadas de ferramenta das respostas do Claude:

for content in response.content:
    if content.type == "tool_use":
        action = content.input["action"]
        result = handle_computer_action(action, content.input)
        
        # Return result to Claude
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

Implementar o loop do agente

Crie um loop que continua até que Claude conclua a tarefa:

while True:
    response = client.beta.messages.create(...)
    
    # Check if Claude used any tools
    tool_results = process_tool_calls(response)
    
    if not tool_results:
        # No more tool use, task complete
        break
        
    # Continue conversation with tool results
    messages.append({"role": "user", "content": tool_results})

Latência: a latência atual do uso de computador para interações humano-IA pode ser muito lenta em comparação com ações de computador direcionadas por humanos regulares. Recomendamos focar em casos de uso onde a velocidade não é crítica (por exemplo, coleta de informações em segundo plano, testes automatizados de software) em ambientes confiáveis.
Precisão e confiabilidade da visão computacional: Claude pode cometer erros ou alucinar ao gerar coordenadas específicas enquanto gera ações. Claude Sonnet 3.7 introduz a capacidade de pensamento que pode ajudá-lo a entender o raciocínio do modelo e identificar possíveis problemas.
Precisão e confiabilidade da seleção de ferramentas: Claude pode cometer erros ou alucinar ao selecionar ferramentas enquanto gera ações ou tomar ações inesperadas para resolver problemas. Além disso, a confiabilidade pode ser menor ao interagir com aplicações de nicho ou múltiplas aplicações ao mesmo tempo. Recomendamos que os usuários solicitem o modelo com cuidado ao solicitar tarefas complexas.
Confiabilidade de rolagem: Claude Sonnet 3.7 introduziu ações de rolagem dedicadas com controle de direção que melhora a confiabilidade. O modelo agora pode rolar explicitamente em qualquer direção (para cima/para baixo/esquerda/direita) por uma quantidade especificada.
Interação com planilhas: Os cliques do mouse para interação com planilhas melhoraram em Claude Sonnet 3.7 com a adição de ações de controle de mouse mais precisas como left_mouse_down, left_mouse_up e novo suporte a teclas modificadoras. A seleção de células pode ser mais confiável usando esses controles refinados e combinando teclas modificadoras com cliques.
Criação de conta e geração de conteúdo em plataformas sociais e de comunicação: Embora Claude visite sites, estamos limitando sua capacidade de criar contas ou gerar e compartilhar conteúdo ou de outra forma se envolver em personificação humana em sites e plataformas de mídia social. Podemos atualizar essa capacidade no futuro.
Vulnerabilidades: Vulnerabilidades como jailbreaking ou injeção de prompt podem persistir em sistemas de IA de fronteira, incluindo a API de uso de computador em beta. Em algumas circunstâncias, Claude seguirá comandos encontrados em conteúdo, às vezes até em conflito com as instruções do usuário. Por exemplo, instruções de Claude em páginas da web ou contidas em imagens podem substituir instruções ou fazer com que Claude cometa erros. Recomendamos: a. Limitar o uso de computador a ambientes confiáveis, como máquinas virtuais ou contêineres com privilégios mínimos b. Evitar dar acesso de uso de computador a contas ou dados sensíveis sem supervisão rigorosa c. Informar os usuários finais sobre riscos relevantes e obter seu consentimento antes de ativar ou solicitar permissões necessárias para recursos de uso de computador em suas aplicações
Ações inadequadas ou ilegais: De acordo com os termos de serviço da Anthropic, você não deve empregar o uso de computador para violar quaisquer leis ou nossa Política de Uso Aceitável.

Latência: a latência atual do uso de computador para interações humano-IA pode ser muito lenta em comparação com ações de computador direcionadas por humanos regulares. Recomendamos focar em casos de uso onde a velocidade não é crítica (por exemplo, coleta de informações em segundo plano, testes automatizados de software) em ambientes confiáveis.
Precisão e confiabilidade da visão computacional: Claude pode cometer erros ou alucinar ao gerar coordenadas específicas enquanto gera ações. Claude Sonnet 3.7 introduz a capacidade de pensamento que pode ajudá-lo a entender o raciocínio do modelo e identificar possíveis problemas.
Precisão e confiabilidade da seleção de ferramentas: Claude pode cometer erros ou alucinar ao selecionar ferramentas enquanto gera ações ou tomar ações inesperadas para resolver problemas. Além disso, a confiabilidade pode ser menor ao interagir com aplicações de nicho ou múltiplas aplicações ao mesmo tempo. Recomendamos que os usuários solicitem o modelo com cuidado ao solicitar tarefas complexas.
Confiabilidade de rolagem: Claude Sonnet 3.7 introduziu ações de rolagem dedicadas com controle de direção que melhora a confiabilidade. O modelo agora pode rolar explicitamente em qualquer direção (para cima/para baixo/esquerda/direita) por uma quantidade especificada.
Interação com planilhas: Os cliques do mouse para interação com planilhas melhoraram em Claude Sonnet 3.7 com a adição de ações de controle de mouse mais precisas como left_mouse_down, left_mouse_up e novo suporte a teclas modificadoras. A seleção de células pode ser mais confiável usando esses controles refinados e combinando teclas modificadoras com cliques.
Criação de conta e geração de conteúdo em plataformas sociais e de comunicação: Embora Claude visite sites, estamos limitando sua capacidade de criar contas ou gerar e compartilhar conteúdo ou de outra forma se envolver em personificação humana em sites e plataformas de mídia social. Podemos atualizar essa capacidade no futuro.
Vulnerabilidades: Vulnerabilidades como jailbreaking ou injeção de prompt podem persistir em sistemas de IA de fronteira, incluindo a API de uso de computador em beta. Em algumas circunstâncias, Claude seguirá comandos encontrados em conteúdo, às vezes até em conflito com as instruções do usuário. Por exemplo, instruções de Claude em páginas da web ou contidas em imagens podem substituir instruções ou fazer com que Claude cometa erros. Recomendamos: a. Limitar o uso de computador a ambientes confiáveis, como máquinas virtuais ou contêineres com privilégios mínimos b. Evitar dar acesso de uso de computador a contas ou dados sensíveis sem supervisão rigorosa c. Informar os usuários finais sobre riscos relevantes e obter seu consentimento antes de ativar ou solicitar permissões necessárias para recursos de uso de computador em suas aplicações
Ações inadequadas ou ilegais: De acordo com os termos de serviço da Anthropic, você não deve empregar o uso de computador para violar quaisquer leis ou nossa Política de Uso Aceitável.

Model	Input tokens per tool definition
Claude 4.x models	735 tokens
Claude Sonnet 3.7 (deprecated)	735 tokens

Latência: a latência atual do uso de computador para interações humano-IA pode ser muito lenta em comparação com ações de computador direcionadas por humanos regulares. Recomendamos focar em casos de uso onde a velocidade não é crítica (por exemplo, coleta de informações em segundo plano, testes automatizados de software) em ambientes confiáveis.
Precisão e confiabilidade da visão computacional: Claude pode cometer erros ou alucinar ao gerar coordenadas específicas enquanto gera ações. Claude Sonnet 3.7 introduz a capacidade de pensamento que pode ajudá-lo a entender o raciocínio do modelo e identificar possíveis problemas.
Precisão e confiabilidade da seleção de ferramentas: Claude pode cometer erros ou alucinar ao selecionar ferramentas enquanto gera ações ou tomar ações inesperadas para resolver problemas. Além disso, a confiabilidade pode ser menor ao interagir com aplicações de nicho ou múltiplas aplicações ao mesmo tempo. Recomendamos que os usuários solicitem o modelo com cuidado ao solicitar tarefas complexas.
Confiabilidade de rolagem: Claude Sonnet 3.7 introduziu ações de rolagem dedicadas com controle de direção que melhora a confiabilidade. O modelo agora pode rolar explicitamente em qualquer direção (para cima/para baixo/esquerda/direita) por uma quantidade especificada.
Interação com planilhas: Os cliques do mouse para interação com planilhas melhoraram em Claude Sonnet 3.7 com a adição de ações de controle de mouse mais precisas como left_mouse_down, left_mouse_up e novo suporte a teclas modificadoras. A seleção de células pode ser mais confiável usando esses controles refinados e combinando teclas modificadoras com cliques.
Criação de conta e geração de conteúdo em plataformas sociais e de comunicação: Embora Claude visite sites, estamos limitando sua capacidade de criar contas ou gerar e compartilhar conteúdo ou de outra forma se envolver em personificação humana em sites e plataformas de mídia social. Podemos atualizar essa capacidade no futuro.
Vulnerabilidades: Vulnerabilidades como jailbreaking ou injeção de prompt podem persistir em sistemas de IA de fronteira, incluindo a API de uso de computador em beta. Em algumas circunstâncias, Claude seguirá comandos encontrados em conteúdo, às vezes até em conflito com as instruções do usuário. Por exemplo, instruções de Claude em páginas da web ou contidas em imagens podem substituir instruções ou fazer com que Claude cometa erros. Recomendamos: a. Limitar o uso de computador a ambientes confiáveis, como máquinas virtuais ou contêineres com privilégios mínimos b. Evitar dar acesso de uso de computador a contas ou dados sensíveis sem supervisão rigorosa c. Informar os usuários finais sobre riscos relevantes e obter seu consentimento antes de ativar ou solicitar permissões necessárias para recursos de uso de computador em suas aplicações
Ações inadequadas ou ilegais: De acordo com os termos de serviço da Anthropic, você não deve empregar o uso de computador para violar quaisquer leis ou nossa Política de Uso Aceitável.

Visão geral

Visão geral

Visão geral

Compatibilidade de modelos

Visão geral

Compatibilidade de modelos

Considerações de segurança

Visão geral

Compatibilidade de modelos

Considerações de segurança

Início rápido

Visão geral

Compatibilidade de modelos

Considerações de segurança

Como funciona o uso de computador

Visão geral

Compatibilidade de modelo

Considerações de segurança

Início rápido

Como funciona o uso de computador

O ambiente de computação

Como implementar o uso de computador

Comece com nossa implementação de referência

Entendendo o loop multi-agente

Claude Opus 4.5

Modelos Claude 4

Claude Sonnet 3.7

Otimize o desempenho do modelo com prompting

Prompts do sistema

Como implementar o uso de computador

Comece com nossa implementação de referência

Entendendo o loop multi-agente

Claude Opus 4.5

Modelos Claude 4

Claude Sonnet 3.7

Otimize o desempenho do modelo com prompting

Prompts do sistema

Ações disponíveis

Ações de exemplo

Parâmetros da ferramenta

Parâmetros da ferramenta

Ativar capacidade de pensamento em modelos Claude 4 e Claude Sonnet 3.7

Parâmetros da ferramenta

Aumentar o uso de computador com outras ferramentas

Parâmetros da ferramenta

Ativar capacidade de pensamento em modelos Claude 4 e Claude Sonnet 3.7

Aumentar o uso de computador com outras ferramentas

Construir um ambiente de uso de computador personalizado

Implementar a ferramenta de uso de computador

Lidar com erros

Falha na captura de tela

Coordenadas inválidas

Falha na execução da ação

Seguir as melhores práticas de implementação

Usar resolução de tela apropriada

Implementar manipulação adequada de captura de tela

Adicionar atrasos de ação

Validar ações antes da execução

Registrar ações para depuração

Entender as limitações do uso de computador

Entender as limitações do uso de computador

Preços

Entender as limitações do uso de computador

Preços

Próximas etapas