☁️ Ambientes

Local é o que existe só no computador que você está usando, como um arquivo no seu disco.

Saber o que é local explica por que algumas coisas só funcionam com o computador ligado.

Local, disco, máquina ligada.

localhost é o endereço que aponta para o próprio computador. O Codex costuma servir páginas de teste assim.

Você vai ver esse endereço o tempo todo e precisa saber o que ele significa.

localhost, 127.0.0.1, porta, página de teste.

Local mexe nos seus arquivos e deixa escolher modelo e permissão; na nuvem roda num ambiente isolado da OpenAI.

Cada uma serve a um tipo de trabalho; escolher errado trava a tarefa ou expõe o que não devia.

Tarefa local, tarefa na nuvem, ambiente isolado.

Pelo app do ChatGPT no celular você vê e continua as conversas do Codex que estão no computador.

Com a máquina ligada, o trabalho segue com você fora do escritório.

Acesso remoto, app do ChatGPT, continuar conversa.

Um critério para decidir entre local e nuvem conforme os arquivos, o risco e onde você vai estar.

Decidir rápido evita refazer a tarefa no lugar certo depois.

Critério de escolha, arquivos, risco.

Mandar um link localhost para alguém não funciona: no computador da pessoa, localhost é o computador dela.

É o erro mais comum de quem começa; para outros abrirem, é preciso publicar.

Link local, compartilhar, publicar.

Mudança grande feita direto no projeto original pode estragar o que estava funcionando.

Entender o risco mostra por que vale ter um lugar separado para testar.

Original, mudança arriscada, desfazer.

Worktree é uma cópia de trabalho paralela do projeto, criada pelo Git, onde você testa sem tocar no original.

Dá liberdade para experimentar sabendo que o original fica intacto.

Worktree, Git, cópia paralela.

Branch é uma linha paralela de mudanças; main é a linha principal do projeto.

Esses nomes aparecem na interface e assustam quem não sabe o que significam.

Branch, main, histórico de versões.

Escolher a opção de trabalhar numa nova worktree no app, ou abrir com codex --worktree no terminal.

É um clique ou um comando: o Codex cuida da parte técnica.

Nova worktree, codex --worktree, sessão paralela.

Quando o teste deu certo, juntar as mudanças ao projeto principal; quando deu errado, descartar a cópia.

A worktree só vale a pena se você souber fechar o ciclo.

Merge, juntar, descartar.

Para trabalho de escritório quase nunca precisa; o Codex às vezes cria worktrees sozinho.

Evita complicar o simples e evita susto quando aparecer "main" na tela.

Quando usar, software com equipe, worktree automática.

Pasta com ponto no começo do nome fica oculta; é preciso mandar o sistema mostrar arquivos ocultos.

Sem isso você não acha as configurações nem entende de onde vem um comportamento.

Pasta oculta, ponto no nome, mostrar ocultos.

O .codex dentro do projeto vale só ali; o ~/.codex na sua pasta de usuário vale para todos os projetos.

É a ideia mais importante da trilha e reaparece nas skills.

Projeto, usuário, global, escopo.

O config.toml é um arquivo de texto com linhas de chave e valor, como model e model_reasoning_effort.

Ler a configuração tira o mistério de por que o Codex age de certo jeito.

config.toml, chave, valor, modelo padrão.

O ~/.codex guarda config.toml, memórias, histórico de sessões, automações e o login.

Saber o que tem lá mostra o que é seu e o que não pode ser compartilhado.

Pasta global, memórias, sessões, auth.json.

Pedir em português: "deixe o esforço padrão em medium neste projeto" ou "isso vai no projeto ou no global?".

Ele consulta a própria documentação e erra menos do que uma edição manual.

Pedido em linguagem natural, ajuste, documentação.

Não copiar, enviar nem publicar a pasta de usuário do Codex, que tem login e histórico.

Quem tem esses arquivos tem acesso à sua conta.

Segurança, login, histórico, dados pessoais.