Codex CLI 0.171.0: GPT-6.2 Sol padrão, TUI workspace e exec remoto
O Codex CLI 0.171.0 define GPT-6.2 Sol como modelo padrão do catálogo, ativa por padrão o TUI workspace em painel dividido, adiciona codex exec --remote <ADDR> e /rc e preserva perfis de permissão ao trocar de diretório. Confira os IDs ativos, volte ao GPT-6.2 Astra ou configure provedores de API como a BetterToken, desative o workspace se precisar e verifique os pré-requisitos de execução remota.
Conteúdo

Atualizar para o Codex CLI 0.171.0 (lançado em 20 de novembro de 2026) define gpt-6.2-sol como seleção padrão do catálogo e ativa por padrão o TUI workspace em painel dividido. Isso impacta quem abre o codex sem um model fixado no config.toml, equipes que usam codex exec em scripts e desenvolvedores que conectam o Codex a provedores de API personalizados. Fixe model = "gpt-6.2-astra" no seu config.toml do Codex para manter o Astra, execute codex features disable tui_workspace para voltar ao layout de terminal em painel único ou configure abaixo o acesso ao GPT-6.2 pela API com cobrança por uso.
Rotas para executar GPT-6.2 Sol e Astra no Codex CLI 0.171.0
Antes de alterar configurações, escolha como o Codex faz autenticação e cobrança do uso de GPT-6.2. O método de login determina quais IDs de modelo funcionam e se recursos exclusivos do ChatGPT, como Codex cloud e controle remoto /rc, continuam disponíveis.
| Rota | Conta e autenticação | Unidade de cobrança | Suporte e limites no Codex 0.171.0 | Melhor quando |
|---|---|---|---|---|
Assinatura ChatGPT (codex login) | Conta ChatGPT via login no navegador | Franquia de uso do plano (compartilhada entre mensagens locais e chats na nuvem) | Suporta Codex cloud e controle remoto /rc; o ChatGPT Pro 200 inclui Ultrafast com Sol | Você já tem um plano ChatGPT elegível e quer recursos de nuvem ou controle remoto |
| API direta da OpenAI | Conta na OpenAI Platform + chave de API | Por 1M de tokens (USD) | Usa gpt-6.2-sol e gpt-6.2-astra; sem recursos em nuvem, e o controle remoto /rc fica indisponível com chave de API | Você quer cobrança direta da OpenAI e políticas de dados da sua organização na API |
| Gateway de API BetterToken | Conta BetterToken + chave de API | Saldo pay-as-you-go por unidade do modelo | Lista gpt-6.2-sol e gpt-6.2-astra via OpenAI Responses (https://www.bettertoken.ai/v1); saldo pago não é zerado mensalmente | Você quer acesso API multimodelo pay-as-you-go sem assinatura do ChatGPT |
Configure o Codex CLI 0.171.0 com a BetterToken
A BetterToken é uma camada de acesso a APIs multimodelo com cobrança pay-as-you-go, e não um produto oficial da OpenAI. Em 2026-11-21, a BetterToken lista gpt-6.2-sol e gpt-6.2-astra na sua página de preços atual pelo protocolo OpenAI Responses (https://www.bettertoken.ai/v1). Veja a visão geral da API para Codex para um resumo da compatibilidade com o Codex.
Crie uma conta na BetterToken e gere sua chave de API no console da BetterToken. Usar autenticação por chave de API em arquivo via auth.json substitui o login oficial do ChatGPT; por isso, recursos exclusivos do ChatGPT, como o controle remoto /rc e o Ultrafast do ChatGPT Pro 200, não funcionam nesse modo. Para manter seu login oficial do ChatGPT ativo junto com um provedor de terceiros, siga o guia de preservação de login oficial da BetterToken em vez de editar o auth.json.
Encerre totalmente o Codex CLI e o Codex App antes de editar arquivos, pois os dois clientes compartilham config.toml e auth.json no mesmo diretório do Codex ($CODEX_HOME se definido; caso contrário, ~/.codex no macOS/Linux ou %USERPROFILE%\.codex no Windows; veja Codex CLI vs Codex App vs extensão do VS Code). Faça backup privado de config.toml e auth.json desse diretório ativo e crie config.toml se ele ainda não existir.
No config.toml, atualize no lugar as chaves raiz model_provider, model ou cli_auth_credentials_store que já existam e adicione apenas as que faltam antes de qualquer [tables]. Se [model_providers.bettertoken] já existir, mescle esses campos nessa tabela em vez de duplicar o cabeçalho; caso contrário, adicione a tabela abaixo preservando as demais configurações, conforme o guia de configuração do Codex na BetterToken:
model_provider = "bettertoken"
model = "gpt-6.2-sol"
cli_auth_credentials_store = "file"
[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false
Troque model para "gpt-6.2-astra" sempre que quiser o Astra como padrão. Remova env_key e experimental_bearer_token de [model_providers.bettertoken] ao usar autenticação em arquivo.
Em seguida, grave auth.json nesse mesmo diretório do Codex. No macOS ou Linux com Bash e Python 3, execute o trecho abaixo para informar sua chave sem exibi-la no terminal; o script cancela sem alterar auth.json se a entrada for interrompida ou vazia e cria o novo arquivo com permissão exclusiva do proprietário (0600) antes de gravar a chave. No Windows nativo, siga os passos documentados de autenticação em arquivo no auth.json (auth_mode definido como "apikey" e OPENAI_API_KEY com sua chave) no diretório ativo do Codex ($CODEX_HOME ou %USERPROFILE%\.codex), descritos no guia de configuração do Codex na BetterToken:
CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_DIR"
if IFS= read -rs BETTERTOKEN_API_KEY && [ -n "$BETTERTOKEN_API_KEY" ]; then
export BETTERTOKEN_API_KEY CODEX_DIR
python3 -c 'import json, os, pathlib, tempfile
dir_path = pathlib.Path(os.environ["CODEX_DIR"])
fd, tmp_name = tempfile.mkstemp(prefix=".auth.", dir=dir_path)
try:
os.fchmod(fd, 0o600)
with os.fdopen(fd, "w", encoding="utf-8") as fh:
json.dump({"auth_mode": "apikey", "OPENAI_API_KEY": os.environ["BETTERTOKEN_API_KEY"]}, fh, indent=2)
fh.write("\n")
os.replace(tmp_name, dir_path / "auth.json")
except Exception:
os.unlink(tmp_name)
raise'
unset BETTERTOKEN_API_KEY
else
echo "API key entry cancelled or empty; auth.json was not changed." >&2
fi
Se você tem Node.js instalado e prefere a configuração automática, a documentação do Codex na BetterToken também oferece curl -fsSL "https://www.bettertoken.ai/install-codex-provider.sh" | bash para macOS e Linux, além de um instalador PowerShell (install-codex-provider.ps1) para Windows. Compare o config.toml e o auth.json gerados com as configurações manuais acima antes de iniciar o Codex.
Para validar a configuração, inicie uma nova sessão do codex, rode /status para confirmar as linhas Model (gpt-6.2-sol) e Model provider e envie um prompt curto. Uma resposta normal confirma que a conexão via Responses está ativa.
Se preferir a rota própria da OpenAI, instale ou atualize para a 0.171.0 com npm install -g @openai/codex@0.171.0 (ou parta de uma instalação 0.171.0 existente) e confirme se codex --version exibe 0.171.0. Depois execute codex login para acesso via assinatura do ChatGPT ou autentique com uma chave de API da OpenAI seguindo a referência de autenticação do Codex da OpenAI. Equipes que comparam limites de assinatura com cobrança por API podem consultar o planejamento da franquia compartilhada do ChatGPT e Codex.
Criar uma conta na BetterToken
Verifique o padrão GPT-6.2 Sol e selecione o Astra ou outro modelo
No PR #62106, o Codex CLI 0.171.0 adiciona gpt-6.2-sol e gpt-6.2-astra aos catálogos embutido, Amazon Bedrock e Vertex, e torna gpt-6.2-sol a seleção padrão do catálogo (priority: 1). Também aumenta a janela de contexto do gpt-6.1-sol no catálogo para 500,000 tokens.
No catálogo embutido da 0.171.0 (codex-rs/models-manager/models.json), gpt-6.2-sol lista uma janela de contexto de 500,000 tokens e gpt-6.2-astra lista 272,000 tokens, ambos com default_reasoning_level definido como "low". Na documentação da API da OpenAI em 2026-11-21, tanto GPT-6.2 Sol quanto GPT-6.2 Astra suportam uma janela de contexto de 1,050,000 tokens (922,000 de entrada máxima e 128,000 de saída máxima) e rejeitam o esforço de raciocínio none.
A mudança do seu modelo ativo após a atualização depende da sua configuração e do catálogo ativo (codex-rs/models-manager/src/manager.rs):
- Se
modelnão estiver definido emconfig.toml,get_default_modelescolhe o padrão do catálogo ativo (default_model_from_available). Quando a sessão usa o catálogo embutido da 0.171.0, esse padrão égpt-6.2-sol. - Se
modelestiver definido explicitamente no seuconfig.tomlde usuário (ou no.codex/config.tomlde um projeto confiável), o Codex mantém esse modelo, salvo quando o fallback de seleção de modelo do provedor estiver ativado e o modelo especificado não estiver disponível, caso em que usa o modelo padrão do catálogo ativo.
Inspecione o catálogo embutido no seu binário instalado:
codex debug models --bundled
Em uma sessão TUI interativa, execute /status para conferir a linha Model (e Model provider, quando configurada). Para trocar de modelo sem editar config.toml, rode /model na TUI ou passe --model / -m ao iniciar:
codex -m gpt-6.2-astra
codex exec -m gpt-6.2-astra "Audit the auth middleware for race conditions"
Para tornar gpt-6.2-astra (ou um modelo anterior como gpt-6.1-sol) seu padrão permanente, atualize ou adicione model = "gpt-6.2-astra" na raiz de $CODEX_HOME/config.toml (padrão ~/.codex/config.toml), acima de todas as [tables], e reinicie o Codex.
Em 2026-11-21, os preços públicos Standard da API da OpenAI para tokens de texto em requisições de até 272K tokens de entrada são $2 entrada / $10 saída por 1M de tokens no GPT-6.2 Sol e $8 entrada / $40 saída por 1M de tokens no GPT-6.2 Astra. Em requisições com mais de 272K tokens de entrada em qualquer um dos modelos, as tarifas de entrada e cache dobram e a saída custa 1.5 vezes a tarifa de contexto curto para toda a requisição. Comece com o Sol para programação do dia a dia e mude para o Astra quando uma tarefa com vários arquivos exigir raciocínio mais profundo; consulte GPT-6 Astra vs Sol vs Luna para um guia completo de escolha. O modo Ultrafast da OpenAI com Sol é um recurso da assinatura ChatGPT Pro 200 (e na API da OpenAI o Ultrafast custa 3 vezes a tarifa Standard até 28 de fevereiro de 2027), não uma configuração padrão de gateways personalizados.
Mapeie nomes do catálogo para IDs reais em provedores personalizados
O Codex exibe nomes legíveis como GPT-6.2-Sol e GPT-6.2-Astra no seletor, mas cada provedor espera seu próprio ID de modelo na requisição.
| Provedor | ID do GPT-6.2 Sol | ID do GPT-6.2 Astra | Observações |
|---|---|---|---|
| API da OpenAI (direta) | gpt-6.2-sol | gpt-6.2-astra | Corresponde aos slugs do catálogo embutido do Codex |
BetterToken (https://www.bettertoken.ai/v1) | gpt-6.2-sol | gpt-6.2-astra | Verificado na BetterToken em 2026-11-21 via OpenAI Responses (openai-response), além dos tipos de endpoint openai e anthropic |
| Amazon Bedrock | openai.gpt-6.2-sol | openai.gpt-6.2-astra | A normalização do catálogo também reconhece os IDs inter-regionais do Bedrock Runtime global.openai.gpt-6.2-astra e us.openai.gpt-6.2-astra |
| Google Vertex AI | gpt-6.2-sol | gpt-6.2-astra | Adicionado ao catálogo integrado do GCP no PR #62106 |
Outro model_provider personalizado | Definido pelo provedor | Definido pelo provedor | Fixe o valor exato model = "..." em config.toml |
Quando model é omitido em config.toml, o Codex resolve o padrão pelo catálogo ativo em vez de deduzir a convenção de nomes de um gateway personalizado. Se o seu model_provider personalizado usa IDs com prefixo de fornecedor ou apelidos diferentes dos slugs do catálogo embutido, as requisições podem falhar até você fixar o ID exato model = "..." esperado pelo gateway na raiz de config.toml (nunca dentro de [projects."<path>"], que guarda o trust_level do projeto).
TUI workspace ativado por padrão: o que mudou e como desativar
O PR #61352 promove o recurso tui_workspace para Stable com default_enabled: true. Após atualizar, muda o que abre ao lado da conversa principal no terminal:
- Prévias de documentos (PR #61888, PR #61889): abrir links de arquivos na transcrição renderiza abas Markdown somente leitura na barra lateral, com busca, seleção por teclado ou mouse e cópia de Markdown offline. Use
TabouShift+Tabpara alternar entre links e pressioneEnterpara abrir o link selecionado. - Prévias de imagens (PR #61919): links PNG, JPEG, GIF e WebP abrem como prévias de imagem na barra lateral com rótulos de formato e dimensões; quando o terminal não suporta gráficos, exibe uma prévia em texto. Imagens geradas concluídas e salvas aparecem após a resposta do assistente com o rótulo clicável
Generated image. - Transcrições de subagentes (PR #62157): selecionar um subagente na barra lateral abre uma aba de leitura somente visualização ao lado da conversa principal, em vez de substituir o chat ativo.
Como fechar uma visualização da barra lateral depende do item em foco:
- Em uma prévia de documento, pressione
Escpara fechar a prévia. - Em um leitor de transcrição de subagente, pressione
Escpara voltar à lista de subagentes com o mesmo agente selecionado, ou use o botão ou atalho de fechamento da barra lateral para fechar a aba.
Para desativar o TUI workspace em uma única sessão, inicie o Codex com --disable:
codex --disable tui_workspace
Para desativar tui_workspace permanentemente em $CODEX_HOME/config.toml, execute:
codex features disable tui_workspace
Ou defina a flag manualmente em $CODEX_HOME/config.toml:
[features]
tui_workspace = false
Inicie uma nova sessão do codex para confirmar que a barra lateral do workspace permanece desativada. Desativar tui_workspace desliga a barra lateral e suas abas de prévia em conjunto.
Execução remota com codex exec --remote vs /rc e /remote na TUI
O Codex CLI 0.171.0 adiciona dois recursos remotos distintos:
codex exec --remote <ADDR>executa um turno não interativo em umcodex app-serverque já esteja em execução./rc(alias/remote) gerencia pela TUI o controle remoto do Codex local (no servidor local em segundo plano) a partir de dispositivos pareados e exibe códigos de pareamento.
Sintaxe, transporte e limites de codex exec --remote <ADDR>
O PR #61707 permite que codex exec se conecte a um app server existente via ws://host:port, wss://host:port, unix:// (socket Unix padrão) ou unix://PATH.
Exemplo no mesmo host ou com encaminhamento de porta SSH (loopback): listeners WebSocket sem criptografia em ws://127.0.0.1:PORT servem apenas para localhost ou túnel SSH com encaminhamento de portas. Inicie o servidor nesse host:
codex app-server --listen ws://127.0.0.1:4500
Depois execute codex exec no mesmo host (ou por um túnel SSH que encaminhe a porta 4500):
codex exec --remote ws://127.0.0.1:4500 "Run the test suite and summarize failures"
Host separado ou runner de CI (wss:// autenticado): listeners WebSocket fora de loopback aceitam conexões não autenticadas por padrão durante o lançamento, e o próprio codex app-server escuta em ws:// (veja a documentação do app-server da OpenAI). Antes de expor um app server a outra máquina ou runner de CI, ative a autenticação WebSocket no servidor (prefira --ws-token-file em vez de passar tokens puros na linha de comando) e coloque terminação TLS na frente para que os clientes conectem via wss://:
# On the app-server host (behind a TLS reverse proxy exposing wss://remote-host:4500)
codex app-server --listen ws://127.0.0.1:4500 \
--ws-auth capability-token \
--ws-token-file /absolute/path/to/app-server-token
No cliente ou runner de CI, passe o token bearer correspondente por meio do nome de uma variável de ambiente com --remote-auth-token-env. Na saída legível por humanos, codex exec --remote imprime thread id: <UUID> no stderr; com --json, emite um evento JSONL thread.started ("type": "thread.started") contendo thread_id. Para retomar essa thread, substitua <THREAD_UUID> pelo thread_id retornado na primeira execução:
if IFS= read -rs CODEX_REMOTE_TOKEN && [ -n "$CODEX_REMOTE_TOKEN" ]; then
export CODEX_REMOTE_TOKEN
# Start a new noninteractive turn (capture thread_id from the thread.started JSONL event)
codex exec --remote wss://remote-host:4500 \
--remote-auth-token-env CODEX_REMOTE_TOKEN \
--json "Run the test suite and summarize failures"
# Resume syntax example: replace <THREAD_UUID> with the thread_id returned above
codex exec --remote wss://remote-host:4500 \
--remote-auth-token-env CODEX_REMOTE_TOKEN \
resume <THREAD_UUID> "Fix the failing parser test"
unset CODEX_REMOTE_TOKEN
else
echo "Remote token entry cancelled or empty." >&2
fi
Você pode posicionar --remote e --remote-auth-token-env antes ou depois de exec; passar endpoints conflitantes nos dois locais falha com `codex exec` received conflicting remote server endpoints. Considere três restrições rígidas verificadas na 0.171.0 (codex-rs/exec/src/remote.rs):
- O servidor define a configuração do agente: passar sobrescritas de configuração como
-m/--model,-s/--sandbox,-C/--cd, sobrescritas-c,-i/--image,-p/--profile,--add-dir,--output-schema,--ephemeralou--worktreefalha com"--remote currently supports only prompt, resume by UUID, and output options; configure the agent on the server". - Retomada apenas por UUID:
exec --remote resumerejeita--last,--all,--imageou destinos que não sejam UUID com"remote resume requires a thread UUID". - Sem turnos simultâneos: direcionar a execução para uma thread cujo status já esteja ativo falha com
"remote thread already has an active turn".
/rc e /remote na TUI
O PR #62121 adiciona /rc (e /remote) dentro da TUI para ativar ou desativar o controle remoto do servidor local gerenciado em segundo plano. Ao ativar, o menu verifica se remoteControlEnabled foi salvo em app-server-daemon/settings.json para a próxima reinicialização e informa caso falhe ao salvar; selecionar Add device exibe um código manual de pareamento. Você pode abrir /rc mesmo visualizando uma sessão na nuvem, e as alterações valem apenas para sessões locais.
Verifique três pré-requisitos antes de usar /rc:
- O servidor local gerenciado em segundo plano precisa estar em execução; caso contrário, as ações de controle remoto falham com
"Remote control requires the local background server.". - Você precisa estar conectado com o ChatGPT. A autenticação por chave de API é recusada com
"Sign in with ChatGPT to manage remote control.". - Administradores corporativos podem bloqueá-lo globalmente definindo
allow_remote_control = falsenorequirements.tomlgerenciado, o que retorna"Remote control is disabled by managed requirements.".
Fora da TUI (como em sessões SSH), use codex remote-control start, codex remote-control stop e codex remote-control pair conforme a referência da CLI da OpenAI.
Perfis de permissão ao trocar de diretório e outras correções da 0.171.0
Sim, seu perfil de permissão ativo permanece preservado quando você troca de diretório de trabalho na 0.171.0. Na rust-v0.170.0, quando a política antiga permitia vincular a permissão de escrita à nova raiz do projeto, uma atualização apenas de diretório podia reconstruir um perfil de permissão legado a partir da política de sandbox legada (codex-rs/core/src/session/session.rs).
O PR #61195 remove esse ramo legado de reconstrução. Assim, o perfil de permissão ativo, sua seleção atual e as raízes de workspace definidas no perfil permanecem intactos, enquanto as raízes de workspace em tempo de execução são atualizadas para o novo diretório. Na verificação de regressão de escrita em workspace do PR, arquivos comuns no novo workspace continuam graváveis, enquanto gravações em .git/config e no workspace anterior seguem bloqueadas; perfis nomeados personalizados continuam aplicando suas próprias raízes e regras configuradas. Se você mantém perfis restritos de rede ou sistema de arquivos para instalar pacotes, revise os perfis de permissão de sandbox do Codex para conferir suas regras de domínio e escrita.
Outras três correções da rust-v0.171.0 reduzem atritos no fluxo diário da CLI:
- Troca de sessão preserva texto não enviado (PR #61216): rascunhos, acompanhamentos na fila e entradas interrompidas permanecem vinculados às threads originais ao alternar ou retomar sessões.
- Login MCP corporativo sem tokens de atualização (PR #62129): corrige a autenticação MCP para provedores de identidade corporativos que emitem tokens de ID sem tokens de atualização.
- Direcionamento de turno ativo e aprovações (PR #61820, PR #61801): direcionar um turno ativo mantém edições anteriores nos diffs agregados, e eventos tardios de conclusão não cancelam mais aprovações de um turno mais recente.