Como usar o Cline com sua chave CodeMax
O Cline é uma extensão do VS Code. A configuração é feita pela interface, não por arquivo: são três campos para apontar ele à CodeMax e passar a pagar 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 /v1 — https://api.tn1.top/v1. O Cline acrescenta apenas o /chat/completions. Sem o /v1, a resposta é um erro dizendo que a chave é inválida — mesmo com a chave certa.
1. Pré-requisitos
- Uma chave CodeMax ativa.
- Instale a extensão Cline pelo marketplace do VS Code.
2. Configurar o Cline
Abra o Cline, clique na engrenagem e escolha o provedor OpenAI Compatible. Preencha assim:
| Sistema | Onde fica |
|---|---|
| macOS | ~/.cline/data/settings/providers.json (modo CLI) ou a interface da extensão |
| Linux | ~/.cline/data/settings/providers.json (modo CLI) ou a interface da extensão |
| Windows | %USERPROFILE%\.cline\data\settings\providers.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- Repita os mesmos valores nos dois modos, Plan e Act — o Cline guarda a configuração separada para cada um.
- Feche e reabra o painel do Cline para ele reler a configuração.
- Não há variável de ambiente: o Cline guarda a chave no armazenamento interno da extensão.
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-cline). Em 2 de agosto de 2026 testamos o Cline de verdade contra o gateway: com https://api.tn1.top/v1 a chamada volta 200; sem o /v1, 401. O gerador do OmniRoute afirma que o Cline acrescenta o /v1 sozinho — ele não acrescenta, e esta página indicou o endereço errado por causa disso até então. 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 Cline 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 sem /v1 | Não funciona | O Cline monta apenas /chat/completions; o gateway só autentica caminhos em /v1/. Use https://api.tn1.top/v1. |
| Modos Plan e Act | Depende | Funcionam, mas guardam configuração separada. Configurar só um deixa o outro quebrado. |
| Chave fora do disco | Não | O Cline não aceita referência a variável de ambiente; a chave fica no armazenamento da extensão. |
| Uso pelo terminal | Funciona | Testado no CLI 3.0.48. A configuração fica em ~/.cline/data/settings/providers.json. |
5. Troubleshooting
| Sintoma | O que fazer |
|---|---|
401 dizendo que a chave está ausente ou inválida | Quase sempre é o /v1 faltando no Base URL. Use https://api.tn1.top/v1. A mensagem culpa a chave, mas o problema é o endereço. |
| Funciona no Plan e falha no Act (ou o contrário) | São duas configurações independentes. Preencha os três campos nos dois modos. |
| O modelo não responde depois de trocar | Feche e reabra o painel — o Cline não relê a configuração sozinho. |
6. FAQ
Por que OpenAI Compatible e não Anthropic?
Porque a CodeMax expõe o formato da OpenAI nesse endereço. O modelo pode ser da Anthropic mesmo assim.
Onde fica a minha chave?
No armazenamento interno da extensão, na sua máquina. O Cline não oferece referência a variável de ambiente.
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 Cline 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: