Communitygithub.com

thenamangoyal/codex-vision

Claude Code 스킬: OpenAI Codex CLI로 이미지를 전송하고 이미지를 생성/편집합니다. 세 가지 모드와 선택적 tmux 세션으로 'codex exec -i'를 래핑합니다.

codex-vision란 무엇인가요?

이 스킬은 Claude Code가 OpenAI Codex CLI와 상호 작용하여 이미지 기반 작업을 수행할 수 있게 해줍니다. 'codex exec -i' 명령어를 래핑하여 이미지를 Codex CLI로 전송하거나, Codex CLI에서 이미지를 생성/편집할 수 있는 세 가지 작동 모드(전송, 생성, 편집)를 제공합니다. 개발자는 이 스킬을 통해 Claude Code의 텍스트 기반 인터페이스를 벗어나 Codex CLI의 비전 능력을 활용할 수 있습니다. 또한 선택적 tmux 세션을 지원하여 장기 실행 작업을 위한 백그라운드 프로세스 관리를 용이하게 합니다. 이 스킬은 Claude Code와 Codex CLI를 함께 사용하는 개발자 워크플로우를 단순화하고, 두 도구 간의 원활한 이미지 교환을 가능하게 합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add thenamangoyal/codex-vision

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

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

문서

codex-vision은(는) 무엇을 하나요?

Claude Code 스킬: OpenAI Codex CLI로 이미지를 전송하고 이미지를 생성/편집합니다. 세 가지 모드와 선택적 tmux 세션으로 codex exec -i를 래핑합니다.

작동 방식

이 스킬은 Claude Code가 OpenAI Codex CLI의 이미지 처리 기능에 접근할 수 있도록 합니다. codex exec -i 명령어를 기반으로 하여 프롬프트와 이미지를 Codex CLI에 전달할 수 있습니다. 세 가지 주요 모드가 있습니다:

  1. 전송 모드: 로컬 이미지를 Codex CLI로 보내 처리합니다.
  2. 생성 모드: 텍스트 설명을 기반으로 Codex CLI가 새 이미지를 생성하도록 합니다.
  3. 편집 모드: 기존 이미지를 수정하거나 편집합니다.

전제 조건

  • OpenAI Codex CLI가 설치되고 설정되어 있어야 합니다.
  • Claude Code가 Codex CLI 명령어를 실행할 수 있어야 합니다.
  • (선택 사항) tmux – 장기 실행 작업을 위해 권장됩니다.

설정

  1. 스킬 디렉토리로 이동합니다:
    cd ~/.claude/skills/thenamangoyal/codex-vision
    
  2. 필요에 따라 스킬 파일을 편집합니다.

사용법

Claude Code에서 다음 명령어를 사용합니다:

/codex-vision <모드> <이미지 경로/URL> [추가 인수]

예시

# 이미지 전송
/codex-vision send /path/to/image.png "이 이미지에서 텍스트를 추출해줘"

# 이미지 생성
/codex-vision generate "산 풍경의 사실적인 이미지를 생성해줘"

# 이미지 편집
/codex-vision edit /path/to/old_image.png "배경을 파란색으로 바꿔줘"

tmux 통합

--tmux 플래그를 사용하여 tmux 세션에서 명령어를 실행할 수 있습니다:

/codex-vision send image.png "설명해줘" --tmux

이렇게 하면 연결이 끊어져도 작업이 계속 실행됩니다.

문제 해결

  • Codex CLI를 찾을 수 없음: codex가 $PATH에 있는지 확인하거나 절대 경로를 사용하세요.
  • 이미지 너무 큼: 보내기 전에 이미지를 압축하세요.
  • tmux 세션이 응답 없음: tmux ls로 세션을 확인하고 tmux attach -t <이름>으로 연결하세요.

라이선스

이 스킬은 MIT 라이선스에 따라 배포됩니다.

관련 스킬