GPT Image Skill이란? Codex·Claude Code에서 이미지 생성하는 Skill 사용법

개발 테크

9일 전

조회수

651

AI 코딩 도구를 활용해 AI 이미지를 생성하고 있습니다.

Codex와 Claude Code로 개발하다가 이미지를 생성해야 할 때는 별도의 이미지 생성 AI에 접속해 작업해야 하는 경우가 많습니다. 개발 도구와 이미지 생성 서비스를 오가다 보면 창이 늘어나고, 작업 흐름이 끊기기 쉽습니다.

이러한 불편을 줄이기 위해 Codex와 Claude Code 안에서 이미지 생성을 요청할 수 있도록 돕는 GPT Image Skill이 등장했습니다. 개발 작업을 이어가면서 필요한 이미지를 생성하거나 수정할 수 있다는 점이 특징입니다.

이 글에서는 GPT Image Skill의 특징과 설치 방법, Codex·Claude Code에서 사용하는 방법, 적용 전 확인해야 할 사항을 정리했습니다.

GPT Image Skill 핵심 요약

Codex와 Claude Code에서 이미지 작업을 요청할 수 있습니다. $gpt-image, /gpt-image 명령으로 텍스트 이미지 생성, 기존 이미지 편집, 변형 시안 제작을 요청할 수 있습니다.
OpenAI 이미지 API 키를 사용하지 않습니다. 이 Skill은 별도 API 호출이나 API 키 발급 대신, ChatGPT 구독으로 로그인한 Codex 환경을 이용하도록 설계됐습니다.
참조 이미지를 활용한 생성과 수정이 가능합니다. 로컬 PNG·JPEG·WebP 파일을 참조 이미지로 지정하거나, 이전 결과물을 다시 불러와 수정할 수 있습니다.
이미지 생성 한도는 ChatGPT 구독 및 워크스페이스 정책을 따릅니다. Skill 자체는 공개 저장소에서 제공되지만, 이미지 생성 가능 여부와 사용량은 로그인한 계정의 플랜 및 한도에 영향을 받습니다.

GPT Image Skill이란?

GPT Image Skill의 공식 깃허브 저장소 이미지입니다.

* 이미지 출처: GPT Image Skill Github 공식 저장소

GPT Image Skill은 Codex와 Claude Code에서 직접 이미지를 생성할 수 있도록 돕는 오픈 소스 스킬입니다.

GitHub 계정 GENEXIS-AI가 공개했으며, ChatGPT 구독 계정으로 Codex에 로그인한 상태라면 별도의 API Key 없이 GPT Image 기반의 이미지 생성과 수정을 요청할 수 있습니다.

코딩 작업을 이어가는 대화 안에서 필요한 이미지를 만들고, 생성한 결과물을 프로젝트 파일에 바로 활용할 수 있어 작업 흐름을 끊지 않고 계속 진행할 수 있습니다.

GPT Image Skill이 주목받는 이유

1. ChatGPT 구독 계정을 활용해 이미지 작업을 이어갈 수 있습니다

GPT Image Skill은 ChatGPT 또는 Codex 구독 계정으로 Codex와 Claude Code에 연결해 이미지 생성과 수정을 요청할 수 있습니다.

별도의 API Key를 발급할 필요가 없으며, 이미지 생성 서비스를 따로 열고 프롬프트를 다시 입력하는 과정을 줄일 수 있습니다. 개발 작업을 이어가면서 필요한 이미지를 생성하거나 수정할 수 있어 작업 흐름이 끊기지 않습니다.

2. 생성한 이미지를 프로젝트 파일과 함께 관리할 수 있습니다

GPT Image Skill로 생성한 이미지는 작업 중인 프로젝트 폴더에 저장됩니다. 이후 Codex나 Claude Code에서 파일 경로를 바로 참조해 수정하거나, 생성한 이미지를 웹페이지·앱 화면·문서에 곧바로 활용할 수 있습니다.

별도의 이미지 생성 서비스에서 결과물을 내려받아 다시 개발 환경으로 옮기는 과정을 줄일 수 있어, 여러 시안과 수정본을 프로젝트 파일과 함께 관리하기 좋습니다.

3. 여러 이미지 시안을 한 번에 만들어 비교할 수 있습니다

GPT Image Skill은 한 번의 요청으로 색상, 구도, 화풍을 다르게 적용한 여러 시안을 만들 수 있습니다. 예를 들어 같은 제품 이미지를 3가지 배경색이나 서로 다른 일러스트 스타일로 생성해 비교할 수 있습니다.

생성된 결과물은 각각 별도 파일로 저장되므로, 여러 시안을 확인한 뒤 프로젝트에 적용할 이미지를 선택하기 편리합니다.

GPT Image Skill 사용법

GPT Image Skill 설치하기

GPT Image Skill은 GitHub 저장소를 영구 경로에 내려받은 뒤 설치합니다. 설치된 Skill 경로가 저장소 폴더를 참조하므로, 임시 폴더가 아닌 유지할 수 있는 위치에 설치해야 합니다.

Windows에서 설치하기

$RepositoryUrl = "https://github.com/GENEXIS-AI/gpt-image-skill"

$InstallDir = Join-Path $env:LOCALAPPDATA "gpt-image-skill"

터미널에서 위의 명령어를 입력해 설치 위치와 GitHub 주소를 변수에 저장합니다.

git clone $RepositoryUrl $InstallDir

Set-Location $InstallDir

node .\gpt-image\scripts\validate_skill.mjs

node .\gpt-image\scripts\gpt_image.mjs bootstrap --target all --yes --json

위의 명령어를 입력해 git clone부터 실제 다운로드와 설치를 진행합니다.

macOS·Linux·WSL2에서 설치하기

REPOSITORY_URL="https://github.com/GENEXIS-AI/gpt-image-skill"

INSTALL_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/gpt-image-skill"

git clone "$REPOSITORY_URL" "$INSTALL_DIR"

cd "$INSTALL_DIR"

node ./gpt-image/scripts/validate_skill.mjs

node ./gpt-image/scripts/gpt_image.mjs bootstrap --target all --yes --json

WSL 환경에서는 Windows 경로인 /mnt/c 대신 Linux 홈 디렉터리 안에 설치하는 것이 권장됩니다. WSL1은 지원하지 않으므로, WSL2 또는 네이티브 Windows 환경을 사용해야 합니다.

Codex에서 이미지 생성하기

설치가 완료되면 Codex에서 /skills를 입력해 Skill 목록을 열고, GPT Image Skill이 추가됐는지 확인할 수 있습니다.

$gpt-image 이미지 생성 프롬프트 내용

Codex에서 GPT Image Skill로 이미지를 생성한 화면입니다. $gpt-image 명령어 뒤에 만들고 싶은 이미지를 입력하면 이미지가 생성됩니다.

Codex에서 GPT Image Skill로 이미지를 생성한 뒤 이미지 화면을 연 이미지입니다. 터미널에서 이미지를 바로 확인할수는 없지만 이미지 파일을 열어 달라고 요청하면 저장된 결과물을 바로 확인할 수 있습니다.

Codex에서 GPT Image Skill로 여러 개의 이미지를 동시에 생성한 화면입니다. GPT Image Skill은 여러 이미지를 함께 생성하는 작업도 지원합니다. 기존에 생성한 이미지를 기준으로 배경만 다르게 적용한 4가지 버전을 요청해 보았습니다.

Codex에서 GPT Image Skill로 배경이 다른 여러 개의 이미지를 생성한 화면입니다. 위의처럼 배경만 달라진 이미지 4장이 생성된 것을 확인할 수 있습니다.

Claude Code에서 이미지 생성하기

Claude Code에서 GPT Image Skill을 사용하기 위해서는 먼저 ChatGPT 계정으로 로그인을 해야합니다.

$env:PATH = "$env:USERPROFILE\.codex\packages\standalone\current\bin;$env:PATH"

node "$env:LOCALAPPDATA\gpt-image-skill\gpt-image\scripts\gpt_image.mjs" login

Claude Code에서 GPT Image Skill을 사용하기 위해 ChatGPT 로그인 경로를 입력한 화면입니다. 위 명령어를 실행하면 ChatGPT 계정을 연결할 수 있는 로그인 주소와 One-time Code가 표시됩니다.

GPT Image Skill을 사용하기 위해 One time Code를 입력하는 화면입니다. 로그인 주소를 열어 ChatGPT 계정으로 로그인한 뒤, 화면에 표시된 One-time Code를 입력하면 Codex CLI와 계정 연결이 완료됩니다.

/gpt-image 이미지 생성 프롬프트 내용

/gpt-image 명령어 뒤에 생성하고 싶은 이미지를 입력하면 이미지를 생성합니다.

봄꽃이 다채롭게 뒤덮인 산을 시네마틱한 분위기로 생성해 달라고 요청하자, 프롬프트에 맞는 이미지가 생성되었습니다.

Codex에서 GPT Image Skill로 4계절로 변한 산의 이미지를 만든 이미지입니다. 이어서 계절에 따른 산의 변화를 반영해 이미지 생성을 요청하자, 프롬프트에 맞춰 봄·여름·가을·겨울의 산 모습을 담은 이미지가 생성됐습니다.

GPT Image Skill 사용 시 주의사항 4가지

1. Skill 설치와 이미지 생성 한도는 별개입니다

GPT Image Skill 저장소는 공개되어 있지만, 이미지 생성은 ChatGPT 구독과 워크스페이스의 제공 범위 안에서 이뤄집니다. 설치했다고 해서 이미지 생성 횟수가 무제한으로 제공되는 것은 아닙니다.

이미지 생성 작업이 일반 대화보다 구독 한도를 더 빠르게 사용할 수도 있어, 여러 이미지를 한꺼번에 만들기 전에는 현재 플랜의 사용 가능 범위를 확인하는 것이 좋습니다.

2. API 키를 입력하거나 별도 API 과금을 기대하면 안 됩니다

GPT Image Skill은 OpenAI Images API, OPENAI_API_KEY, API 키 로그인 사용을 막도록 설계됐습니다. API 기반 자동화가 필요한 경우에는 이 Skill이 아니라 OpenAI Images API의 요금과 운영 방식을 별도로 검토해야 합니다.