detachbox
PáginasAdicione chaves de API

Adicione chaves de API

Rode o Claude Code, o Codex ou o OpenCode na sua própria chave de API, de qualquer um dos sete provedores, cobrada pelo provedor. Cole a chave uma vez em Assinaturas e chaves, e cada inicialização nela já começa com o endereço e o modelo certos.

Qual agente aceita qual chave

ProvedorClaude CodeCodexOpenCode
AnthropicSimSim
OpenAISimSim
xAISimSim
DeepSeekSimSimSim
Z.aiSimSimSim
abliteration.aiSimSimSim
GeminiSim

Adicione uma chave

  1. Abra Assinaturas e chaves e escolha Adicionar uma chave de API, ou Adicionar chave embaixo de um provedor.
  2. Escolha o Provedor e cole a chave.
  3. Dê um Nome a ela se você tem duas chaves do mesmo provedor, como Trabalho e Pessoal.
  4. Escolha Conferir e salvar.

O detachbox confere a chave com o provedor antes de salvá-la. Uma chave recusada nunca é salva, e a janela avisa. Depois de salva, o painel mostra só os últimos 4 caracteres da chave.

Você também pode adicionar uma chave na hora de iniciar: Adicionar uma chave… na lista Roda em de uma inicialização ou do Novo terminal abre a mesma janela e já escolhe a chave nova.

Rode um agente numa chave

Escolha a chave em Roda em, numa inicialização ou no Novo terminal. O campo Modelo é opcional. Quando está vazio, mostra o modelo que a inicialização vai usar, o que melhor combina com aquele agente e provedor. A combinação fica salva como inicialização do projeto.

A chave fica nas configurações da inicialização, dentro do projeto: o agente que a usa consegue lê-la, e nenhum outro projeto a vê. Troque a chave ou o modelo de uma inicialização salva quando quiser: os terminais que você abrir a partir daí usam a nova escolha, e os que já estão rodando mantêm o que tinham ao começar.

Acompanhe o saldo de uma chave

Nos provedores que informam o saldo, a linha da chave mostra o saldo disponível, com restantes — recarregue logo quando ele fica baixo. O mesmo saldo aparece no menu de conta acima de um terminal e nos chips do cabeçalho. Um provedor que não informa saldo avisa isso na própria linha.

Se o provedor passar a recusar uma chave, a linha dela mostra o erro, e as inicializações que a usam param até você substituí-la.

Renomeie, substitua ou remova uma chave

Abra o menu ⋯ na linha da chave:

  • Tornar padrão: as inicializações em Sempre a minha padrão daquele provedor usam esta chave.
  • Renomear: mude o nome que diferencia duas chaves.
  • Substituir chave: cole a chave nova e escolha Conferir e substituir. As inicializações na chave antiga passam para a nova. A chave antiga continua válida no provedor até você revogá-la lá.
  • Remover chave: as inicializações nela passam para o seu acesso padrão daquele provedor; sem nenhum, param até você escolher outro. A chave continua válida no provedor até você revogá-la lá.

Alterne entre chaves de um mesmo provedor

Com duas ou mais chaves de um provedor, uma inicialização pode passar para a próxima chave quando uma bate no limite ou fica sem saldo. Alternância mostra como ligar isso.