- O Que É o CoBuddy?
- Por Que Usar o CoBuddy no Claude Code?
- Etapa 1: Obtenha Sua Chave de API da Novita AI
- Etapa 2: Instale o Claude Code
- Etapa 3: Configure as Variáveis de Ambiente
- Etapa 4: Inicie o Claude Code
- Especificações e Preços do CoBuddy
- Dicas Práticas de Fluxo de Trabalho de Codificação
- Perguntas Frequentes
- 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: geração de código, refatoração, escrita de testes, planejamento de implementações e suporte a 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 |
| Recursos | 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, então a configuração usa 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 agentica que permite delegar tarefas de codificação em linguagem simples — edições de arquivos, comandos de terminal, análise de base de código e fluxos de trabalho de várias etapas. Por padrão, ele funciona com modelos Claude, mas a variável de ambiente ANTHROPIC_BASE_URL permite rotear solicitações através de um provedor e modelo diferentes.
Substituir pelo CoBuddy através da Novita AI oferece:
- Especialização em codificação. O CoBuddy é desenvolvido 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 de ponta a ponta. A implantação do CoBuddy na Novita AI é ajustada para taxa de transferência sustentada, o que é importante durante longas sessões de agente que fazem muitas solicitações incrementais.
- Janela de contexto de 128K. Espaço suficiente para passar trechos de arquivos substanciais, saída de testes e notas de implementação em um único prompt.
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.
Etapa 1: Obtenha 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.
Etapa 2: Instale 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 v18, instale-o em nodejs.org.
Instale o Claude Code globalmente:
npm install -g @anthropic-ai/claude-code
Confirme a instalação:
claude --version
Etapa 3: Configure as 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 solicitações para lá.
macOS e Linux
export ANTHROPIC_BASE_URL="https://api.novita.ai/v3/openai"
export ANTHROPIC_AUTH_TOKEN="<Sua Chave de API 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 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 Novita>"
$env:ANTHROPIC_MODEL = "baidu/cobuddy"
$env:ANTHROPIC_SMALL_FAST_MODEL = "baidu/cobuddy"
O que cada variável faz:
ANTHROPIC_BASE_URL— redireciona as solicitaçõ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 em segundo plano 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.
Etapa 4: Inicie o Claude Code
Navegue até o diretório do seu projeto e inicie o Claude Code:
cd /caminho/para/seu/projeto
claude .
O . indica ao Claude Code para operar no diretório atual. Você verá um prompt interativo onde pode descrever tarefas em linguagem 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 é mais baixo que o do Sonnet 4.5, e as leituras de cache são mais baratas em termos absolutos para sessões agentivas 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 com custo de saída reduzido; fique no Sonnet quando precisar dos 200K de contexto 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 exploratórios abertos.
Use a janela de contexto de 128K deliberadamente
Com 128K tokens, você pode passar trechos de arquivos relevantes, saída de testes, guias de estilo e contratos de API em uma única solicitação. Dito isso, mantenha os prompts estruturados: descreva a tarefa, forneça o contexto selecionado, liste restrições e peça uma saída delimitada. Contexto longo não substitui instruções claras.
Verifique a saída de 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 intenso se beneficiam do preço 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 longas sessões 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 em 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.
Perguntas Frequentes
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 solicitação de API direta.
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 solicitações através desse endpoint. O caminho compatível com Anthropic (https://api.novita.ai/anthropic) é para modelos que implementam a API de mensagens Anthropic nativamente — o CoBuddy não faz isso.
Quanto custa o CoBuddy na Novita AI?
A partir de 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 de GPU acessível e confiável para construir e escalar.
