Guia de início rápido
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:
- Uma conta com acesso à API (consulte nosso guia aqui sobre obter acesso ao Claude)
- Uma chave de API (disponível através das suas Configurações de Conta)
- Python 3.7.1 ou mais recente instalado no seu computador
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:
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:
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:
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:
- Abra seu terminal e digite:
nano ~/.bash_profile
(ounano ~/.zshrc
se você estiver usando uma versão mais recente do macOS) - Adicione esta linha ao arquivo, substituindo
your-api-key-here
por sua chave de API real:export ANTHROPIC_API_KEY='your-api-key-here'
- Salve o arquivo e saia do editor (pressione
Ctrl+O
, depoisEnter
, depoisCtrl+X
) - Carregue o perfil atualizado executando:
source ~/.bash_profile
(ousource ~/.zshrc
)
- Abra seu terminal e digite:
- No Windows:
- Abra o prompt de comando e digite:
setx ANTHROPIC_API_KEY "your-api-key-here"
, substituindoyour-api-key-here
por sua chave de API real - 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
- Abra o prompt de comando e digite:
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:
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
- Visite nosso guia de migração para aprender como fazer a transição do seu caso de uso para o Claude.
- Explore o glossário de termos para se familiarizar com a terminologia usada em IA, LLMs e no ecossistema Claude.
- Junte-se ao nosso servidor Discord para desenvolvedores para se conectar com outros desenvolvedores, fazer perguntas e compartilhar seus projetos.
- Visite a biblioteca de prompts para inspiração e prompts prontos para uso em várias tarefas, ou mergulhe na engenharia de prompts verificando a introdução ao prompting.
Estamos ansiosos para ver o que você criará com o Claude. Feliz codificação!