clodex

Clodex é um lançador local e de código aberto que executa o Claude Code como o harness de codificação interativo enquanto encaminha as solicitações de modelo para o Codex na sua conta ChatGPT. Ele mantém a interface, os agentes, as ferramentas, as permissões e os fluxos de trabalho do Claude Code; apenas o transporte de modelo e os aliases de modelo mudam para o processo iniciado. Qualquer função também pode executar um modelo Claude real na sua própria assinatura Claude. Ele não precisa de chave de API da OpenAI, nem do Codex CLI, nem de proxy externo: faça login uma vez com `clodex auth login`. Um login existente do Codex CLI é reutilizado quando você tem um. Sessões normais do `claude` não são afetadas. Principais recursos: - Mantenha a experiência de terminal, subagentes, uso de ferramentas e controles de permissão do Claude Code. - Use modelos que sua conta ChatGPT pode acessar no Codex sem codificar nomes de modelos, e misture modelos Claude na sua assinatura Claude. - Escolha qualquer modelo em `/model`, e atribua a subagentes um modelo de qualquer um dos provedores. - Execute tudo localmente em um único binário autocontido, atrás de uma ponte apenas em loopback. - Deixe sessões normais do Claude Code e configurações globais de modelo intactas. - Compartilhe um backend supervisionado com segurança entre sessões Clodex simultâneas. Requisitos: macOS ou Linux, uma conta ChatGPT com acesso ao Codex e o Claude Code. Opcionalmente, `claude-code-proxy` se você mudar do backend Codex integrado para o externo. O Clodex depende de sockets de domínio Unix e não oferece suporte ao Windows nativo. Instalação: baixe o arquivo para sua plataforma na versão mais recente, extraia e instale em `~/.local/bin/clodex`. Para compilar a partir do código-fonte, instale Rust 1.88+ e execute `./scripts/install.sh`. Adicione `--install-proxy` para também instalar o `claude-code-proxy` com Homebrew. Início rápido: ```sh clodex auth login # faça login no Codex com sua conta ChatGPT clodex doctor clodex ``` `clodex auth login` abre um navegador; use `--device` para SSH ou máquinas headless. Se você já usa o Codex CLI, pode pular o login. Execute `clodex` de qualquer diretório de projeto. Argumentos que não são comandos de gerenciamento do Clodex são passados diretamente ao Claude Code: ```sh clodex --resume clodex -p "summarize this repository" clodex -- --resume ``` O Clodex mostra um banner de inicialização roxo, altera o título do terminal e seleciona um tema Claude roxo exclusivo do Clodex. Os comandos incluem: `clodex auth login/logout/status/sync`, `clodex models [list]`, `clodex models map`, `clodex config [show]`, `clodex config context <auto|tokens>`, `clodex config compact-at <1..95>`, `clodex config backend <builtin|proxy>`, `clodex config hierarchical-compaction <on|off>`, `clodex config route <role> <claude-model|codex>`, `clodex config allow-tool <exact-name>`, `clodex config forget-tool <exact-name>`, `clodex config path`, `clodex context` e `clodex doctor`. Roteamento de modelo: a cada inicialização, o Clodex lê o catálogo de modelos Codex da sua conta, remove entradas ocultas ou sem suporte de API e mapeia a prioridade do catálogo para as funções do Claude Code. O catálogo é armazenado em cache por cinco minutos. A sessão iniciada usa a rota Opus por padrão; Fable e Sonnet permanecem disponíveis no seletor de modelos. Haiku fica oculto, mas é suportado pela rota Sonnet. Nenhum nome de modelo é codificado, então o mapeamento segue o catálogo Codex ativo. Modelos Claude na sua assinatura Claude: qualquer função pode usar um modelo Claude real em vez de seu modelo Codex. Solicitações roteadas para Claude reutilizam o login de assinatura do próprio Claude Code e contam contra os limites de uso do seu plano Claude. O Clodex nunca lê, copia ou armazena a credencial Claude. Os modelos roteados aparecem para o Claude Code como `anthropic/<model>`. Todos os modelos em `/model` e em subagentes: cada inicialização lista todos os modelos Codex roteáveis no seletor `/model` do Claude Code, além dos modelos Claude atuais quando existe um login de assinatura. O Clodex grava a lista no cache de descoberta de modelos do Claude Code e passa linhas curadas de `modelPicker`. O parâmetro `model` da ferramenta Agent aceita os quatro aliases de função, e o Clodex passa uma definição `--agents` por modelo listado. Modo rápido: inicie com `clodex --fast` para manter os modelos Codex suportados no nível de serviço prioritário durante toda a sessão, incluindo subagentes e compactação. As rotas Claude são executadas em velocidade normal. `/fast on` e `/fast off` alternam o nível prioritário interativamente para o modelo selecionado. Contexto e compactação: a configuração padrão `auto` resolve para a maior capacidade que cada modelo roteado realmente aceitará. Valores explícitos são respeitados até o teto e limitados acima dele. O Clodex também executa o backend Codex com compactação do lado do servidor habilitada. Compactação hierárquica (opcional): substitui uma única solicitação de compactação grande demais por uma dobra cujas rodadas cabem por construção. O número de rodadas segue o tamanho da conversa. Desativada por padrão porque cada rodada custa uma chamada de modelo. Esforço de raciocínio: o roteamento de modelo e o esforço de raciocínio são independentes. Use o controle `/effort` do Claude Code ou a opção `--effort`. Ferramentas confiáveis: o Clodex pode fornecer uma regra de permissão exata por inicialização para a sessão principal e todos os subagentes via `clodex config allow-tool <exact-name>`. Backend Codex integrado: traduz as solicitações do Claude Code para o próprio Codex, sem proxy externo instalado. Este é o padrão. O proxy externo permanece disponível via `clodex config backend proxy`. Ciclo de vida do proxy compartilhado: a primeira sessão ativa inicia um supervisor e um proxy apenas em loopback em uma porta efêmera disponível. A inicialização simultânea é serializada com um bloqueio de arquivo exclusivo. A sessão que iniciou o supervisor não tem propriedade especial; o proxy permanece ativo enquanto qualquer concessão permanecer. Um segundo após a última concessão desaparecer, o supervisor para o proxy e limpa tudo. Credenciais e arquivos locais: o Clodex usa seu próprio login de `clodex auth login` quando existe um; caso contrário, reutiliza o `~/.codex/auth.json` do Codex CLI quando autenticado no modo `chatgpt`. O login próprio do Clodex é armazenado em `~/.clodex/auth/codex.json` com modo `0600` em um diretório `0700`. Arquivos persistentes e de tempo de execução usam `~/.clodex/` por padrão, com subdiretórios config, auth, cache, logs e run. Defina `CLODEX_HOME` para mover todo esse diretório. Solução de problemas: comece com `clodex doctor`, `clodex auth status`, `clodex auth sync` e `clodex context`. Problemas comuns incluem respostas interrompidas do Codex upstream (tente novamente após a conectividade se recuperar, ou tente `clodex config transport websocket`), falhas de upgrade WebSocket 403 (atualize o Clodex, defina o transporte como http, reinicie as sessões) e 413 request_too_large (compare a capacidade de contexto com o teto roteado; atualize o Clodex e inicie uma nova sessão). O Clodex é um projeto comunitário independente, não afiliado, endossado ou suportado pela Anthropic ou OpenAI. É licenciado sob MIT.