Skip to content

Instalação

Instale o Codex CLI. Para o aplicativo desktop, consulte o Codex App.

npm install -g @openai/codex

Uso com o Ollama

Nota

O Codex requer uma janela de contexto maior. Recomenda-se utilizar uma janela de contexto de pelo menos 64k tokens.

Configuração rápida

ollama launch codex

Quando iniciado por meio de ollama launch codex, o Ollama atualiza o catálogo de modelos e utiliza um perfil dedicado do Codex para essa sessão.

Para configurar sem iniciar:

shell
ollama launch codex --config

Para remover o perfil de inicialização do Ollama e o catálogo de modelos gerado:

shell
ollama launch codex --restore

Configuração manual

Para usar o codex com o Ollama, utilize a flag --oss:

codex --oss

Para usar um modelo específico, passe a flag -m:

codex --oss -m gpt-oss:120b

Para usar um modelo em nuvem:

codex --oss -m gpt-oss:120b-cloud

Configuração baseada em perfil

Para uma configuração persistente do Codex CLI, crie o arquivo ~/.codex/ollama-launch.config.toml:

toml
model = "gpt-oss:120b"
model_provider = "ollama-launch"
model_catalog_json = "/Users/you/.codex/model.json"

[model_providers.ollama-launch]
name = "Ollama"
base_url = "http://localhost:11434/v1/"
wire_api = "responses"

Em seguida, execute:

codex --profile ollama-launch