Skip to main content
Codex CLI é um agente de programação local de código aberto lançado pela OpenAI, que roda no seu terminal. Ele pode ler código, modificar arquivos, executar comandos, interpretar erros e auxiliar em tarefas diárias de desenvolvimento. Codex CLI suporta fornecedores de modelos personalizados. Você pode usá-lo através do proxy compatível com OpenAI Responses fornecido pela Ace Data Cloud, sem precisar assinar uma conta oficial da OpenAI. Após a configuração, o Codex CLI enviará as requisições para https://api.acedata.cloud/v1.

​
Processo de Solicitação

Para usar o Codex CLI, primeiro acesse o Console da Ace Data Cloud para obter seu Token de API, que deve ser guardado para uso futuro. Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, onde poderá se registrar e entrar. Após o login, você será redirecionado de volta para a página atual. Na primeira solicitação, há uma cota gratuita para experimentar o serviço Codex CLI sem custos.

​
Instalação do Codex CLI

Codex CLI suporta macOS, Linux, Windows e WSL. Você pode instalar via npm ou usar Homebrew (somente macOS).

​
Instalação via npm (Recomendado)

Se você já tem Node.js instalado, pode instalar diretamente via npm. Requer Node.js 18 ou superior.

​
Instalação via Homebrew (macOS)

Usuários macOS também podem instalar via Homebrew:

​
Verificar Instalação

Após a instalação, reabra o terminal e verifique se o comando está disponível:
Se aparecer command not found, geralmente significa que o terminal atual ainda não carregou o novo PATH. Feche e reabra o terminal ou verifique as configurações de PATH indicadas na saída do script de instalação.

​
Configuração do Codex CLI

Após a instalação, o Codex CLI tentará se conectar ao serviço oficial da OpenAI por padrão. Para usar a Ace Data Cloud, é necessário declarar um model_provider personalizado no arquivo de configuração do Codex e colocar o Token da API na variável de ambiente correspondente.

​
Passo 1: Definir Variável de Ambiente

Recomenda-se adicionar o Token da API no arquivo de configuração do seu shell, como ~/.zshrc, ~/.bashrc ou ~/.bash_profile:
Substitua {token} pelo Token de API copiado do console da Ace Data Cloud. Depois, reabra o terminal ou execute o comando source para aplicar a configuração imediatamente:

​
Passo 2: Editar o Arquivo de Configuração do Codex

O Codex CLI usa ~/.codex/config.toml como arquivo de configuração global. Se não existir, crie-o:
Adicione o seguinte conteúdo em ~/.codex/config.toml:
Descrição dos campos:

​
Limpar Cache de Login da OpenAI

Se você já fez login com uma conta oficial da OpenAI no Codex CLI, pode haver um cache local do estado de login (normalmente em ~/.codex/auth.json). Antes de mudar para o proxy da Ace Data Cloud, recomenda-se limpar esse login antigo:
Se o comando codex logout não estiver disponível, você pode remover manualmente o arquivo de cache:
Se você nunca fez login com uma conta oficial da OpenAI, pode pular esta etapa.

​
Iniciar uma Sessão

Entre no diretório do seu projeto e inicie o Codex CLI:
Quando a interface interativa do Codex aparecer, você pode digitar suas solicitações, por exemplo:

​
Verificar Configuração

Dentro do Codex CLI, você pode verificar o modelo e fornecedor atuais com:
Você deverá ver que o modelo está vindo do fornecedor acedatacloud, por exemplo:
Se o fornecedor mostrado não for acedatacloud, significa que a configuração não foi aplicada corretamente. Verifique se ~/.codex/config.toml foi salvo corretamente e se a variável ACEDATACLOUD_API_KEY está acessível no terminal atual:
Você também pode consultar o histórico de uso e detalhes de cobrança no Console da Ace Data Cloud - Histórico de Uso e verificar o saldo restante em Console da Ace Data Cloud - Lista de Aplicações.

​
Como Funciona

Codex CLI usa nativamente o protocolo OpenAI Responses API. A Ace Data Cloud oferece um serviço proxy compatível em https://api.acedata.cloud/v1/responses, portanto o Codex CLI não precisa de um proxy local nem plugins adicionais. O fluxo de trabalho é:
  1. Codex CLI lê model_provider em ~/.codex/config.toml e carrega o bloco de configuração correspondente [model_providers.acedatacloud].
  2. Codex CLI lê o Token da API da variável de ambiente indicada por env_key (ACEDATACLOUD_API_KEY).
  3. A requisição é enviada via protocolo wire_api = "responses" para base_url + /responses, ou seja, https://api.acedata.cloud/v1/responses.
  4. A Ace Data Cloud autentica o Token, verifica a cota e encaminha a requisição para o canal de modelo upstream disponível.
  5. Após a conclusão, a plataforma registra o uso e deduz a cota correspondente.
Isso significa que você continua usando o comando original codex e a experiência nativa do Codex CLI, apenas alterando o serviço de modelo para a Ace Data Cloud.

​
Configurar o Modelo

O campo model em ~/.codex/config.toml determina o modelo padrão usado pelo Codex. O serviço OpenAI Responses da Ace Data Cloud suporta vários modelos comuns, incluindo: Para trocar temporariamente o modelo, use o parâmetro na linha de comando ao iniciar o Codex:
Ou modifique diretamente o campo model em ~/.codex/config.toml e reinicie o Codex. A lista completa de modelos está disponível na Documentação do Serviço OpenAI da Ace Data Cloud.

​
Nível de Confiança do Projeto

Codex CLI permite definir níveis de confiança diferentes para projetos distintos, controlando quais operações o agente pode executar. Você pode adicionar ao final do ~/.codex/config.toml:
Onde:
  • trusted: O agente tem permissões completas, podendo executar comandos e modificar arquivos.
  • untrusted: O agente tem permissões restritas, mais adequado para projetos desconhecidos.

​
Saiba Mais