Trae + JoinGonka Gateway — modelos da rede Gonka no AI-IDE

Build e versão. O Trae tem duas linhas: a internacional (documentação em docs.trae.ai) e a chinesa (docs.trae.cn). A opção Custom Model existe nas duas e funciona do mesmo jeito; o que muda são os modelos integrados e o conjunto de presets nas configurações adicionais. O endereço de requisição personalizado para o seu próprio modelo é suportado a partir da versão 3.5.51, de 14 de abril de 2026 — se o seu build for mais antigo, atualize. O build internacional não está disponível em todos os países: antes de instalar, confira a lista de países e regiões compatíveis.

Sistema. macOS 12 ou superior, Windows 10 ou 11 (x64), Linux em pacotes .deb e .rpm. Na primeira inicialização o Trae vai sugerir escolher tema e idioma, importar as configurações do VS Code ou do Cursor e entrar na sua conta.

Chave da JoinGonka. Cadastre-se no gateway, abra no seu painel a seção «Chaves de API» e clique em «Criar chave». A chave começa com jg- e é exibida uma única vez — salve-a na hora. Vale a pena criar uma chave separada para o Trae: na seção «Uso» o consumo dela vai aparecer em uma linha própria.

Plano do Trae. O seu próprio modelo precisa ser escolhido manualmente na lista de modelos, e na tabela de planos do Trae o plano gratuito só contempla o modo Auto na linha de seleção de modelo — e nesse modo não se usam modelos próprios. A documentação não diz claramente se essa limitação se aplica aos modelos adicionados com a sua própria chave. A regra prática é simples: se no seu plano o Auto Mode puder ser desativado na lista de modelos, está tudo pronto; se não, vai precisar de um plano pago.

1. Abra Settings → Models — o painel de controle de modelos.
2. Clique em Add Model. Na janela que abrir, escolha a opção Custom Model, e não um provedor da lista pronta.
3. Preencha os campos com os valores da tabela. São duas colunas — uma para cada formato de API; escolha uma.
4. Clique em Add Model. O Trae fará uma chamada de teste à API e verificará a chave: em caso de sucesso, o modelo aparecerá na lista; em caso de falha, a janela mostrará uma mensagem de erro e o log de resposta do provedor.

Os demais campos não dependem do formato:

Qual formato escolher. Comece pelo OpenAI Chat Completions: é o caminho principal do gateway e é nele que funciona a maioria das ferramentas. O Anthropic Messages é útil se você já está acostumado a esse formato em outras ferramentas ou quer comparar o comportamento do agente nos dois protocolos — a chave e o saldo são os mesmos.

Como funciona o Full URL. A chave decide quem acrescenta o caminho. Desligada — você informa o endereço base e o Trae adiciona o caminho conforme o formato escolhido: /chat/completions ao endereço com /v1 para OpenAI e /v1/messages à raiz para Anthropic. Ligada — o endereço é usado como está e o caminho deve estar completo nele. O erro mais comum é misturar os modos: colocar o caminho completo com a chave desligada ou o endereço base com a chave ligada.

Um registro, um modelo. Repita os passos para os demais modelos da rede, para alternar entre eles sem voltar às configurações: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 e zai-org/GLM-5.3-Flash. A lista atualizada é retornada por GET https://gate.joingonka.ai/v1/models. Depois, o modelo adicionado pode ser editado, desativado (ele continua no painel, mas some da lista no chat) ou excluído.

Abaixo dos campos principais, há uma lista colapsável Advanced Settings. Você pode não mexer nela — o Trae preencherá os valores padrão —, mas duas configurações valem a pena definir conscientemente: a série do modelo e a janela de contexto.

O preço dos modelos da rede é o mesmo, então a escolha é sobre o comportamento. Todos os modelos da tabela suportam tool calling nativo, que é a base do funcionamento dos agentes do Trae.

Como funciona o orçamento de raciocínio e por que os modelos de reasoning não devem ter o limite de saída reduzido é explicado na análise do GLM-5.3 Flash; a comparação de modelos em tarefas de desenvolvimento está no artigo sobre os melhores modelos para código.

Seus modelos residem em uma lista geral: clique no nome do modelo atual no canto inferior direito do campo de entrada do chat e selecione aquele que você adicionou. Lá também se encontra o interruptor Auto Mode — ele deve estar desativado: no modo Auto, o Trae escolhe por si mesmo um modelo dos integrados e não utiliza os que você adicionou.

Dê ao agente uma tarefa que exija uma ferramenta, por exemplo: «Leia o package.json e liste os scripts de compilação». O agente deve abrir o arquivo e responder corretamente — isso significa que o ciclo «solicitação - chamada de ferramenta - resposta» através do gateway está sendo montado. Em seguida, abra o painel do gateway, seção «Uso»: no bloco «Por chaves», a chave Trae mostrará as solicitações e a hora do último acesso, e no bloco «Por modelos», o modelo selecionado.

Se algo deu errado, observe o texto do erro. O Trae não esconde a resposta do seu modelo: ele mostra o erro do provedor como ele é, com seu próprio código 4028.

Um agente na IDE gasta tokens mais rápido que um chat: cada solicitação inclui instruções do sistema, descrição de ferramentas, arquivos abertos e histórico de passos. Por isso, o preço por token define se você pode rodar o agente para cada pequena tarefa ou se precisa economizar.

Através do JoinGonka Gateway, os tokens custam $0.0069 por milhão na entrada e $0.021 por milhão na saída — o preço é o mesmo para todos os modelos da rede e é preenchido nesta página a partir de uma fonte em tempo real. A ordem de grandeza dos preços em setembro de 2026 é:

A comparação com o próprio Trae é clara, porque modelos abertos existem entre os integrados, e o Trae publica sua lista de preços por milhão de tokens. O DeepSeek-V4-Flash e o MiniMax-M2.7 custam lá $0.30 na entrada e $1.20 na saída, enquanto o GLM-5.3 Flash não consta na lista integrada da versão internacional. Através do gateway, a diferença para os mesmos modelos é de aproximadamente ×43 na entrada e ×58 na saída.

Seu próprio modelo funciona onde houver uma lista de modelos. Trata-se de chats e agentes — tanto no modo IDE quanto no SOLO (modelos próprios são suportados a partir da versão 3.3.0). O preenchimento automático e a previsão de edições são um mecanismo separado, CUE, com seu próprio painel de configurações: não há opção de seleção de modelo nele, e seus limites são definidos pela tarifa do Trae.

Ferramentas e MCP. Os agentes do Trae atuam como clientes MCP, e os servidores conectados por você permanecem disponíveis para o agente em seu próprio modelo: todos os modelos da rede suportam a invocação nativa de ferramentas. Se o Trae informar que o esquema de argumentos da ferramenta é incompatível com o modelo (código 4027), tente usar um modelo de rede adjacente ou outro servidor MCP.

TraeWork. No aplicativo separado TraeWork, o formulário para adicionar seu próprio modelo é o mesmo, mas, segundo a documentação, ele funciona apenas no TraeWork Desktop e apenas para tarefas em ambiente local.

Plugin para outros editores. Na documentação do plugin TraeCode para VS Code e JetBrains não há seção sobre modelos próprios — este guia refere-se ao IDE de desktop. Se você permanecer no VS Code, o mesmo gateway é conectado através de extensões de agente, por exemplo, Cline.

Privacidade. A configuração Privacy Mode (Settings → Account) controla o que o próprio Trae faz com seus diálogos e fragmentos de código: com ela, eles não são enviados para análise e treinamento. Pelo lado do gateway, os diálogos não são armazenados: os prompts e as respostas não permanecem nele após a resposta; no painel, são vistos apenas contadores de solicitações e tokens.

Se precisar trabalhar com imagens — maquetes, capturas de tela de erros —, delegue essa tarefa a um modelo integrado com visão, e deixe o código, comandos e arquivos para o modelo de rede: a alternância leva apenas um clique na lista de modelos.