Codex Auth: ferramenta de linha de comando que fornece comutação de várias contas e monitoramento de limites

O Codex Auth é uma ferramenta de aprimoramento de linha de comando (CLI) de terceiros desenvolvida para os usuários do OpenAI Codex, com o objetivo principal de solucionar os incômodos problemas de gerenciamento de várias contas e de limitação de solicitações que os desenvolvedores enfrentam ao usar assistentes de programação de IA. O OpenAI Codex, como um poderoso parceiro de programação Agentic, tem limitações de sistema nativo em termos de vários ambientes para autenticação e exibição do status da cota. O Codex Auth preenche essa lacuna, permitindo que os usuários gerenciem de forma centralizada e alternem perfeitamente entre várias credenciais no dispositivo local.

Projetada tendo em mente a “orientação para resultados” e a “automação”, a ferramenta não é apenas uma chave de alternância, mas também um centro de programação visual. Por meio da intuitiva Interface Interativa de Terminal (TUI), os desenvolvedores podem entender em tempo real a taxa de consumo do tipo de pacote de cada conta (por exemplo, Pro, Team, Pro Lite), o uso de alta frequência de 5 horas e o uso total semanal. Além disso, a ferramenta oferece o inovador recurso “Auto-switch”: quando uma conta ativa atinge um limite de uso personalizado, ela é automaticamente alternada para uma conta em espera em segundo plano, garantindo que o fluxo mental da programação de IA não seja interrompido. O Codex Auth é totalmente compatível com Windows, macOS e Linux e funciona perfeitamente com o Codex CLI, aplicativos de desktop e plug-ins do VS Code, tornando-o uma infraestrutura de desempenho indispensável para equipes corporativas e desenvolvedores de IA pesados.

Lista de funções

• Troca interativa de várias contasInterface interativa de terminal (TUI) integrada que permite a troca rápida e contínua de credenciais entre várias contas do Codex por meio de teclas para cima e para baixo, números de linha ou aliases personalizados.
• Uso em tempo real e monitoramento de pacotesEle suporta a exibição em tempo real do plano de assinatura em que uma conta está, bem como a taxa de chamadas de 5 horas da conta atual e o status de uso semanal, capturando registros de segurança locais ou chamando diretamente a API subjacente.
• Comutação automática em segundo planoO sistema monitora automaticamente e alterna sem problemas para a próxima conta disponível em segundo plano para evitar interrupções acionadas pelo mecanismo oficial de limitação de tráfego, permitindo que o usuário personalize o limite da cota de chamadas (por exemplo, definir a taxa de uso para atingir 80% por 5 horas).
• Integração flexível de autenticação de loginIntegração profunda da lógica de login subjacente, suporte para invocar a autorização padrão da Web (Web Auth) e a autorização de código de dispositivo de servidor remoto sem cabeça (Device Auth), arquivada automaticamente no repositório de gerenciamento após a entrada.
• Importação em lote e manutenção de limpezaSuporte à importação inteligente em lote (Import) de diretórios de arquivo único e de vários arquivos, sincronização rápida de arquivos forenses compartilhados pela equipe e limpeza interativa de arquivos redundantes e expirados.
• Compatível com vários clientes e plataformasOs status de autenticação gerados são fornecidos diretamente à CLI do Codex (@openai/codex), ao plug-in VS Code e ao cliente do aplicativo Codex, e são totalmente compatíveis com as arquiteturas Windows, macOS e Linux.

Usando a Ajuda

Bem-vindo ao Codex Auth! Para garantir que você possa maximizar sem problemas o valor dessa ferramenta em seu fluxo de trabalho de desenvolvimento real, leia o guia detalhado de operação e configuração abaixo. O sistema é estritamente modular, e tanto a implementação local básica quanto o agendamento avançado de recursos automatizados podem ser feitos a partir de uma simples linha de comando.

I. Preparação do ambiente operacional e processo de instalação

O Codex Auth é executado no ambiente de tempo de execução do Node.js, e a lógica subjacente precisa ser compatível com o sistema nativo oficial Codex CLI Adequação ao cliente.

Etapa 1: Instale as dependências predecessoras
Certifique-se de ter o Node.js instalado em seu sistema operacional (recomenda-se a versão 22+). Em seguida, é altamente recomendável que você instale primeiro a ferramenta oficial Codex CLI para gerar automaticamente o diretório de ambiente padrão e a configuração de credenciais de dependência.

npm install -g @openai/codex

Etapa 2: Instalar o Codex Auth
É possível instalar a ferramenta globalmente em seu sistema operacional por meio do gerenciador de pacotes npm, para que você possa usá-la diretamente em qualquer pasta de projeto. codex-auth Comando:

npm install -g @loongphy/codex-auth

(Implementação sem instalação: se você usar a função de consulta apenas ocasionalmente, poderá usar o npx diretamente para chamadas na memória:npx @loongphy/codex-auth list）

II Operações básicas: acesso à conta e consulta

1. adicione e faça login em contas
Antes de poder gerenciar várias credenciais de identidade no sistema, você precisa inseri-las. Basta inseri-las no terminal:

# 启动标准图形化登录流程
codex-auth login

O sistema abrirá automaticamente seu navegador e o guiará pelo ChatGPT Login da conta. Se estiver operando em uma máquina virtual baseada em nuvem que não tenha uma interface gráfica, como o Ubuntu Server, use o modo de login de código de dispositivo:

codex-auth login --device-auth

Nesse momento, o terminal gerará uma cadeia de códigos de verificação. Você pode inserir o código no navegador do computador local para concluir a autorização, e as credenciais serão sincronizadas automaticamente com o hub do servidor.

2. acesso ao status global da conta (painel principal)
aprovar (um projeto de lei ou inspeção etc.) list para ver rapidamente o status de sobrevivência e a pressão de carga de todas as contas hospedadas. Essa é a verificação mais comumente usada durante o desenvolvimento:

codex-auth list

Na bela tabela de dados, você verá que cada número de conta corresponde ao ACCOUNT(conta de e-mail),PLAN(por exemplo, pacotes Team ou Pro Lite),5H USAGE(porcentagem de consumo da cota dinâmica de 5 horas) e WEEKLY USAGE(Porcentagem do total de chamadas semanais). Seguido por --live pode forçar o acionamento de uma solicitação de dosagem em tempo real:

codex-auth list --live

III Programação avançada: comutação de ambiente e limitação automatizada de anti-corrente

A principal reivindicação do gerenciamento de várias contas é lidar com cenários em que uma única conta fica sem poder aritmético durante uma reconfiguração extensa.

1. comutação interativa versus direcional
Quando sua conta ativa (com * (Logo) Quando o alarme de cota for exibido, digite o seguinte comando para ativar o seletor TUI:

codex-auth switch

A interface listará todas as contas atuais da biblioteca em uma lista destacada. Use as setas para cima e para baixo do teclado para selecionar uma conta válida e digite-a. As credenciais serão substituídas imediatamente.
Se você estiver familiarizado com o número da lista da conta ou com um alias definido, poderá ignorar a tela interativa para realizar uma troca a quente:

codex-auth switch 02
codex-auth switch work-account

[Notas-chave].Após a conclusão da troca, o plug-in nativo do VS Code e o aplicativo de desktop precisam serReinicie o clienteSó então o arquivo de autenticação poderá ser lido novamente. Se você quiser uma alternância contínua e sem reinicialização para edição de código, é altamente recomendável desinstalar a CLI nativa e usar uma versão modificada das dependências principais:

npm uninstall -g @openai/codex
npm install -g @loongphy/codext

2) Ativação do mecanismo de proteção do Auto-switch
Não deixe que a troca manual interrompa seu fluxo mental de codificação. Você pode configurar o Codex Auth para atuar como um serviço residente em segundo plano que muda automaticamente para a próxima conta saudável quando monitora que a cota atingiu a linha vermelha.
Em primeiro lugar, ative o modo automático:

codex-auth config auto enable

Em seguida, defina o limite de fusão. Por exemplo, exigimos que a ferramenta execute automaticamente a rotação de contas quando o limite de 5 horas for consumido até 80% ou o limite semanal atingir 95%:

codex-auth config auto --5h 80 --weekly 95

Isso é particularmente adequado para pipelines de teste automatizados e scripts de compilação noturnos para garantir que o AI Agent tenha um suprimento constante de poder aritmético.

IV. manutenção de ativos: importação e atualização de comprovantes de contas

1. apresentação dos ativos da empresa e da equipe
Os líderes da equipe de TI ou de P&D da empresa geralmente emitem arquivos JSON forenses de maneira uniforme. Use o comando a seguir para fazer a fusão perfeita em um pool de gerenciamento existente:

# 导入单独的鉴权文件，并指派别名为 team-alpha
codex-auth import /path/to/auth.json --alias team-alpha
# 批量扫描并导入某个目录下的所有合规配置
codex-auth import /path/to/auth_folder/

2. gerenciamento de fontes de dados para o mecanismo de atualização
Para obter os benefícios mencionados acima 5H USAGE Para ser preciso, o Codex Auth pesquisa HTTPS por padrão usando uma conexão direta com a API (que consome alguns recursos de rede). Se você estiver enfrentando restrições de rede ou se preferir ser conservador e ler apenas os logs de solicitação locais, poderá desativar a pesquisa de API:

# 开启（默认推荐，数据最精确）
codex-auth config api enable
# 关闭（改为读取 ~/.codex/sessions 本地日志，会有少许延迟）
codex-auth config api disable

Por fim, você sempre pode usar o codex-auth status para verificar a configuração e a sobrevivência de todos os daemons em segundo plano.

cenário do aplicativo

1. Grande número de desenvolvedores de pilha completa
   Ao usar o OpenAI Codex para executar tarefas de agente altamente simultâneas, como refatoração de código de biblioteca inteira, derivação de tipo estático de arquivo completo etc., é muito fácil para os desenvolvedores esgotarem o limite de solicitação de 5 horas da conta atual. Ao configurar o codex-auth config auto Com o mecanismo de rotação automática, os desenvolvedores podem agrupar de 3 a 5 contas de assinatura em um único pool aritmético, garantindo que o processo de geração de código não precise ser pausado para aguardar a retomada da limitação de fluxo.
2. Alocação compartilhada de recursos aritméticos básicos para equipes de desenvolvimento
   A equipe do projeto adquiriu várias contas do ChatGPT Team e as compartilhou com programadores juniores para realizar operações de rotina, como revisões de código. O administrador distribui o arquivo de autorização para os membros da equipe, que usam o arquivo codex-auth import Executar uma importação em lote e passar o list A visualização observa a carga de cada conta em tempo real, evitando manualmente contas congestionadas e melhorando consideravelmente a utilização de recursos dentro da equipe.
3. Acompanhamento automatizado de scripts para servidores remotos sem cabeça
   Em pipelines de CI/CD ou sandboxes de nuvem (como instâncias do Codex implantadas pela NVIDIA para execução em segundo plano), é extremamente difícil para os desenvolvedores lidar com a expiração da sessão confiando no cliente nativo, pois eles não podem operar a GUI do sistema. Usando o codex-auth login --device-auth Completar a vinculação de autenticação em ambientes nativos da nuvem, usando a linha de comando para permitir a troca rápida de identidade entre várias versões de ambientes de teste, garantindo que a integração contínua não seja interrompida devido a falhas de autenticação.

QA

1. Por que meus limites de uso estão atrasados ou não estão sendo atualizados no terminal?
   Isso geralmente ocorre porque o modo de atualização de dados está definido para ler somente os registros locais (Local-only). O Native Codex é frequentemente encontrado nos feeds de registro de novas versões rate_limits: nullresultando em dados de arquivos locais que podem estar várias horas atrasados em relação ao que realmente aconteceu. Você pode executar o codex-auth config api enable Alterne para o modo de busca ao vivo da API para contornar esse problema.
2. Como posso ter certeza de que a ativação da busca de API em tempo real não resultará em um bloqueio?
   Ativar o modo API significa que a ferramenta extrairá diretamente seu token de acesso e enviará uma solicitação de consulta de status para o ponto de extremidade de back-end oficial. Essa ação é lida simulando a interface oficial e, embora satisfaça a lógica do uso normal, pode violar as regras de controle de vento se for acessada simultaneamente em uma frequência extremamente alta devido à modificação humana. Intensidade normal da consulta dentro do escopo de conformidade, a ferramenta em si não suporta o risco de controle de vento de força maior, o usuário precisa ser razoável no uso.
3. Após a conclusão da transição, por que o aplicativo Codex ou o código VS ainda informa crédito insuficiente?
   O Native Codex e suas extensões oficiais foram projetados para ler o arquivo forense uma vez na inicialização do aplicativo e residir na memória. Como resultado, ao usar o codex-auth switch Depois de alterar com êxito a configuração subjacente, é necessário reiniciar o IDE (VS Code) ou o aplicativo de desktop para que ele recarregue o arquivo de configuração. Se você quiser dispensar a reinicialização, desinstale as bibliotecas nativas e instale a versão personalizada da biblioteca @loongphy/codext。
4. Suporte para a eliminação de informações de vouchers expirados ou inválidos?
   Suporte. Execução em um terminal codex-auth remove Será exibido um menu gráfico de seleção múltipla, no qual você poderá marcar e limpar os perfis de conta que foram invalidados ou banidos para manter o ambiente do sistema limpo. Como alternativa, você pode usar o botão codex-auth remove <别名> Exclusão direcional.