Memórias

Mantenha as orientações obrigatórias da equipe em AGENTS.md ou na documentação versionada no repositório. Use as memórias para recuperar informações úteis. Evite depender delas como única fonte de regras que devem ser seguidas sempre.

No aplicativo do ChatGPT para desktop, use /memories para escolher se um chat pode usar memórias locais ou contribuir para memórias futuras. Em Configurações > Personalização, use Ativar memórias do Codex para ativar ou desativar o recurso na máquina selecionada. Use Permitir memórias de chats que usam ferramentas para escolher se chats que usam ferramentas MCP ou pesquisa na Web podem contribuir para memórias futuras.

Para limpar as memórias armazenadas na máquina selecionada, selecione Excluir memórias do Codex e confirme. Na máquina local, essa ação também limpa o Histórico do computador quando o recurso está disponível.

Gerencie a memória do ChatGPT em Configurações > Personalização. O ChatGPT Work usa as configurações de memória disponíveis para sua conta e seu espaço de trabalho. Ele não usa o armazenamento nem os controles de memória locais do Codex.

Na CLI do Codex, use /memories em uma sessão interativa para definir se o chat atual pode usar memórias locais existentes ou servir de fonte para memórias futuras. Consulte Configurar memórias locais se o comando não estiver disponível.

A extensão para IDE usa as memórias armazenadas localmente no host do Codex ao qual está conectada. Quando as memórias estiverem ativadas nesse host, use os mesmos controles por chat disponíveis na CLI do Codex.

O Histórico do computador é um recurso do aplicativo para desktop no macOS. Ele usa a atividade nos aplicativos e sites permitidos para gerar memórias e uma linha do tempo que o ChatGPT e o Codex podem consultar.

Como funcionam as memórias locais do Codex

Depois que você ativa as memórias, o Codex pode aproveitar informações úteis de chats anteriores que atendem aos critérios para gerar arquivos de memória locais. O Codex ignora sessões ativas ou de curta duração, remove informações secretas dos campos de memória gerados e atualiza as memórias em segundo plano, em vez de atualizá-las assim que cada chat termina.

As memórias podem levar algum tempo para serem atualizadas após o fim de um chat. O Codex espera até que o chat fique inativo por tempo suficiente para evitar resumir um trabalho ainda em andamento.

O Codex também pode pular um ciclo de geração de memórias em segundo plano se o percentual restante do seu limite de taxa do Codex estiver abaixo do mínimo configurado. Assim, ele evita consumir sua cota quando você está perto de atingir o limite.

Armazenamento de memórias locais

O Codex armazena as memórias no diretório inicial do Codex. Por padrão, esse diretório é ~/.codex. Consulte Locais dos arquivos de configuração e de estado para saber como o Codex usa CODEX_HOME.

Quando você ativa as memórias em um diretório inicial do Codex recém-criado, a CLI usa $CODEX_HOME/memories_v2/ por padrão. Se o diretório $CODEX_HOME/memories/ já existir, a CLI continuará a usá-lo por padrão. Para escolher a versão explicitamente, defina memories.version. Se você não especificar a versão, a configuração memories.dual_write = false mantém até mesmo um perfil recém-criado na v1.

No aplicativo para desktop, verifique os dois diretórios, $CODEX_HOME/memories/ e $CODEX_HOME/memories_v2/, para encontrar os resumos gerados e os dados dos chats anteriores que serviram de base para esses resumos. Durante a migração, um novo chat local com as memórias ativadas pode ler dados de memories/ e gravar nos dois diretórios, mesmo em um perfil recém-criado.

Trate esses arquivos como dados de estado gerados pelo Codex. Você pode consultá-los ao investigar problemas ou antes de compartilhar o diretório inicial do Codex, mas evite usar a edição manual como principal forma de controlar as memórias.

Controlar as memórias locais por chat

No aplicativo do ChatGPT para desktop e na interface de terminal do Codex, use /memories para controlar como as memórias funcionam no chat atual. Você pode decidir se esse chat pode usar memórias existentes e se o Codex pode usá-lo para gerar memórias futuras.

As escolhas feitas para cada chat não alteram suas configurações globais de memória.

Revisar as memórias locais

Não armazene informações secretas nas memórias. O Codex remove essas informações dos campos de memória gerados, mas você ainda deve revisar os arquivos de memória antes de compartilhar o diretório inicial do Codex ou os artefatos de memória gerados.

Configurar memórias locais

As memórias locais do Codex vêm desativadas por padrão. No aplicativo do ChatGPT para desktop, abra Configurações > Personalização e habilite a opção Ativar memórias do Codex.

Para ativar o recurso pelo arquivo de configuração, adicione a seguinte opção ao config.toml:

[features]
memories = true

Para saber onde ficam os arquivos de configuração e consultar a lista completa de configurações de memória, veja Configuração básica e a referência de configuração.

Entre as configurações específicas de memória mais usadas estão:

• memories.generate_memories: define se chats recém-criados podem ser armazenados para uso na geração de memórias.
• memories.use_memories: define se o Codex inclui memórias existentes no contexto de sessões futuras.
• memories.disable_on_external_context: quando definida como true, exclui da geração de memórias os chats que usaram contexto externo, como chamadas a ferramentas MCP, pesquisa na Web ou busca de ferramentas. A chave antiga memories.no_memories_if_mcp_or_web_search ainda é aceita como nome alternativo.
• memories.min_rate_limit_remaining_percent: define o percentual mínimo do limite de taxa do Codex que ainda deve estar disponível para iniciar a geração de memórias.
• memories.extract_model: substitui o modelo usado para extrair memórias de cada chat.
• memories.consolidation_model: substitui o modelo usado na consolidação global das memórias.