Theia IDE

Uma entrada em ai-features.openAiCustom.customOpenAiModels — model, url e apiKey — coloca a Kunavo por trás do Theia Coder, do Architect e da conclusão inline.

{
  "ai-features.openAiCustom.customOpenAiModels": [
    {
      "model": "claude-sonnet-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-sonnet-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    },
    {
      "model": "claude-haiku-4-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-haiku-4-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    }
  ]
}

Passo a passo

1. Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
2. Ative o recurso: a documentação do Theia orienta acessar Preferences e habilitar a configuração “AI-features => AI Enable”. Nada do que vem abaixo aparecerá até que isso seja feito.
3. Abra a visualização AI Configuration — Alt+A, ou selecione AI Configuration no menu Manage (ícone de engrenagem) no canto inferior esquerdo, logo abaixo de Settings. As categorias são General, Providers & Models, Model Aliases, Agents, Prompts & Skills, Variables, Tools, Token Usage e MCP Servers.
4. Adicione as entradas acima. A documentação descreve isso como clicar no link na seção de configurações de OpenAI Compatible Models — a preferência é uma lista estruturada, e o Theia observa que configurações estruturadas sem um editor dedicado “recorrem a settings.json”, que é o arquivo aberto. Um objeto por ID de modelo; url e apiKey se repetem.
5. Aponte algo para ele. Em Agents, cada agente tem um seletor de Language Model; muitos agentes resolvem um alias de modelo, então configurar default/code, default/universal, default/code-completion, default/summarize e default/fast em Model Aliases redireciona vários agentes de uma só vez.
6. Envie uma mensagem de chat ao Theia Coder e, em seguida, peça algo que envolva um arquivo. Os agentes deste IDE dependem de chamadas de ferramentas e do conteúdo do espaço de trabalho, então uma primeira execução que leia ou edite algo informa mais do que uma saudação — e Token Usage, na mesma visualização, mostra quantos tokens a interação custou.

Verificado em a página de recursos de IA do IDE Theia, seção OpenAI Compatible Models 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.

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 Theia IDE.

# 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.

O que o Theia afirma sobre este provedor

A tabela LLM Providers Overview na página do próprio Theia avalia cada provedor em três eixos. Esta é a afirmação do Theia sobre o Theia, copiada dessa tabela na data acima — não é um resultado de teste da Kunavo, e a coluna intitulada “What that needs from the model id” é a única parte desta tabela redigida aqui.

Dois parágrafos acima da tabela, o Theia acrescenta uma ressalva própria que vale repetir, pois é o enquadramento honesto para toda esta página: nem todos os modelos “podem funcionar imediatamente, pois talvez exijam personalizações ou otimizações específicas”.

O que realmente custa dinheiro

O IDE Theia é de código aberto e gratuito para baixar, e seus recursos de IA não têm custo próprio — o que custa são as chamadas ao modelo, cobradas por quem detém a chave em apiKey. Duas configurações afetam essa conta mais do que a escolha do modelo, e ambas estão na documentação:

1. Automatic Code Completion está ativado por padrão, e a documentação descreve que ele faz “solicitações contínuas ao LLM subjacente enquanto você programa”. É o agente que é executado milhares de vezes por dia. Direcione default/code-completion para um ID barato ou mude o agente para o modo manual em 'AIFeatures'=>'CodeCompletion' e acione-o com Ctrl+Alt+Space.
2. Max Context Lines, no mesmo grupo de configurações, limita a quantidade de conteúdo ao redor do arquivo incluída em cada solicitação de conclusão. Cada linha é cobrada como entrada em cada chamada acionada por uma tecla.

Os agentes de chat funcionam de forma oposta: menos chamadas, contexto muito maior e os mesmos arquivos do espaço de trabalho reenviados a cada interação. É para isso que serve o cache de prompts — consulte /docs/caching — e por isso as duas partes da tabela de modelos acima se dividem pela frequência de execução do agente, e não por sua inteligência.

Quando não conecta

1. 404 — o url. A Kunavo atende em /v1/chat/completions, então o campo precisa conter a raiz /v1; informar apenas a origem ou o endereço completo .../chat/completions não funciona.
2. 401 — a chave. O Readme do Theia diz que o apiKey “será enviado como Bearer Token na solicitação de autorização”, exatamente o que uma chave sk-kn- espera. Observe o padrão documentado: se não houver nenhum apiKey, o Theia envia no-key, então um campo ausente parece uma chave rejeitada, e não ausente. (true significa “usar a chave global da API OpenAI” — não é o que você quer aqui.)
3. O ID do modelo não aparece no seletor — essa lista vem das suas próprias entradas customOpenAiModels, não do endpoint; portanto, se um ID não aparece, falta um objeto. O campo id é o que a interface mostra; se você o omitir, será usado o nome do modelo.
4. A primeira mensagem do sistema é rejeitada ou ignorada — isso é developerMessageSettings. O padrão é developer, que é uma função no formato OpenAI; o próprio exemplo do Theia para um fornecedor que não seja a OpenAI define system, por isso o bloco acima faz o mesmo. user, mergeWithFollowingUserMessage e skip são as alternativas documentadas.
5. Nada responde em lugar algum — verifique a Confiança no Espaço de Trabalho. O Theia exige isso para todos os recursos de IA, e um espaço de trabalho não confiável desativa a entrada de chat e a conclusão em linha, além de exibir a mensagem AI Features are Restricted.