O Codex CLI é um assistente de programação com IA de código aberto que é executado localmente no seu terminal enquanto se conecta a modelos de IA remotos por meio de APIs. Construído em Rust para desempenho e segurança, ele pode ler, modificar e executar código no diretório escolhido por você, mantendo proteções rigorosas de sandbox.
Este guia mostra como configurar o Codex CLI com modelos avançados de IA por meio da Novita AI, incluindo modelos especializados em programação como o Qwen Coder, modelos focados em raciocínio como o DeepSeek e modelos agentes como o Kimi K2.
O que é o Codex CLI?
O Codex CLI é um agente de programação baseado em terminal que combina execução local com capacidades de IA em nuvem. Ao contrário das ferramentas de geração de código que só produzem snippets, o Codex CLI pode entender todo o seu projeto, executar o código que cria, depurar problemas e iterar até que as soluções funcionem corretamente.
Principais Funcionalidades
Arquitetura Primeiro Local: É executado inteiramente na sua máquina enquanto faz chamadas de API para modelos de IA. Seu código permanece local enquanto aproveita as poderosas capacidades de IA em nuvem.
Compreensão do Projeto: Lê todo o seu código, entende os padrões existentes, dependências e estilo de programação para gerar código que se encaixa perfeitamente no seu projeto.
Operação Autônoma: Pode trabalhar de forma independente por longos períodos, dividindo tarefas complexas e executando-as sistematicamente com supervisão mínima.
Modos de Aprovação Flexíveis:
- Modo Sugestão: Solicita aprovação em cada etapa (padrão)
- Modo Edição Automática: Edita arquivos automaticamente, mas pede permissão antes de executar comandos
- Modo Totalmente Automático: Autonomia completa sem solicitações de aprovação
Funcionalidades de Segurança: É executado em ambientes com rede desativada e diretórios em sandbox para proteger o seu sistema, mantendo toda a funcionalidade.
Codex CLI vs Claude Code: Principais Diferenças
Antes de mergulhar na configuração do Codex CLI, é importante entender como ele difere do Claude Code, outro assistente de programação com IA popular:
Codex CLI
- Suporte a Modelos: Suporta modelos da OpenAI e APIs compatíveis com a OpenAI, com suporte a vários provedores
- Arquitetura: Agente local executado no seu terminal com chamadas de API para modelos remotos
- Código Aberto: Totalmente open source com contribuições da comunidade
Claude Code
- Suporte a Modelos: Foca nos modelos Claude da Anthropic e APIs compatíveis com a Anthropic
- Arquitetura: Experiência integrada em plataformas web, desktop e IDEs
- Desenvolvimento: Núcleo proprietário com acesso via API
O Codex CLI é superior pela sua precisão e capacidade de lidar com tarefas complexas, especialmente em bases de código existentes. O Claude Code é frequentemente preferido pela sua experiência de usuário e configurações iniciais de projetos. Alguns usuários obtêm os melhores resultados combinando as duas ferramentas.
Para fluxos de trabalho específicos do Claude, confira o nosso guia para usar o Claude Code com a Novita AI.
Por que Usar APIs de Terceiros com o Codex CLI?
Embora o Codex CLI suporte modelos da OpenAI nativamente, APIs de terceiros como a Novita AI oferecem vantagens fundamentais:
Modelos Especializados: Acesse modelos de ponta como o DeepSeek V3.1 para raciocínio, o Qwen Coder para programação e o Kimi K2 para fluxos de trabalho agentes.
Custo e Desempenho: Preços competitivos com modelos otimizados para tarefas específicas, desde respostas leves até resolução de problemas complexos.
Modelos Personalizados: Com a Novita AI, você pode até usar seus próprios modelos personalizados rapidamente no Codex CLI para requisitos especializados.
Confiabilidade: Provedores alternativos reduzem limites de taxa e garantem acesso consistente durante quedas ou restrições regionais.
Como Acessar Modelos da Novita AI no Codex CLI
Pré-requisitos
- Crie uma conta: Visite o site da Novita AI e cadastre-se para uma conta.
- Gere sua Chave de API: Após fazer login, acesse a página de Gerenciamento de Chaves para gerar sua chave de API.
- Selecione um Nome de Modelo: Você precisará copiar o nome do modelo que deseja usar da Biblioteca de Modelos da Novita AI. Alguns modelos disponíveis incluem:
deepseek/deepseek-v3.1qwen/qwen3-coder-480b-a35b-instructmoonshotai/kimi-k2-0905openai/gpt-oss-120bzai-org/glm-4.5google/gemma-3-12b-it
- Salve-a com Segurança: você precisará dela para a configuração.
Instalação
Instalar via npm (Recomendado)
npm install -g @openai/codex
Instalar via Homebrew (macOS)
brew install codex
Verificar Instalação
codex --version
Configurando Modelos da Novita AI
Configurar Arquivo de Configuração
O Codex CLI usa um arquivo de configuração TOML localizado em:
- macOS/Linux:
~/.codex/config.toml - Windows:
%USERPROFILE%\.codex\config.toml
Modelo de Configuração Básica
model = "MODEL_NAME"
model_provider = "novitaai"
[model_providers.novitaai]
name = "Novita AI"
base_url = "https://api.novita.ai/openai"
http_headers = {"Authorization" = "Bearer YOUR_NOVITA_API_KEY"}
wire_api = "chat"
Modelos Disponíveis e Quando Usá-los
| Modelo | Melhor Para | Pontos Fortes |
|---|---|---|
deepseek/deepseek-v3.1 |
Algoritmos e arquitetura complexos | Raciocínio e resolução de problemas superiores |
qwen/qwen3-coder-480b-a35b-instruct |
Geração e refatoração de código | Especializado em tarefas de programação |
moonshotai/kimi-k2-0905 |
Fluxos de trabalho agentes e automação | Execução rápida, manipulação de contexto longo |
openai/gpt-oss-120b |
Tarefas de desenvolvimento geral | Desempenho de linha de base confiável |
zai-org/glm-4.5 |
Integração de ferramentas e depuração | Alta taxa de sucesso para chamadas de ferramentas |
google/gemma-3-12b-it |
Tarefas de desenvolvimento leves | Respostas eficientes e rápidas |
Primeiros Passos
Iniciar o Codex CLI
codex
Exemplos de Uso Básico
Geração de Código:
> Create a Python class for handling REST API responses with error handling
Análise de Projeto:
> Review this codebase and suggest improvements for performance
Correção de Bugs:
> Fix the authentication error in the login function
Testes:
> Generate comprehensive unit tests for the user service module
Trabalhando com Projetos Existentes
Navegue até o diretório do seu projeto antes de iniciar o Codex CLI:
cd /path/to/your/project
codex
O Codex CLI entenderá automaticamente a estrutura do seu projeto, lerá os arquivos existentes e manterá o contexto sobre a sua base de código durante toda a sessão.
Conclusão
O Codex CLI com modelos da Novita AI oferece um ambiente de desenvolvimento poderoso e flexível que combina controle local com capacidades de IA em nuvem. Ao escolher o modelo certo para cada tarefa e configurar o seu ambiente corretamente, você pode acelerar significativamente o seu fluxo de trabalho de desenvolvimento, mantendo a qualidade e a segurança do código.
Comece com a configuração básica usando o Qwen Coder para tarefas de desenvolvimento geral, depois experimente modelos especializados como o DeepSeek para raciocínio complexo ou o Kimi K2 para fluxos de trabalho autônomos conforme as suas necessidades evoluem.
Sobre a Novita AI
Novita AI é uma plataforma de nuvem de IA que oferece aos desenvolvedores uma forma fácil de implantar modelos de IA usando nossa API simples, além de fornecer uma nuvem de GPU acessível e confiável para construção e escalonamento.
Leitura Recomendada
