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
Theme

Codex CLI

Analise, edite e execute código pelo terminal

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

$ codex
╭──────────────────────────────────────────────────╮
│ >_ OpenAI Codex                                  │
│                                                  │
│ model:     gpt-6.1-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

Deixe o Codex analisar e editar arquivos e executar 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

Integre o Codex a scripts e pipelines de CI

Use o Codex de forma interativa ou execute o comando codex exec em fluxos de trabalho e pipelines reutilizáveis.

Quickstart

Comece a usar o Codex CLI

Instale o Codex, entre na sua conta e execute sua primeira tarefa no diretório de um projeto.

  1. Instalar o Codex

    Instale o 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 entre na sua conta

    Open a project directory and run codex. The first time you run Codex, choose Entrar com o ChatGPT or another available sign-in method.

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

    Descreva o que você quer fazer. Por exemplo, peça ao Codex para explicar o projeto, fazer uma alteração pontual ou ajudar a depurar um problema.

    Tell me about this project

    Crie pontos de controle no Git antes e depois de uma tarefa para poder reverter as alterações. Consulte as boas práticas.

Veja o que o Codex CLI pode fazer

No mesmo fluxo de trabalho no terminal, você pode interagir com o Codex, automatizar tarefas, revisar código e delegar trabalho.

01

Desenvolva sem sair do terminal

Inicie o Codex em um repositório para explorar código que você ainda não conhece, planejar uma alteração, editar arquivos e executar suas ferramentas locais de desenvolvimento. Dê novas orientações enquanto o Codex trabalha, confira os comandos e diffs à medida que aparecem e continue na mesma sessão.

Learn more
02

Use habilidades e plug-ins

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

Learn more
03

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

Revise as alterações ainda sem commit, um commit específico ou as diferenças em relação a uma branch de base. O Codex apresenta os resultados em ordem de prioridade sem modificar sua árvore de trabalho. Assim, você pode tratar os riscos antes de fazer um commit ou abrir um pull request.

Learn more

Conheça os recursos da CLI para retomar sessões, adicionar contexto visual e informações da Web, dividir tarefas complexas em partes e conectar o Codex às suas ferramentas de desenvolvimento.

01 codex resume

Retome um chat salvo

Reabra um chat recente do repositório atual ou pesquise nos chats locais para retomar um trabalho anterior.

02 codex --image

Adicione contexto visual ao prompt

Envie uma captura de tela de um erro, um diagrama de arquitetura ou uma referência de design junto com o primeiro prompt ou cole uma imagem no editor interativo.

03 subagents

Divida uma investigação maior em partes

Peça ao Codex que delegue tarefas específicas a agentes especializados. Depois, reúna os resultados na sessão principal do terminal.

04 codex --search

Busque informações atualizadas

Ative a pesquisa na Web em tempo real durante a execução quando a tarefa depender das versões mais recentes, da documentação ou do comportamento de sistemas externos. As pesquisas ficam visíveis no histórico da sessão.

05 codex cloud

Transfira o trabalho para o Codex Cloud

Pelo terminal, consulte os chats ativos e concluídos, envie tarefas para um ambiente configurado e aplique o resultado ao seu repositório local.

06 codex mcp

Conecte ferramentas externas via MCP

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

07 /permissions

Defina os limites de cada execução

Escolha quando o Codex pode editar arquivos ou executar comandos sem pedir aprovação. Antes de continuar, confira o sandbox ativo e os diretórios raiz com permissão de escrita.

08 codex completion

Adapte o Codex ao seu terminal

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

Use Codex CLI when…

Você trabalha pelo terminal

Explore, edite e execute o código de um repositório no mesmo fluxo de trabalho.

Você precisa usar scripts ou CI

Execute um comando não interativo em um fluxo de trabalho reutilizável.

Você quer revisar o código localmente

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

Você quer delegar uma tarefa à nuvem

Inicie uma conversa na nuvem e volte ao terminal mais tarde.