Perfis do Codex

Visão Geral

Use codex-profiles quando um usuário quiser contextos separados do Codex CLI ou Codex Desktop para atividades de trabalho, pessoais, escolares, de clientes ou específicas de projetos. A ferramenta encapsula o suporte CODEX_HOME do Codex para que cada perfil tenha seu próprio diretório inicial do Codex para autenticação, configuração, sessões, conectores, plugins, caches, logs e estado local.

Esta funcionalidade é para seleção de perfil e segurança operacional em torno dessa fronteira. Não é um projeto oficial da OpenAI e não fornece isolamento completo em nível de sistema operacional.

Quando Usar Esta Funcionalidade

• Use quando o usuário quiser manter várias contas do Codex ou contextos de projeto separados em uma única máquina.
• Use quando um fluxo de trabalho precisar de um CODEX_HOME diferente sem exportar manualmente variáveis de ambiente.
• Use ao diagnosticar qual perfil do Codex está ativo ou se os perfis estão logados.
• Use quando o usuário perguntar sobre troca de conta do Codex sem copiar auth.json.
• Use ao iniciar o Codex Desktop a partir de um perfil, somente após confirmar que o usuário aceita interrupções de aplicativo/processo.

Como Funciona

Etapa 1: Confirmar Escopo e Instalação

Primeiro, verifique se o usuário deseja alternar perfis apenas para CLI ou iniciar o Codex Desktop. Operações de desktop podem encerrar, iniciar, clonar ou reconstruir instâncias de aplicativos, portanto, obtenha aprovação explícita antes de executá-las.

Se a ferramenta já estiver instalada, inspecione a superfície de comando ativa:

codex-profile --help
codex-profile doctor
codex-profile list
codex-profile status

Se não estiver instalada, prefira instalações via gerenciador de pacotes que o usuário possa inspecionar e controlar:

npm install -g codex-profile
brew install Ducksss/tap/codex-profile

Não execute scripts de instalação remota automaticamente. Se o usuário solicitar uma instalação a partir do código-fonte, clone o repositório e inspecione suas instruções de instalação primeiro.

Etapa 2: Criar ou Selecionar um Perfil

Crie um novo diretório inicial isolado do Codex apenas quando o usuário nomear o perfil pretendido:

codex-profile init work
codex-profile path work

Peça ao usuário para fazer login uma vez por perfil, quando necessário:

codex-profile login work

Não copie, analise, imprima ou migre tokens auth.json entre perfis.

Etapa 3: Executar o Codex CLI com um Perfil

Use o wrapper de perfil da CLI para trabalho normal do agente:

codex-profile cli work
codex-profile cli work exec "run tests and summarize failures"

Para sessões de shell únicas, prefira os comandos de ativação de ambiente ou shell da ferramenta após verificar --help:

codex-profile env work
codex-profile shell-init --help

Etapa 4: Usar Comandos do Perfil do Desktop com Cuidado

Fluxos de inicialização do Codex Desktop podem afetar o estado do aplicativo em execução. Antes de executá-los, declare qual perfil, modo de aplicativo e espaço de trabalho serão usados e, em seguida, aguarde a aprovação.

codex-profile app work ~/Dev/project
codex-profile app work --instance ~/Dev/project

Use --instance apenas quando o usuário desejar perfis de Desktop lado a lado e aceitar o clone adicional do aplicativo local e a fronteira separada de dados do usuário do Electron.

Exemplos

Exemplo 1: Auditoria de Perfil Somente Leitura

codex-profile list
codex-profile status
codex-profile doctor

Use isso antes de alterar o estado do perfil. Não deve expor o conteúdo dos tokens.

Exemplo 2: Tarefa CLI em um Perfil de Trabalho

codex-profile cli work exec "inspect this repository and run its test suite"

Confirme se o nome do perfil é intencional antes de executar tarefas longas.

Exemplo 3: Equivalente Manual de CODEX_HOME

Se o wrapper não estiver disponível, explique a fronteira subjacente em vez de improvisar a movimentação de tokens:

CODEX_HOME="$HOME/.codex-work" codex
CODEX_HOME="$HOME/.codex-work" codex exec "review this change"

Melhores Práticas

• Mantenha os nomes dos perfis explícitos e simples, como work, personal, client-a ou school.
• Use status, list e doctor antes de ações destrutivas ou de Desktop.
• Trate cada perfil como um diretório inicial separado do Codex local, não como um sandbox completo.
• Mantenha segredos dentro da conta/perfil que os possui; não copie arquivos de autenticação entre perfis.
• Prefira comandos de perfil CLI para trabalho rotineiro e reserve comandos de aplicativo de Desktop para trocas de contexto aprovadas pelo usuário.
• Verifique o comportamento em relação ao codex-profile --help instalado, pois as flags de comando podem mudar.

Limitações

• codex-profiles é mantido pela comunidade e não é uma ferramenta oficial da OpenAI.

…