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.
