Codex Desktop

Depois de concluir a configuração do provedor, confira qual configuração o Codex para desktop realmente abre. O fato de a CLI funcionar não significa que o app desktop esteja verificado; um local de configuração personalizado e a versão do aplicativo podem alterar as configurações lidas.

Configure mais rápido com o Ofox Desktop. Em um Mac com Apple silicon, o Desktop detecta esta ferramenta, faz backup da configuração atual e aplica uma Ofox API Key e um modelo compatível. Abrir o Ofox Desktop .

O Ofox Desktop oferece outra forma de configuração; antes de usar, confira os dispositivos e clientes compatíveis. Ofox Desktop e Codex Desktop são aplicativos diferentes.

Verificar a configuração do app desktop

Se quiser confirmar que o app desktop leu a configuração do CC Switch, siga estes passos:

Etapa 1: Ver config.toml no CC Switch

Abra o CC Switch, clique no provedor para abrir a página de edição e mude para a aba config.toml (TOML) no topo para ver a configuração atualmente escrita.

Conteúdo do config.toml no CC Switch

Etapa 2: Abrir o config.toml do Codex Desktop

Abra o Codex Desktop, vá ao menu Configurações à esquerda e clique no botão Abrir config.toml no canto superior direito. O arquivo abrirá no seu editor padrão.

Página de configurações do Codex Desktop

config.toml no editor

Etapa 3: Comparar as duas configurações

Compare o modelo selecionado, model_provider e o base_url desse provedor. Configurações iguais são apenas uma etapa da verificação: o roteamento precisa ser confirmado com uma requisição real.

Etapa 4: Enviar uma mensagem para verificar

Crie uma nova conversa e envie uma requisição curta, como “Responda apenas OK”. Essa requisição é cobrada conforme os preços da conta e do modelo. Em seguida, confira o horário e o modelo no registro de uso do Ofox; se não houver registro, verifique primeiro a conta, o provedor e a configuração ativa antes de tentar de novo.

Receber a resposta e encontrar o registro correspondente verifica o caminho desta requisição. Isso não prova sozinho a identidade do modelo subjacente nem substitui a verificação separada de chamadas de ferramentas, entrada de imagens ou saída estruturada.

Codex Desktop funcionando

Solução de problemas da primeira requisição

Sintoma	O que verificar primeiro	Próximo passo
A CLI funciona, mas o app desktop não	Configuração realmente aberta em cada lado, provedor e modelo selecionados	Corrija os campos divergentes, salve, reinicie o cliente correspondente e verifique em uma nova conversa
Erro de autenticação	Credenciais do provedor atual e a conta que as emitiu	Substitua as credenciais inválidas pelo fluxo normal de configuração; não cole a Key em chamados
Modelo ou endpoint inexistente	ID exato do modelo, endpoint e protocolo	Corrija conforme o guia de configuração do provedor; não acrescente `/v1` a um endereço que já o contém
Há resposta, mas não há registro de uso no Ofox	Conta, provedor, horário da requisição	Confira o caminho real da requisição; a identidade declarada pelo modelo não prova que o roteamento está correto
O texto funciona, mas as ferramentas falham	Capacidades do modelo, parâmetros da ferramenta e resposta de erro	Verifique separadamente em um projeto de teste temporário e guarde o erro sem dados sensíveis e o identificador de requisição disponível

Faça backup antes de alterar a configuração; em caso de falha, restaure a última configuração funcional e evite que várias ferramentas de configuração se sobrescrevam. Ao relatar um problema, informe a versão do cliente, o sistema operacional, o ID exato do modelo, o horário e o fuso da requisição, o status HTTP e o identificador de requisição disponível, removendo a Key, os cabeçalhos de autenticação, os prompts privados e o conteúdo do projeto.