Codex에서 이미지를 만들려면 대화에 원하는 결과를 설명하면 됩니다. 이미지 생성을 명확히 요청하고 싶다면 $imagegen을 함께 적으세요. 공식 이미지 생성 안내에 따르면 내장 이미지 생성에는 GPT Image 2가 사용됩니다. Codex의 대화 모델을 gpt-image-2로 바꾸는 과정은 필요하지 않습니다.
다만 Codex에 로그인할 수 있다고 해서 모든 계정에 이미지 생성이 제공되는 것은 아닙니다. 2026년 9월 7일 기준 공식 요금 안내는 Free 요금제에서 Codex 이미지 생성을 제공하지 않는다고 명시합니다. 아래 방법은 이미지 기능을 사용할 수 있는 계정을 전제로 합니다. ChatGPT 웹에서 이미지를 만들 수 있는지와 Codex에서 사용할 수 있는지는 각각 확인해야 합니다. Codex 이미지 사용 한도
GPT Image Skill을 먼저 설치해야 할까요?
내장 기능이 있는 환경이라면 외부 스킬 설치부터 시작할 필요는 없습니다. 이름이 비슷해도 $imagegen과 $gpt-image는 같은 명령이 아닙니다.
| 안내에서 본 이름 | 무엇을 뜻하나요? | 지금 할 일 |
|---|---|---|
$imagegen | 공식 문서가 안내하는 내장 이미지 생성 요청 방식 | 현재 Codex 대화에서 생성이나 편집을 요청합니다. |
$gpt-image, /gpt-image | 별도로 설치한 스킬이 제공할 수 있는 호출 이름 | 설치한 스킬의 출처와 사용법을 확인합니다. 내장 기능의 필수 준비라고 가정하지 않습니다. |
OPENAI_API_KEY | API 호출에 사용하는 인증 정보 | Codex에 포함된 사용량으로 작업하는 중인지, 별도 API 작업을 선택했는지 먼저 확인합니다. |
예를 들어 이랜서의 GPT Image Skill 안내는 GENEXIS-AI의 외부 스킬을 설치하는 방법을 다룹니다. 해당 방식을 이미 쓰고 있다면 그 스킬의 안내를 따르면 됩니다. 처음 시작하는 독자라면 현재 Codex의 내장 기능으로 한 장을 생성해 보는 편이 준비 과정을 줄일 수 있습니다.
외부 스킬을 설치한다고 계정의 이미지 생성 권한이나 사용 한도가 자동으로 늘어나는 것으로 이해해서는 안 됩니다. 기능이 없다는 메시지가 나오면 아래의 문제 해결 항목에서 계정과 실행 환경부터 확인하세요.
첫 요청에는 그림의 용도와 저장할 결과를 함께 적습니다
프로젝트에서 사용할 그림이라면 프로젝트를 연 Codex 대화에서 시작합니다. 용도, 원하는 내용, 필요한 비율이나 크기, 결과를 둘 위치를 한 번에 알려 주면 파일을 다시 찾거나 옮기는 일을 줄일 수 있습니다. 다음은 요청 예시입니다.
text$imagegen 독서 기록 앱의 시작 화면에 넣을 이미지를 만들어 주세요. 사용자가 오늘 읽은 책을 기록하고 싶어지는 따뜻한 분위기면 좋겠습니다. 화면에 안내 문구는 별도로 넣을 예정입니다. 가로형 이미지로 만들고, 완성 파일을 프로젝트의 public/images/reading-start.png에 저장해 주세요. 마지막에 실제 저장 경로와 파일 형식, 가로·세로 픽셀 크기를 알려 주세요.
이 예시의 소재나 분위기를 그대로 따를 필요는 없습니다. 쇼핑몰 사진이라면 제품과 바꿀 배경을, 발표 자료라면 설명하려는 개념과 청중을 적으면 됩니다. 그림 안에 정확한 문구가 필요하다면 사용할 문구를 직접 써 주세요. 크기가 정해져 있다면 가로 1600픽셀, 세로 900픽셀처럼 단위까지 명시합니다.
생성 요청과 파일 저장 요청은 서로 다른 결과를 확인하게 해 줍니다. 이미지가 대화에 표시되어도 필요한 프로젝트 위치에 파일이 없을 수 있으므로, 마지막에는 경로를 열어 실제 파일을 확인합니다. 요청한 크기를 결과의 실제 크기로 간주하지 말고 저장된 파일의 픽셀 크기를 확인하세요.
Codex가 이미지 대신 설명문이나 이미지 생성용 문장만 답한다면 다음과 같이 요청 의도를 좁힐 수 있습니다.
text설명문 작성이 아니라 내장 이미지 도구로 실제 이미지 파일을 생성해 주세요. 완료되면 이미지를 보여 주고 저장된 파일의 경로를 알려 주세요.
그다음에도 도구를 사용할 수 없다는 응답이 나온다면 같은 문장을 계속 바꾸기보다 기능 제공 여부와 오류 내용을 확인해야 합니다.
참조 이미지를 수정할 때는 유지할 부분부터 정합니다
기존 이미지를 바탕으로 수정하려면 원본을 첨부하고, 바꿀 것과 유지할 것을 함께 알려 주세요. “더 좋게 만들어 주세요”보다 “배경만 바꾸고 제품은 유지해 주세요”가 원하는 수정 범위를 전달하기 쉽습니다.
text$imagegen 첨부한 제품 사진의 배경을 밝은 실내로 바꿔 주세요. 제품의 모양, 색상, 로고와 촬영 각도는 유지해 주세요. 원본 파일은 그대로 두고 수정본을 별도 파일로 저장해 주세요. 완료 후 원본과 수정본을 구분할 수 있도록 파일 경로를 알려 주세요.
여러 파일을 첨부했다면 어느 것이 수정 대상이고 어느 것이 분위기나 색상의 참고 자료인지 구분합니다. 한 장을 다시 손볼 때도 “방금 만든 수정본”처럼 대상을 명확히 하면 이전 파일과 혼동을 줄일 수 있습니다.
앱에서 생성된 이미지를 선택하면 제공되는 환경에 따라 Focused view나 Canvas view로 볼 수 있습니다. Canvas의 Comment와 Multi-select는 특정 부분을 짚어 수정 내용을 전달하는 데 사용할 수 있습니다. 수정할 대상을 선택한 뒤 무엇을 바꿀지, 무엇을 유지할지 설명하세요. 이 화면 기능은 앱에 대한 안내이며 CLI나 IDE에 동일한 Canvas가 있다고 가정하지 않습니다. 이미지 보기와 수정에 관한 공식 안내
터미널과 IDE에서는 참조 이미지를 이렇게 전달합니다
CLI에서는 프로젝트 디렉터리에서 codex를 실행해 대화형 세션을 열고 자연어로 이미지를 요청할 수 있습니다. 기존 파일을 처음부터 첨부하려면 -i 또는 --image를 사용합니다.
bashcodex -i ./assets/product.png
세션이 열리면 위의 편집 요청처럼 원본에서 유지할 부분과 수정할 부분, 수정본의 저장 위치를 입력합니다. 예시에 나온 파일 경로는 실제 존재하는 자신의 이미지 경로로 바꿔야 합니다.
bashcodex --help
설치된 CLI에서 사용할 수 있는 옵션은 이 명령으로 확인합니다. Codex CLI 0.153.4의 도움말에는 -i/--image가 있고 별도의 image 하위 명령은 표시되지 않습니다. 따라서 인터넷에서 본 codex image ... 예제를 그대로 붙여 넣기보다 설치 버전의 도움말과 공식 CLI 참조를 확인하는 편이 좋습니다. 이 버전 정보는 명령 구문에 관한 확인이며 생성 속도나 품질을 뜻하지 않습니다.
IDE에서는 공식 안내에 따라 Shift 키를 누른 채 이미지를 Codex 대화로 끌어 놓아 참조 자료로 전달할 수 있습니다. 파일이 첨부되었는지 확인하고 수정 요청을 입력하세요. 앱의 Canvas 조작과 IDE의 이미지 첨부 방법을 혼동하지 않으면 됩니다. 클라이언트별 이미지 입력 방법
완성은 미리보기가 아니라 사용할 수 있는 파일입니다
그림이 마음에 들면 다음 세 가지를 확인합니다.
- 파일을 열 수 있는가: 전달받은 경로에서 이미지가 실제로 열리는지 확인합니다. 파일 이름만 응답에 적힌 상태와 구분합니다.
- 필요한 형식과 크기인가: PNG, JPEG, WebP 등 실제 형식과 픽셀 크기를 확인합니다. “4K로 만들어 달라”고 요청한 것만으로 모든 환경의 원본 4K 출력이 보장되는 것은 아닙니다.
- 사용할 곳에서 보이는가: 웹 프로젝트에 넣었다면 해당 페이지를 열어 이미지 경로가 맞는지, 의도한 크기로 표시되는지 확인합니다. 원본과 최종 사용 파일은 구분해 두면 이후 수정하기 편합니다.
확인이 필요하면 Codex에 다음과 같이 이어서 요청할 수 있습니다.
text방금 만든 이미지가 실제 파일로 존재하고 열리는지 확인해 주세요. 파일 형식과 픽셀 크기를 알려 주고, 제가 지정한 프로젝트 경로에 저장되지 않았다면 원본을 유지한 채 그 위치로 복사해 주세요.
생성된 화면 이미지에 버튼이 그려져 있어도 버튼이 클릭되는 웹 화면이 만들어진 것은 아닙니다. 이미지를 프로젝트에 넣은 뒤 실제 화면 구성과 동작을 구현하는 일은 별도로 요청해야 합니다.
생성이 멈추거나 API 키를 요구할 때
이미지 기능 문제는 요청 문장보다 계정, 사용량, 선택한 도구에서 원인이 갈리는 경우가 있습니다. 보이는 증상에 맞춰 다음 단계로 진행합니다.
| 현재 상황 | 먼저 확인할 내용 | 이어서 할 일 |
|---|---|---|
| 이미지 생성 도구가 없다고 합니다. | 현재 계정의 요금제와 해당 클라이언트에서 기능이 제공되는지 | 공식 요금 안내와 현재 앱·CLI·IDE의 기능 상태를 확인합니다. 외부 스킬 설치만으로 해결된다고 가정하지 않습니다. |
| 텍스트만 나오고 파일이 없습니다. | 요청을 이미지 생성이 아닌 설명 작성으로 이해했는지 | $imagegen으로 실제 생성을 요청하고 파일 경로를 받습니다. 도구가 없다는 오류로 바뀌면 기능 제공 여부를 확인합니다. |
| 사용 한도에 도달했습니다. | 남은 사용량과 재설정 시각 | 사용량 화면을 확인한 뒤 재설정을 기다리거나 계정에 표시된 추가 사용 선택지를 판단합니다. |
OPENAI_API_KEY를 요구합니다. | API 방식이나 별도 스킬·스크립트를 선택했는지 | 포함 사용량으로 하려던 작업이라면 내장 이미지 생성 요청인지 확인합니다. API를 선택할 때는 별도 과금을 확인합니다. |
| 참조 이미지가 반영되지 않습니다. | 파일이 실제 첨부되었고 수정 대상이 명확한지 | 첨부 상태와 파일 경로를 확인하고, 유지할 부분과 바꿀 부분을 다시 지정합니다. |
| 이미지가 보이지만 프로젝트에서 찾을 수 없습니다. | 최종 파일이 어디에 저장되었는지 | 실제 경로를 받아 필요한 폴더로 복사하도록 요청합니다. |
이미지 작업은 Codex의 일반 사용량을 함께 소모합니다. 공식 문서는 이미지가 없는 유사한 작업에 비해 포함 사용 한도를 평균 3~5배 빠르게 소모하며, 품질과 크기에 따라 달라진다고 설명합니다. 이를 “이미지 한 장이 메시지 다섯 개” 또는 “하루에 몇 장” 같은 고정 계산으로 바꾸면 안 됩니다. 공식 이미지 사용량 설명
현재 계정의 한도와 재설정 시각은 Codex 사용량 화면에서 확인할 수 있습니다. CLI의 활성 대화에서는 /status를 입력할 수 있습니다. 표시된 계정 상태를 기준으로 판단하고 다른 사용자의 생성 장수를 자신의 보장량으로 계산하지 마세요. 사용량 확인 방법
여러 이미지를 프로그램에서 자동으로 생성하려는 단계라면 GPT Image 2 API 사용 안내를 이어서 볼 수 있습니다. API 키를 사용하는 이미지 생성에는 API 요금이 적용됩니다. 지금 필요한 일이 한 장을 만들거나 수정해 프로젝트에 넣는 것이라면, 내장 기능에서 생성과 편집을 마친 뒤 실제 파일의 위치와 크기까지 확인하면 됩니다.
