Pular para o conteúdo
Português

WorkBuddy: integração com a API do Claude

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.

Use a funcionalidade de fornecedor personalizado do WorkBuddy para conectar-se ao 1折AI. Primeiro, crie uma chave de API e confirme os modelos disponíveis atualmente; os IDs de modelo abaixo são exemplos — ajuste-os conforme as permissões da sua chave.

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.

De acordo com a configuração oficial dos modelos: 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

Seção intitulada "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 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.

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.

Consulte os preços em tempo real da API do Claude e as regras de cobrança. Para outros clientes, retorne ao diretório de integração de ferramentas; para escrever seu próprio programa, use o SDK e guia de desenvolvimento.