⚙️ A pasta .codex: configurações

A Paula abriu a pasta paula-escritorio no explorador de arquivos e não viu nenhum .codex. Não é que ele não exista: está escondido. Toda pasta cujo nome começa com ponto é oculta.

O ponto é uma convenção antiga: "isto é configuração, não mexa sem querer". Para ver, é só pedir ao sistema que mostre os itens ocultos. Nada muda nos arquivos; eles só aparecem.

Como ler o desenho: é a mesma pasta nas duas janelas. Só muda o olho no canto: fechado, a .codex some; aberto, ela aparece (meio transparente, como os sistemas costumam mostrar itens ocultos).

O que olhar na tabela: o atalho do seu sistema. Os nomes dos menus mudam um pouco entre versões, mas a opção sempre fala em "ocultos". O mesmo atalho esconde de novo.

Existem dois lugares para a .codex. No projeto (paula-escritorio/.codex/): configurações que valem só para aquele projeto, como agentes e fluxos próprios dele.

No usuário (~/.codex/): configurações globais, que valem para todos os projetos daquele computador. É como a diferença entre a regra de uma sala e a regra do prédio inteiro.

Como ler o desenho: o guarda-chuva azul é a configuração de usuário: cobre os três projetos. A caixinha ciano dentro do projeto da Paula vale só ali. Os projetos sem caixinha ficam apenas com o que vem do guarda-chuva.

O coração da configuração é o config.toml. O nome assusta, mas por dentro é uma lista de preferências, uma por linha: o nome da preferência, um sinal de igual e o valor escolhido.

O Rui abriu o dele num editor de texto comum e encontrou duas linhas. Em cinco minutos entendeu tudo: qual modelo ele usa por padrão e quanto esse modelo pensa.

Como ler o desenho: cada linha tem três partes. A seta da esquerda aponta a chave, a de cima o sinal de igual e a da direita o valor. Mudar a configuração é trocar o valor, nunca o nome da chave.

model = "gpt-6-astra"
model_reasoning_effort = "medium"

A ~/.codex é a gaveta pessoal do Codex no seu computador. Além do config.toml, ele guarda ali as memórias, o histórico das sessões, as automações e o seu login.

Quase tudo isso o próprio Codex escreve e lê. Você não precisa abrir, mas precisa saber que existe, porque essa pasta tem a sua conta dentro. Os nomes exatos dos arquivos internos podem mudar entre versões.

Como ler o desenho: cada gaveta guarda um tipo de coisa. As notas à direita dizem quem mexe: a de cima é sua, as do meio são do Codex e a de baixo, em vermelho, é a chave da sua conta.

O que olhar na tabela: a coluna da direita. Só a primeira linha é "sua" no dia a dia; o resto existe para o Codex funcionar.

Você quase não precisa editar nada à mão. O Codex sabe onde ficam os arquivos e consulta a própria documentação para escrever a configuração certa. Diga o que quer em português.

A Paula pediu: "deixe o esforço padrão em medium neste projeto". Antes, perguntou: "isso vai no .codex do projeto ou no global?". Essa segunda pergunta é a que evita surpresa em outro projeto.

Como ler o desenho: siga os números no sentido horário, a partir do topo. O arquivo no centro só muda no passo 5, depois que você viu a linha nova. Os passos 3 e 4 são a sua rede de segurança.

Quero que o esforço padrão seja medium só neste projeto, sem mudar os outros. Consulte a sua documentação, me diga em que arquivo isso fica (no .codex do projeto ou no global) e me mostre a linha exata que vai escrever. Só grave depois que eu aprovar.

O Rui quis ajudar um amigo e pensou em mandar a pasta ~/.codex inteira, "com a configuração pronta". Ainda bem que perguntou antes. Ali dentro está o login dele (auth.json), o histórico de conversas e as memórias sobre a loja.

Quem recebe essa pasta pode entrar na conta dele e ler o que ele conversou. A regra é simples: a pasta global não sai do seu computador. Para ajudar alguém, mande só as linhas do config.toml que interessam.

Como ler o desenho: o escudo é o seu computador protegendo a pasta global. A seta vermelha de cima (a pasta inteira saindo) está bloqueada. A seta verde de baixo é o jeito certo: copiar só as linhas de configuração, sem nada pessoal.