Chaves de desenvolvedor

Quem pode criar uma chave

Uma chave de desenvolvedor pertence à sua conta ToRun. Para criar uma, sua conta precisa de:

• um endereço de e-mail confirmado,
• um plano pago ou saldo comprado, porque a cota gratuita nunca paga chamadas de API.

Criar uma chave

1. Abra a página Desenvolvedores da sua conta ToRun.
2. Clique em Criar chave e preencha o formulário:
   • Nome: algo que mostre onde a chave é usada, como "opencode no meu notebook".
   • Limite de gastos mensal (Runs): o máximo que esta chave pode gastar em um mês.
   • Perguntar antes de uma geração acima de (Runs): uma geração que custaria mais do que isso pergunta a você primeiro.
   • Quando a cota do meu plano acabar, deixar esta chave gastar da minha carteira: deixe desativado se a chave deve usar só a cota do seu plano.
3. Passe pela verificação de segurança e crie a chave.
4. Copie a chave. Ela é exibida só uma vez.

Mantenha a chave fora dos seus arquivos

Salve a chave em uma variável de ambiente chamada TORUN_API_KEY e aponte a configuração da sua ferramenta para a variável, em vez de colar a chave nela.

macOS e Linux, no perfil do seu shell (por exemplo ~/.zshrc ou ~/.bashrc):

export TORUN_API_KEY="trn_live_..."

Windows, no PowerShell (depois abra um novo terminal):

setx TORUN_API_KEY "trn_live_..."

Nunca faça commit de uma chave em um repositório nem a coloque em um arquivo de configuração que você compartilha.

Acompanhe e revogue

A página Desenvolvedores lista suas chaves com quanto cada uma gastou neste mês em relação ao limite, quando foi usada pela última vez e se está ativa. O último uso é atualizado a cada poucos minutos, então uma chave que você não reconhece aparece ali quando é usada.

Revogar interrompe uma chave na hora: uma ferramenta que a usa é recusada na próxima chamada. Se uma chave pode ter vazado, revogue-a e crie uma nova.

Há um limite para quantas chaves ativas uma conta pode ter e quantas chaves ela pode criar em um dia.

Próximos passos

• O servidor MCP do ToRun: o que as ferramentas fazem e como as chamadas são pagas.
• Conecte uma ferramenta: opencode, Claude Code, Cursor.