Aider, Cline e Continue com modelos na UE: configuração para Kimi K3, GLM 5.3, DeepSeek e Qwen

O Aider, o Cline e o Continue comunicam com APIs compatíveis com a OpenAI, por isso cada um deles pode usar o Nodion AI Gateway em https://api.nodion.ai/v1 com uma chave de API da Nodion e um ID de modelo como moonshot/kimi-k3. O gateway encaminha apenas para fornecedores sediados na UE, todos com zero data retention, e não precisa de conta nesses fornecedores. Encontra abaixo as definições exatas de cada ferramenta, os limites a introduzir para Kimi K3, GLM 5.3, DeepSeek V4.1 Flash e Qwen3.8 27B e o que verificar quando um pedido falha.

As definições seguem a documentação oficial de cada ferramenta em outubro de 2026: Aider v0.86.0 (a versão mais recente, de agosto de 2025), Cline v4.1.26 e Continue v2.1.0 para VS Code. Se um campo tiver mudado de lugar numa versão mais recente, a referência é a documentação indicada em cada secção.

O que é preciso

• Uma conta Nodion e um projeto. Abra o AI Inference nesse projeto.
• Uma chave de API. Crie uma em AI Inference → Keys; esta usa o saldo pré-pago. Se tiver um AI Coding Plan, crie antes a chave no plano. As chaves começam por nodion_ai_ e só são mostradas uma vez. As chaves da plataforma não funcionam aqui.
• O URL base https://api.nodion.ai/v1.
• Um ID de modelo da tabela abaixo. curl https://api.nodion.ai/v1/models lista todos os modelos de chat e não precisa de chave.

Defina a chave uma única vez na shell, por exemplo em ~/.zshrc:

export NODION_AI_KEY=nodion_ai_your_key

Modelos e limites

Os quatro modelos suportam chamadas de ferramentas (tool calls). No Cline, o contexto e a saída máxima têm de ser introduzidos manualmente; no Aider e no Continue são opcionais. Valores do catálogo da Nodion a 29 de outubro de 2026; a página de cada modelo mostra os valores, os fornecedores e os preços atuais.

Modelo	ID do modelo	Contexto	Saída máxima	Entrada de imagem
Kimi K3	moonshot/kimi-k3	1 048 576	32 768	Sim
GLM 5.3	z-ai/glm-5.3	1 048 576	131 072	Não, só texto
DeepSeek V4.1 Flash	deepseek/deepseek-v4.1-flash	1 048 576	393 216	Sim
Qwen3.8 27B	qwen/qwen3.8-27b	262 144	131 072	Sim

Fonte: catálogo AI Inference, verificado a 29 de outubro de 2026.

Aider

O Aider corre no terminal. A documentação para APIs compatíveis com a OpenAI usa duas variáveis de ambiente e um nome de modelo com o prefixo openai/. Com a Nodion:

export OPENAI_API_BASE=https://api.nodion.ai/v1
export OPENAI_API_KEY=$NODION_AI_KEY
aider --model openai/moonshot/kimi-k3

Para os outros modelos, coloque openai/ antes do ID da Nodion: openai/z-ai/glm-5.3, openai/deepseek/deepseek-v4.1-flash, openai/qwen/qwen3.8-27b. O Aider não tem nenhuma definição que leia a chave de uma variável à sua escolha, daí a atribuição a OPENAI_API_KEY (ou passe --openai-api-key).

OPENAI_API_BASE envia para a Nodion todos os modelos openai/ dessa shell. Se preferir definir o URL base por projeto, coloque-o num .aider.conf.yml no repositório. Mantenha a chave fora desse ficheiro; o lugar dela é na variável de ambiente ou num ficheiro .env:

model: openai/moonshot/kimi-k3
openai-api-base: https://api.nodion.ai/v1

Ao arrancar, o Aider mostra Unknown context window size and costs, using sane defaults. (janela de contexto e custos desconhecidos, por isso usa valores por omissão razoáveis). Segundo a documentação, normalmente pode ignorar esta mensagem: o Aider assume então uma janela de contexto ilimitada e um modelo gratuito e, de qualquer forma, nunca impõe limites de tokens. Para lhe indicar os limites reais, adicione um .aider.model.metadata.json ao seu diretório pessoal, à raiz do repositório ou ao diretório a partir do qual inicia o Aider:

{
  "openai/moonshot/kimi-k3": {
    "max_input_tokens": 1048576,
    "max_output_tokens": 32768,
    "input_cost_per_token": 0,
    "output_cost_per_token": 0,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

A chave é o mesmo nome que passa em --model, e litellm_provider corresponde ao respetivo prefixo openai/. Adicione uma entrada por modelo. Deixe os campos de custo a 0 ou introduza os preços por token indicados na página do modelo.

Fontes: Aider: APIs compatíveis com a OpenAI, definições avançadas de modelos, .aider.conf.yml, versões.

Cline

O Cline configura-se nas definições da extensão do VS Code, não num ficheiro. Abra as definições do Cline (ícone da roda dentada) e defina API Provider como OpenAI Compatible:

• Base URL: https://api.nodion.ai/v1
• API Key: a própria chave da Nodion, ou seja, o valor e não o nome de uma variável.
• Model ID: depois de definir o URL e a chave, o Cline carrega a lista a partir do endpoint /models do gateway. Escolha moonshot/kimi-k3 ou escreva o ID.
• Custom Headers e as opções do Azure ficam vazios.

Depois, abra Model Configuration e preencha manualmente duas coisas para o modelo escolhido:

• Context Window Size e Max Output Tokens, a partir da tabela acima. Para um modelo que não conhece, o Cline assume, por omissão, uma janela de contexto de 128 000 tokens.
• Supports Images: ativado para Kimi K3, DeepSeek V4.1 Flash e Qwen3.8 27B, desativado para GLM 5.3, que só lê texto. O Cline ativa esta opção por omissão para modelos desconhecidos, pelo que, de outro modo, enviaria imagens para um modelo que não as consegue ler.

Quando mudar de modelo, atualize também os limites e a definição de imagens.

Fontes: Cline: OpenAI Compatible, nomes dos campos no código-fonte, valores por omissão para modelos desconhecidos.

Continue

O Continue lê ~/.continue/config.yaml (no Windows, %USERPROFILE%\.continue\config.yaml). A Nodion entra como fornecedor OpenAI com o seu próprio apiBase:

name: Nodion
version: 1.0.0
schema: v1

models:
  - name: Kimi K3 (Nodion)
    provider: openai
    model: moonshot/kimi-k3
    apiBase: https://api.nodion.ai/v1
    apiKey: ${{ secrets.NODION_AI_KEY }}
    capabilities:
      - tool_use
      - image_input
    defaultCompletionOptions:
      contextLength: 1048576
      maxTokens: 32768

  - name: GLM 5.3 (Nodion)
    provider: openai
    model: z-ai/glm-5.3
    apiBase: https://api.nodion.ai/v1
    apiKey: ${{ secrets.NODION_AI_KEY }}
    capabilities:
      - tool_use
    defaultCompletionOptions:
      contextLength: 1048576
      maxTokens: 131072

• O cabeçalho com name, version e schema é obrigatório.
• capabilities: [tool_use] é aquilo de que o modo Agent precisa. O Continue deteta o suporte de ferramentas a partir do nome do modelo, e os IDs da Nodion não estão na sua lista, por isso, sem esta linha, o modo Agent não está disponível. Pode acrescentar capabilities, mas não pode desligar a deteção. Defina image_input apenas para modelos com entrada de imagem, ou seja, não para o GLM 5.3.
• A chave vai para ~/.continue/.env como NODION_AI_KEY=nodion_ai_your_key. As extensões para VS Code e JetBrains não conseguem ler as variáveis de ambiente da sua shell, por isso um export só por si não chega. Nunca faça commit de ficheiros .env.
• roles pode ser omitido: por omissão, são chat, edit, apply e summarize.

Fontes: Continue: OpenAI, referência do config.yaml, capacidades dos modelos, segredos.

Kilo Code

O Kilo Code funciona da mesma forma: em Settings → Providers → Custom provider, escolha OpenAI Compatible com o URL base https://api.nodion.ai/v1; num kilo.json, mantenha o fornecedor na configuração global e defina limit.context, limit.output e tool_call: true para cada modelo, de forma muito semelhante ao guia do OpenCode.

Fonte: Kilo Code: OpenAI Compatible.

Faturação: saldo pré-pago ou coding plan

É a chave configurada na ferramenta que decide quem paga. Uma chave de AI Inference → Keys desconta do saldo pré-pago, por token, ao preço do modelo. Com uma chave de AI Coding Plan (Go, Pro ou Max), a utilização de chat e de ferramentas é contabilizada no plano, contabilizada numa janela de 5 horas, numa semanal e numa mensal. Quando uma janela fica cheia, os pedidos só continuam a partir do saldo pré-pago se o plano o permitir; caso contrário, param até o limite da janela ser reposto. Os planos estão em AI Coding Plans e os preços por modelo na página de cada modelo e no catálogo AI Inference.

Fontes: documentação do AI Inference, AI Coding Plans.

Resolução de problemas

• 401 com missing bearer token ou invalid api key: a chave não está a ser enviada. No Aider, verifique OPENAI_API_KEY na mesma shell; no Continue, verifique ~/.continue/.env. A chave tem de começar por nodion_ai_.
• 404 com model not found: compare o ID com /v1/models, incluindo o prefixo (moonshot/, z-ai/, deepseek/, qwen/). No Aider, vem ainda openai/ à frente.
• 402: o saldo não cobre o pedido (empty_balance) ou foi atingido um limite de gastos (daily_quota, month_quota). Carregue o saldo ou aumente o limite no separador Billing.
• 503: nenhuma rota disponível para o modelo corresponde às definições do projeto, por exemplo depois de ter excluído fornecedores nas definições de IA.
• O Continue indica que o modo Agent não está disponível: adicione capabilities: [tool_use] ao modelo.
• O Cline envia imagens para o GLM 5.3: desative Supports Images para esse modelo.

Fonte: Referência da API de IA: erros e limites.

Outras ferramentas

• Codex CLI através da Responses API: o guia do Codex CLI.
• OpenCode com Kimi K3 e GLM 5.3: o guia do OpenCode.
• O seu próprio código com o SDK da OpenAI: mudar para uma API compatível com a OpenAI.
• O Claude Code e o Cursor não conseguem chamar esta API; mantêm os seus próprios modelos. Podem, no entanto, fazer deploy na Nodion através de MCP.