O Codex App é o agente de codificação desktop da OpenAI para macOS e Windows. O Ollama configura o aplicativo para usar o endpoint compatível com OpenAI do Ollama, para que o Codex possa funcionar com modelos locais e modelos do Ollama Cloud no aplicativo desktop.

Instalação

Instale o Codex App para macOS ou Windows.

Nota

O suporte ao Codex App está disponível no Ollama v0.24.0 e versões mais recentes.

Configuração rápida

ollama launch codex-app

Assim que o Codex App abrir, inicie uma tarefa ou abra um repositório como de costume.

Navegador integrado

O Codex App pode abrir servidores locais e sites em seu navegador integrado. Anote diretamente na página para solicitar alterações.

Modo de revisão

Use o modo de revisão para inspecionar alterações de código, deixar comentários e iterar nas correções sem sair do aplicativo.

Executar diretamente com um modelo

ollama launch codex-app --model kimi-k2.6:cloud

Use um modelo local passando seu nome de modelo:

ollama launch codex-app --model gemma4:31b

Executar ollama launch codex-app é persistente e manterá seu modelo selecionado na próxima vez que você abrir o Codex.

Restaurar o Codex App

Para voltar o Codex App para o perfil que você estava usando antes de ollama launch codex-app, execute:

ollama launch codex-app --restore

O Ollama restaura as configurações e ajustes do Codex App. Se o Codex App estiver aberto, o Ollama solicita confirmação antes de reiniciá-lo.

O perfil do Codex CLI gerenciado por ollama launch codex é mantido separado do perfil do Codex App.

Antes de sobrescrever os arquivos de configuração do Codex App, o Ollama Launch salva backups em ~/.ollama/backup/codex-app/. No Windows, o ~ é resolvido para o diretório do perfil do seu usuário.

Solução de problemas

Se o Codex App não abrir após a configuração, abra o Codex manualmente uma vez e execute ollama launch codex-app novamente.

Se o Codex App já estiver em execução e não alternar os modelos, permita que o Ollama o reinicie quando solicitado, ou feche o Codex App e execute ollama launch codex-app novamente.