Escolha o ambiente de trabalho
O Codex CLI é o cliente de terminal da OpenAI para consultar código, editar arquivos e executar ferramentas no ambiente do projeto. No Windows 11, convém decidir primeiro se o trabalho será feito no PowerShell nativo ou em uma distribuição Linux pelo WSL. Essa escolha determina onde estarão os programas e arquivos usados. A documentação do Windows descreve o sandbox nativo; portanto, instalar WSL não é uma exigência geral para usar o cliente.
- Ambiente de execução: Terminal, programas e pasta de trabalho precisam corresponder ao projeto escolhido.
Para seguir a rota com npm, confira se Node.js e o gerenciador estão disponíveis no terminal escolhido. Os comandos node --version e npm --version ajudam a identificar esse ambiente. Se algum deles não for reconhecido, resolva primeiro a instalação ou a localização do programa. Não suponha que o que está instalado no Windows também esteja disponível dentro do Linux do WSL, nem altere controles do computador apenas para fazer desaparecer uma mensagem de erro.
A instrução oficial de instalação inclui npm install -g @openai/codex. Confira a grafia completa do pacote e execute o comando no ambiente escolhido. O mesmo comando aparece como opção de atualização. A documentação também oferece outros instaladores; este guia se concentra no npm para quem já utiliza esse gerenciador. Instalar o cliente não configura automaticamente as dependências de cada projeto nem define a conta que será usada.
Da instalação à primeira revisão
Com o pacote instalado, abra a pasta do projeto e execute codex. O primeiro acesso oferece as formas de entrada disponíveis. Segundo a referência de autenticação, o uso de modelos OpenAI admite login com ChatGPT ou chave de API. A chave gera consumo cobrado pela plataforma de API, em vez de utilizar os créditos incluídos no plano ChatGPT. Antes de continuar, confirme a conta, a modalidade de acesso e as regras da organização. O login com ChatGPT abre um fluxo no navegador. Senhas e chaves não devem ser colocadas no código, em comentários ou em pedidos ao agente; mantenha-as fora dos arquivos compartilhados com outras pessoas, inclusive em repositórios privados.
Autenticação identifica a conta; as permissões delimitam as ações no computador. A documentação de segurança distingue o sandbox, que restringe tecnicamente arquivos e rede, da política de aprovação, que determina quando uma ação exige confirmação. Essas camadas funcionam juntas. Pedir cautela em uma mensagem ajuda a definir a tarefa, mas não substitui a conferência dos controles ativos antes de permitir alterações.
- Conta e cobrança claras: O acesso por chave de API tem cobrança própria e não consome créditos do plano ChatGPT.
- Permissões sob controle: Confira o alcance de arquivos e rede antes de aceitar ações que ampliem o acesso.
- Resultado com evidência: Leia as diferenças e registre quais testes foram executados e quais seguem pendentes.
Na sessão, consulte /status para ver a configuração e /permissions para examinar ou escolher o alcance permitido, conforme a interface documentada do CLI. Confira a pasta e as áreas graváveis. Se surgir um pedido de acesso adicional, leia o comando, o destino e a justificativa antes de decidir. Uma falha de execução pode indicar dependência ausente ou restrição legítima; ampliar acesso não deve ser a resposta automática.
Como primeira tarefa, peça uma explicação da estrutura do projeto e indique que deseja apenas leitura. Depois, escolha uma correção pequena: descreva o comportamento observado, o resultado esperado e os arquivos envolvidos. Essa é uma recomendação de organização do trabalho, não uma garantia de acerto do modelo. Compare a proposta com o objetivo original e interrompa mudanças que escapem do escopo. Se houver uma dúvida de requisito, resolva-a antes de aceitar uma solução ampla.
Antes de editar, preserve um estado recuperável dos arquivos, por meio do controle de versão ou de uma cópia adequada. Depois, leia as diferenças e execute os testes pertinentes à mudança. Um teste não executado deve continuar identificado como pendente, mesmo que o agente anuncie a conclusão da tarefa. Reúna o que mudou, o que foi verificado e o que falta confirmar antes de incorporar o resultado ao projeto. O ponto de partida é simples: ambiente identificado, pacote correto, conta conferida e permissões compreendidas. A qualidade do trabalho depende também da revisão humana e da capacidade de reproduzir o comportamento esperado, sem tratar a resposta como prova de funcionamento.
Veja Mais
- Ctrl+Shift+H: substitua texto no VS Code
- Arquivos no Windows: confira antes de abrir
- Revo Uninstaller: revise antes de apagar
