Como usar o Roo Code com sua chave CodeMax
O Roo Code é uma extensão do VS Code derivada do Cline. 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 Roo Code pelo marketplace do VS Code.
2. Configurar o Roo Code
Nas configurações do Roo, escolha o provedor OpenAI Compatible e preencha. O endereço vai com /v1.
| Sistema | Onde fica |
|---|---|
| Todos | interface da extensão (ou importação de settings) |
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 Roo.
- O Roo também consegue importar um arquivo de configuração na inicialização, pela opção
roo-cline.autoImportSettingsPathdas configurações do VS Code — útil para replicar a mesma config em várias máquinas.
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-roo-code). Nós ainda não executamos o Roo 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 Roo 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 | O Roo espera o caminho completo: https://api.tn1.top/v1. |
| Importar configuração de arquivo | Funciona | Pela chave roo-cline.autoImportSettingsPath do VS Code. |
| Chave fora do disco | Não | A chave fica na configuração da extensão ou no arquivo importado. |
| 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 o /v1 no fim do Base URL. O endereço correto é https://api.tn1.top/v1. |
| Vim do Cline e reaproveitei o endereço | O Cline usa a raiz; o Roo usa /v1. Mesma família, endereços diferentes. |
6. FAQ
Qual a diferença para o Cline?
O Roo nasceu do Cline e seguiu caminho próprio. Para o que importa aqui: o endereço da API leva /v1, o do Cline não.
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 Roo 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: