Como usar o Kilo Code com sua chave CodeMax
O Kilo Code é uma extensão do VS Code, prima do Cline e do Roo. Configura pela interface e aceita a CodeMax como provedor compatível, pagando em reais.
Se você ainda não tem chave, escolha um plano ou peça um teste grátis.
O detalhe que mais gera chamado: o endereço da API termina em https://api.tn1.top/v1. O /v1 no fim não é opcional — sem ele o gateway responde 401 dizendo que a chave está inválida, e você vai procurar o problema no lugar errado.
1. Pré-requisitos
- Uma chave CodeMax ativa.
- Instale a extensão Kilo Code pelo marketplace do VS Code.
2. Configurar o Kilo Code
Nas configurações do Kilo, escolha o provedor OpenAI Compatible e preencha. Atenção ao /v1: diferente do Cline, aqui ele entra.
| Sistema | Onde fica |
|---|---|
| macOS | ~/.local/share/kilo/auth.json (modo CLI) ou a interface da extensão |
| Linux | ~/.local/share/kilo/auth.json (modo CLI) ou a interface da extensão |
| Windows | %LOCALAPPDATA%\kilo\auth.json (modo CLI) ou a interface da extensão |
Provider: OpenAI Compatible
Base URL: https://api.tn1.top/v1
API Key: <sua chave CodeMax>
Model ID: Opus 4.8- Salve e reabra o painel do Kilo.
- Se você usa o Kilo pelo terminal, a configuração equivalente fica em
~/.local/share/kilo/auth.json.
De onde vem esta configuração. Ela foi extraída do código do OmniRoute, o roteador que a CodeMax usa por baixo (comando omniroute setup-kilo-code). Nós ainda não executamos o Kilo Code contra o gateway para conferir de ponta a ponta. Se algo divergir, escreva para suporte@tn1.top: corrigimos e creditamos o aviso.
3. Modelos disponíveis
O CodeMax é feito para rodar Opus 4.8 sem contar tokens. Sonnet e Haiku ficam disponíveis para quando a tarefa não pedir o modelo maior.
No Kilo Code o modelo é informado por Model ID (OpenAI Compatible).
| Modelo | Como escrever |
|---|---|
Opus 4.8 | Opus 4.8 |
Sonnet | Sonnet |
Haiku | Haiku |
4. O que funciona
| Recurso | Status | Observação |
|---|---|---|
Endereço com /v1 | Funciona | Ao contrário do Cline, o Kilo espera o caminho completo: https://api.tn1.top/v1. |
| Extensão e terminal | Depende | São duas superfícies com configuração própria; ajustar uma não ajusta a outra. |
| Chave fora do disco | Não | A chave fica gravada na configuração da extensão. |
| Comportamento do agente | Não testamos | Não abrimos a extensão para verificar. |
5. Troubleshooting
| Sintoma | O que fazer |
|---|---|
401 dizendo que a chave está ausente ou inválida | Confira se o Base URL termina em /v1. É o erro mais comum aqui, e a mensagem culpa a chave. |
| Vim do Cline e copiei o mesmo endereço | Não dá: o Cline usa a raiz e o Kilo usa /v1. Este é o detalhe que mais confunde quem migra. |
6. FAQ
Kilo, Cline e Roo são a mesma coisa?
São parentes, com a mesma origem, mas cada um evoluiu por conta. O endereço da API, por exemplo, diverge entre eles.
Dúvida que não está aqui? Fale com a gente em suporte@tn1.top.
7. Em sessão longa
O CodeMax existe para a sessão que não acaba em dez minutos. O Kilo Code dispara várias chamadas por tarefa, e é aí que o teto de uso costuma aparecer.
Por isso o padrão aqui é o Opus 4.8: não há motivo para trocar por um modelo menor no meio da tarefa só para economizar chamada. Se a sessão passar de uma hora, o que costuma atrapalhar não é o teto, é o contexto acumulado — recomece a conversa quando o assunto mudar, em vez de arrastar o histórico inteiro.
Outras ferramentas de uso contínuo, na mesma chave: