Guia rápido

Summary (EN): create a Free key, point Claude Code at the gateway with the connect command (your Anthropic key stays yours), use it normally, read your net savings report, upgrade via Stripe Checkout, rotate keys when needed. The burnless_connect.py client covers the whole cycle: install, check, report, upgrade --plan pro, billing --open, rotate.

1. Criar a chave Free

Na página inicial ou via API:

curl -X POST https://gateway.burnless.dev/api/v1/signup -H 'content-type: application/json' -d '{"email":"voce@exemplo.com"}'

2. Conectar o Claude Code

python3 burnless_connect.py install --url https://gateway.burnless.dev --key bl_live_...

A chave Anthropic continua sendo a sua; o gateway só recebe a chave bl_live_ para identificar o tenant.

3. Usar normalmente

Use o Claude Code como sempre; a compactação acontece no proxy.

4. Ver a economia

curl https://gateway.burnless.dev/api/v1/report?format=text&lang=pt -H 'X-Burnless-Key: bl_live_...'

Também: https://gateway.burnless.dev/api/v1/usage e https://gateway.burnless.dev/api/v1/savings.

5. Fazer upgrade

curl -X POST https://gateway.burnless.dev/api/v1/billing/checkout -H 'X-Burnless-Key: bl_live_...' -H 'Content-Type: application/json' -d '{"plan":"pro","success_url":"https://exemplo.com/ok","cancel_url":"https://exemplo.com/cancel"}'

A resposta traz a URL do Checkout do Stripe. Portal de cobrança:

curl -X POST https://gateway.burnless.dev/api/v1/billing/portal -H 'X-Burnless-Key: bl_live_...'

6. Ciclo completo com o cliente

O burnless_connect.py cobre o ciclo inteiro, sem curl:

1. python3 burnless_connect.py install --url https://gateway.burnless.dev --key bl_live_... — aponta o Claude Code para o gateway.
2. python3 burnless_connect.py check --url https://gateway.burnless.dev — confere a conexão e a chave.
3. python3 burnless_connect.py report --url https://gateway.burnless.dev --lang pt — economia líquida medida do seu tenant.
4. python3 burnless_connect.py upgrade --url https://gateway.burnless.dev --plan pro — abre o Checkout do Stripe: por padrão só imprime a URL; com --open abre no navegador. Enquanto o operador não ligar o Stripe, responde "Pagamento ainda não habilitado" (rc 3).
5. python3 burnless_connect.py billing --url https://gateway.burnless.dev --open — portal de cobrança (cartão, faturas, cancelamento).
6. python3 burnless_connect.py rotate --url https://gateway.burnless.dev — troca a chave (veja a seção abaixo).

7. Rotacionar a chave

Com o kit: burnless_connect rotate --url https://gateway.burnless.dev (grava a chave nova sozinho).

curl -X POST https://gateway.burnless.dev/api/v1/keys/rotate -H 'X-Burnless-Key: bl_live_...'

8. Limites por plano

9. Edge / Enterprise

Instalação single-tenant com licença offline. Fale com o operador pela página inicial.

Versão 2026-11-01 · Início · Guia rápido · Termos · Privacidade