O Claude Code não usa o endpoint de chat da OpenAI. Ele envia solicitações Anthropic Messages para /v1/messages, portanto a URL base e as credenciais devem usar as configurações Anthropic do Claude Code. O GetVibe oferece suporte ao formato Messages para modelos específicos do catálogo; GPT-6 Luna, GPT-6 Sol e GPT-6.1 Sol não são compatíveis com este caminho da CLI. Este guia segue a configuração do Claude Code do GetVibe e a referência de endpoint personalizado existente.
Instale e configure o Claude Code
Instale a CLI com o Node.js 22 ou posterior:
npm install -g @anthropic-ai/claude-code
mkdir -p ~/.claudeEdite ~/.claude/settings.json e use exatamente os campos abaixo. A URL base intencionalmente não tem /v1; o Claude Code acrescenta /v1/messages. O campo ANTHROPIC_API_KEY vazio é importante: sem ele, o Claude Code pode priorizar sua autenticação direta normal da Anthropic em vez do endpoint personalizado.
{
"apiKeyHelper": "echo $GETVIBE_API_KEY",
"env": {
"ANTHROPIC_BASE_URL": "https://getvibeapi.com",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
}
}Defina a chave no shell antes de iniciar o Claude Code: export GETVIBE_API_KEY='your-dashboard-key'. Essa é a variável de ambiente usada pelos arquivos de integração do GetVibe. O arquivo de configurações referencia a variável; ele não deve conter a chave real. Evite colocar uma credencial direta da Anthropic neste perfil, porque a precedência das credenciais pode contornar o endpoint personalizado.
Verifique o endpoint antes de conceder acesso de escrita
Inicie o claude em um repositório descartável e execute /status. A URL base da Anthropic deve ser https://getvibeapi.com. Faça primeiro uma pergunta somente de leitura; em seguida, solicite uma pequena edição e inspecione o diff. Se a solicitação ainda for diretamente para a Anthropic, verifique se ANTHROPIC_API_KEY é uma string vazia e se o helper consegue ler GETVIBE_API_KEY. Se você vir um /v1/v1/messages duplicado, remova /v1 da URL base.
Quais modelos funcionam por meio do Messages?
O guia de integração atual do GetVibe lista Claude Opus 5.5, Claude Sonnet 5, DeepSeek V4.1 Flash, Gemini 3.8 Flash, GLM-5.3 e Kimi K3 como exemplos compatíveis com a rota Anthropic Messages. Consulte o catálogo atual de modelos antes de alterar um slot; o suporte ao protocolo é específico de cada modelo. GPT-6 Luna, GPT-6 Sol e GPT-6.1 Sol não funcionam pelo endpoint Messages do Claude Code. Use o Codex CLI para esses modelos compatíveis com Responses. O snapshot público do catálogo consultado em 3 de outubro de 2026 mostra o Sonnet 5.5 a $0.168 entrada · $0.84 saída por 1M de tokens por milhão de tokens; o preço exibido continua atualizado.
Atribua os slots de modelo intencionalmente
O Claude Code oferece slots para Opus, Sonnet e Haiku. O exemplo de configurações do GetVibe escolhe IDs atuais para esses slots e usa CLAUDE_CODE_SUBAGENT_MODEL para o trabalho de subagentes. Altere um slot por vez. Depois de reiniciar a CLI, pergunte a /status qual modelo está ativo e execute um prompt de teste inofensivo. Não presuma que um modelo OpenAI pertence a um slot Claude: o protocolo e o tratamento da família de modelos são diferentes.
Para calcular o custo, compare Sonnet e Opus na mesma tarefa, com o mesmo snapshot do repositório, permissões e solicitação de saída. Registre todos os turnos do agente e as etapas de correção. O preço atual do Sonnet 5.5 é mostrado como $0.168 entrada · $0.84 saída por 1M de tokens por milhão de tokens de entrada e saída. A data do snapshot do catálogo é 3 de outubro de 2026; use a página do modelo vinculada ao definir o orçamento de uma nova sessão.
Mantenha sessões longas sob controle
As sessões de agentes geram contexto repetido. Mantenha as instruções concisas, exclua artefatos de build e diretórios de dependências fornecidas e evite pedir ao agente que releia arquivos grandes quando uma lista de arquivos focada for suficiente. As solicitações do Claude podem usar pontos de cache; o GetVibe documenta o comportamento de cache na documentação de cache. Mantenha o prefixo estável e verifique os campos de uso para saber se a entrada armazenada em cache está sendo realmente informada. Não considere uma taxa de cache teórica mais baixa como economia até que a sessão mostre leituras do cache.
Defina um limite claro para a tarefa, use prompts normais de permissão e revise comandos e diffs. Um preço baixo por token não torna seguro um comando de shell perigoso. Para comparações reproduzíveis de benchmark, use o mesmo modo de permissão e o mesmo acesso a ferramentas para cada modelo.
Falhas comuns de configuração
- 401: verifique
GETVIBE_API_KEY, a saída do helper e o campoANTHROPIC_API_KEYvazio. - O tráfego contorna o GetVibe: verifique as credenciais no perfil do shell e confirme a URL base usando
/status. - Modelo indisponível: copie um ID atual exato e verifique a compatibilidade com Messages na página do modelo.
- URL incorreta: defina o domínio raiz sem
/v1; o Claude Code adiciona o sufixo da rota.
Crie uma linha de base de custo
Antes da implementação, execute uma tarefa curta e uma alteração realista em vários arquivos. Registre o ID do modelo, o uso de entrada e saída, as leituras do cache, se informadas, o tempo decorrido e se os testes passam. Mantenha a chave em um gerenciador de secrets e configure um alerta interno. Essas observações fornecem à equipe uma linha de base real de custo por alteração, em vez de presumir que toda sessão de coding consome o mesmo contexto. O preço atual pode ser consultado na página do modelo Sonnet 5.5.
Mantenha os slots de modelo explícitos
O Claude Code tem slots para Opus, Sonnet e Haiku. Defina apenas os slots que sua equipe planeja usar e confirme a escolha ativa com /status depois de alterar as configurações. O nome de um slot Claude não é um adaptador de protocolo: um modelo exclusivo da OpenAI não se tornará compatível com Messages por ser atribuído ao slot Sonnet.
Meça o cache em uma sessão real
Execute uma tarefa curta e uma tarefa em vários arquivos com as mesmas instruções estáveis. Compare o uso de leituras do cache nos turnos seguintes e registre o custo total da sessão. Mantenha as permissões, o snapshot do repositório e o slot de modelo inalterados entre testes repetidos; caso contrário, a comparação não poderá determinar se uma diferença de custo veio do cache, de chamadas adicionais a ferramentas ou de uma tarefa diferente.
Proteja edições e credenciais
Use um worktree descartável para a primeira tarefa com escrita habilitada, revise comandos e diffs e mantenha as credenciais em um secret gerenciado pelo shell. Se uma chave for parar no histórico do terminal ou em um arquivo de configurações compartilhado, faça a rotação dela. Esses limites simples permitem que os desenvolvedores explorem o agente sem dar a cada prompt acesso a dados de produção ou a uma árvore de trabalho não revisada.