클로드코드를 사용하시면서 “AI로 이미지도 자동으로 만들 수 있다는데 어떻게 하는 거지?” 궁금해하시는 분들 많으실 거예요. 사실 저도 처음에는 어디서부터 시작해야 할지 막막했습니다. API니, 환경변수니, 키 발급이니 용어부터 어렵게 느껴지더라고요. 그래서 오늘은 컴퓨터를 잘 모르시는 분들도 차근차근 따라하실 수 있도록 클로드코드와 이미지 생성 API를 연동하는 방법을 처음부터 끝까지 자세히 알려드리겠습니다. 한 번만 세팅해두면 그 다음부터는 “가을 풍경 이미지 5장 만들어줘” 한 마디로 자동으로 이미지가 만들어지는 마법 같은 환경이 만들어집니다. 천천히 따라와주세요.
이미지 생성 API가 뭐길래?
먼저 용어부터 간단히 짚고 넘어갈게요. API라는 단어가 어렵게 느껴지실 수 있는데, 쉽게 말하면 “내 프로그램에서 다른 회사의 서비스를 사용할 수 있게 해주는 통로”라고 생각하시면 됩니다.
왜 API를 써야 할까?
평소 이미지를 만들 때는 어떻게 하시나요? ChatGPT 사이트에 접속해서 로그인하고, 채팅창에 프롬프트 입력하고, 결과 나올 때까지 기다리고, 다운로드 버튼 누르고… 이걸 5장 만들려면 5번 반복해야 합니다. 그런데 API를 사용하면 클로드코드가 이 모든 과정을 알아서 처리해줍니다. 명령 한 번이면 5장이든 50장이든 자동으로 만들어서 폴더에 척척 저장해주는 거죠.
대표적인 이미지 생성 API들
현재 사용할 수 있는 주요 이미지 생성 API는 다음과 같습니다.
- OpenAI DALL-E: 챗GPT 만든 회사의 이미지 생성 API, 품질 좋고 사용 쉬움
- Stability AI: Stable Diffusion API, 비교적 저렴하고 커스터마이징 다양
- Google Imagen: 구글의 이미지 생성 API, 사실적인 이미지 강점
- Replicate: 다양한 오픈소스 모델을 한 곳에서 쓸 수 있는 플랫폼
| 서비스 | 장점 | 추천 대상 |
|---|---|---|
| DALL·E | 사용 쉬움, 결과 안정적 | 일반 앱 개발 |
| Stability AI | 자유도 높음 | 커스터마이징·로컬 AI |
| Google Imagen | 사실적 이미지 강함 | 기업·고품질 서비스 |
| Replicate | 다양한 모델 실험 가능 | 개발자·연구·프로토타입 |
처음 시작하시는 분이라면 OpenAI DALL-E를 추천드립니다. 가장 쉽고 사용법도 간단합니다. 이 글에서는 DALL-E 기준으로 설명드릴게요.
1단계: OpenAI API 키 발급받기
가장 먼저 OpenAI에서 API 키를 발급받아야 합니다. API 키는 “이 사용자가 OpenAI 서비스를 쓸 수 있다”는 일종의 신분증이에요.
OpenAI 계정 만들기
웹 브라우저로 https://platform.openai.com 에 접속하세요. 챗GPT 계정이 있으시면 그대로 로그인하시면 되고, 없으시면 새로 가입하셔야 합니다. 회원가입은 이메일이나 구글 계정으로 간단하게 할 수 있습니다.
결제 수단 등록하기
API는 사용한 만큼 비용을 지불하는 종량제 방식이라서 결제 수단을 먼저 등록해야 합니다. 좌측 메뉴에서 “Settings” → “Billing” 으로 이동한 뒤 “Add payment method” 버튼을 눌러 신용카드 정보를 입력하세요. 처음에는 5달러나 10달러 정도만 충전해두시면 충분합니다.
API 키 생성하기
이제 좌측 메뉴에서 “API keys” 메뉴를 찾아 클릭하세요. 우측 상단의 “Create new secret key” 버튼을 누르고, 이름을 적당히 지어주세요(예: claude-code). 그러면 “sk-“로 시작하는 긴 문자열이 나옵니다. 이게 바로 API 키입니다.
⚠️ 매우 중요한 주의사항: API 키는 발급되는 순간 한 번만 보여주고 다시는 볼 수 없습니다. 반드시 메모장에 복사해서 안전한 곳에 보관하세요. 그리고 절대로 다른 사람에게 알려주거나 공개된 곳에 올리시면 안 됩니다. 누군가 이 키를 알게 되면 여러분 계정으로 서비스를 사용해서 비용이 청구될 수 있습니다.
2단계: API 키를 컴퓨터에 안전하게 저장하기
API 키를 코드 안에 직접 적어두면 보안상 위험합니다. 그래서 “환경 변수”라는 곳에 저장해두는 게 정석입니다. 환경 변수는 컴퓨터 시스템 어디서든 꺼내 쓸 수 있는 일종의 비밀 보관함이에요.
윈도우에서 환경 변수 설정하기
윈도우 사용자분들은 다음 순서대로 진행하세요.
- 키보드 윈도우 키를 눌러 “환경 변수” 검색
- “시스템 환경 변수 편집” 클릭
- 나타나는 창에서 “환경 변수” 버튼 클릭
- “사용자 변수” 영역에서 “새로 만들기” 클릭
- 변수 이름에 OPENAI_API_KEY 입력
- 변수 값에 발급받은 API 키(sk-로 시작하는 것) 붙여넣기
- 확인 버튼 누르고 모든 창 닫기
설정 후에는 열려있던 터미널이나 클로드코드를 모두 종료하고 다시 실행해야 적용됩니다.
맥에서 환경 변수 설정하기
맥 사용자분들은 터미널을 열고 다음 명령어를 입력하시면 됩니다.
먼저 어떤 셸을 쓰는지 확인해야 하는데, 최근 맥은 zsh가 기본입니다. 터미널에서 “nano ~/.zshrc” 입력 후 엔터를 누르면 편집 화면이 열립니다. 거기에 다음 줄을 추가하세요.
export OPENAI_API_KEY="여기에_본인_API_키_붙여넣기"Ctrl+O 누르고 엔터, 다시 Ctrl+X로 저장하고 나옵니다. 그리고 터미널에서 “source ~/.zshrc” 명령어로 변경사항을 적용합니다.
3단계: 작업 폴더 준비하기
이제 클로드코드가 작업할 공간을 만들어야 합니다.
새 폴더 만들기</h3
바탕화면이나 원하는 위치에 “image-generator” 같은 이름으로 새 폴더를 하나 만드세요. 이 폴더가 앞으로 이미지를 만들고 저장할 작업 공간이 됩니다.
터미널로 폴더 이동
윈도우의 경우 만든 폴더를 열고, 주소창을 클릭한 뒤 “cmd” 또는 “powershell”을 입력하면 그 폴더 위치에서 터미널이 열립니다. 맥은 폴더에서 우클릭 후 “폴더에서 새로운 터미널 열기”를 선택하면 됩니다.
클로드코드 실행
터미널에서 “claude” 명령어를 입력하면 클로드코드가 실행됩니다. 이제 모든 준비가 끝났습니다.
4단계: 클로드코드에게 이미지 생성 시키기
드디어 가장 재미있는 부분입니다. 이제 클로드코드에게 자연스러운 한국어로 명령만 내리면 됩니다.
첫 번째 이미지 생성 명령
클로드코드 화면에 다음과 같이 입력해보세요.
"OpenAI DALL-E 3 API를 사용해서 이미지를 생성하는 Node.js 스크립트를 만들어줘. 환경 변수 OPENAI_API_KEY에서 API 키를 읽어오고, '한국의 가을 단풍 풍경' 주제로 이미지 1장을 만들어서 output 폴더에 저장해줘. 16:9 비율로 만들어줘."그러면 클로드코드가 알아서 다음 작업을 수행합니다.
- 필요한 패키지 자동 설치 (npm install)
- 이미지 생성 스크립트 코드 작성
- 스크립트 실행해서 OpenAI API 호출
- 받은 이미지를 output 폴더에 저장
- 혹시 에러가 나면 자동으로 디버깅까지
몇 십 초 후면 output 폴더 안에 가을 단풍 이미지가 멋지게 만들어져 있을 거예요. 신기하지 않나요?
여러 장 한 번에 만들기
한 장이 잘 됐으면 이제 본격적으로 활용해봅시다. 다음과 같이 명령해보세요.
“방금 만든 스크립트를 수정해줘. ‘가을 여행’을 주제로 5가지 다른 컨셉의 이미지를 만들어줘. 예를 들어 단풍 산, 가을 카페, 황금 들판, 코스모스 길, 가을 밤하늘 같은 식으로 다양하게. 파일명은 autumn-1.png부터 autumn-5.png로 저장해줘.”
이렇게 하면 5장이 자동으로 다 만들어집니다. 매번 사이트 접속해서 일일이 입력하는 것과는 비교가 안 되게 편해집니다.
5단계: 더 편하게 사용하는 꿀팁
한 번만 만들고 끝이 아니라 계속 편하게 사용할 수 있는 팁들을 알려드릴게요.
CLAUDE.md 파일 만들기
작업 폴더에 “CLAUDE.md”라는 파일을 만들어두면 클로드코드가 매번 이 파일을 참고합니다. 다음 내용을 적어두세요.
사용 API: OpenAI DALL-E 3
API 키 위치: 환경변수 OPENAI_API_KEY
저장 폴더: ./output/
기본 이미지 크기: 1792×1024 (16:9)
파일명 규칙: 주제명-번호.png
이렇게 해두면 다음부터는 “겨울 여행 이미지 5장 만들어줘” 한 마디면 알아서 다 처리합니다.
비용 관리하는 방법
DALL-E 3 기준으로 1장당 약 0.04~0.08달러(약 60~120원) 정도 들어요. 5장 만들면 500원 안팎입니다. 처음에는 1~2장만 테스트해보면서 프롬프트가 마음에 들면 그때 여러 장 만드는 게 좋습니다. OpenAI 사이트의 Usage 메뉴에서 사용량을 실시간으로 확인할 수 있고, 월 한도도 설정할 수 있으니 요금 폭탄 걱정은 안 하셔도 됩니다.
저렴한 대안 활용하기
비용이 부담스러우시면 다른 옵션도 있습니다. Stability AI는 DALL-E보다 저렴하고, Replicate는 다양한 오픈소스 모델을 쓸 수 있습니다. 컴퓨터 사양이 좋으시다면 Stable Diffusion을 본인 컴퓨터에 직접 설치해서 무료로 무제한 사용할 수도 있습니다. 클로드코드에게 “로컬에 설치된 Stable Diffusion과 연동해줘”라고 하면 그것도 알아서 처리해줍니다.
https://www.nolavoza.com/technology/stable-diffusion-local-installation-guide
자주 발생하는 문제 해결하기
처음 하시면 몇 가지 문제가 발생할 수 있는데 해결법도 미리 알려드릴게요.
API 키가 인식되지 않을 때
가장 흔한 문제입니다. 환경 변수를 설정한 뒤에는 반드시 터미널과 클로드코드를 모두 종료하고 다시 실행해야 합니다. 윈도우는 컴퓨터 재시작이 가장 확실합니다. 그래도 안 되면 클로드코드에게 “echo $OPENAI_API_KEY 명령어로 환경 변수가 제대로 설정됐는지 확인해줘”라고 물어보세요.
에러가 발생할 때
대부분의 에러는 클로드코드가 알아서 해결해줍니다. 에러 메시지가 나오면 그냥 “에러 났어 고쳐줘”라고 하시면 됩니다. 결제 수단이 등록 안 됐거나 잔액이 부족한 경우도 흔하니 OpenAI 사이트에서 확인해보세요.
이미지 품질이 마음에 안 들 때
프롬프트를 더 구체적으로 만들면 됩니다. “가을 풍경” 보다는 “한국의 설악산 단풍, 맑은 가을 하늘, 빨간색과 노란색 단풍이 어우러진 풍경, 사실적인 사진 스타일”처럼 자세히 적으면 훨씬 좋은 결과가 나옵니다. 클로드코드에게 “더 좋은 프롬프트로 만들어줘”라고 부탁해도 됩니다.
처음에는 좀 복잡하게 느껴지실 수 있지만 한 번만 세팅해두면 정말 편해집니다. 블로그 썸네일, SNS 콘텐츠, 발표 자료 이미지, 카드뉴스 등 이미지가 필요한 모든 작업에 활용할 수 있어요. 매달 클로드코드 구독료 내고 계신 거 아까워하지 마시고, 이렇게 다양하게 활용해보시면 본전 그 이상을 뽑으실 수 있을 거예요. 막히는 부분이 있으면 클로드코드에게 그냥 물어보세요. AI 비서가 직접 해결해드릴 거니까요.