Pular para o conteúdo

08 / Guias

Como conectar um agente de programação a um modelo privado

Configure o Claude Code, o Cline, o Aider ou o OpenCode para usar a API do nonex: URL base, chave, nome do modelo e como a sessão por hora funciona com agentes.

08-1Publicado em 26 de set. de 2026

Agentes de programação enviam muito texto. A cada passo, eles reenviam a conversa, as definições das ferramentas e arquivos inteiros. Com cobrança por token, a conta sobe rápido. Em uma sessão cobrada por hora, isso não muda o preço. Os limites são o tamanho do contexto e quantas requisições rodam ao mesmo tempo.

O que você precisa

  1. Uma conta no nonex com algum saldo.
  2. Uma chave de API. Crie uma na página Chaves de API do app. A chave aparece uma única vez, então guarde-a em um lugar seguro.
  3. Uma sessão ativa. Inicie a sessão pelo app ou envie POST /v1/runtime/start com a sua chave. Ao iniciar, a primeira hora é cobrada.

A URL base é https://api.nonex.ai/v1, e o nome do modelo é nonex-1.

Ferramentas que falam OpenAI

Cline, Aider, OpenCode, Continue e a maioria dos outros agentes permitem configurar um provedor compatível com OpenAI. Use:

  • URL base: https://api.nonex.ai/v1
  • Chave de API: a sua chave do nonex
  • Modelo: nonex-1

No Aider, por exemplo:

export OPENAI_API_BASE=https://api.example/v1
export OPENAI_API_KEY=nx_your_key
aider --model openai/nonex-1

Substitua a URL base e o modelo pelos valores acima.

Claude Code

O Claude Code se conecta a endpoints compatíveis com Anthropic. O nonex tem um em /v1/messages:

export ANTHROPIC_BASE_URL=https://api.example
export ANTHROPIC_AUTH_TOKEN=nx_your_key
export ANTHROPIC_MODEL=nonex-1
claude

Em ANTHROPIC_BASE_URL, use a origem da API sem /v1.

Vários agentes ao mesmo tempo

Sem plano, a sua conta pode rodar até 2 requisições ao mesmo tempo, compartilhadas entre a API e o app web. Cada plano tem o seu próprio número, de 2 a 12. Se todas já estiverem rodando, mais uma requisição recebe um erro runtime_busy, então configure a concorrência do seu agente para o número da sua conta ou menos.

De olho no relógio

Cada hora em que a sessão fica ativa é cobrada, então não a deixe ativa: encerre a sessão pelo app ou com POST /v1/runtime/stop quando o agente terminar. Um script que inicia uma sessão também deve encerrá-la.

Experimente o nonex por uma hora