Primeiros passos

Perguntas frequentes

Encontre respostas sobre contas BetterToken, cobrança, uso, API Keys, Base URL, acesso a modelos, ferramentas compatíveis e erros de conexão mais comuns.

Perguntas sobre ferramentas de desenvolvimento com IA

Estas páginas são destinadas a desenvolvedores que buscam informações sobre Claude Code, Codex, Cursor, Cline e outras ferramentas de desenvolvimento com IA. Primeiro elas explicam a ferramenta e depois mostram como API Key, Base URL, escolha de protocolo e consulta de uso se relacionam com o BetterToken.

O que é Claude Code e como funciona
Claude Code ou Claude Desktop
Claude Code ou Cursor para desenvolvimento local
O Claude Code usa uma conta Claude.ai ou uma API Key?
Como configurar API Key e Base URL no Claude Code
Kimi K3 no Claude Code: Configure a BetterToken API Key, a Base URL e os mapeamentos do modelo kimi-k3 no settings.json ou no VS Code.
O que é CLAUDE.md no Claude Code
Como alternar entre Sonnet e Opus no Claude Code
Permissões e hooks do Claude Code
Como configurar MCP no Claude Desktop
Endpoint do Claude Desktop
Claude Desktop: erros SSL e roteamento local: Corrija a falta de resposta e o erro de certificado SSL expirado do Claude Desktop com o roteamento local e Needs model mapping do CC Switch.
Claude Desktop Cowork ou Code Gateway
O que é Codex CLI
Codex CLI, Codex App ou Codex Web
Como configurar config.toml no Codex CLI
GPT-5.6 Sol com contexto de 1M no Codex: Configure um contexto de um milhão de tokens e o limite de compactação para GPT-5.6 Sol no config.toml ou apenas em uma sessão do Codex CLI.
O que significam model_provider, base_url e wire_api no Codex CLI
O que significam review_model e reasoning_effort no Codex CLI
O que é AGENTS.md no Codex CLI
O que são os modos sandbox e approval do Codex CLI
Como configurar GPT-6 Astra no modo API do Codex?
Como manter o login oficial do Codex com uma API de terceiros
API GPT Image de terceiros com Codex: Mantenha o login e o chat do Codex enquanto um skill separado usa a BetterToken GPT Image API.
Como configurar uma API Key e uma Base URL personalizadas da OpenAI no Cursor
Cursor Rules, AGENTS.md e .cursorignore
Como configurar MCP no Cursor
Como configurar uma API compatível com OpenAI no Cline
GLM no OpenCode: Configure o GLM no OpenCode com sua BetterToken API Key, Base URL e Model ID exato, verifique o modelo e resolva erros de autenticação e configuração.
Kimi K3 no OpenCode: Conecte o Kimi K3 ao OpenCode pela BetterToken com API Key, Base URL e o Model ID kimi-k3 usando /connect ou opencode.json.
API compatível com OpenAI ou API compatível com Anthropic
Claude Code ou Codex CLI
MCP ou API Key e Base URL

Conta e cobrança

Programa de indicação: Saiba como funcionam as recompensas após o cadastro e a primeira recarga de um amigo, como o saldo é usado e quando há análise manual.

Como o BetterToken cobra pelo uso?

O BetterToken cobra pelo uso real de tokens e segue os preços da Anthropic / OpenAI sem adicionar uma margem extra.

Consulte a página de preços para ver os detalhes.

Posso pedir reembolso depois do cadastro?

Entre em contato com o suporte se precisar de reembolso de uma recarga paga.

Posso usar a mesma API Key em várias ferramentas?

Sim. Você pode usar a mesma API Key ao mesmo tempo no Claude Code, Codex, Cursor e em outras ferramentas. O uso é compartilhado.

Onde posso consultar meu uso?

Entre no Dashboard para consultar o uso atual e os registros de cobrança.

Instalação e configuração

Qual é a base_url do BetterToken?

O BetterToken usa dois endpoints diferentes de acordo com o protocolo:

Cenário	Base URL
Claude Code / `ANTHROPIC_BASE_URL`	`https://bettertoken.ai`
Codex / `OPENAI_BASE_URL` / ferramentas externas	`https://bettertoken.ai/v1`

Não reutilize o mesmo endereço em todas as ferramentas.

Preciso informar um modelo ao usar o Claude Code?

Conecte o Claude Code com sua BetterToken API Key, a Base URL https://bettertoken.ai e o Model ID escolhido. Substitua YOUR_MODEL_ID pelo ID copiado. ANTHROPIC_MODEL define o modelo principal e as três variáveis ANTHROPIC_DEFAULT_*_MODEL definem os aliases Haiku, Sonnet e Opus. Use o mesmo modelo ou um diferente para cada função. Copie o Model ID exato da model plaza.

Preciso informar um modelo ao usar o Codex?

Copie o Model ID exato da model plaza.

Preciso informar um modelo ao usar outras ferramentas, como o Cursor?

Copie o Model ID exato da model plaza.

O OpenClaw e outras ferramentas externas precisam de headers adicionais?

Normalmente, não.

De acordo com a documentação oficial consultada, ferramentas externas comuns, como Cursor, Cline e Zed, usam principalmente Base URL, API key e ID do modelo. OpenCode e OpenClaw aceitam headers opcionais, mas a documentação oficial os descreve para headers personalizados ou necessidades específicas de autenticação, e não como uma etapa obrigatória de configuração do BetterToken.

Adicione headers extras somente quando a documentação oficial da ferramenta ou seu próprio gateway upstream, roteamento de tenant, camada de observabilidade ou cache exigir isso explicitamente.

O que devo fazer se a autenticação falhar após a configuração?

Confira os itens a seguir:

A API Key está correta e não contém espaços extras
O Claude Code usa https://bettertoken.ai, enquanto o Codex e as ferramentas externas usam https://bettertoken.ai/v1
Nenhuma variável antiga, como ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, OPENAI_API_KEY ou OPENAI_BASE_URL, está sobrescrevendo a configuração
Em ferramentas externas, confira se há requisitos oficiais adicionais, como limites de versão, listas de modelos permitidos ou headers exigidos explicitamente pelo seu gateway upstream

Se o problema continuar, entre em contato com o suporte.

Uso de modelos

Escolher um modelo: Saiba como escolher um modelo de IA por protocolo, tipo de tarefa, qualidade, velocidade, tamanho do contexto e custo.
Versão do modelo: Saiba por que um modelo pode informar a própria versão incorretamente em uma chamada à API e como verificar qual modelo foi usado.
Configuração da Base URL: Entenda como a Base URL, os caminhos /v1, a API Key e o Model ID devem corresponder no Claude Code, Codex CLI, Cursor, Cline e outras ferramentas.
Limites de tokens de saída: Entenda max_tokens, max_completion_tokens e max_output_tokens e saiba como definir o limite de tokens de saída nas chamadas de modelo.
JSON com Pydantic: Valide com Pydantic o JSON retornado por um LLM, preserve a resposta original e trate reparo e novas tentativas explicitamente.

Custos e tokens

Por que o Claude Code usa tantos tokens e como reduzir o custo
Cobrança com cache: Entenda o cache de prompt, os campos de acerto de cache, as diferenças entre protocolos e como verificar se uma requisição usou tokens em cache.
Tokens em Responses e Messages: Compare os tokens de entrada de Responses API e Messages API com a mesma API Key e modelo para entender as diferenças entre as solicitações.

Confiabilidade e limites de uso

Limite de uso do Codex e limite de requisições da API: Diferencie limite do plano Codex, limite de requisições da API, teto de uso e saldo insuficiente da BetterToken para identificar a causa correta antes de tentar novamente.

Como o BetterToken mantém a confiabilidade?

O BetterToken se conecta a vários provedores e usa os seguintes mecanismos:

Vários provedores: a falha de um provedor não interrompe todas as solicitações
Roteamento dinâmico: o BetterToken seleciona em tempo real uma rota rápida e estável
Compatibilidade prioritária: o trabalho de confiabilidade se concentra no Claude Code e no ecossistema do Codex

O que devo fazer se encontrar limites de uso ou timeouts?

O BetterToken trata automaticamente os limites de uso e timeouts de provedores individuais. Se o problema continuar:

Confira se há saldo suficiente
Aumente o timeout da ferramenta (API_TIMEOUT_MS=3000000 é o valor recomendado)
Entre em contato com o suporte para confirmar o estado atual da cota

O BetterToken é adequado para produção?

O BetterToken foi desenvolvido principalmente para pessoas que usam ferramentas de desenvolvimento com IA, como Claude Code e Codex. Para cargas de API de produção em grande escala, avalie o serviço de acordo com seus próprios requisitos.

Privacidade e segurança

Segurança dos dados: Entenda os limites de segurança dos dados, o transporte HTTPS, os logs, os registros de uso e as práticas do usuário nas chamadas à API da BetterToken.

O BetterToken armazena o conteúdo das minhas solicitações?

O BetterToken atua como relay e não mantém o conteúdo das conversas. Consulte a Política de Privacidade para ver os detalhes.

O que devo fazer se minha API Key vazar?

Entre imediatamente no Dashboard, exclua a chave antiga e gere uma nova. Depois, atualize todas as ferramentas que usam essa chave.