Documentação

Qoder

O aplicativo de desktop independente Qoder aceita uma URL base arbitrária em Provider → Custom. Preencha três campos e digite um ID de modelo manualmente, e o Qoder se conecta ao Claude e ao GPT usando uma única chave — modelos que não aparecem no próprio catálogo do Qoder.

Qoder Settings → Models → + Add → Provider → Custom recebe uma Base URL compatível com OpenAI, uma API Key e IDs de modelo digitados manualmente — assim, o aplicativo independente Qoder para desktop acessa Claude e GPT, nenhum dos quais está em seu próprio catálogo.

Qoder Settings → Models → + Add → Provider → Custom

Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model

Este é o aplicativo independente Qoder, não o Qoder IDE. “Qoder” é uma família de produtos documentados separadamente, e apenas o aplicativo de desktop independente documenta um endpoint arbitrário: a página de modelos personalizados oferece OpenAI Compatible e Anthropic Compatible em Custom, e a nota de versão 0.1.8, de 5 de setembro de 2026, apresentou o recurso como “O BYOK do plano Personal agora aceita URLs base personalizadas para qualquer serviço de modelos compatível com OpenAI ou Anthropic”. A página de modelos personalizados do Qoder IDE lista apenas provedores específicos e não contém a expressão Base URL. Se esse campo não aparece na sua tela, provavelmente você está em outro produto Qoder.

A URL base mantém o sufixo /v1. A página do Qoder diz para “inserir a URL base exata fornecida pelo serviço de modelos” e mostra https://api.example.com/v1 como formato de exemplo — portanto, para um endpoint compatível com OpenAI, o campo espera a raiz /v1, e não a origem sem o caminho. Isso é o oposto do que ocorre com clientes no estilo Anthropic, que esperam https://api.kunavo.com e acrescentam a rota por conta própria.

O Qoder também oferece um provedor personalizado Anthropic Compatible, e o Kunavo também atende a /v1/messages. A documentação publica um exemplo de URL base, mas não informa qual rota cada protocolo acrescenta; portanto, não esclarece se esse tipo espera https://api.kunavo.com ou https://api.kunavo.com/v1. O caminho compatível com OpenAI acima é o que corresponde ao exemplo da própria documentação; se você escolher o tipo Anthropic, espere ter de testar as duas formas. A própria lista de solução de problemas do Qoder começa exatamente por esse ponto: “Se a URL base está completa e se o protocolo de compatibilidade e o tipo de API selecionados correspondem ao endpoint”.

O Kunavo não executou uma sessão dentro do Qoder. Nada aqui é um teste do cliente em tempo de execução: os campos foram transcritos da própria página do Qoder na data indicada abaixo, e o lado do endpoint corresponde à interface publicada do Kunavo. O botão Validate and Add Model do Qoder é a etapa que realmente verifica o par, e essa verificação é feita na sua máquina, não na nossa.

Ainda não tem uma chave? Crie uma conta na Kunavo, gere uma chave (ela começa com sk-kn-) e adicione crédito a partir de $10 — as chamadas são pagas com esse saldo, e chamadas malsucedidas não são cobradas. O painel então abre na configuração de Qoder.

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
Abra Qoder Settings, selecione Models na navegação à esquerda e clique em + Add.
Abra Provider e selecione OpenAI Compatible em Custom — não um dos provedores predefinidos acima. Em seguida, escolha Chat Completions API como tipo de API.
Informe a Base URL, a API Key e pelo menos um Model ID. A documentação do Qoder não menciona a descoberta de uma lista de modelos para este campo, então digite os IDs; clique em Add Model ID para adicionar cada modelo extra no mesmo endpoint.
Clique em Next e defina os recursos que o Qoder não consegue inferir: Display name, Supported Context Windows e um Default Context Window entre esses valores, além das opções Vision e Thinking Mode, quando compatíveis com o modelo.
Clique em Validate and Add Model. A página de seleção de modelos do Qoder diz que, uma vez adicionado, “o modelo fica disponível nos seletores de modelos de tarefas, do Agent e de automação”.

Verificado em a página de modelos personalizados do aplicativo independente Qoder em 21 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Esta é a versão resumida. O guia completo — escolha do modelo, custo de uma sessão real e modos de falha — está em Qoder e Claude Code — qual Qoder, qual endpoint e qual cobrança.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em Qoder.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

ID do modelo	Entrada / saída da Kunavo	Onde se encaixa em Qoder
`claude-sonnet-5`	$1.40 / $7.00	o modelo funcional padrão para os seletores de tarefas e do Agent
`claude-opus-5`	$3.50 / $17.50	grandes refatorações, nas quais um plano incorreto custa mais do que os tokens
`claude-haiku-4-5`	$0.70 / $3.50	execuções de automação de alto volume, nas quais a quantidade é o fator predominante
`gpt-5-6-sol`	$2.00 / $12.00	uma segunda opinião de outra família, com a mesma chave e o mesmo endpoint

A cobrança é por token, usando um saldo pré-pago e sem tarifa mensal — consulte billing. Em contextos repetidos — que representam a maior parte do que um editor ou cliente de chat envia — o cache de prompt altera a conta mais do que a escolha do modelo.

Por que seu Qoder pode não ter um campo de URL base

Três interfaces do Qoder documentam o uso de chave própria, mas apenas uma documenta um endpoint escolhido por você. Esse é o único fator que determina se a configuração acima pode ser usada onde você está; vale a pena conferir antes de mexer em um arquivo de configuração — e a página do CLI diz explicitamente para não fazer isso.

Superfície	Há documentação sobre uma URL base personalizada?	O que diz a página do próprio produto
Qoder (aplicativo independente)	Sim	`OpenAI Compatible` e `Anthropic Compatible` ficam em Custom na lista de provedores, junto com Base URL, API Key e Model IDs digitados manualmente. Esta página.
Qoder IDE	Não	A página de modelos personalizados informa “Aplicável a: usuários dos planos Individuals” e lista provedores: Alibaba Cloud Model Studio, DeepSeek, Z.ai, Kimi, MiniMax e Xiaomi MIMO. A expressão `Base URL` não aparece.
Qoder CLI	Não consta na página de documentação	Há uma aba Custom em `/model` com `Add custom model...`, mas a página não documenta uma URL base e alerta: “Não configure BYOK manualmente em `settings.json`”.

O CLI é a parte que causa confusão, porque as próprias notas de versão e a própria documentação não são consistentes. A nota da versão 1.1.50, de 11 de setembro de 2026, diz: “Usuários da edição Personal agora podem configurar e gerenciar centralmente modelos BYOK com endpoints de URL personalizados na página Custom”. Já a página de modelos personalizados que continua disponível descreve um catálogo: “os provedores, modelos e campos de credenciais disponíveis são determinados pelo catálogo BYOK disponível para a conta atual”. Tanto essas páginas quanto a página do IDE limitam o recurso ao plano Individual. Portanto, quando a aba Custom estiver ausente ou não mostrar um campo de endpoint, verifique o plano da conta e as opções oferecidas pelo catálogo dessa conta — não um arquivo de configuração, cuja edição manual é desaconselhada pela página do CLI e que, de qualquer forma, é regenerado a partir do catálogo.

Perguntas frequentes

Como adiciono um provedor personalizado ao Qoder?

No aplicativo de desktop independente Qoder: abra Qoder Settings, selecione Models na navegação à esquerda, clique em + Add, depois abra Provider e escolha "OpenAI Compatible" ou "Anthropic Compatible" em Custom. Para o tipo OpenAI, escolha também Chat Completions API ou Responses API. Informe a Base URL, a API Key e pelo menos um Model ID; use Add Model ID para adicionar outros modelos no mesmo endpoint. Clique em Next para definir Display name, Supported Context Windows, Default Context Window, Vision e Thinking Mode; depois, clique em Validate and Add Model. O Qoder valida a conexão antes de salvar.

A URL base do Qoder precisa terminar em /v1?

Para um endpoint compatível com OpenAI, sim. A página de modelos personalizados do Qoder instrui você a informar a URL base exata fornecida pelo serviço de modelos e mostra https://api.example.com/v1 como formato de exemplo. Portanto, o campo espera a raiz /v1, e não a origem sem o caminho — para o Kunavo, https://api.kunavo.com/v1. Para o tipo Anthropic Compatible, a página não fornece um exemplo separado nem informa qual rota é acrescentada; portanto, a documentação não esclarece esse caso. Tente primeiro a raiz /v1 e, se a validação falhar, tente a origem sem o caminho.

Por que não há uma aba Custom ou um campo de URL base no meu Qoder?

Porque os três produtos Qoder têm regras diferentes para uso de chave própria. Apenas o aplicativo de desktop independente Qoder documenta uma URL base arbitrária. A página de modelos personalizados do Qoder IDE lista provedores específicos e não menciona uma URL base; a página do Qoder CLI diz que os provedores, modelos e campos de credenciais disponíveis são determinados pelo catálogo BYOK disponível para a conta atual. As páginas do IDE e do CLI também restringem o recurso ao plano Individual. Se o campo estiver ausente, confira qual produto Qoder está aberto e o que o plano e o catálogo da conta permitem — a página do CLI alerta especificamente contra configurar BYOK manualmente em settings.json.

O Qoder pode usar modelos Claude sem uma conta Anthropic?

Sim, por meio de um provedor personalizado — o catálogo integrado do Qoder é outra questão. A página de seleção de modelos lista modelos Qwen, DeepSeek, GLM, Kimi e MiniMax, e não menciona modelos Claude, GPT ou Gemini; portanto, a forma documentada de usar um deles é com sua própria chave. "OpenAI Compatible" é uma opção de protocolo de comunicação, não de fornecedor: o Model ID digitado é resolvido na Base URL configurada. Assim, um ID Claude funciona desde que o endpoint o disponibilize, e as credenciais usadas são as desse endpoint, não as da Anthropic.

Um modelo personalizado no Qoder ainda consome Qoder Credits?

A página de modelos personalizados do Qoder informa que as tarifas de modelos personalizados são cobradas diretamente na conta de API do seu provedor e não consomem Qoder Credits. Ela cita o Repo Wiki como exceção: esse recurso usa um modelo fixo e é cobrado separadamente, com um aviso exibido quando ele é gerado. A cobrança do Kunavo é por token, descontada de um saldo pré-pago, sem mensalidade. Observe também que a operação Edit do Qoder em um modelo personalizado salvo só atualiza a chave de API; para alterar uma URL base, é necessário excluir a entrada e adicioná-la novamente.

O Kunavo testou esta configuração no Qoder?

Não. O Kunavo não executou nenhuma sessão em qualquer interface do Qoder, e esta página não é um relatório de compatibilidade em tempo de execução: os nomes e a ordem dos campos foram transcritos da própria página de modelos personalizados do Qoder na data indicada, e o lado do endpoint corresponde à API publicada do Kunavo. A verificação relevante ocorre na sua máquina: antes de salvar, o botão Validate and Add Model do Qoder testa em conjunto a Base URL, a chave e o Model ID. Um comando curl simples com a mesma URL base e a mesma chave permite determinar se uma falha vem do endpoint ou do cliente.