Resposta curta
O Codex CLI é o agente de programação local no terminal. Ele se concentra em projetos locais, execução de comandos, edição de arquivos e configuração peloconfig.toml.
O Codex App é o aplicativo para desktop. Ele é mais adequado para fluxos gráficos, gerenciamento de sessões, plugins, Remote Control e recursos de aplicativo complementar.
O Codex Web / Cloud funciona como um agente remoto ou baseado no navegador. Ele não usa o mesmo ambiente da CLI local e pode não compartilhar o mesmo acesso a arquivos locais, sandbox, política de aprovação ou arquivo de configuração.
Quando é preciso diferenciá-los
- Você está decidindo entre instalar a CLI ou usar o App / Web
- Você quer manter o login oficial no Codex App e rotear as chamadas de modelo por uma API de terceiros
- Você alterou o
config.tomllocal, mas o comportamento na Web não mudou - Você precisa saber onde ocorrem o acesso a arquivos, a execução de comandos e as aprovações
- Você está escrevendo regras de equipe para o uso do Codex
Principais diferenças
Como escolher
Use o Codex CLI quando seu fluxo principal for editar código localmente e executar comandos no terminal. Use o Codex App quando você precisar de um fluxo no desktop, plugins ou Remote Control. Para manter o login oficial enquanto usa uma API de terceiros, separe a camada de autenticação da camada de solicitações de modelo. Use o Codex Web / Cloud quando o trabalho pertencer a um ambiente remoto ou a um fluxo no navegador. Não presuma que oconfig.toml local controla o ambiente na nuvem.
Erros comuns
- Achar que as mudanças no
config.tomlda CLI local afetam automaticamente o Codex Web / Cloud. - Tratar o login oficial do Codex App e uma API Key de terceiros como a mesma camada.
- Achar que as três opções têm permissões idênticas no sistema de arquivos.
- Esquecer que as configurações de sandbox e aprovação pertencem a um ambiente específico.
- Tratar plugins, Remote Control e configurações do provedor de modelos como uma única camada.
Sobre a BetterToken
A BetterToken pertence à camada de solicitações de modelo: ela define qual provedor de API recebe as chamadas. No Codex CLI, a configuração comum de um provedor personalizado geralmente fica noconfig.toml. No Codex App, quando o login oficial é preservado, a autenticação e o roteamento de inferência precisam ser tratados separadamente.
A BetterToken não altera os limites de execução entre CLI, App e Web / Cloud.
Documentos relacionados
- Guia de configuração do Codex com BetterToken
- Como manter o login oficial do Codex com uma API de terceiros
- Como configurar o config.toml do Codex CLI
- O que são os modos de sandbox e aprovação do Codex CLI?

