Pré-requisitos
- Codex Desktop instalado
- Um login oficial do ChatGPT ou Codex concluído no aplicativo desktop
- Uma chave de API do Flatkey — crie uma no Console do Flatkey
- Um ID de modelo compatível do Diretório de Modelos do Flatkey
- CC Switch, se você usar a configuração com CC Switch
Configuração manual
1. Defina a chave de API
Armazene a chave em uma variável de ambiente do usuário em vez de escrevê-la em um arquivo de configuração.2. Atualize o config.toml
Abra o arquivo de configuração do Codex em nível de usuário:
Antes de substituir as configurações de nível superior
model e model_provider, registre seus valores atuais para que você possa restaurá-los mais tarde. Em seguida, atualize ambas as configurações. Se qualquer uma das chaves já existir, substitua seu valor em vez de acrescentar uma chave duplicada. Preserve todas as configurações não relacionadas. Adicione a tabela de provedor abaixo; se [model_providers.flatkey] já existir, atualize essa tabela em vez de criar uma duplicata:
gpt-5.4 está disponível no Diretório de Modelos do Flatkey no momento em que este texto foi escrito. Verifique o diretório antes de trocar para um ID de modelo diferente.
3. Reinicie e verifique
Encerre completamente o Codex Desktop, reabra-o e envie um pequeno prompt. Abra os Logs de Uso do Flatkey e confirme o modelo, as contagens de tokens, a latência e o custo.Configure com o CC Switch
O CC Switch é um gerenciador de configuração de terceiros, não um produto do Flatkey. Você também pode baixá-lo do repositório do CC Switch no GitHub. As etapas abaixo seguem a interface atual do CC Switch. A configuração manual e o CC Switch são métodos de configuração alternativos. Use um método para o provedor ativo. O Codex Desktop e o Codex CLI compartilham o~/.codex/config.toml no macOS e Linux, ou %USERPROFILE%\.codex\config.toml no Windows. O CC Switch controla as configurações de modelo e provedor nesse arquivo compartilhado. Preserve configurações e provedores não relacionados.
1. Conclua um login oficial
Abra o Codex Desktop e conclua um login oficial do ChatGPT ou Codex antes de trocar de provedor. Faça isso pelo menos uma vez para que o aplicativo desktop tenha uma sessão oficial válida para acesso à conta e para seu catálogo de modelos. As credenciais oficiais são armazenadas emauth.json ou no armazenamento de credenciais do seu sistema operacional. Trate ambos como sensíveis.
2. Preserve o login oficial para trocas diretas
No CC Switch, abra Settings > General > Codex App Enhancements e ative Keep official login for direct switches. Essa configuração impede que uma troca direta de provedor descarte o login oficial que o Codex Desktop ainda precisa.
3. Adicione o Flatkey como um provedor personalizado
Abra o painel Codex no CC Switch e adicione um Custom Provider. Use os valores a seguir. Este tutorial não depende de um provedor Flatkey integrado.
4. Configure o modelo
Defina o Default Model do provedor com o ID exato do modelo Flatkey que você deseja usar. A captura de tela mostragpt-5.6-sol como exemplo. Verifique o Diretório de Modelos do Flatkey antes de escolher um ID.
Clique em Fetch Models para carregar os IDs atuais. Adicione o modelo ao Model Mapping do provedor quando quiser que ele apareça no menu /model do Codex. Você também pode definir um ID exato como Default Model do provedor ou passá-lo pelo Codex CLI com codex --model <id>. No Codex Desktop, considere o provedor ativo e o modelo padrão como a rota pretendida, mesmo que o seletor não liste o modelo personalizado. Confirme a rota real com os Logs de Uso do Flatkey depois de enviar uma solicitação.
5. Salve, ative e reinicie
Salve o provedor personalizado e ative-o para o Codex. Não remova configurações ou provedores não relacionados doconfig.toml compartilhado.
6. Verifique a rota real
Inicie uma nova conversa com um contexto pequeno e envie um prompt mínimo. Em seguida, abra os Logs de Uso do Flatkey e confirme o modelo, as contagens de tokens, a latência e o custo dessa solicitação.
config.toml compartilhado controlam a rota. Os Logs de Uso do Flatkey são a confirmação definitiva de que a solicitação chegou ao Flatkey.
Prompts de sistema, ferramentas, histórico de conversa, arquivos anexados e saída de comandos podem aumentar os tokens de entrada além do texto do seu prompt visível. Contagens mais altas de tokens de entrada podem aumentar o custo faturado.
Se o modelo não estiver visível
O Codex Desktop pode mostrar o catálogo oficial de modelos e omitir um modelo personalizado de seu seletor. A ausência de um modelo personalizado na interface não comprova que o roteamento falhou.- Confirme que o login oficial do ChatGPT ou Codex ainda está ativo.
- Confirme que Settings > General > Codex App Enhancements > Keep official login for direct switches está ativado.
- Confirme que o provedor Flatkey está ativo e que seu Default Model contém o ID exato do modelo.
- Verifique o mapeamento de modelo do provedor. Use Fetch Models quando quiser que o modelo apareça no menu
/model. - Confirme que o
config.tomlcompartilhado contém o provedor e o modelo ativos pretendidos, sem alterar configurações não relacionadas. - Encerre completamente todos os processos do Codex Desktop e reabra o aplicativo.
- Envie um prompt mínimo e verifique os Logs de Uso do Flatkey para a rota real.
Voltar ao provedor oficial
Se você usou o CC Switch, ative o provedor oficial do Codex. Encerre completamente o Codex Desktop, certifique-se de que nenhum processo antigo permaneça e reabra-o. Não é necessário excluir o provedor personalizado do Flatkey. Se você usou a configuração manual, restaure os valores anteriores de nível superiormodel e model_provider no config.toml. Preserve configurações e tabelas de provedor não relacionadas. Deixe as credenciais oficiais no auth.json ou no armazenamento de credenciais do sistema operacional intocadas. Encerre completamente o Codex Desktop, certifique-se de que nenhum processo antigo permaneça e reabra-o.