detachbox
PáginasAlterne assinaturas e chaves

Alterne assinaturas e chaves

Conecte duas assinaturas do Claude, ou duas do Codex, ligue a alternância na inicialização, e um limite às 2 da manhã não encerra mais a noite: o agente passa para a próxima assinatura com folga e continua na mesma conversa. Você acorda com o trabalho pronto. As chaves de API de um provedor alternam do mesmo jeito.

A inicialização padrão de api: Claude Code numa de três assinaturas do Claude, com uma chave do DeepSeek e uma do Z.ai também à escolha, um modelo opcional e a alternância entre as assinaturas do Claude quando os limites se esgotam.

Ligue a alternância

A alternância pertence a uma inicialização e vale para todos os terminais dela. Ligue em qualquer um dos dois lugares:

  • Na inicialização: abra o projeto em Projetos, escolha Editar na inicialização padrão ou no menu ⋯ de uma salva, marque Alternar as assinaturas à medida que se esgotam e escolha Salvar.
  • Num terminal rodando: clique na conta na barra acima do terminal e depois em Alternância de assinaturas…. A janela edita a inicialização e diz quantos terminais dela seguem a mudança. Escolha Salvar alternância: os terminais em execução seguem na hora, sem reiniciar.

A inicialização começa na conta escolhida em Roda em, ou na sua padrão se você deixou Sempre a minha padrão. Uma inicialização numa chave oferece Alternar as chaves à medida que se esgotam e Alternância de chaves… no lugar. Um grupo reúne assinaturas ou chaves, nunca as duas coisas.

Escolha o grupo

  • Todas as minhas assinaturas Claude, Todas as minhas assinaturas Codex ou todas as suas chaves daquele provedor. Contas que você conectar depois entram na alternância no fim da lista.
  • As que eu escolher: marque as contas que alternam. A conta em uso sempre fica no grupo, com pelo menos uma outra ao lado.

Escolha a ordem

Para assinaturas, defina como escolher a próxima conta:

  • Minha ordem: as contas são numeradas; mova uma com as setas para cima e para baixo. O agente vai para a próxima conta depois da atual que ainda tenha limite acima do limiar de troca. Depois da última vem a primeira.
  • Auto: primeiro a que renova antes: a assinatura cujo limite semanal renova mais cedo é usada primeiro, porque o que sobra nela se perde na renovação. O Claude Code passa para ela antes, mesmo com folga onde está; os outros agentes passam quando a deles se esgota.

As chaves passam para a próxima chave do provedor quando uma bate no limite ou fica sem saldo.

Defina o limiar de troca

Em Limiar de troca: passar para outra quando restar, defina % do limite de 5 horas e % da semana, de 0 a 95. Os limiares começam em 2% e 1%, então o agente troca pouco antes que um limite o corte no meio de um passo.

  • 0 troca só quando o limite acaba.
  • Quando nenhuma outra assinatura tem limite acima do limiar dela, o agente fica onde está até o limite e depois passa para a próxima com alguma folga.
  • Uma margem definida em Assinaturas e chaves continua valendo, e conta a maior das duas. Enquanto a margem estiver suspensa até a renovação, só conta o limiar de troca.

Quando o agente troca

A inicialização passa para outra conta quando aquela em que ela roda:

  • bate no limite num terminal
  • chega a 100% de uma janela, ou uma chave fica sem saldo
  • chega ao limiar de troca
  • chega à margem que você definiu
  • perde o login
  • é desconectada

Em Auto: primeiro a que renova antes, uma inicialização do Claude Code também passa antes para uma assinatura que renova pelo menos uma hora mais cedo e tem folga acima do limiar.

Enquanto o seu Compute roda, o servidor confere cada inicialização com alternância a cada 2 minutos, e logo depois que você muda a alternância dela. Ligue a alternância numa inicialização cuja conta já se esgotou, e ela troca na hora.

Para onde o agente vai

O agente pula contas esgotadas, paradas na margem, com login perdido ou ainda sem limites lidos. A inicialização então fica na conta nova até ela chegar ao limiar ou se esgotar também. A sua padrão continua sendo a sua padrão, e uma renovação na conta antiga não puxa a inicialização de volta, então ela nunca fica indo e voltando entre duas contas.

O que acontece com os terminais

O detachbox entrega o login novo aos agentes daquela inicialização e continua os terminais parados dela. Os terminais de outras inicializações e os shells ficam como estão. O Claude Code pega o login novo sozinho e recebe "continue". O Codex reinicia com codex resume --last e depois recebe "continue".

Quando o grupo inteiro se esgota

A inicialização espera. Com Continuar quando o limite renovar ligado, ela passa para a primeira conta que renovar e continua os terminais lá, e o trabalho da noite segue.

Veja para onde ele foi

  • A linha da inicialização na página do projeto mostra a conta em que ela roda agora e diz alterna assinaturas.
  • Os terminais dela trazem a mesma conta e uma marca de alternância na lista Terminais.
  • Atividade registra cada troca com o motivo: o limite, a sua margem, o limiar de troca, um login perdido, uma conta desconectada ou uma renovação mais próxima.

O que a alternância exige

RecursoExige
AlternânciaUma inicialização numa assinatura ou chave conectada no painel, e uma segunda conta do mesmo provedor e do mesmo tipo
Limiar de troca e ordemAssinaturas; as chaves passam para a próxima chave no limite delas

Uma inicialização cujo agente faz login no próprio terminal não tem conta conectada para acompanhar, então o formulário dela não tem alternância. Conecte mais contas como mostra Assinaturas.