Skip to main content
O Codex CLI é o agente local de programação da OpenAI para linha de comando. Ele é executado no terminal, lê o workspace selecionado, edita arquivos, executa comandos e segue as configurações de sandbox e aprovação durante as tarefas de desenvolvimento.

​
Resposta curta

Ele é útil quando você quer a ajuda de um agente para alterações de código, revisão, correções de testes, scripts e trabalhos de engenharia com várias etapas em um repositório local. O Codex CLI é diferente de uma conversa comum no ChatGPT. Ele não apenas sugere código: trabalha com o diretório atual, as instruções do projeto, os resultados das ferramentas e as permissões locais de execução.

​
Codex CLI, App e Web

Veja Codex CLI, Codex App e Codex Web para uma comparação detalhada.

​
Quando isso é importante

  • Você está instalando @openai/codex pela primeira vez
  • Você está comparando Codex CLI, Codex App e Codex Web
  • Você quer que um agente edite arquivos em um projeto local
  • Você precisa configurar um provedor de API, uma Base URL ou um modelo personalizado
  • Você quer entender sandbox, aprovação e AGENTS.md

​
Conceitos principais

​
Fluxo recomendado

  1. Inicie o Codex CLI no diretório do projeto que você deseja alterar.
  2. Peça que ele examine os arquivos ou as instruções relevantes antes de fazer alterações amplas.
  3. Em trabalhos complexos, peça um plano antes de permitir alterações nos arquivos.
  4. Escolha as configurações de sandbox e aprovação conforme o risco da tarefa.
  5. Coloque regras permanentes do projeto no AGENTS.md e requisitos pontuais na conversa atual.
Se você usa um provedor de API de terceiros, concentre-se em model_provider, base_url, wire_api e nos campos de modelo do config.toml. O Codex e outras ferramentas compatíveis com OpenAI geralmente usam um endpoint compatível com OpenAI, que nesta documentação é https://bettertoken.ai/v1.

​
Erros comuns

  • Tratar o Codex CLI como um assistente apenas de chat.
  • Achar que Codex CLI, Codex App e Codex Web são executados no mesmo ambiente.
  • Alterar apenas model sem configurar o provedor e a Base URL correspondentes.
  • Relaxar o sandbox e as aprovações sem testes, revisão ou limites de comandos.
  • Misturar Base URLs compatíveis com OpenAI e com Anthropic.

​
Sobre a BetterToken

Ao usar um provedor personalizado compatível com OpenAI, a BetterToken pode atuar como camada de API de modelos para o Codex CLI. Ela gerencia API Key, Base URL, roteamento de modelos, saldo e registros de uso. A BetterToken não substitui o sandbox local, as aprovações, o AGENTS.md nem a política de execução de comandos do Codex CLI. Para acesso geral à API do Codex, consulte a página Codex API da BetterToken. Esta FAQ trata do funcionamento do Codex CLI e de sua configuração local.

​
Documentos relacionados

​
Referências