Cheat Sheet da API Personalizada para Agentes de Codificação: Copie e Cole Configurações para Reduzir sua Fatura de Tokens

Todo agente de codificação popular permite trocar o modelo que o sustenta, mas cada um esconde essa configuração em um arquivo diferente, com um nome de chave diferente e um formato de URL distinto. Por isso, as pessoas desistem e continuam pagando preços de modelos de fronteira, mesmo que usuários intensos de agentes gastem cerca de USD13 por dia por desenvolvedor ativo nos modelos padrão (CloudZero, 2026). Esta página resolve isso. É uma referência única com a configuração de API personalizada exata para Claude Code, OpenClaw, Codex, OpenCode e Cursor, além da única distinção que explica todas as diferenças entre eles. Adicione aos favoritos, pois o valor aqui está nos blocos de copiar e colar e nos detalhes técnicos, não em preenchimento. Ao final, você será capaz de apontar qualquer um desses agentes para um modelo mais barato em poucos minutos e entenderá por que a URL muda de uma ferramenta para outra.

Principais pontos

• Agentes de codificação dividem-se em duas famílias de protocolo. O Claude Code utiliza a API da Anthropic; OpenClaw, Codex, OpenCode e Cursor utilizam a API compatível com OpenAI.
• A diferença prática é a URL: as ferramentas compatíveis com OpenAI exigem um sufixo /v1, e o Claude Code não.
• Toda configuração precisa das mesmas três coisas: uma URL base, uma chave de API e um ID de modelo. Apenas os nomes dos campos mudam.
• Modelos de pesos abertos são a vantagem: o DeepSeek V4 Flash custa cerca de USD0.14 por milhão de tokens de entrada, contra vários dólares dos modelos de fronteira (Codersera, 2026).

Por que uma "folha de dicas" de API personalizada para agentes de codificação compensa

O motivo para se preocupar é o custo, e a causa é estrutural. Os agentes reenviam seu contexto acumulado a cada passo de raciocínio, queimando de 10 a 100 vezes mais tokens do que uma janela de chat para a mesma tarefa (LeanOps, 2026). Esse multiplicador é o motivo pelo qual as contas de agentes disparam, e também o motivo pelo qual reajustar o preço dos tokens, em vez de usar menos o agente, é a estratégia que realmente funciona. Uma API personalizada aponta seu agente para um backend mais barato sem mudar sua forma de trabalhar. Direcione a codificação de rotina para um modelo de pesos abertos e o custo por token cai drasticamente, muitas vezes em 70% ou mais, enquanto a diferença de qualidade em tarefas do dia a dia permanece pequena. Uma "folha de dicas" de API personalizada para agentes de codificação é importante porque a economia é real, mas o atrito na configuração é o que impede a maioria das pessoas, e esse atrito resume-se quase inteiramente a "qual arquivo, qual campo, qual URL".

Como funciona uma entrada na folha de dicas de API personalizada

Antes das configurações, aqui está a ideia única que faz tudo fazer sentido. Os agentes de codificação se dividem em duas famílias de protocolo, e a família à qual uma ferramenta pertence define o formato de sua configuração. O Claude Code fala com a Anthropic Messages API, portanto ele lê seu backend em ANTHROPIC_BASE_URL e autentica com um token no estilo Anthropic. Todo o restante nesta folha de dicas, OpenClaw, Codex, OpenCode e Cursor, fala com a Chat Completions API compatível com OpenAI, portanto, eles utilizam uma baseURL, uma chave no estilo OpenAI e esperam o caminho /v1 no endpoint. Esse detalhe do /v1 é o motivo mais comum para uma configuração falhar silenciosamente. Uma vez que você percebe essa divisão, cada entrada abaixo são os mesmos três valores com roupagens diferentes: uma URL base, uma chave e um ID de modelo. Os exemplos usam Atlas Cloud como provedor, pois ele atende a ambas as famílias de protocolo a partir de uma única conta, então a única coisa que muda entre as ferramentas é a sintaxe, não a chave que você cola. Qualquer provedor compatível funciona da mesma maneira; basta substituir a URL base e a chave.

A folha de dicas de API personalizada, ferramenta por ferramenta

Aqui está a tabela de referência rápida primeiro, seguida pelo bloco de configuração completo para cada ferramenta. Tenha sua chave de API pronta antes de começar. No Atlas Cloud, você cria uma selecionando Coding Plan como tipo de chave, o que a vincula à cota de codificação baseada em créditos.

Claude Code

O Claude Code é o ponto fora da curva da família Anthropic, então note que a URL base não possui /v1. Edite ~/.claude/settings.json no macOS ou Linux, ou %USERPROFILE%.claude\settings.json no Windows:

JSONCopy
1{
2  "env": {
3    "ANTHROPIC_AUTH_TOKEN": "your-atlas-api-key",
4    "ANTHROPIC_BASE_URL": "https://api.atlascloud.ai",
5    "ANTHROPIC_MODEL": "zai-org/glm-5.1",
6    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "zai-org/glm-5.1",
7    "ANTHROPIC_DEFAULT_SONNET_MODEL": "zai-org/glm-5.1",
8    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
9  }
10}

Definir os padrões Haiku e Sonnet para o mesmo modelo direciona as pequenas chamadas em segundo plano do Claude Code para o seu modelo também, em vez de falhar em um padrão indisponível.

OpenClaw

O OpenClaw é o mais fácil porque possui um assistente. No terminal, execute openclaw onboard, depois escolha Yes, QuickStart e Custom Provider. Insira a URL base https:​//api.atlascloud.ai/v1, cole sua chave, cole o ID do modelo e escolha o protocolo OpenAI-compatible. Quando exibir Verification successful, nomeie o endpoint e pronto. O que saber caso você edite ~/.openclaw/openclaw.json manualmente: o OpenClaw é uma configuração de duas etapas. Você define o provedor em models.providers e, em seguida, deve adicionar o modelo à lista de permissões (allowlist) em agents.defaults.models usando a chave provider-name/model-name, ou o agente irá rejeitá-lo (documentação do OpenClaw, 2026). Falhar ao adicionar à lista de permissões é a principal causa do erro "model not allowed". O assistente faz ambas as etapas para você, por isso é o caminho recomendado.

Codex

O Codex usa dois arquivos. Coloque o provedor em ~/.codex/config.toml:

TOMLCopy
1model_provider = "atlas_coding_plan"
2model = "zai-org/glm-5.1"
3
4[model_providers.atlas_coding_plan]
5name = "atlascloud"
6base_url = "https://api.atlascloud.ai/v1"
7wire_api = "chat"
8requires_openai_auth = true

Em seguida, coloque a chave em ~/.codex/auth.json:

JSONCopy
1{ "OPENAI_API_KEY": "your-atlas-api-key" }

Execute codex no terminal, pule o prompt de atualização e você estará conectado.

OpenCode e Cursor

O OpenCode lê ~/.config/opencode/opencode.json (no Windows, \Users\seu-nome.config\opencode\opencode.json):

JSONCopy
1{
2  "$schema": "https://opencode.ai/config.json",
3  "provider": {
4    "atlascloud": {
5      "npm": "@ai-sdk/openai-compatible",
6      "name": "atlascloud",
7      "options": {
8        "baseURL": "https://api.atlascloud.ai/v1",
9        "apiKey": "your-atlas-api-key"
10      },
11      "models": {
12        "zai-org/glm-5.1": { "name": "glm-5.1" }
13      }
14    }
15  }
16}

O Cursor não possui arquivo de configuração para isso. Abra as Configurações, vá para Modelos, adicione o ID do seu modelo pelo nome, depois defina a URL base personalizada do OpenAI como https:​//api.atlascloud.ai/v1 e cole sua chave. Como o Cursor segue o padrão compatível com OpenAI, a mesma URL base e chave das outras ferramentas funcionam sem alterações.

---

Escolhendo um modelo: a outra metade da folha de dicas

Conectar o endpoint é apenas metade do trabalho. O modelo que você escolhe é o que decide a economia. O padrão que funciona é definir um modelo aberto forte e barato como padrão para codificação diária e manter um modelo de fronteira na reserva para os raciocínios mais difíceis. A diferença de capacidade é menor que a diferença de preço: no SWE-Bench Pro, os principais modelos abertos pontuam na casa dos 70 altos, contra aproximadamente 91 para os melhores modelos de fronteira (Codersera, 2026), o que mal é perceptível em trabalhos de rotina e refatorações. Em um provedor baseado em créditos, cada modelo tem um multiplicador que mapeia o uso de tokens para créditos, então o custo relativo é fácil de ler:

Fonte: Regras de crédito do Atlas Cloud Coding Plan. Custo em crédito = tokens de entrada × multiplicador de entrada + tokens de saída × multiplicador de saída. Um padrão prático: GLM-5.1 ou Kimi K2.6 para codificação interativa, DeepSeek V4 Flash para tarefas de alto volume ou em segundo plano, e um modelo de fronteira apenas para a tarefa rara que um modelo aberto não consegue resolver. A troca é uma alteração de uma linha no ID do modelo em qualquer uma das configurações acima.

Uma chave de API em todos os agentes de codificação

Observe o que a tabela da folha de dicas mostra silenciosamente: a mesma chave e os mesmos IDs de modelo aparecem em todas as configurações. Esse é o verdadeiro argumento para um provedor unificado. Se você conectar cada ferramenta a um fornecedor diferente, terminará com chaves separadas, painéis separados e contas separadas, perdendo qualquer visão única dos gastos. Apontar todos eles para um provedor condensa isso em um pool de créditos e um único lugar para trocar modelos. Isso também facilita o orçamento, o que o faturamento medido por tokens torna genuinamente difícil. Um plano que renova uma franquia diária de créditos fixa à meia-noite limita o dano de um loop de agente descontrolado, enquanto pacotes pré-pagos absorvem picos ocasionais. Os planos do Atlas Cloud começam em USD10 por mês, seus pacotes pré-pagos trazem um desconto de 41%, e upgrades no meio do ciclo são rateados, portanto, subir de nível custa apenas a diferença, em vez de um plano novo inteiro.

Erros comuns na folha de dicas de API personalizada

Quase toda configuração que falha se resume a um desses pontos, e todos são rápidos de corrigir. A confusão com o /v1. O erro mais frequente nesta folha de dicas. Ferramentas compatíveis com OpenAI querem o sufixo /v1; o Claude Code não. Um erro de conexão geralmente significa que o caminho está errado para a família daquela ferramenta. Usar o tipo de chave errado. Sua chave de provedor não é sua chave da Anthropic, e vice-versa. Colar a errada gera um erro de autenticação que parece mais confuso do que realmente é. Pular a lista de permissões do OpenClaw. Definir o provedor é apenas metade da configuração do OpenClaw. Se você vir "model not allowed", o modelo está faltando na lista de permissões ou a chave provider-name/model-name tem um erro de digitação. Deixar modelos de segundo plano não definidos no Claude Code. Se você definir apenas o modelo principal, mas deixar os padrões Haiku e Sonnet apontando para modelos indisponíveis, as pequenas chamadas em segundo plano falharão. Defina todos os três.

FAQ: Folha de dicas de API personalizada para agentes de codificação

Esta folha de dicas exige a troca de ferramentas?

Não. O objetivo é que você mantenha o agente que já usa, seja Claude Code, OpenClaw, Codex, OpenCode ou Cursor. Uma API personalizada é uma mudança de configuração, não uma migração, então seu fluxo de trabalho permanece idêntico enquanto o backend e a conta mudam.

Por que a URL base na folha de dicas muda conforme a ferramenta?

Por causa da família de protocolo. O Claude Code usa a API Anthropic e aceita o domínio puro, enquanto as ferramentas compatíveis com OpenAI esperam o caminho /v1. Mesmo provedor, mesma chave, caminho diferente. Essa única diferença explica a maioria das configurações com falha.

Quanto uma folha de dicas de API personalizada pode economizar?

Muito, dependendo do modelo. O DeepSeek V4 Flash custa cerca de USD0.14 por milhão de tokens de entrada contra vários dólares dos modelos de fronteira (Codersera, 2026), portanto, enviar trabalhos de rotina para um modelo aberto comumente reduz a conta por token em 70% ou mais sem mudar sua forma de codificar.

Com qual modelo devo começar a partir da folha de dicas?

Para codificação interativa, GLM-5.1 ou Kimi K2.6 são padrões fortes e acessíveis. Para tarefas de alto volume ou segundo plano, o DeepSeek V4 Flash é mais barato. Mantenha um modelo de fronteira de prontidão apenas para tarefas que um modelo aberto genuinamente não consegue resolver.

A configuração da folha de dicas é reversível?

Sim. Cada configuração é reversível. Restaure a URL base original ou remova o bloco do provedor, e o agente apontará de volta para o padrão. Muitos desenvolvedores mantêm ambas as configurações e alternam com base na tarefa.

Conclusão

O motivo pelo qual vale a pena manter uma folha de dicas de API personalizada para agentes de codificação é que a parte difícil nunca foi o conceito, mas lembrar qual arquivo e qual URL cada ferramenta deseja. Uma vez que você enxerga as duas famílias de protocolo, cada configuração é a mesma URL base, chave e ID de modelo em sintaxe diferente. Escolha um modelo de pesos abertos, cole o bloco correto, atente-se à regra do /v1, e você manterá o agente de que gosta enquanto paga uma fração dos preços de modelos de fronteira. Se quiser uma chave e um orçamento único para todos eles, você pode configurar tudo através do console do Atlas Cloud Coding Plan e trocar de modelos sempre que a tarefa mudar.