Como conectar o Codex à Cortex?

Viewed 214

Quero usar o Codex (linha de comando ou aplicativo) com os modelos da Cortex. Como configuro o provedor?

1 Answers

Resposta curta: crie um provedor cortex no ~/.codex/config.toml com base_url = "https://llm.sinapsetech.online/v1" (com /v1), wire_api = "responses" e a chave de acesso da Cortex Telemetria na variável CORTEX_API_KEY.

Passo a passo

  1. Defina a chave (chave de acesso da Cortex Telemetria) no ambiente:
    • PowerShell: $env:CORTEX_API_KEY = "sk-sua-chave-de-acesso"
    • macOS, Linux ou WSL: export CORTEX_API_KEY="sk-sua-chave-de-acesso"
  2. Edite o arquivo global ~/.codex/config.toml (no Windows, %USERPROFILE%\.codex\config.toml):
    model = "gpt-5.6-sol"
    model_provider = "cortex"
    model_reasoning_effort = "medium"
    
    [model_providers.cortex]
    name = "Cortex"
    base_url = "https://llm.sinapsetech.online/v1"
    env_key = "CORTEX_API_KEY"
    wire_api = "responses"
    requires_openai_auth = false
    supports_websockets = false
    stream_idle_timeout_ms = 7200000
    stream_max_retries = 5
    request_max_retries = 4
    
    As linhas model e model_provider ficam antes do bloco [model_providers.cortex].
  3. Teste em modo só leitura:
    codex exec --skip-git-repo-check --ephemeral --sandbox read-only "Responda somente: conectado à Cortex"
    
  4. Depois, rode codex normalmente e escolha as permissões adequadas ao projeto.
  5. Troque de modelo no config.toml ou numa execução: codex --model "gpt-6.1-sol".

💡 Dica: modelos indicados para o Codex: gpt-5.6-sol, gpt-6.1-sol ou gpt-5.3-codex, desde que liberados na sua chave. Confira em /v1/models.

⚠️ Atenção: o aplicativo desktop lê o mesmo config.toml, mas aberto pelo menu do sistema pode não enxergar a variável CORTEX_API_KEY. Abra-o a partir de um terminal que tenha a variável ou defina-a no ambiente da sessão.

Se não funcionar

  • 404 em /responses → base_url deve terminar em /v1, não em /responses.
  • wire_api = "chat" → não é aceito pelas versões atuais; use responses.
  • Chave ausente → a variável precisa existir no processo do Codex.
  • Configuração ignorada → o provedor deve estar no arquivo global, não só no .codex/config.toml do repositório.
  • Responde, mas não usa ferramentas → escolha um modelo indicado para código.
  • Ainda com problema? Abra um chamado em https://care.sinapsetech.online (nunca envie a chave).

📖 Saiba mais na Wiki: IDEs e Agentes de Código