← 프리뷰 목록으로

Codex CLI로 미디어 편집하기 (Mac 환경)

작성일: 2025년 12월 29일

이 가이드에서 배우는 것

OpenAI의 Codex CLI를 사용해서 자연어로 미디어 편집 작업을 수행하는 방법을 알아봐요.

  • Codex CLI 설치 — npm 또는 Homebrew로 간단하게 설치
  • ImageMagick 작업 — 이미지 리사이즈, 포맷 변환, 텍스트 오버레이
  • FFmpeg 작업 — 비디오 클립 추출, GIF 생성, 오디오 편집
  • 실전 예제 — 바로 따라할 수 있는 구체적인 프롬프트

목차

⚡ 퀵스타트

설명 없이 바로 실행해보고 싶다면:

brew install --cask codex
brew install imagemagick ffmpeg
codex

(ChatGPT 로그인 후)

mkdir -p ~/codex-demo && cd ~/codex-demo
curl -o test.jpg "https://upload.wikimedia.org/wikipedia/commons/thumb/c/cb/The_Blue_Marble_%28remastered%29.jpg/1024px-The_Blue_Marble_%28remastered%29.jpg"
codex "test.jpg를 가로 300px로 리사이즈해서 small.jpg로 저장해줘"
open small.jpg

• • •

1. 사전 준비 및 설치

시스템 요구사항

  • macOS (공식 지원)
  • Node.js v18+ (npm 설치 방법 사용 시) 또는 Homebrew
  • 인터넷 연결
  • ChatGPT Plus/Pro 구독 (권장) 또는 OpenAI API 키

Codex CLI 설치

두 가지 방법 중 하나를 선택하세요:

방법 A: npm으로 설치

npm install -g @openai/codex

방법 B: Homebrew로 설치

brew install --cask codex

인증 설정

아래 명령을 실행하고, 프롬프트가 나타나면 “Sign in with ChatGPT”를 선택하세요. 브라우저에서 OAuth 인증이 진행됩니다.

codex

API 키를 직접 사용하려면: (아래 명령을 ~/.zshrc에 추가하면 영구 설정됩니다)

export OPENAI_API_KEY="sk-..."

미디어 도구 설치

brew install imagemagick ffmpeg

설치 확인:

magick --version
ffmpeg -version

• • •

2. Codex 기본 사용법

승인 모드

Codex는 세 가지 승인 모드를 제공해요:

모드동작플래그
Suggest (기본)모든 작업에 승인 요청--suggest
Auto Edit파일 작업은 자동, 쉘 명령은 승인 요청--auto-edit
Full Auto모든 작업을 자동으로 실행--full-auto

초보자 권장: 기본 Suggest 모드로 시작해서 Codex가 어떤 명령을 생성하는지 먼저 이해하세요.

기본 워크플로우

cd ~/media-playground
codex

Codex를 실행하면 전체 화면 터미널 UI가 나타나요:

╭──────────────────────────────────────────────────╮
│ >_ OpenAI Codex                                  │
│                                                  │
│   model: gpt-5-codex      /model to change       │
│   directory: ~/media-playground                  │
╰──────────────────────────────────────────────────╯

프롬프트에 자연어로 요청을 입력하면 Codex가 분석하고, 명령을 제안하고, 승인 모드에 따라 실행 전에 확인을 요청해요.

주요 명령어

  • /status — 현재 세션 설정 확인
  • /mode — 승인 모드 변경
  • /exit 또는 Ctrl+C — 세션 종료

• • •

3. 연습 환경 구성

작업 디렉토리 생성

mkdir -p ~/codex-media-demo && cd ~/codex-media-demo

(선택) git 저장소로 초기화하면 되돌리기가 쉬워요:

git init

예제 미디어 다운로드 (퍼블릭 도메인)

샘플 이미지 (NASA, 퍼블릭 도메인):

curl -o earth.jpg "https://upload.wikimedia.org/wikipedia/commons/thumb/c/cb/The_Blue_Marble_%28remastered%29.jpg/1024px-The_Blue_Marble_%28remastered%29.jpg"

샘플 비디오 (Blender Foundation, Creative Commons, ~6MB):

curl -L -o bunny_clip.mp4 "https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/360/Big_Buck_Bunny_360_10s_1MB.mp4"

직접 파일 사용: 로컬에 있는 이미지나 비디오를 사용해도 돼요. ~/codex-media-demo/에 복사하고 아래 예제의 파일명만 바꿔주세요.

• • •

4. ImageMagick 작업

기본 이미지 작업

Codex에 입력할 프롬프트 예시:

작업프롬프트
리사이즈
earth.jpg를 가로 500px로 리사이즈하고 비율 유지해서 earth_small.jpg로 저장해줘
포맷 변환
earth.jpg를 PNG 포맷으로 변환해줘
텍스트 추가
earth.jpg 하단 중앙에 흰색으로 'Hello Earth' 텍스트 추가해줘
썸네일 생성
earth.jpg로 150x150 썸네일 만들어줘
흑백 변환
earth.jpg를 흑백으로 변환해줘

배치 작업

이 폴더의 모든 jpg 파일을 가로 800px로 리사이즈해줘
모든 png 파일을 jpg로 변환해줘

합성 작업

폴더의 모든 이미지로 2x2 그리드 콜라주 만들어줘
earth.jpg에 반투명 워터마크 추가해줘

• • •

5. FFmpeg 작업

기본 비디오 작업

작업프롬프트
클립 추출
bunny_clip.mp4에서 처음 10초를 추출해서 clip.mp4로 저장해줘
포맷 변환
bunny_clip.mp4를 WebM 포맷으로 변환해줘
오디오 추출
bunny_clip.mp4에서 오디오만 MP3로 추출해줘
비디오 리사이즈
bunny_clip.mp4를 720p로 리사이즈해줘
GIF 생성
bunny_clip.mp4의 5초~10초 구간으로 GIF 만들어줘

오디오 작업

bunny_clip.mp4 볼륨을 50% 높여줘
bunny_clip.mp4에서 오디오 제거해줘
bunny_clip.mp4에 background.mp3를 배경음악으로 추가해줘

필터 및 효과

bunny_clip.mp4에 블러 효과 적용해줘
bunny_clip.mp4 재생 속도를 2배로 해줘
bunny_clip.mp4에 페이드인/페이드아웃 추가해줘
bunny_clip.mp4 오른쪽 하단에 logo.png 오버레이해줘

• • •

6. 팁과 주의사항

모범 사례

  • git 저장소에서 작업하면 되돌리기가 쉬워요 (선택)
  • 익숙해질 때까지 Suggest 모드 사용
  • 덮어쓰기를 방지하려면 출력 파일명을 명시적으로 지정
  • 대용량 파일은 작은 샘플로 먼저 테스트

결과물 확인하기

작업 완료 후 파일을 바로 열어볼 수 있어요:

open output.jpg

현재 폴더를 Finder에서 열기:

open .

Quick Look으로 미리보기 (스페이스바로 닫기):

qlmanage -p output.mp4

자주 발생하는 문제

문제해결책
”Command not found: magick”brew install imagemagick 실행
”Permission denied”파일 권한 확인; Codex 샌드박스가 일부 작업 차단 가능
네트워크 접근 거부기본 샌드박스가 네트워크 차단; --full-auto 사용 또는 설정 조정
대용량 비디오 처리가 느림FFmpeg 작업은 CPU 집약적; 짧은 클립으로 테스트

Codex가 생성한 명령 이해하기

Suggest 모드에서 Codex는 실행 전에 정확한 명령을 보여줘요:

Codex wants to run:
  magick earth.jpg -resize 500x earth_small.jpg

[y]es / [n]o / [e]xplain

e를 입력하면 명령이 무슨 일을 하는지 설명을 받을 수 있어요. Codex를 학습 도구로도 활용할 수 있죠:

이 ffmpeg 명령이 뭘 하는 건지 설명해줘: ffmpeg -i input.mp4 -vf scale=1280:720 output.mp4
ffmpeg에서 -crf와 -b:v의 차이가 뭐야?

• • •

7. 빠른 참조 치트시트

Codex 시작

대화형 모드:

codex

자동 모드:

codex --full-auto

원샷 모드:

codex "작업 설명"

유용한 원라이너 프롬프트

./photos의 모든 이미지를 500KB 이하로 압축해줘
video.mp4에서 30초 지점부터 10초 미리보기 만들어줘
모든 .jpeg 파일을 .jpg로 일괄 이름 변경해줘
video.mp4에서 10초마다 프레임 추출해서 썸네일 그리드 만들어줘
이 폴더의 모든 이미지에서 메타데이터 제거해줘

참고 자료

참고: 이 가이드는 작은 실제 예제들로 워크플로우를 보여주는 데 초점을 맞췄어요. Codex의 전체 기능이나 “바이브 코딩” 튜토리얼은 다루지 않아요.

생성: Claude (Anthropic)

총괄: 존 (디노이저denoiser)