Configuração do Codex Desktop

O aplicativo para desktop do OpenAI Codex pode entrar com uma chave de API e abrir o config.toml no nível do usuário de dentro do aplicativo. Com a Aiberm configurada, o Codex envia as solicitações pelo endpoint compatível com Responses da Aiberm.

Pré-requisitos

Antes de começar, certifique-se de ter:

• O aplicativo para desktop mais recente do OpenAI Codex
• Uma conta Aiberm (Cadastre-se)
• Uma chave de API da Aiberm (Crie uma no Console)

Configuração

1. Abra o aplicativo para desktop do Codex.
2. Na tela de login, escolha Sign in another way.

3. Insira sua chave de API da Aiberm no campo OpenAI API key e escolha Continue.

Observação: esta etapa permite apenas entrar no aplicativo para desktop do Codex. Ela não substitui a configuração da chave de API em config.toml. Conclua também a configuração abaixo, mesmo que você já tenha inserido uma chave na tela de login.

4. Após entrar no aplicativo, abra Settings.
5. Selecione Configuration na barra lateral.
6. Em Custom config.toml settings, certifique-se de que User config está selecionado.
7. Escolha Open config.toml para abrir o arquivo de configuração no nível do usuário.

8. Adicione ou substitua o conteúdo de config.toml por:

model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false

Substitua sk-your-aiberm-api-key pela sua chave de API real da Aiberm. A chave fica armazenada em texto simples no seu computador. Não faça commit desse arquivo no Git nem o compartilhe com outras pessoas.

9. Salve config.toml.
10. Encerre completamente e reabra o aplicativo para desktop do Codex.

Verificar se está funcionando

Após reabrir o Codex:

1. Abra um projeto ou workspace.
2. Peça ao Codex para executar uma tarefa real de programação, como explicar o arquivo atual, editar um trecho pequeno de código ou executar os testes do projeto.

Se a tarefa for executada e retornar um resultado, a configuração está funcionando.

Solução de problemas

Chave de API inválida

• Copie a chave completa em Aiberm Console.
• Verifique se há espaços extras antes ou depois da chave.
• Confirme se a chave começa com sk-.

As alterações de configuração não são aplicadas

• Confirme se você editou o config.toml aberto a partir de User config.
• Encerre completamente e reabra o aplicativo para desktop do Codex após salvar o arquivo.
• Confirme se model_provider = "aiberm" corresponde a [model_providers.aiberm].
• Confirme se experimental_bearer_token foi substituído pela sua chave de API real da Aiberm e se o marcador de posição não foi salvo sem alteração.

Erros de modelo ou conexão

• Confirme se o base_url é exatamente https://aiberm.com/v1.
• Confirme se wire_api é responses.
• Confirme se sua conta tem acesso a gpt-5.6-sol. Para a lista atual, consulte Lista de modelos.

Referência oficial

• OpenAI Codex: Configuration Reference