Codex CLI
Inspecione,edite e execute código a partir do terminal
Inspecione código, faça alterações, execute comandos e automatize trabalho repetível 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 the model and reasoning effort /review - review changes and find issues
› Refactor the Dashboard component to React Hooks
100% context left · ? for shortcuts
Trabalhe no seu repositório local
Permita que o Codex inspecione ficheiros, faça edições e execute as ferramentas já instaladas na sua máquina.
Mantenha o controlo
Escolha o modelo, o nível de raciocínio, as permissões e os comandos adequados à tarefa.
Combine com scripts e CI
Utilize o Codex de forma interativa ou invoque codex exec a partir de fluxos de trabalho e pipelines repetíveis.
Início rápido
Introdução
Instale o Codex, inicie sessão e execute a primeira tarefa a partir de um diretório de projeto.
-
Instalar o Codex
Escolha um destes métodos de instalação: Instale a Codex CLI com o instalador autónomo para macOS e Linux. Instalar: Atualizar: Instale a Codex CLI com o instalador autónomo para Windows. Instalar: Atualizar: Também pode instalar a Codex CLI com npm. Instalar: Atualizar: Também pode instalar a Codex CLI com Homebrew. Instalar: Atualizar:
Instalar o Codex -
Executar o Codex e iniciar sessão
Abra um diretório de projeto e execute codex . Na primeira vez que executar o Codex, escolha Iniciar sessão com o ChatGPT ou outro método de início de sessão disponível.
Consultar as opções de autenticação -
Iniciar a primeira tarefa
Descreva o que pretende realizar. Por exemplo, peça ao Codex para explicar o projeto, fazer uma alteração específica ou ajudar a depurar um problema. Crie pontos de restauro do Git antes e depois de uma tarefa, para poder reverter as alterações. Consulte as práticas recomendadas .
práticas recomendadas
Veja o que pode fazer com a Codex CLI
Utilize um único ciclo de trabalho focado no terminal para trabalho interativo, automatização, revisão e delegação.
Mantenha o ciclo de programação no terminal
Inicie o Codex num repositório para explorar código desconhecido, planear uma alteração, editar ficheiros e executar as suas ferramentas de desenvolvimento locais. Oriente a interação ativa, inspecione os comandos e as diferenças à medida que aparecem e mantenha o trabalho subsequente na mesma sessão.
Mantenha o ciclo de programação no terminalUtilize skills e plugins
Organize instruções repetíveis como skills e, em seguida, adicione plugins para ligar o Codex às ferramentas e aos dados da sua equipa sem sair da CLI.
Utilize skills e pluginsReveja as alterações antes de serem disponibilizadas
Execute uma revisão dedicada das alterações não consolidadas, de um commit ou de um ramo base. O Codex comunica as conclusões por ordem de prioridade sem modificar a sua árvore de trabalho, para que possa resolver os riscos antes de criar um commit ou abrir um pull request.
Reveja as alterações antes de serem disponibilizadasCrie um fluxo de trabalho de terminal em torno do Codex
Conheça as funcionalidades da CLI que pode utilizar para retomar sessões, adicionar contexto visual e da Web, dividir trabalho complexo e ligar o Codex às suas ferramentas de desenvolvimento.
Regressar a uma conversa guardada
Volte a abrir uma conversa recente do repositório atual ou pesquise nas conversas locais quando precisar de retomar trabalho mais antigo.
Adicionar contexto visual ao pedido
Forneça uma captura de ecrã de um erro, um diagrama de arquitetura ou uma referência de design com o primeiro pedido, ou cole uma imagem no campo de composição interativo.
Dividir uma investigação mais abrangente
Peça ao Codex para delegar trabalho específico a agentes especializados e, em seguida, integrar as conclusões na sessão principal do terminal.
Pesquisar contexto atual
Mude uma execução para pesquisa em tempo real na Web quando uma tarefa depender de versões, documentação ou comportamentos externos atuais. A atividade de pesquisa permanece visível na transcrição.
Transferir trabalho para o Codex cloud
Consulte conversas ativas e concluídas, envie trabalho para um ambiente configurado e aplique o resultado ao seu repositório local a partir do terminal.
Ligar ferramentas externas com MCP
Adicione servidores MCP locais ou remotos, autentique-se quando necessário e inspecione as ferramentas disponíveis na sessão atual antes de o Codex as utilizar.
Definir os limites de cada execução
Escolha quando o Codex pode editar ficheiros ou executar comandos sem pedir autorização e inspecione o sandbox ativo e as raízes com permissão de escrita antes de continuar.
Adaptar o Codex ao seu terminal
Gere conclusões automáticas para a sua shell, escolha um tema de sintaxe e abra pedidos mais longos no editor configurado por VISUAL ou EDITOR.
Utilize a Codex CLI quando…
- Trabalha a partir do terminal
- Explore, edite e execute um repositório num único ciclo de trabalho focado.
- Precisa de scripting ou CI
- Execute um comando não interativo num fluxo de trabalho repetível.
- Pretende uma revisão de código local
- Inspecione as alterações antes de criar um commit ou abrir um pull request.
- Pretende transferir trabalho para a cloud
- Inicie uma conversa na cloud e regresse mais tarde ao terminal.