Quer apenas conversar com o Claude? Visite claude.ai!

Quer mergulhar diretamente no entendimento da nossa API? Vá para a documentação de referência da API para mais detalhes.

Vamos colocá-lo rapidamente em funcionamento com o Claude! Neste guia, vamos orientá-lo através do processo de configuração do seu ambiente, instalação das bibliotecas necessárias e envio da sua primeira solicitação de API para o Claude. Vamos começar!

Observe que, embora este guia use nosso SDK Python, também mantemos um SDK TypeScript e suportamos integrações HTTP diretas. Consulte nossa documentação de SDKs de cliente e referência da API para obter detalhes.

​
Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

​
Passo 1: Configure seu ambiente

Faça uma cópia do nosso notebook Google Colab de início rápido para começar imediatamente sem configurar um ambiente!

Primeiro, certifique-se de ter o Python instalado. Abra seu terminal (no macOS) ou prompt de comando (no Windows) e digite:

Shell
python --version

Se você vir um número de versão como “Python 3.12.2”, está tudo pronto. Caso contrário, visite o site oficial do Python e baixe a versão mais recente.

​
(Opcional) Crie um ambiente virtual

Embora não seja obrigatório, é recomendado criar um ambiente virtual para seus projetos Claude. Isso ajuda a manter suas dependências organizadas e evita conflitos com outros projetos. Para criar um ambiente virtual, execute:

Shell
python -m venv claude-env

Em seguida, ative-o:

  • No macOS ou Linux: source claude-env/bin/activate
  • No Windows: claude-env\Scripts\activate

​
Passo 2: Instale o SDK Python da Anthropic

Com seu ambiente configurado, é hora de instalar a biblioteca Python do Claude. Simplesmente execute:

Shell
pip install anthropic

Este comando instalará a versão mais recente da biblioteca, juntamente com quaisquer dependências necessárias.

​
Passo 3: (Opcional) Configure sua chave de API

Para usar o Claude, você precisará fornecer sua chave de API. Você pode disponibilizar sua chave de API para todos os seus projetos Claude definindo uma variável de ambiente. Veja como:

  • No macOS ou Linux:
    1. Abra seu terminal e digite: nano ~/.bash_profile (ou nano ~/.zshrc se você estiver usando uma versão mais recente do macOS)
    2. Adicione esta linha ao arquivo, substituindo your-api-key-here por sua chave de API real: export ANTHROPIC_API_KEY='your-api-key-here'
    3. Salve o arquivo e saia do editor (pressione Ctrl+O, depois Enter, depois Ctrl+X)
    4. Carregue o perfil atualizado executando: source ~/.bash_profile (ou source ~/.zshrc)
  • No Windows:
    1. Abra o prompt de comando e digite: setx ANTHROPIC_API_KEY "your-api-key-here", substituindo your-api-key-here por sua chave de API real
    2. Para tornar essa alteração permanente, siga estas etapas:
      • Clique com o botão direito em ‘Este Computador’ ou ‘Meu Computador’ e selecione ‘Propriedades’
      • Clique em ‘Configurações avançadas do sistema’
      • Clique no botão ‘Variáveis de Ambiente’
      • Na seção ‘Variáveis do sistema’, clique em ‘Novo…’ e insira ANTHROPIC_API_KEY como o nome da variável e sua chave de API como o valor da variável

​
Passo 4: Envie sua primeira solicitação de API

Você está quase lá! Vamos enviar sua primeira solicitação de API para o Claude. Crie um novo arquivo Python (por exemplo, claude_test.py) e adicione o seguinte código:

Python
import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)

message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0.0,
    system="Responda apenas em Yoda-speak.",
    messages=[
        {"role": "user", "content": "Como você está hoje?"}
    ]
)

print(message.content)

Vamos analisar o que está acontecendo aqui:

  • Importamos a biblioteca anthropic, que fornece uma maneira conveniente de interagir com a API do Claude.
  • Criamos uma instância do cliente Anthropic, passando nossa chave de API (se você definiu uma variável de ambiente, pode omitir isso).
  • Chamamos o método messages.create() para enviar uma mensagem ao Claude. Especificamos o modelo que queremos usar (claude-3-opus-20240229), o número máximo de tokens na resposta (max_tokens=1000), a temperatura (que controla a aleatoriedade da saída, temperature=0.0 significa aleatoriedade mínima) e a mensagem do sistema (que define o contexto para a conversa).
  • Por fim, imprimimos a resposta do Claude.

Para executar o código, basta digitar python claude_test.py no seu terminal ou prompt de comando. Você deve ver uma resposta semelhante a um provérbio do Claude!

Visite Exemplos da API de Mensagens para obter mais exemplos de estruturas de chamada de API. Para obter mais informações sobre os parâmetros da API, consulte a referência da API de Mensagens.

​
Próximos passos

Parabéns, você enviou com sucesso sua primeira solicitação de API para o Claude! Aqui estão alguns próximos passos para continuar sua jornada.

​
Recursos da API

Mergulhe em nossa documentação da API para obter mais detalhes sobre os endpoints e parâmetros disponíveis.

Confira nossos SDKs de cliente para um conjunto de ferramentas para facilitar a construção e integração do Claude em seus aplicativos.

​
Anthropic Cookbook

O Anthropic Cookbook abriga um conjunto de receitas na forma de notebooks Jupyter. Esses notebooks apresentam código copiável que demonstra como usar o Claude de maneiras inteligentes e eficazes em cenários mais avançados, como upload de PDFs, uso de ferramentas e chamada de funções, embeddings e muito mais.

​
Outros recursos

Estamos ansiosos para ver o que você criará com o Claude. Feliz codificação!