CommunityImagemgithub.com

matisiu09/codex-imagen

Envia fotos ao Codex (OpenAI) para gerar novas imagens ou corrigir/editar fotos com seu gerador integrado (gpt-image-2) e traz os resultados para uma pasta. Use quando o usuário disser 'passe isto para o Codex', 'gere com Codex', 'que o Codex corrija esta foto', 'edite esta foto com Codex / com OpenAI / com gpt-image', 'remova X da foto com Codex', ou peça imagens 'com o gerador do Codex'. Também dispara em 'generate/edit this image with Codex'. Não faz vídeo.

O que é codex-imagen?

Esta skill integra o Claude com o Codex CLI da OpenAI para geração e edição de imagens usando a ferramenta integrada `image_gen` (gpt-image-2). Ela permite que usuários solicitem a criação de novas imagens ou a edição de fotos existentes (como remover objetos, corrigir detalhes) diretamente através de comandos em linguagem natural. A skill suporta múltiplas variantes, modos de edição (editar/generar) e lida com todo o fluxo: confirmação com o usuário, execução do script Python que chama o Codex, e revisão dos resultados. É especialmente útil para desenvolvedores e designers que desejam automatizar tarefas de manipulação de imagens sem sair do terminal ou do ambiente de desenvolvimento. Importante: cada imagem consome créditos do plano ChatGPT do usuário, e a skill não gera vídeos.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/matisiu09/codex-imagen-skill/tree/HEAD/codex-imagen

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Codex imagem

Codex CLI (codex, instalado com npm install -g @openai/codex e com sessão iniciada com codex login usando a conta ChatGPT do usuário) gera e edita imagens com sua ferramenta integrada image_gen (gpt-image-2). Usa o plano ChatGPT do usuário, não uma chave de API. Claude monta o pedido, executa o script e revisa os resultados.

Antes de enviar

  1. Confirmar com o usuário: quais fotos, qual alteração ou qual imagem nova, quantas variantes e onde serão salvas. Revisar a ortografia de qualquer texto que precise aparecer dentro da imagem.
  2. Avisar o consumo: cada imagem desconta do limite de uso do plano ChatGPT. Dizer quantas imagens serão solicitadas antes de enviá-las.
  3. Privacidade: as fotos são enviadas para a OpenAI. Com fotos de terceiros (clientes, pessoas identificáveis), confirmar que podem ser enviadas.
  4. Olhar as fotos de entrada para confirmar que são as corretas.

Executar

python ~/.claude/skills/codex-imagen/scripts/codex_imagen.py \
  --foto "caminho/foto.jpg" \
  --pedido "Remova o cabo do chão e mantenha todo o resto igual" \
  --modo editar --variantes 1 \
  --saida "caminho/de/saida" --nome foto_sem_cabo
  • --modo editar: altera apenas o solicitado e preserva rostos, pose, enquadramento e cor. É o modo padrão se houver fotos.
  • --modo gerar: imagem nova; as fotos (opcionais) são referência de estilo ou tema.
  • --foto pode ser repetido. A primeira é a que será editada; as demais são de apoio.
  • --variantes N: N imagens, uma chamada para cada uma.
  • Cada imagem leva entre 30 segundos e alguns minutos (timeout 900 s; aumente com --timeout para lotes).
  • Saída: <nome>_v1.png, _v2…, <nome>_resposta.txt (o que o Codex respondeu) e <nome>_log.txt. O script imprime um JSON com os caminhos.

Codex executa com sandbox somente leitura: não toca nos arquivos do projeto. O script copia as imagens novas de ~/.codex/generated_images/.

Depois

  • Verificar cada resultado: se a alteração foi feita e se não deformou rostos, mãos, produtos nem texto. Se falhar, uma correção pontual por vez.
  • Mostrar ao usuário as imagens junto com o pedido utilizado.
  • Não sobrescrever originais: os resultados sempre terão nome novo.

Vídeo

Codex não gera vídeo. Para vídeo com IA é necessário outro serviço (por exemplo Sora pela API da OpenAI, com chave e custo separados); perguntar ao usuário.

Se falhar

  • codex: command not found → npm install -g @openai/codex.
  • Sem sessão → que o usuário execute codex login no terminal dele (Claude não insere senhas).
  • Não retorna imagens → ler <nome>_log.txt: pode ser o limite de uso do plano ou uma rejeição de conteúdo. Verificar codex features list (image_generation precisa estar como true).

Habilidades Relacionadas