​
Por que usar o Claude for Sheets?

O Claude for Sheets permite engenharia de prompts em escala, permitindo que você teste prompts em suítes de avaliação em paralelo. Além disso, ele se destaca em tarefas de escritório como análise de pesquisas e processamento de dados online. Visite nossa planilha de exemplo de engenharia de prompts para ver isso em ação.

​
Começando com o Claude for Sheets

​
Instalar o Claude for Sheets

Habilite facilmente o Claude for Sheets usando os seguintes passos:
1

Obtenha sua chave de API do Claude

Se você ainda não tem uma chave de API, você pode criar chaves de API no Console do Claude.
2

Instale a extensão Claude for Sheets

Encontre a extensão Claude for Sheets no marketplace de complementos, então clique no botão azul Install e aceite as permissões.
A extensão Claude for Sheets solicitará uma variedade de permissões necessárias para funcionar adequadamente. Tenha certeza de que processamos apenas os dados específicos que os usuários pedem ao Claude para executar. Esses dados nunca são usados para treinar nossos modelos generativos.As permissões da extensão incluem:
  • Visualizar e gerenciar planilhas nas quais este aplicativo foi instalado: Necessário para executar prompts e retornar resultados
  • Conectar a um serviço externo: Necessário para fazer chamadas aos endpoints da API do Claude
  • Permitir que este aplicativo seja executado quando você não estiver presente: Necessário para executar recálculos de células sem intervenção do usuário
  • Exibir e executar conteúdo web de terceiros em prompts e barras laterais dentro de aplicativos Google: Necessário para exibir a barra lateral e o prompt pós-instalação
3

Conecte sua chave de API

Digite sua chave de API em Extensions > Claude for Sheets™ > Open sidebar > ☰ > Settings > API provider. Você pode precisar aguardar ou atualizar para que o menu do Claude for Sheets apareça.
Você terá que reinserir sua chave de API toda vez que criar uma nova planilha do Google

​
Digite seu primeiro prompt

Existem duas funções principais que você pode usar para chamar o Claude usando o Claude for Sheets. Por enquanto, vamos usar CLAUDE().
1

Prompt simples

Em qualquer célula, digite =CLAUDE("Claude, em uma frase, o que é bom sobre a cor azul?")
O Claude deve responder com uma resposta. Você saberá que o prompt está sendo processado porque a célula dirá Loading...
2

Adicionando parâmetros

Argumentos de parâmetros vêm após o prompt inicial, como =CLAUDE(prompt, model, params...).
model é sempre o segundo na lista.
Agora digite em qualquer célula =CLAUDE("Oi, Claude!", "claude-3-haiku-20240307", "max_tokens", 3)Qualquer parâmetro da API pode ser definido desta forma. Você pode até passar uma chave de API para ser usada apenas para esta célula específica, assim: "api_key", "sk-ant-api03-j1W..."

​
Uso avançado

CLAUDEMESSAGES é uma função que permite usar especificamente a API de Mensagens. Isso permite que você envie uma série de mensagens User: e Assistant: para o Claude. Isso é particularmente útil se você quiser simular uma conversa ou pré-preencher a resposta do Claude. Tente escrever isso em uma célula: 
=CLAUDEMESSAGES("User: Em uma frase, o que é bom sobre a cor azul?
Assistant: A cor azul é ótima porque")
Quebras de linhaCada turno de conversa subsequente (User: ou Assistant:) deve ser precedido por uma única quebra de linha. Para inserir quebras de linha em uma célula, use as seguintes combinações de teclas:
  • Mac: Cmd + Enter
  • Windows: Alt + Enter
Para usar um prompt do sistema, defina-o como você definiria outros parâmetros opcionais da função. (Você deve primeiro definir um nome de modelo.)
=CLAUDEMESSAGES("User: Qual é sua flor favorita? Responda em tags <answer>.
Assistant: <answer>", "claude-3-haiku-20240307", "system", "Você é uma vaca que adora mugir em resposta a qualquer consulta do usuário.")`

​
Parâmetros opcionais da função

Você pode especificar parâmetros opcionais da API listando pares argumento-valor. Você pode definir múltiplos parâmetros. Simplesmente liste-os um após o outro, com cada par de argumento e valor separado por vírgulas.
Os dois primeiros parâmetros devem sempre ser o prompt e o modelo. Você não pode definir um parâmetro opcional sem também definir o modelo.
Os parâmetros argumento-valor que você pode se importar mais são:
ArgumentoDescrição
max_tokensO número total de tokens que o modelo produz antes de ser forçado a parar. Para respostas sim/não ou múltipla escolha, você pode querer que o valor seja 1-3.
temperaturea quantidade de aleatoriedade injetada nos resultados. Para tarefas de múltipla escolha ou analíticas, você vai querer próximo de 0. Para geração de ideias, você vai querer definir como 1.
systemusado para especificar um prompt do sistema, que pode fornecer detalhes de papel e contexto ao Claude.
stop_sequencesArray JSON de strings que farão o modelo parar de gerar texto se encontradas. Devido às regras de escape no Google Sheets™, aspas duplas dentro da string devem ser escapadas duplicando-as.
api_keyUsado para especificar uma chave de API particular com a qual chamar o Claude.
Ex. Definir prompt system, max_tokens, e temperature:
=CLAUDE("Oi, Claude!", "claude-3-haiku-20240307", "system", "Repita exatamente o que o usuário diz.", "max_tokens", 100, "temperature", 0.1)
Ex. Definir temperature, max_tokens, e stop_sequences:
=CLAUDE("Em uma frase, o que é bom sobre a cor azul? Produza sua resposta em tags <answer>.","claude-opus-4-20250514","temperature", 0.2,"max_tokens", 50,"stop_sequences", "\[""</answer>""\]")
Ex. Definir api_key:
=CLAUDE("Oi, Claude!", "claude-3-haiku-20240307","api_key", "sk-ant-api03-j1W...")

​
Exemplos de uso do Claude for Sheets

​
Tutorial interativo de engenharia de prompts

Nosso tutorial interativo de engenharia de prompts em profundidade utiliza o Claude for Sheets. Confira para aprender ou revisar técnicas de engenharia de prompts.
Assim como com qualquer instância do Claude for Sheets, você precisará de uma chave de API para interagir com o tutorial.

​
Fluxo de trabalho de engenharia de prompts

Nossa bancada de exemplos de prompting do Claude for Sheets é uma planilha alimentada pelo Claude que abriga prompts de exemplo e estruturas de engenharia de prompts.

​
Modelo de pasta de trabalho do Claude for Sheets

Faça uma cópia do nosso modelo de pasta de trabalho do Claude for Sheets para começar com seu próprio trabalho no Claude for Sheets!

​
Solução de problemas

  1. Certifique-se de que você habilitou a extensão para uso na planilha atual
    1. Vá para Extensions > Add-ons > Manage add-ons
    2. Clique no menu de três pontos no canto superior direito da extensão Claude for Sheets e certifique-se de que “Use in this document” esteja marcado
  2. Atualize a página
Você pode recalcular manualmente células #ERROR!, ⚠ DEFERRED ⚠ ou ⚠ THROTTLED ⚠ selecionando das opções de recálculo dentro do menu da extensão Claude for Sheets.
  1. Aguarde 20 segundos, então verifique novamente
  2. Atualize a página e aguarde 20 segundos novamente
  3. Desinstale e reinstale a extensão

​
Informações adicionais

Para mais informações sobre esta extensão, veja a página de visão geral do Claude for Sheets Google Workspace Marketplace.