A extensão Claude for Sheets integra Claude ao Google Sheets, permitindo que você execute interações com Claude diretamente nas células.
Por que usar Claude for Sheets?
Claude for Sheets permite engenharia de prompts em escala, permitindo que você teste prompts em suites de avaliação em paralelo. Além disso, é excelente 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.
Comece com Claude for Sheets
Instale Claude for Sheets
Ative facilmente Claude for Sheets seguindo os passos abaixo:
Obtenha sua chave de API Claude: Se você ainda não tem uma chave de API, pode criar chaves de API no Console Claude.
Instale a extensão Claude for Sheets: Encontre a extensão Claude for Sheets no marketplace de complementos, clique no botão azul `Instalar` e aceite as permissões.
Permissões: A extensão Claude for Sheets solicitará uma variedade de permissões necessárias para funcionar corretamente. Tenha certeza de que apenas processamos 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 em que 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 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 da 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.
Conecte sua chave de API: Digite sua chave de API em
Extensões>Claude for Sheets™>Abrir barra lateral>☰>Configurações>Provedor de API. Você pode precisar aguardar ou atualizar para que o menu Claude for Sheets apareça.
Importante: Você terá que inserir novamente sua chave de API toda vez que criar uma nova Planilha Google.
Digite seu primeiro prompt
Existem duas funções principais que você pode usar para chamar Claude usando Claude for Sheets. Por enquanto, vamos usar CLAUDE().
Prompt simples
Em qualquer célula, digite =CLAUDE("Claude, em uma frase, o que é bom sobre a cor azul?").
Claude deve responder com uma resposta. Você saberá que o prompt está sendo processado porque a célula dirá Carregando....
Adicionando parâmetros
Os argumentos de parâmetro vêm após o prompt inicial, como =CLAUDE(prompt, model, params...).
Nota: model é sempre o segundo na lista.
Agora digite em qualquer célula =CLAUDE("Oi, Claude!", "claude-haiku-4-5-20251001", "max_tokens", 3).
Qualquer parâmetro de API pode ser definido dessa 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 Usuário: e Assistente: para Claude.
Isso é particularmente útil se você quiser simular uma conversa ou preencher previamente a resposta do Claude.
Tente escrever isto em uma célula:
=CLAUDEMESSAGES("Usuário: Em uma frase, o que é bom sobre a cor azul?
Assistente: A cor azul é ótima porque")Quebras de linha
Cada turno de conversa subsequente (Usuário: ou Assistente:) 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
Exemplo de chamada CLAUDEMESSAGES() com múltiplos turnos e prompt do sistema
Para usar um prompt do sistema, defina-o como você definiria outros parâmetros de função opcionais. (Você deve primeiro definir um nome de modelo.)
=CLAUDEMESSAGES("Usuário: Qual é sua flor favorita? Responda em tags <answer>.
Assistente: <answer>", "claude-haiku-4-5-20251001", "system", "Você é uma vaca que adora mugir em resposta a qualquer consulta do usuário.")
Parâmetros de função opcionais
Você pode especificar parâmetros de API opcionais listando pares de 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.
Nota: Os dois primeiros parâmetros devem ser sempre o prompt e o modelo. Você não pode definir um parâmetro opcional sem também definir o modelo.
Os parâmetros de argumento-valor que você pode se importar mais são:
Argumento | Descrição |
| O 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. |
| A quantidade de aleatoriedade injetada nos resultados. Para tarefas de múltipla escolha ou analíticas, você vai querer que seja próximo de 0. Para geração de ideias, você vai querer que seja definido como 1. |
| Usado para especificar um prompt do sistema, que pode fornecer detalhes de função e contexto ao Claude. |
| Array 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 dobrando-as. |
| Usado para especificar uma chave de API particular com a qual chamar Claude. |
Exemplo: Definindo parâmetros
Ex. Defina prompt system, max_tokens e temperature:
=CLAUDE("Oi, Claude!", "claude-haiku-4-5-20251001", "system", "Repita exatamente o que o usuário diz.", "max_tokens", 100, "temperature", 0.1)Ex. Defina `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-5-20251101","temperature", 0.2,"max_tokens", 50,"stop_sequences", "\[""</answer>""\]")Ex. Defina api_key:
=CLAUDE("Oi, Claude!", "claude-haiku-4-5-20251001","api_key", "sk-ant-api03-j1W...")
Exemplos de uso de Claude for Sheets
Tutorial interativo de engenharia de prompts
Nosso tutorial interativo de engenharia de prompts em profundidade utiliza Claude for Sheets.
Confira para aprender ou revisar técnicas de engenharia de prompts.
Nota: Assim como em qualquer instância de Claude for Sheets, você precisará de uma chave de API para interagir com o tutorial.
Fluxo de trabalho de engenharia de prompts
Nosso banco de trabalho de exemplos de prompts Claude for Sheets é uma planilha alimentada por Claude que contém prompts de exemplo e estruturas de engenharia de prompts.
Modelo de pasta de trabalho Claude for Sheets
Faça uma cópia do nosso modelo de pasta de trabalho Claude for Sheets para começar com seu próprio trabalho com Claude for Sheets!
Solução de problemas
Erro NAME?: Função desconhecida: 'claude'
Certifique-se de que você habilitou a extensão para uso na planilha atual
Vá para Extensões > Complementos > Gerenciar complementos
Clique no menu de três pontos no canto superior direito da extensão Claude for Sheets e certifique-se de que "Usar neste documento" está marcado
Atualize a página
#ERROR!, ⚠ DEFERRED ⚠ ou ⚠ THROTTLED ⚠
Você pode recalcular manualmente células #ERROR!, ⚠ DEFERRED ⚠ ou ⚠ THROTTLED ⚠ selecionando as opções de recálculo dentro do menu da extensão Claude for Sheets.
Não consigo inserir a chave de API
Aguarde 20 segundos e verifique novamente
Atualize a página e aguarde mais 20 segundos
Desinstale e reinstale a extensão
Informações adicionais
Para mais informações sobre esta extensão, consulte a página de visão geral do Claude for Sheets Google Workspace Marketplace.