Codex CLI에는 gpt-image-2 기반의 이미지 생성이 공식 스킬(imagegen)로서 내장되어 있어, API 키 없이 ChatGPT 계정 로그인만으로 사용할 수 있습니다. 하지만 그대로 사용하면 저장 위치나 파일명을 매번 임의로 결정해 버리기 때문에, 워크플로우(Workflow)에組み込む에는 동작이 불안정합니다. 이 기사에서는 래퍼 스크립트(Wrapper Script) + Claude Code의 스킬화(Skillification)를 통해 "한 마디만 부탁하면 생성부터 사이트 반영까지 끝나는" 상태로 만든 구성을 소개합니다.

웹사이트 제작 중에 이미지가 필요할 때마다, 기존에는 이 5가지 공정이 끼어들었습니다.

• 이미지 생성 AI 사이트를 연다
• 프롬프트(Prompt)를 생각해서 입력한다
• 생성된 이미지를 다운로드한다
• 파일명을 정리하여 프로젝트로 이동한다
• 코드에 이미지 경로를 작성한다

스킬화하면, Claude Code에 "신뢰감 있는, 바다와 배의 이미지의 이미지를 만들어 둬"라고 말하는 것만으로, 프롬프트 구성 → 생성 → 명명 규칙에 따른 저장 → 코드 반영까지 단 한 번의 의뢰로 흐릅니다. 도구의 단순한 추가가 아니라 워크플로우의 통합이 본질입니다.

Claude Code
└─ SKILL.md (절차서) … 의뢰문 → 영어 프롬프트 변환, 명명 규칙, 스크립트 호출 단계
└─ 래퍼 스크립트 (shell) … Codex CLI의 이미지 생성을 정해진 인수로 호출하여 지정된 경로에 저장

Codex CLI의 이미지 생성을 "프롬프트", "출력 경로"를 인수로 받는 작은 셸 스크립트(Shell Script)로 감쌉니다. 포인트는 추가 결제가 필요 없다는 점입니다. 통상적으로 프로그램에서 이미지 생성 AI를 사용하려면 API 키 발급과 종량제 결제 설정이 필요하지만, Codex는 ChatGPT 계정 로그인 방식을 지원하며 이용분은 기존 ChatGPT 플랜 범위 내에 포함됩니다.

Claude Code의 스킬은 Markdown 절차서를 디렉토리에 두기만 하면, 의뢰 내용에 따라 AI가 스스로 선택하여 실행해 주는 메커니즘입니다.

---
name: image-gen-codex
description: 이미지를 생성한다. "이미지를 만들어 줘", "썸네일을 만들어 줘" 등의 의뢰 시 사용.
...

SKILL.md는 YAML frontmatter를 반드시 파일의 맨 앞에 두어야 합니다. frontmatter보다 앞에 H1 헤더 등을 작성하면 frontmatter가 해석되지 않아, description (스킬 발동 조건의 힌트)이 작동하지 않게 됩니다. 저는 이 문제로 한 번 "스킬이 호출되지 않는" 시행착오를 겪었습니다. description에는 기능 설명뿐만 아니라 "어떤 말로 부탁했을 때 사용할 것인가"라는 발동 키워드까지 적는 것이 요령입니다.

이 구성의 흥미로운 점은 Claude Code (Anthropic)에서 Codex (OpenAI)의 기능을 호출하고 있다는 점입니다. 이미지 생성은 Codex만이 가진 강점이므로 그 부분만 파트너로 빌려 쓰는 것입니다. 반대로 리뷰를 Codex 측에 던져 별도의 계통 AI에게 체크하게 하는 방식으로도 사용할 수 있습니다. 한 회사의 에코시스템(Ecosystem)에 갇히지 않고, 특기 분야별로 조합하는 것이 실무에서는 더 강력하다는 것이 운용하며 느낀 실감입니다.

• Codex CLI의 이미지 생성은 API 키가 불필요 (ChatGPT 계정 로그인으로 플랜 내 이용)
• 그대로 사용하면 동작이 불안정함. 래퍼 스크립트로 입출력을 고정하고, SKILL.md로 절차를 전달
• SKILL.md의 frontmatter는 맨 앞에 배치. description에 발동 키워드를 작성

이 메커니즘으로 실제로 웹사이트 이미지를 전부 만든 이야기는 블로그에 적어두었습니다: Claude Code의 스킬이란 | "이런 이미지를 만들어 둬"라는 한 마디로 생성부터 HP 반영까지 끝나는 실례