- O que é o CoBuddy?
- Por que usar o CoBuddy no Claude Code?
- Passo 1: Obter sua Chave de API da Novita AI
- Passo 2: Instalar o Claude Code
- Passo 3: Configurar Variáveis de Ambiente
- Passo 4: Iniciar o Claude Code
- Especificações e Preços do CoBuddy
- Dicas Práticas de Fluxo de Trabalho de Codificação
- FAQ
- Artigos recomendados
O CoBuddy é o modelo especializado em codificação da Baidu disponível na Novita AI, oferecendo chamada de funções, raciocínio, uma janela de contexto de 128K e baixa latência de ponta a ponta para fluxos de trabalho de desenvolvedores. Como o CoBuddy expõe um endpoint chat/completions compatível com OpenAI em vez de um compatível com Anthropic, configurá-lo no Claude Code requer apontar ANTHROPIC_BASE_URL para o caminho compatível com OpenAI da Novita AI. Este guia percorre cada etapa — desde a chave de API até a primeira sessão.
O que é o CoBuddy?
O CoBuddy é um modelo de geração de código desenvolvido pela Baidu e disponível através da API LLM da Novita AI. Ele é projetado especificamente para tarefas de desenvolvimento de software: gerar código, refatorar, escrever testes, planejar implementações e suportar fluxos de trabalho de agentes.
| Especificação | Detalhes |
|---|---|
| ID do modelo | baidu/cobuddy |
| Janela de contexto | 131.072 tokens (128K) |
| Saída máxima | 65.536 tokens |
| Preço de entrada | $2,80 / 1M tokens |
| Preço de saída | $11,30 / 1M tokens |
| Leitura de cache | $0,70 / 1M tokens |
| Funcionalidades | Chamada de funções, raciocínio |
| Endpoint | Apenas chat/completions compatível com OpenAI |
A distinção do endpoint é importante para a configuração do Claude Code. O CoBuddy não suporta o endpoint compatível com Anthropic, portanto a configuração utiliza a URL base compatível com OpenAI da Novita AI (https://api.novita.ai/v3/openai) em vez do caminho anthropic.
Por que usar o CoBuddy no Claude Code?
O Claude Code é uma CLI agentic que permite delegar tarefas de codificação em linguagem natural — edições de arquivos, comandos de terminal, análise de base de código e fluxos de trabalho em várias etapas. Por padrão, ele funciona com modelos Claude, mas a variável de ambiente ANTHROPIC_BASE_URL permite rotear requisições para um provedor e modelo diferentes.
Substituir pelo CoBuddy através da Novita AI oferece:
- Especialização em codificação. O CoBuddy é construído para tarefas de software, em vez de conversas gerais. Ele visa diretamente a geração de código, revisão e fluxos de trabalho de agentes.
- Diferença de custo em relação ao Claude Sonnet. O Claude Sonnet 4.5 custa $3,00/M de entrada e $15,00/M de saída. O CoBuddy na Novita AI custa $2,80/M de entrada e $11,30/M de saída — economia significativa em volume, com leituras de cache a $0,70/M.
- Alta taxa de transferência e baixa latência E2E. A implantação do CoBuddy na Novita AI é otimizada para taxa de transferência sustentada, o que é importante durante sessões longas de agente que fazem muitas requisições incrementais.
- Janela de contexto de 128K. Espaço suficiente para incluir trechos substanciais de arquivos, saída de testes e notas de implementação em uma única consulta.
Para equipes que já usam o Claude Code e desejam avaliar uma alternativa focada em codificação sem alterar suas ferramentas de fluxo de trabalho, o CoBuddy é um ponto de partida prático.
Passo 1: Obter sua Chave de API da Novita AI
Crie uma conta na Novita AI — novas contas recebem créditos de teste gratuitos. Após fazer login, vá para Gerenciamento de Chaves e clique em Criar Nova Chave. Copie a chave imediatamente; ela é mostrada apenas uma vez.
Passo 2: Instalar o Claude Code
O Claude Code requer Node.js 18 ou superior. Verifique sua versão:
node --version
Se o Node.js estiver ausente ou abaixo da versão 18, instale-o a partir de nodejs.org.
Instale o Claude Code globalmente:
npm install -g @anthropic-ai/claude-code
Confirme a instalação:
claude --version
Passo 3: Configurar Variáveis de Ambiente
O CoBuddy suporta apenas o endpoint compatível com OpenAI. Defina ANTHROPIC_BASE_URL para o caminho compatível com OpenAI da Novita AI para que o Claude Code encaminhe as requisições para lá.
macOS e Linux
export ANTHROPIC_BASE_URL="https://api.novita.ai/v3/openai"
export ANTHROPIC_AUTH_TOKEN="<Sua Chave de API da Novita>"
export ANTHROPIC_MODEL="baidu/cobuddy"
export ANTHROPIC_SMALL_FAST_MODEL="baidu/cobuddy"
Windows (Command Prompt)
set ANTHROPIC_BASE_URL=https://api.novita.ai/v3/openai
set ANTHROPIC_AUTH_TOKEN=<Sua Chave de API da Novita>
set ANTHROPIC_MODEL=baidu/cobuddy
set ANTHROPIC_SMALL_FAST_MODEL=baidu/cobuddy
Windows (PowerShell)
$env:ANTHROPIC_BASE_URL = "https://api.novita.ai/v3/openai"
$env:ANTHROPIC_AUTH_TOKEN = "<Sua Chave de API da Novita>"
$env:ANTHROPIC_MODEL = "baidu/cobuddy"
$env:ANTHROPIC_SMALL_FAST_MODEL = "baidu/cobuddy"
O que cada variável faz:
ANTHROPIC_BASE_URL— redireciona as requisições do Claude Code para o endpoint compatível com OpenAI da Novita AI, em vez dos servidores da AnthropicANTHROPIC_AUTH_TOKEN— sua chave de API da Novita AI usada para autenticaçãoANTHROPIC_MODEL— o modelo usado para tarefas principais (complexas)ANTHROPIC_SMALL_FAST_MODEL— o modelo usado para tarefas de fundo e leves
Para tornar essas variáveis persistentes entre sessões de terminal no macOS/Linux, adicione as linhas export ao seu ~/.zshrc ou ~/.bashrc.
Passo 4: Iniciar o Claude Code
Navegue até o diretório do seu projeto e inicie o Claude Code:
cd /caminho/para/seu/projeto
claude .
O . informa ao Claude Code para operar no diretório atual. Você verá um prompt interativo onde pode descrever tarefas em inglês simples.
Execute /model para confirmar qual modelo está ativo, ou /doctor para diagnosticar problemas de configuração.
Especificações e Preços do CoBuddy
Aqui está a comparação completa entre o CoBuddy na Novita AI e o Claude Sonnet 4.5:
| CoBuddy (Novita AI) | Claude Sonnet 4.5 | |
|---|---|---|
| Entrada (por 1M tokens) | $2,80 | $3,00 |
| Saída (por 1M tokens) | $11,30 | $15,00 |
| Leitura de cache (por 1M tokens) | $0,70 | $0,30 |
| Janela de contexto | 131.072 tokens | 200.000 tokens |
| Saída máxima | 65.536 tokens | 64.000 tokens |
| Chamada de funções | Sim | Sim |
| Raciocínio | Sim | Sim |
| Endpoint Anthropic | Não | Nativo |
A principal troca: o preço do token de saída do CoBuddy é menor que o do Sonnet 4.5, e as leituras de cache são mais baratas em termos absolutos para sessões agentic pesadas que reutilizam contexto. O Claude Sonnet 4.5 tem uma janela de contexto maior e é o modelo nativo para o Claude Code. Escolha o CoBuddy quando quiser um modelo focado em codificação a um custo de saída reduzido; fique com o Sonnet quando precisar do contexto completo de 200K ou tarefas de raciocínio mais amplas.
Dicas Práticas de Fluxo de Trabalho de Codificação
Mantenha os prompts específicos para a tarefa
O CoBuddy é ajustado para tarefas de software. Prompts que descrevem um resultado de engenharia concreto — “adicione validação de entrada a esta função”, “escreva um teste unitário para o fluxo de checkout”, “refatore este módulo para remover a dependência circular” — obtêm melhores resultados do que prompts de exploração abertos.
Use a janela de contexto de 128K deliberadamente
Com 128K tokens, você pode incluir trechos de arquivos relevantes, saída de testes, guias de estilo e contratos de API em uma única requisição. Dito isso, mantenha os prompts estruturados: descreva a tarefa, forneça contexto selecionado, liste restrições e peça uma saída delimitada. Contexto longo não substitui instruções claras.
Verifique a saída da chamada de funções
O CoBuddy suporta chamada de funções, que o Claude Code usa para invocações de ferramentas. Para tarefas que modificam arquivos ou executam comandos, revise as ações planejadas antes de aprovar. Use /review no Claude Code para inspecionar alterações antes de aplicá-las.
Sessões com cache pesado se beneficiam dos preços do CoBuddy
A $0,70/M tokens de leitura de cache, sessões com prompts de sistema grandes ou contexto repetido ficam significativamente mais baratas ao longo do tempo. Se você executa sessões longas de agente que referenciam o mesmo contexto da base de código repetidamente, as leituras de cache se acumulam — e o preço de leitura de cache do CoBuddy é competitivo.
Avalie em tarefas reais antes de se comprometer
A melhor maneira de avaliar o CoBuddy para sua equipe é executá-lo no seu backlog real: um ticket de bug, uma tarefa de geração de teste, uma pequena refatoração. Compare a qualidade da saída com seu modelo atual nessas tarefas específicas, em vez de confiar em benchmarks gerais.
FAQ
Qual é o ID do modelo para o CoBuddy na Novita AI?
Use baidu/cobuddy na variável de ambiente ANTHROPIC_MODEL e em qualquer corpo de requisição direta à API.
Por que usar https://api.novita.ai/v3/openai em vez do endpoint anthropic?
O CoBuddy suporta apenas o endpoint chat/completions compatível com OpenAI. Definir ANTHROPIC_BASE_URL para o caminho compatível com OpenAI da Novita AI (https://api.novita.ai/v3/openai) instrui o Claude Code a rotear requisições através desse endpoint. O caminho compatível com Anthropic (https://api.novita.ai/anthropic) é para modelos que implementam a API de mensagens da Anthropic nativamente — o CoBuddy não o faz.
Quanto custa o CoBuddy na Novita AI?
Em junho de 2026: $2,80/M tokens de entrada, $11,30/M tokens de saída, $0,70/M tokens de leitura de cache. Confirme os preços atuais na página do modelo CoBuddy antes do planejamento de produção.
O CoBuddy suporta chamada de funções?
Sim. O CoBuddy suporta chamada de funções e raciocínio, ambos necessários para o loop de agente do Claude Code.
Posso usar o CoBuddy no Cursor ou em outras ferramentas?
Sim. Qualquer ferramenta que aceite uma URL base personalizada compatível com OpenAI pode usar o CoBuddy via Novita AI. Defina a URL base como https://api.novita.ai/v3/openai e o modelo como baidu/cobuddy.
Novita AI é uma plataforma de nuvem de IA que oferece aos desenvolvedores uma maneira fácil de implantar modelos de IA usando nossa API simples, além de fornecer nuvem GPU acessível e confiável para construir e escalar.
