Como usar o Goose com sua chave CodeMax
O Goose é o agente de terminal da Block. Ele fala o formato da OpenAI, então basta apontar o host para a CodeMax, 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. Esta ferramenta monta o resto do caminho sozinha.
1. Pré-requisitos
- Uma chave CodeMax ativa.
- O Goose instalado:
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash
2. Configurar o Goose
O Goose guarda a configuração num YAML. Repare que o host vai sem /v1: ele acrescenta o caminho sozinho.
| Sistema | Onde fica |
|---|---|
| macOS | ~/.config/goose/config.yaml |
| Linux | ~/.config/goose/config.yaml |
| Windows | %USERPROFILE%\.config\goose\config.yaml |
GOOSE_PROVIDER: openai
GOOSE_MODEL: Opus 4.8
OPENAI_HOST: https://api.tn1.top- Exporte a chave:
export OPENAI_API_KEY="sua-chave"(o Goose usa esse nome). - Rode
goose sessionna pasta do projeto. - As mesmas três chaves funcionam como variáveis de ambiente, se preferir não gravar o arquivo.
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-goose). Nós ainda não executamos o Goose 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 Goose o modelo é informado por GOOSE_MODEL.
| Modelo | Como escrever |
|---|---|
Opus 4.8 | Opus 4.8 |
Sonnet | Sonnet |
Haiku | Haiku |
4. O que funciona
| Recurso | Status | Observação |
|---|---|---|
| Sessões de agente no terminal | Não testamos | É o modo principal do Goose; não executamos aqui. |
Host sem /v1 | Funciona | O Goose acrescenta /v1/chat/completions. Use https://api.tn1.top. |
| Extensões e MCP | Não testamos | Independem do provedor, mas não verificamos com a CodeMax. |
| Chave fora do disco | Funciona | Fica em OPENAI_API_KEY; o YAML guarda só provedor, modelo e host. |
5. Troubleshooting
| Sintoma | O que fazer |
|---|---|
404 ao chamar o modelo | O OPENAI_HOST está com /v1 no fim. Esta ferramenta quer a raiz: https://api.tn1.top. |
401 dizendo que a chave está ausente ou inválida | O Goose lê OPENAI_API_KEY, não CODEMAX_API_KEY. Confira com echo $OPENAI_API_KEY. |
| O Goose insiste em outro provedor | GOOSE_PROVIDER tem que ser openai. Variável de ambiente vence o arquivo. |
6. FAQ
Preciso de conta na OpenAI?
Não. openai aqui é o formato da API, não o fornecedor.
Dá para alternar entre modelos?
Sim, mudando GOOSE_MODEL.
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 Goose 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: