For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal

Codex CLI

Inspecione, edite e execute código pelo terminal

Inspecione código, faça alterações, execute comandos e automatize tarefas repetitivas sem sair do terminal.

$ codex
╭──────────────────────────────────────────────────╮
│ >_ OpenAI Codex                                  │
│                                                  │
│ model:     gpt-5.6-sol medium/model to change │
│ directory: ~/code                                │
╰──────────────────────────────────────────────────╯

  To get started, describe a task or try one of these commands:

  /init - create an AGENTS.md file with instructions for Codex
  /status - show current session configuration
  /permissions - choose what Codex is allowed to do
  /model - choose what model and reasoning effort to use
  /review - review any changes and find issues
      

 Refactor the Dashboard component to React Hooks
      
  100% context left · ? for shortcuts
      
01

Trabalhe no seu repositório local

Permita que o Codex inspecione arquivos, faça edições e execute as ferramentas já instaladas na sua máquina.

02

Mantenha o controle

Escolha o modelo, o esforço de raciocínio, as permissões e os comandos adequados à tarefa.

03

Combine com scripts e CI

Use o Codex interativamente ou chame codex exec em fluxos de trabalho e pipelines repetíveis.

Início rápido

Comece a usar a Codex CLI

Instale o Codex, faça login e execute sua primeira tarefa em um diretório de projeto.

  1. Instalar o Codex

    Instale a Codex CLI com o instalador independente para macOS e Linux.

    Instalar o Codex

    curl -fsSL https://chatgpt.com/codex/install.sh | sh

    Atualizar o Codex

    curl -fsSL https://chatgpt.com/codex/install.sh | sh
  2. Execute o Codex e faça login

    Abra o diretório de um projeto e execute codex. Na primeira vez que executar o Codex, escolha Entrar com o ChatGPT ou outro método de login disponível.

    Consultar opções de autenticação
  3. Inicie sua primeira tarefa

    Descreva o que você quer alcançar. Por exemplo, peça ao Codex que explique o projeto, faça uma alteração específica ou ajude a depurar um issue.

    Explique este projeto para mim

    Crie pontos de verificação do Git antes e depois de uma tarefa para poder reverter alterações. Consulte as práticas recomendadas.

Veja o que é possível fazer com a Codex CLI

Use um único ciclo de trabalho no terminal para trabalho interativo, automação, revisão e delegação.

01

Mantenha o ciclo de desenvolvimento no terminal

Inicie o Codex em um repositório para explorar código desconhecido, planejar uma alteração, editar arquivos e executar suas ferramentas locais de desenvolvimento. Oriente a interação em andamento, inspecione comandos e diffs à medida que aparecerem e mantenha o trabalho subsequente na mesma sessão.

Saiba mais
02

Use habilidades e plug-ins

Empacote instruções reutilizáveis como habilidades e adicione plug-ins para conectar o Codex às ferramentas e aos dados da sua equipe sem sair da CLI.

Saiba mais
03

Revise as alterações antes de enviá-las

Execute uma revisão específica das alterações sem commit, de um commit ou de uma branch-base. O Codex apresenta as descobertas em ordem de prioridade sem modificar sua árvore de trabalho, para que você possa tratar os riscos antes de fazer commit ou abrir um pull request.

Saiba mais

Conheça os recursos da CLI que permitem retomar sessões, adicionar contexto visual e da Web, dividir trabalhos complexos e conectar o Codex às suas ferramentas de desenvolvimento.

01 codex resume

Volte a um chat salvo

Reabra um chat recente do repositório atual ou pesquise nos chats locais quando precisar retomar um trabalho antigo.

02 codex --image

Adicione contexto visual ao prompt

Inclua uma captura de tela de erro, um diagrama de arquitetura ou uma referência de design no primeiro prompt; ou cole uma imagem no editor interativo.

03 subagents

Divida uma investigação mais ampla

Peça ao Codex que delegue partes específicas do trabalho a agentes especializados e depois incorpore as descobertas deles à sessão principal do terminal.

04 codex --search

Busque contexto atualizado

Ative a Pesquisa na Web em tempo real quando uma tarefa depender de versões, documentação ou comportamento externo atuais. A atividade de pesquisa continua visível na transcrição.

05 codex cloud

Transfira o trabalho para o Codex Cloud

Navegue pelos chats ativos e concluídos, envie o trabalho a um ambiente configurado e aplique o resultado ao repositório local pelo terminal.

06 codex mcp

Conecte ferramentas externas com o MCP

Adicione servidores MCP locais ou remotos, autentique-se quando necessário e inspecione as ferramentas disponíveis para a sessão atual antes que o Codex as utilize.

07 /permissions

Defina os limites de cada execução

Escolha quando o Codex pode editar arquivos ou executar comandos sem pedir aprovação e, antes de continuar, inspecione o Sandbox ativo e as raízes com permissão de gravação.

08 codex completion

Adapte o Codex ao seu terminal

Gere scripts de preenchimento automático para o shell, escolha um tema de sintaxe e abra prompts mais longos no editor configurado por VISUAL ou EDITOR.

Use Codex CLI when…

Você trabalha pelo terminal

Explore e edite um repositório e execute o código em um único ciclo de trabalho.

Você precisa de scripts ou CI

Execute um comando não interativo em um fluxo de trabalho repetível.

Você quer uma revisão de código local

Inspecione as alterações antes de fazer commit ou abrir um pull request.

Você quer transferir o trabalho para a nuvem

Inicie um chat na nuvem e volte ao terminal mais tarde.