Community이미지github.com

matisiu09/codex-imagen

Codex (OpenAI)에 사진을 전달하여 새로운 이미지를 생성하거나 내장 생성기(gpt-image-2)로 사진을 수정/편집한 후 결과물을 폴더로 가져옵니다. 사용자가 'Codex에 전달해 줘', 'Codex로 생성해 줘', 'Codex가 이 사진을 수정하게 해 줘', '이 사진을 Codex/OpenAI/gpt-image로 편집해 줘', 'Codex로 사진에서 X를 제거해 줘'라고 말하거나 'Codex로 이 이미지를 생성/편집해 줘'라고 요청할 때 사용합니다. 비디오는 생성하지 않습니다.

codex-imagen란 무엇인가요?

이 스킬은 Anthropic의 Claude가 OpenAI의 Codex CLI(gpt-image-2 엔진 기반)를 호출하여 이미지 생성 및 편집을 수행할 수 있게 해줍니다. Codex는 사용자의 ChatGPT 플랜을 통해 실행되므로 별도의 API 키가 필요 없습니다. Claude는 사용자의 요청을 분석하여 적절한 Python 스크립트를 구성하고 실행한 후 결과 이미지를 검토합니다. 주요 기능으로는 기존 사진의 특정 요소를 수정하는 편집 모드(얼굴, 포즈, 구도, 색상 유지)와 참조 이미지를 스타일이나 주제 참고용으로 사용할 수 있는 생성 모드가 있습니다. 각 이미지 생성은 ChatGPT 플랜의 사용 한도를 차감하므로 사전에 사용자에게 알려야 하며, 타인의 사진을 업로드할 때는 개인정보 동의를 확인해야 합니다. 생성된 이미지는 원본을 덮어쓰지 않고 별도의 새 파일로 저장되며, 실패 시 로그 파일을 통해 원인(플랜 한도 초과, 콘텐츠 거절 등)을 진단할 수 있습니다. 비디오 생성은 지원하지 않습니다.

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

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Codex 이미지

Codex CLI(codex, npm install -g @openai/codex로 설치하고 사용자의 ChatGPT 계정으로 codex login하여 세션을 시작)는 내장 도구 image_gen(gpt-image-2)을 사용하여 이미지를 생성하고 편집합니다. 사용자의 ChatGPT 플랜을 사용하며 API 키는 필요하지 않습니다. Claude가 요청을 구성하고 스크립트를 실행한 후 결과를 검토합니다.

실행 전

  1. 사용자 확인: 어떤 사진, 어떤 변경 사항 또는 어떤 새 이미지, 몇 개의 변형, 저장 위치. 이미지 안에 표시되어야 하는 텍스트의 맞춤법을 확인합니다.
  2. 사용량 안내: 각 이미지는 ChatGPT 플랜의 사용 한도에서 차감됩니다. 요청하기 전에 요청할 이미지 수를 알려줍니다.
  3. 개인정보: 사진은 OpenAI에 업로드됩니다. 제3자(고객, 식별 가능한 인물)의 사진인 경우 업로드 가능 여부를 확인합니다.
  4. 입력 사진을 확인하여 올바른 사진인지 확인합니다.

실행

python ~/.claude/skills/codex-imagen/scripts/codex_imagen.py \
  --foto "경로/사진.jpg" \
  --pedido "바닥의 케이블을 제거하고 나머지는 그대로 두세요" \
  --modo editar --variantes 1 \
  --salida "출력/경로" --nombre foto_케이블_제거됨
  • --modo editar: 요청된 부분만 변경하고 얼굴, 포즈, 구도, 색상을 유지합니다. 사진이 있으면 기본 모드입니다.
  • --modo generar: 새 이미지 생성; 사진(선택 사항)은 스타일이나 주제 참고용입니다.
  • --foto는 반복 가능합니다. 첫 번째 사진이 편집 대상이고 나머지는 참고용입니다.
  • --variantes N: N개의 이미지, 각각 한 번씩 호출합니다.
  • 각 이미지 생성에는 30초에서 몇 분이 소요됩니다(timeout 900초; 배치의 경우 --timeout으로 늘립니다).
  • 출력: <이름>_v1.png, _v2…, <이름>_respuesta.txt(Codex의 응답) 및 <이름>_log.txt. 스크립트는 경로가 포함된 JSON을 출력합니다.

Codex는 읽기 전용 샌드박스에서 실행되므로 프로젝트 파일을 건드리지 않습니다. 이 스크립트는 ~/.codex/generated_images/에서 새 이미지를 복사합니다.

실행 후

  • 각 결과 확인: 변경 사항이 적용되었는지, 얼굴, 손, 제품, 텍스트가 변형되지 않았는지 확인합니다. 실패 시 회당 한 가지씩 구체적으로 수정합니다.
  • 사용자에게 사용된 요청과 함께 이미지를 보여줍니다.
  • 원본을 덮어쓰지 않습니다. 결과물은 항상 새 이름으로 저장됩니다.

비디오

Codex는 비디오를 생성하지 않습니다. AI 비디오를 위해서는 다른 서비스(예: OpenAI API를 통한 Sora, 별도의 키와 비용 필요)가 필요합니다. 사용자에게 문의하세요.

실패 시

  • codex: command not found → npm install -g @openai/codex.
  • 세션 없음 → 사용자가 터미널에서 codex login을 실행하도록 합니다(Claude는 비밀번호를 입력하지 않습니다).
  • 이미지 반환 안 됨 → <이름>_log.txt 읽기: 플랜 사용 한도 초과 또는 콘텐츠 거절일 수 있습니다. codex features list 확인(image_generation이 true여야 합니다).

관련 스킬