Instalação do Codex e a chave que não pode vazar

Perguntas frequentes

O que preciso ter instalado antes do Codex?

Três peças. A primeira é o sistema — Windows, macOS ou Linux, qualquer máquina de trabalho serve. A segunda é o Git, baixado em git-scm.com, com as opções padrão: é o histórico de versões de uma pasta inteira, e sem ele uma alteração ruim é irreversível. A terceira é o Node.js, baixado em nodejs.org, sempre a versão LTS. As duas últimas são onde as pessoas erram. Antes da rota técnica, vale conferir a documentação oficial: se houver um instalador pronto para o seu sistema, ele é o caminho mais curto e o resultado é o mesmo.

Assinatura do ChatGPT ou chave de API?

São dois caminhos de identificação, e a diferença prática está no bolso. Pela conta ChatGPT, o uso é coberto pela assinatura, dentro do plano. Pela chave de API, é cobrado por consumo, na conta de desenvolvedor. Na dúvida, use a assinatura. O login abre o navegador numa página oficial da OpenAI — a senha é digitada no site oficial, nunca dentro do terminal — e, feito o login, o terminal reassume já reconhecendo você.

Onde a chave de API não pode ficar?

Em quatro lugares, que são por onde as chaves vazam de verdade: arquivo público (qualquer arquivo que possa sair da sua mão), prompt, print com a chave visível — print com a chave visível é chave vazada — e repositório público, que é varrido por robôs o dia inteiro. A chave mora fora do projeto: numa variável de ambiente, que é o cofre do próprio sistema operacional, onde o programa a lê por um apelido e ela não fica em arquivo, ou num cofre de segredos, com controle de acesso e registro. A regra mental é que uma chave de API é a chave da sua casa, não o seu endereço.