---
title: "WorkBuddy: integração com a API do Claude"
description: "Tutorial de configuração do endereço, chave e modelo do Claude API via 1折AI no WorkBuddy, incluindo seleção de protocolo, exemplos de configuração, etapas de verificação e erros comuns."
headingIds: {"Verificação da integração e resolução de problemas":"section-1","Custos e outras formas de integração":"section-2"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
Use a funcionalidade de fornecedor personalizado do WorkBuddy para conectar-se ao 1折AI. Primeiro, [crie uma chave de API](/pt/docs/api-keys/) e confirme os [modelos disponíveis atualmente](/pt/docs/models/); os IDs de modelo abaixo são exemplos — ajuste-os conforme as permissões da sua chave.

<Note>
Data de verificação da configuração oficial: 2026-10-15. As configurações abaixo foram organizadas com base na documentação oficial; a verificação ponta a ponta neste site ainda não foi concluída — conclua primeiro uma breve pergunta e resposta e a verificação de chamada de ferramentas antes de usá-las em tarefas longas. Modelos OpenAI / GPT já estão disponíveis; a lista de modelos e preços está em [descrição dos modelos](/pt/docs/models/).
</Note>

De acordo com a [configuração oficial dos modelos](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model): Configurações → Modelos → Adicionar modelo → Personalizado/Custom. Preencha a chave deste site e o modelo `claude-sonnet-4-6`.

Utilize a configuração com o endereço completo da requisição: ative "Protocolo personalizado" nas configurações avançadas, preencha a URL com `https://1zheai.com/v1/chat/completions` e, após salvar, selecione esse modelo no seletor de modelos da conversa. A documentação oficial indica que, com essa opção ativada, a URL preenchida é usada diretamente, sem verificação de caminho nem complementação automática; quando desativada, o complemento é feito conforme o padrão `/chat/completions`. Portanto, a URL completa e a opção devem ser descritas em conjunto.

Aqui, "protocolo personalizado" não significa que uma requisição OpenAI possa ser convertida automaticamente em uma requisição Anthropic — não é possível preencher `/v1/messages` e então afirmar que o protocolo nativo do Claude está conectado. Prefira a interface gráfica; não fornecemos o formato manual `models.json` não verificado. A página oficial apresenta simultaneamente o caminho de configuração local atual e as instruções antigas de migração do `~/.codebuddy/models.json` — evite usar isso para escrever o caminho antigo como um caminho geral atual. As marcações de capacidade de ferramentas na interface também não substituem a verificação ponta a ponta deste site.

## Verificação da integração e resolução de problemas

1. Salve e recarregue a configuração; confirme que o fornecedor selecionado atualmente é `onezhe` ou o modelo personalizado que você adicionou.
2. Envie uma pergunta curta e confirme que uma resposta é retornada; em seguida, tente uma pequena tarefa reversível e confirme separadamente a chamada de ferramentas e a conversa com múltiplas rodadas.
3. Abra o [log de chamadas](/pt/docs/usage-logs/) e verifique o horário da requisição, o modelo, o status e o consumo. Uma resposta de texto bem-sucedida não significa que todas as capacidades de Agent estejam compatíveis.
4. Em caso de 404, verifique se o endereço e o protocolo deste artigo são compatíveis; em caso de 401, verifique a origem da chave e se o processo leu as variáveis de ambiente; em caso de 429, consulte as informações de limitação de taxa antes de tentar novamente. Mais cenários em [códigos de erro e resolução de problemas](/pt/docs/troubleshooting/).

A chave deve ser armazenada apenas no ambiente local ou no armazenamento de credenciais da ferramenta — não a envie para repositórios de código, capturas de tela ou logs públicos. Serviços em segundo plano podem não herdar as variáveis de ambiente do terminal; modelos auxiliares, busca e outras ferramentas também podem ter configurações de fornecedor independentes que precisam ser verificadas separadamente.

## Custos e outras formas de integração

Consulte os [preços em tempo real da API do Claude](https://1zheai.com/en/pricing/) e as [regras de cobrança](/pt/docs/pricing-explained/). Para outros clientes, retorne ao [diretório de integração de ferramentas](/pt/docs/integrations/); para escrever seu próprio programa, use o [SDK e guia de desenvolvimento](/pt/docs/guides/).