Skip to main content
Codex é uma ferramenta de codificação com IA que é executada no seu terminal. Você pode conectar o Codex ao endpoint da API de LLM compatível com OpenAI da Novita e usar os modelos da Novita para tarefas de compreensão, geração, refatoração e depuração de código.
Atualmente, o Codex oferece suporte apenas à Responses API. Configure wire_api = "responses" conforme mostrado abaixo e não altere esta integração para o modo Chat Completions.

​
Pré-requisitos

Antes de começar, prepare os seguintes valores:
  • Chave de API: Crie ou copie uma chave de API em Gerenciamento de Chaves.
  • URL base: https://api.novita.ai/openai/v1
  • ID do modelo: Copie o ID do modelo que você deseja usar no Model Hub, como deepseek/deepseek-v3.1.
Mantenha sua chave de API privada. Use-a apenas na configuração local do Codex e nunca a envie para um repositório Git.

​
Instalar o Codex

Antes de instalar o Codex, certifique-se de que o Node.js 18 ou superior esteja instalado na sua máquina. No macOS, se você usa Homebrew, pode instalar o Node.js com:
Verifique suas versões do Node.js e do npm:
Instale a CLI do Codex:
Verifique a versão do Codex:

​
Configurar sua chave de API

Abra o arquivo de configuração do seu shell, por exemplo ~/.zshrc:
Adicione a seguinte variável de ambiente:
Recarregue a configuração do shell e confirme que a variável está disponível:

​
Configurar o Codex

Abra o arquivo de configuração do Codex:
Adicione a seguinte configuração e substitua model pelo ID do modelo da Novita que você deseja usar:

​
Iniciar o Codex

Acesse o diretório do seu projeto e inicie o Codex:
Agora você pode inserir uma tarefa de codificação, por exemplo:
Se o Codex retornar um erro de autenticação ou de modelo, verifique se:
  • NOVITA_API_KEY está disponível na sessão atual do terminal.
  • model corresponde exatamente ao ID do modelo no Model Hub da Novita.
  • base_url está definido como https://api.novita.ai/openai/v1.
Última modificação em 10 de agosto de 2026