WatchUm limite de uso restringe quanto o Claude pode ser usado em uma janela de tempo, enquanto os limites da janela de contexto restringem a capacidade de uma única conversa. Se a janela de contexto está apenas cheia, use /compact ou /clear dentro do Claude Code. Se você atingiu um limite de uso da conta e precisa trocar de agente, o Watch transfere o histórico local salvo da sessão para o Codex. O Watch não contorna limites nem altera arquivos locais do repositório.
Em tarefas longas de engenharia, o Claude Code pode informar que você atingiu o limite do plano, junto com um horário de redefinição. O raciocínio, as iterações que falharam e as saídas de comandos acumuladas até ali permanecem no disco. O Watch liga essa sessão salva ao OpenAI Codex, permitindo que a nova ferramenta inspecione o contexto anterior sem exigir que você resuma a investigação manualmente.
Passo 1: Verificar o ID da sessão de origem e o diretório de trabalho
Localize o ID da sessão ativa do Claude Code. O histórico fica em ~/.claude/projects/<encoded-cwd>/<session-id>.jsonl. Garanta que o caminho do diretório (cwd) corresponda ao workspace real do projeto para evitar desalinhamentos entre a worktree e o repositório.
Passo 2: Garantir que o projeto de destino exista no Codex Desktop
Pelos requisitos oficiais de importação de agentes externos, o workspace de destino já precisa estar registrado no Codex Desktop. Abra a pasta no Codex Desktop antes, para estabelecer a confiança local e o reconhecimento do projeto.
Passo 3: Preparar o plano de importação (Prepare)
No Watch Desktop, selecione a sessão de origem e clique em OpenAI Codex, ou execute o comando de CLI prepare. Esta etapa faz verificações somente leitura, confere o estado do bloqueio e cria um diário de execução sem modificar os arquivos de destino.
Passo 4: Confirmar a importação e revisar itens degradados (Confirm)
Revise a contagem de mensagens da prévia, o diretório de trabalho e os rastros de chamadas de ferramenta. Confirme explicitamente para iniciar a transferência pelo protocolo local de importação do app-server do Codex. Observe que eventos de chamada de ferramenta podem se degradar em representações de texto.
Passo 5: Iniciar o cliente de destino de forma independente (Open)
Depois de confirmar, abra o Codex Desktop pela interface do app ou pelo comando de retomada. Importação e abertura são estritamente separadas: se a inicialização falhar, tente abrir de novo apenas, sem repetir a fase de importação.
# 1. Preparar o plano de importação (sondagem somente leitura e geração do plano)
npm run watch -- import-codex prepare <claude-id> --cwd /abs/project/path --desktop-project --experimental --json
# 2. Confirmar e executar a importação (usando o planId da saída de prepare)
npm run watch -- import-codex confirm <plan-id> --json
# 3. Verificar o status da execução (sondagem somente leitura se for interrompida)
npm run watch -- import-codex status <plan-id> --json1. Sem garantia de ausência de perdas: estruturas de chamadas de ferramenta se degradam em texto simples no Codex, e a continuação do modelo está fora do escopo da validação limitada. 2. Pare em estado incerto: se o processo for interrompido ou expirar, o bloqueio é mantido. Inspecione com o comando status em vez de excluir bloqueios à força ou reenviar. 3. Conversão local não é totalmente offline: embora o Watch opere sem servidores externos, o Codex invoca o próprio daemon app-server e se autentica com o provedor de modelo upstream.