O acesso ao Codex pelo ChatGPT e pela API
A autenticação do Codex liga o cliente do terminal à credencial que autoriza o uso dos modelos. Você usa o login pelo ChatGPT ou uma chave de API para conectar o agente ao serviço da OpenAI durante o trabalho no seu projeto.
Ficha e sumário da página
- Referência técnica
- Codex CLI 0.169.0
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
O login autoriza o serviço usado pelo agente
O cliente do Codex precisa autenticar as chamadas aos modelos da OpenAI. Para trabalho local, a documentação apresenta o login pelo ChatGPT e o uso de uma chave de API. A escolha conecta a sessão a uma forma de acesso ao serviço. Ela também relaciona o uso às configurações do workspace ou da organização correspondente, conforme o método utilizado.
Os arquivos são lidos e alterados no ambiente onde o cliente executa. O conteúdo consultado pelas ferramentas entra na conversa enviada ao modelo da OpenAI, por isso a execução local também envolve transmissão de código ao serviço. Autenticar a CLI num notebook não copia automaticamente o repositório para uma VPS. O login identifica o acesso ao serviço, enquanto o diretório de trabalho identifica os arquivos usados naquela tarefa.
Credencial
Login ChatGPT ou chave de API.
Codex CLI
O cliente autentica as chamadas ao serviço.
Modelo
A autenticação autoriza os modelos disponíveis.
Projeto
As ferramentas locais trabalham nos arquivos permitidos.
O login ChatGPT no terminal
O login pelo ChatGPT usa um fluxo de autenticação no navegador. Depois da autenticação, o cliente recebe as credenciais necessárias para continuar. A CLI oferece esse caminho pelo comando de login. Você autoriza o acesso ao serviço sem inserir a senha no texto da tarefa enviada ao agente. O cliente conserva a sessão conforme o armazenamento configurado.
A disponibilidade acompanha as condições da assinatura e do workspace. Em ambientes administrados, permissões e configurações podem limitar o acesso ao Codex ou a determinados recursos. Uma sessão autenticada não demonstra, sozinha, que todos os modelos estão liberados. A documentação consultada orienta conferir o acesso disponível no cliente e as configurações da organização.
Numa VPS sem navegador local, a autenticação exige um fluxo adequado ao ambiente remoto. A documentação descreve alternativas para essas situações, incluindo autenticação por dispositivo quando disponível. A janela aberta no seu computador e o processo executado no servidor cumprem papéis diferentes. O retorno da autenticação precisa chegar ao cliente correto para aquela sessão poder usar o serviço.
A chave de API identifica outro acesso
A chave de API é uma credencial criada para acesso programático. No Codex, ela pode autenticar o cliente para o uso associado à organização e ao projeto da API. A documentação distingue esse acesso do login por assinatura. Os valores e as condições comerciais podem mudar, por isso a comparação depende das páginas oficiais vigentes e do painel do serviço utilizado.
Uma chave também pode ser usada por uma aplicação que chama a API da OpenAI. Nesse caso, o seu app faz as requisições ao serviço. No Codex CLI, é o cliente do agente que usa a credencial durante a tarefa. O formato de autenticação pode ser semelhante, mas são processos distintos, com configurações e finalidades próprias. A mensagem de erro de cada processo identifica qual aplicação apresentou a falha de acesso.
O Node OpenAI do n8n usa uma credencial configurada no próprio n8n para realizar suas chamadas. Entrar no Codex pelo ChatGPT não preenche essa credencial da automação. Se um workflow precisa usar a API, o acesso deve estar configurado no serviço que executa o workflow. A conexão entre os produtos passa pela credencial de cada aplicação, sem compartilhar automaticamente a sessão do terminal.
O modelo disponível depende da autenticação
A OpenAI retirou o GPT-5.5 do Codex com login pelo ChatGPT em 14 de outubro de 2026. A retirada preservou o acesso pela API, inclusive em sessões do Codex autenticadas por chave. Esse caso explica por que um identificador pode funcionar num ambiente e falhar em outro. Você confere o método de autenticação e os modelos disponíveis no workspace para distinguir uma restrição do serviço de uma falha na instalação do cliente.
Os nomes documentados na consulta deste portal estão em modelos. Um arquivo de configuração que conserva um identificador retirado pode exigir atualização. A versão da CLI informa qual cliente está instalado, mas não garante a permanência de todos os modelos no serviço. São duas referências que precisam ser acompanhadas separadamente.
Credenciais e permissões locais
As credenciais de autenticação permitem usar o serviço e precisam permanecer fora dos arquivos públicos do projeto. O armazenamento pode usar arquivo local ou o mecanismo de credenciais do sistema, conforme a configuração e a disponibilidade do ambiente. Copiar uma pasta de configuração sem conferir seu conteúdo pode transportar também os tokens que mantêm uma sessão autenticada.
A sandbox continua delimitando os comandos locais depois do login. Uma chave válida não concede escrita numa pasta protegida pelo ambiente, assim como uma permissão de escrita não substitui a autenticação exigida pelo serviço. Você identifica a origem da falha pela ferramenta chamada e pela resposta recebida. Erros de acesso ao modelo e recusas de escrita local exigem conferências diferentes.
O Codex CLI é mantido pela OpenAI sob Apache 2.0, com a versão 0.169.0 como referência deste texto. As condições dos serviços permanecem nas páginas oficiais. Para revisar a integração da API com o seu app durante uma sessão técnica, o Desenvolvimento Colaborativo da Dev Side Studio oferece orientação enquanto você trabalha no código e no terminal.
Continue na comunidade
Leve ao Discord da Promovaweb a alteração que o Codex fez e o teste que ainda falha. O diff e a saída do comando ajudam a comunidade a discutir o comportamento do seu app.
Uma VPS para os seus apps
Depois da revisão e dos testes locais, o app precisa de um ambiente de publicação. A VPS da StayCloud oferece o servidor para hospedar a aplicação que você desenvolve com o Codex.
Link de parceiro da Promovaweb.