Neste exemplo, vamos pedir ao Claude para escrever uma função Python que verifica se uma string é um palíndromo.

Pré-requisitos

Você vai precisar de:

A Anthropic fornece SDKs para Python e TypeScript, embora você possa fazer requisições HTTP diretas para a API.

Comece com o Workbench

Qualquer chamada de API que você fizer—independentemente da tarefa específica—envia um prompt bem configurado para a API da Anthropic. Enquanto você estiver aprendendo a aproveitar ao máximo o Claude, recomendamos que você inicie o processo de desenvolvimento no Workbench, uma interface web para o Claude.

Faça login no Console da Anthropic e clique em Write a prompt from scratch (Escrever um prompt do zero).

Na seção do meio, em User, vamos fazer uma pergunta ao Claude.

Why is the ocean salty?

Clique em Run. No lado direito, você verá uma saída como

Response
The ocean is salty due to several factors:

1. Weathering of rocks: Over millions of years, rain, rivers, and streams have eroded rocks containing mineral salts. These salts are carried into the ocean by water runoff.
2. Volcanic activity: Underwater volcanoes and hydrothermal vents release minerals, including salts, into the ocean water.
3. Atmospheric deposition: Salt particles from ocean spray can be carried by wind and deposited back into the ocean.
4. Evaporation: As water evaporates from the surface of the ocean, it leaves behind dissolved salts, increasing the concentration of salt in the remaining water.
5. Biological processes: Some marine organisms contribute to the ocean's salinity by releasing salt compounds as byproducts of their metabolism.

Over time, these processes have continuously added salts to the ocean, while evaporation removes pure water, leading to the ocean's current salinity levels. It's important to note that the total amount of salt in the ocean remains relatively stable because the input of salts is balanced by the removal of salts through processes like the formation of evaporite deposits.

Esta é uma boa resposta, mas digamos que queremos controlar o tipo exato de resposta que o Claude dá. Por exemplo, permitindo que o Claude responda a perguntas apenas com poemas. Podemos controlar o formato, tom e personalidade da resposta adicionando um System Prompt.

You are a world-class poet. Respond only with short poems.

Clique em Run novamente.

Response
The ocean's salty brine,
A tale of time and elements combined.
Rocks and rain, a slow erosion,
Minerals carried in solution.
Eons pass, the salt remains,
In the vast, eternal watery domain.

Veja como a resposta do Claude mudou? Os LLMs respondem bem a instruções claras e diretas. Você pode colocar as instruções de função tanto no prompt do sistema quanto na mensagem do usuário. Recomendamos testar para ver qual maneira produz os melhores resultados para o seu caso de uso.

Depois de ajustar as entradas de modo que você esteja satisfeito com a saída e tenha uma boa noção de como usar o Claude, converta seu Workbench em uma integração.

Clique em Get Code para copiar o código gerado que representa sua sessão do Workbench.

Instale o SDK

A Anthropic fornece SDKs para Python (3.7+), TypeScript (4.5+) e Java (8+). Também temos atualmente um SDK Go em versão beta.

No diretório do seu projeto, crie um ambiente virtual.

python -m venv claude-env

Ative o ambiente virtual usando

  • No macOS ou Linux, source claude-env/bin/activate
  • No Windows, claude-env\Scripts\activate
pip install anthropic

Configure sua chave de API

Cada chamada de API requer uma chave de API válida. Os SDKs são projetados para obter a chave de API de uma variável de ambiente ANTHROPIC_API_KEY. Você também pode fornecer a chave ao cliente Anthropic ao inicializá-lo.

export ANTHROPIC_API_KEY='your-api-key-here'

Chame a API

Chame a API passando os parâmetros adequados para o endpoint /messages.

Observe que o código fornecido pelo Workbench define a chave de API no construtor. Se você definiu a chave de API como uma variável de ambiente, pode omitir essa linha, como mostrado abaixo.

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1000,
    temperature=1,
    system="You are a world-class poet. Respond only with short poems.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Why is the ocean salty?"
                }
            ]
        }
    ]
)
print(message.content)

Execute o código usando python3 claude_quickstart.py ou node claude_quickstart.js.

[TextBlock(text="The ocean's salty brine,\nA tale of time and design.\nRocks and rivers, their minerals shed,\nAccumulating in the ocean's bed.\nEvaporation leaves salt behind,\nIn the vast waters, forever enshrined.", type='text')]
O Workbench e os exemplos de código usam configurações padrão do modelo para: modelo (nome), temperatura e tokens máximos para amostragem.

Este guia de início rápido mostra como desenvolver uma aplicação básica, mas funcional, alimentada pelo Claude usando o Console, o Workbench e a API. Você pode usar este mesmo fluxo de trabalho como base para casos de uso muito mais poderosos.

Próximos passos

Agora que você fez sua primeira requisição à API da Anthropic, é hora de explorar o que mais é possível: