Claude Code는 코드와 글을 쓰고 이미지를 볼 수도 있지만, 이미지를 그리지는 못합니다. 이미지를 얻으려면 이미지 모델을 연결해야 합니다. 가장 많이 선택하는 모델은 Google의 Gemini 이미지 모델인 Nano Banana입니다. Claude Code는 MCP 서버나 스킬을 통해 Nano Banana를 호출하고, MCP 서버나 스킬은 여러분의 키로 프롬프트를 Gemini API에 보냅니다. 이 가이드에서는 두 가지 설정 방법, 이미지 한 장당 비용, 지금 많은 도구가 작동하지 않게 만드는 모델 문제, 그리고 키가 전혀 필요 없는 방법을 다룹니다.
요약하면, API 키를 설정하지 않고 완성된 이미지를 얻고 싶다면 Orkas의 ImageStudio를 사용하세요. 이미지 모델이 내장된 이미지 에이전트이며, 새 계정은 무료 크레딧 500을 받습니다. 꼭 Nano Banana를 쓰고 싶다면 Gemini API 키를 Orkas에 추가하세요. 그러면 ImageStudio가 Nano Banana 2.1을 사용합니다. Claude Code 안에서 Nano Banana를 호출하려면 Nano Banana MCP 서버를 추가하되, 모델은 직접 지정하세요. 2026년 11월 8일 기준으로 많이 쓰이는 서버들은 Google이 서비스를 종료한 모델 ID를 기본값으로 사용합니다.
Claude Code로 이미지를 생성할 수 있나요?
자체적으로는 할 수 없습니다. Anthropic 고객센터에 따르면 Claude는 이미지 생성 도구처럼 사진이나 일러스트를 생성하지 않습니다. SVG, HTML, 차트 코드는 작성할 수 있어서 아이콘, 다이어그램, 간단한 배너, 차트 정도는 충분히 만들 수 있습니다. 사진, 일러스트, 제품 사진, 회화풍 이미지에는 이미지 모델이 필요합니다. OpenAI의 Codex에는 gpt-image-2를 사용하는 이미지 생성 기능이 내장되어 있지만, Claude Code에는 그런 기능이 없습니다.
대신 Claude Code는 이미지 파일을 읽을 수 있습니다. 이미지 모델이 프로젝트에 이미지를 저장하면, Claude가 그 이미지를 열어 요청한 내용과 비교하고 프롬프트를 다시 쓸 수 있습니다. 이런 반복 과정 덕분에 두 가지를 함께 씁니다. Claude는 계획하고 확인하며, 이미지 모델은 그립니다.
Anthropic의 플러그인 마켓플레이스에는 공식 Nano Banana 플러그인이 없습니다. 보통 다음 세 가지 방법 중 하나로 연결하며, 모두 Google AI Studio에서 만든 키로 Google의 Gemini API를 호출합니다.
- MCP 서버는 Claude Code에 새 도구를 추가합니다. 작업에 이미지가 필요할 때마다 Claude Code가 이 도구를 호출할 수 있습니다.
- 스킬은 지침과 때로는 스크립트가 들어 있는 폴더입니다. 요청이 이미지와 관련 있거나 이름으로 직접 호출하면 Claude Code가 이 스킬을 불러옵니다.
- Gemini CLI용 Google nanobanana 확장 프로그램은 Gemini CLI에 이미지 명령을 추가합니다. Claude Code 스킬이 이를 대신 실행해 줄 수 있습니다.
설정 없이: Orkas의 ImageStudio
Orkas에 내장된 이미지 에이전트인 ImageStudio로 시작하기를 권합니다. 요청 내용, 사진, 로고, 정확한 문구를 전달하고 원하는 결과를 설명하세요. SNS 이미지, 제품 이미지, 커버, 포스터, 인포그래픽, 차트, 일러스트를 만들 수 있습니다. 제목, 가격, 라벨은 실제 글꼴로 조판되므로 문구가 쓴 그대로 나옵니다. 사진을 편집하려면 배경이나 조명처럼 바꿀 부분을 알려 주세요. 그 부분만 바꿉니다. 새 픽셀이 필요할 때는 내장된 Seedream 5.5 모델을 사용하며, 출력 이미지당 13–23크레딧 + 입력 이미지당 5크레딧. 크기 조정, 자르기, 텍스트 배치 같은 레이아웃 작업에는 이미지 모델을 호출하지 않습니다.
Nano Banana를 쓰고 싶다면 Orkas에 Gemini API 키를 추가하세요. 설정을 열고 모델을 선택한 다음, 이미지와 이미지 서비스 추가를 차례로 선택하고 Google · Nano Banana 2.1을 골라 키를 붙여 넣습니다. 새 키는 목록 맨 위에 추가되므로 ImageStudio는 현재 모델인 Nano Banana 2.1로 이미지를 생성합니다. 이 이미지 요금은 Google이 청구하며, Orkas는 크레딧을 차감하지 않습니다. Google 요청이 실패하면 ImageStudio가 내장 모델로 대체할 수 있으며, 이때는 크레딧이 사용됩니다.
- Orkas를 설치하고 로그인합니다. 새 계정은 내장 모델에 쓸 수 있는 무료 크레딧 500을 받으므로 API 키 없이 시작할 수 있습니다.
- ImageStudio를 선택하고 사진과 로고를 추가합니다.
- 원하는 결과를 설명합니다: 크기나 플랫폼, 정확한 문구, 바뀌면 안 되는 부분, 원하는 파일 형식을 알려 주세요.
- 이미지를 검토하고 제목을 더 크게 하거나 배경을 바꾸는 식으로 구체적인 수정을 요청합니다. 기본적으로 요청 한 번에 새 이미지 한 장을 생성하며, 요청할 때만 한 장을 더 만듭니다.
결과물은 PNG, JPG, WEBP, AVIF 또는 TIFF 파일로 내 컴퓨터에 저장됩니다. ImageStudio는 레이어가 있는 PSD 파일이나 벡터 파일은 만들지 않습니다.
해 볼 만한 요청
제품 사진과 로고를 추가하고 대괄호 안의 내용을 바꾼 뒤, 다음 내용을 ImageStudio에 보내세요.
[우리 봄 세일]을 위한 [Instagram] 게시물을 [1080×1350] 크기로 만들어 주세요.
[내 제품 사진]을 메인 이미지로 쓰고, 제품은 원본 그대로 유지해 주세요.
[부드러운 베이지 스튜디오] 배경에 자연광으로 연출해 주세요.
제목은 정확히 이렇게 넣어 주세요: "[봄 세일 — 20% 할인]".
[내 로고]는 오른쪽 아래 모서리에 넣어 주세요.
PNG 파일로 전달해 주세요.이미지가 완성되면 구체적인 수정을 요청하세요. 예를 들면 "제목을 더 크게 하고 로고를 오른쪽 위로 옮겨 주세요."처럼요. ImageStudio는 그 부분만 바꾸고 나머지는 그대로 둡니다.
Nano Banana 모델과 비용
Nano Banana는 Google이 Gemini의 이미지 생성 기능에 붙인 이름입니다. 다음은 Gemini API에서 제공하는 모델과, 유료 등급 기준 Google이 공시한 이미지 한 장당 가격입니다.
| 모델 | 모델 ID | 이미지당 가격 | 참고 |
|---|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 | 1K $0.0336, 2K $0.0504, 4K $0.113 | 최신 모델로, 2026년 10월 6일부터 정식 제공되고 있습니다. 여기서 시작하세요. |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | $0.0336, 1K만 지원 | 가장 빠르고 가장 저렴합니다. 참조 이미지를 여러 장 쓰거나 단계별로 편집하는 용도로는 적합하지 않습니다. |
| Nano Banana Pro | gemini-3-pro-image | 1K 또는 2K $0.134, 4K $0.24 | 복잡한 장면에 적합하며, 그리기 전에 추론합니다. |
| Nano Banana 2 | gemini-3.1-flash-image | 1K $0.067, 2K $0.101, 4K $0.151 | 지원 중단되었습니다. Google은 새 프로젝트에 2.1을 권장합니다. |
| Nano Banana | gemini-2.5-flash-image | $0.039 | 최초 모델입니다. Google은 2027년 3월 15일에 서비스를 종료합니다. |
많은 사람이 놓치는 점이 세 가지 있습니다.
- 이미지에는 무료 등급이 없습니다. API 키로 이미지를 만들려면 결제 계정을 연결하고 최소 $5를 선불 충전해야 합니다. Google Cloud의 $300 무료 체험판은 Gemini API에 적용되지 않습니다.
- 프리뷰 모델 ID는 더 이상 작동하지 않습니다. Google은 2026년 1월 15일에 gemini-2.5-flash-image-preview를, 2026년 6월 25일에 gemini-3.1-flash-image-preview와 gemini-3-pro-image-preview를 종료했습니다. 아직 이 중 하나를 호출하는 도구는 실패합니다.
- 모든 이미지에는 보이지 않는 SynthID 워터마크가 들어갑니다. 위의 모든 모델에 해당합니다.
가격과 ID는 2026년 11월 8일 기준 Google의 가격 페이지와 이미지 생성 가이드를 참고했습니다.
Nano Banana MCP 서버와 스킬 비교
Claude Code와 함께 가장 많이 언급되는 프로젝트들입니다. 모두 무료 오픈소스이며, 이미지 비용은 Google에 냅니다. 설치하기 전에 모델을 확인하세요.
| 프로젝트 | 형태 | 기본 모델 | 바꿔야 할 것 |
|---|---|---|---|
| nanobanana-mcp-server | MCP 서버, uv로 실행 | 서비스가 종료된 Nano Banana 2 프리뷰 ID | NANOBANANA_MODEL을 flash로 설정(최초 Nano Banana 사용) |
| nanobanana 확장 프로그램 | Gemini CLI용 Google 확장 프로그램 | 서비스가 종료된 Nano Banana 2 프리뷰 ID | NANOBANANA_MODEL을 gemini-nano-banana-2.1로 설정 |
| cc-nano-banana | 위 확장 프로그램을 실행하는 Claude Code 스킬 | 확장 프로그램의 기본값 | 확장 프로그램과 같은 설정 |
| Nano-Banana-MCP | MCP 서버, npx로 실행 | 코드에 고정된 Nano Banana 프리뷰 ID | 설정 항목이 없으니 프로젝트가 업데이트될 때까지 사용하지 마세요 |
각 프로젝트의 코드는 2026년 11월 8일에 확인했습니다. 프로젝트를 설치하기 전에 README를 읽어 보세요. 프로젝트는 내 컴퓨터에서 코드를 실행하고, 프롬프트와 이미지를 Google로 보냅니다.
MCP 서버로 Claude Code에 Nano Banana를 추가하는 방법
- Gemini API 키를 만듭니다. Google AI Studio에서 만든 다음, 결제를 연결하고 선불 충전합니다.
- uv를 설치합니다. uv가 서버를 내려받아 실행해 줍니다.
- 터미널에서 서버를 추가합니다:
claude mcp add --env GEMINI_API_KEY=your-key --env NANOBANANA_MODEL=flash --transport stdio nanobanana -- uvx nanobanana-mcp-server@latest.--transport stdio는 반드시 이름 바로 앞에 두세요. 그렇지 않으면 Claude Code가 이름을 또 다른 변수로 읽습니다. - 연결되었는지 확인합니다: Claude Code를 실행하고
/mcp를 입력합니다. - 작업의 일부로 이미지를 요청합니다. 예: "이 랜딩 페이지용 16:9 히어로 이미지를 만들어 public/images에 저장한 다음, 열어 보고 고칠 점을 알려 주세요."
IMAGE_OUTPUT_DIR을 설정하지 않으면 서버는 홈 폴더의 nanobanana-images 폴더에 이미지를 저장합니다. 위 명령은 기본적으로 현재 프로젝트에서 나만 쓸 수 있도록 서버를 추가합니다. 모든 프로젝트에서 쓰려면 --scope user를 붙이세요. project 범위로는 추가하지 마세요. 키가 .mcp.json 파일에 기록되는데, 이 파일을 커밋하게 될 수도 있습니다.
flash 설정은 최초 Nano Banana를 사용합니다. 이 서버의 모델 목록 중 Google이 아직 제공하는 유일한 모델이지만, Google은 2027년 3월 15일에 이 모델의 서비스를 종료합니다. Nano Banana 2.1 지원은 아직 릴리스되지 않은 풀 리퀘스트에 들어 있습니다. 지금 바로 2.1을 쓰려면 아래의 확장 프로그램 방법을 쓰거나, Gemini API 키를 넣은 ImageStudio를 사용하세요.
대신 스킬 사용하기
스킬을 쓰면 자주 쓰는 크기나 선호하는 프롬프트 구조 같은 이미지 규칙을 한곳에 모아 둘 수 있습니다. 가장 잘 알려진 cc-nano-banana는 Google의 Gemini CLI 확장 프로그램을 통해 작동합니다.
- Gemini CLI와 확장 프로그램을 설치합니다:
npm install -g @google/gemini-cli를 실행한 다음gemini extensions install https://github.com/gemini-cli-extensions/nanobanana를 실행합니다. - 셸 프로필에 변수 두 개를 설정합니다:
NANOBANANA_API_KEY에는 Gemini API 키를 넣고,NANOBANANA_MODEL=gemini-nano-banana-2.1도 설정합니다. - 스킬을 추가합니다:
git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana - Claude Code에 이미지를 요청하거나,
/nano-banana로 스킬을 이름으로 호출합니다.
먼저 SKILL.md를 읽어 보세요. 이 스킬은 Claude에게 --yolo 플래그를 붙여 Gemini CLI를 실행하라고 지시하는데, 이 플래그는 Gemini CLI의 모든 동작을 묻지 않고 승인합니다. 또 확장 프로그램이 셸에서 키를 전달받지 못한다는 사용자 보고도 있습니다. 스킬을 직접 작성한다면 모델 ID는 스킬에 넣고, 키는 스킬 파일이 아니라 환경 변수에 두세요.
Orkas에서 Claude Code 실행하기
Orkas와 지금 쓰고 있는 설정 중 하나를 고를 필요는 없습니다.
- MCP 서버와 스킬은 그대로 작동합니다. 사이드바에서 에이전트 연결을 선택하고 Claude Code를 고르세요. Orkas는 내 컴퓨터에 설치된 Claude Code를 내 로그인 정보로 실행합니다. 기존 MCP 서버를 대체하지 않고 그 옆에 Orkas 자체 도구를 추가하므로, 설정해 둔 Nano Banana 서버와 스킬도 그대로 불러옵니다.
- 에이전트마다 맡은 일을 하게 하세요. 페이지나 앱 제작은 Claude Code에, 필요한 이미지는 ImageStudio에 요청하세요. ImageStudio가 파일을 내 컴퓨터에 저장하므로 Claude Code가 그 파일을 프로젝트에 넣을 수 있습니다.
어떤 방법을 선택해야 할까요?
| 목표 | 시작할 곳 | 얻는 것 |
|---|---|---|
| 설정 없이 문구가 정확한 SNS 게시물, 제품 이미지, 포스터 만들기 | Orkas의 ImageStudio | PNG, JPG, WEBP, AVIF 또는 TIFF 파일. 내장 모델, 시작용 무료 크레딧 500 |
| 스크립트나 설정 파일 없이 Nano Banana 2.1 쓰기 | Gemini API 키를 넣은 ImageStudio | Nano Banana 이미지. 요금은 Google이 청구하며 Orkas 크레딧은 들지 않음 |
| Claude Code를 벗어나지 않고 코딩하면서 이미지 만들기 | 모델을 지정한 Nano Banana MCP 서버 | 내 컴퓨터에 저장되는 이미지. Google이 이미지마다 요금 청구 |
| 나만의 규칙으로 반복해서 쓸 수 있는 이미지 워크플로 | Nano Banana 스킬 | 직접 설치하고, 읽고, 업데이트하는 스킬 |
| 아이콘, 다이어그램, 차트 | Claude Code 단독 | SVG 또는 차트 코드. 이미지 모델 불필요 |
자주 묻는 질문
Claude Code가 자체적으로 이미지를 생성할 수 있나요?
아니요. Anthropic은 Claude가 이미지 생성 도구처럼 사진이나 일러스트를 생성하지 않는다고 밝힙니다. Claude Code는 SVG, HTML, 차트 코드를 작성할 수 있고 이미지 파일을 열어 확인할 수도 있어서, Nano Banana 같은 이미지 모델과 잘 맞습니다.
Claude Code에서 Nano Banana를 무료로 쓸 수 있나요?
아니요. Gemini API의 이미지 모델에는 무료 등급이 없습니다. 결제를 연결하고 최소 $5를 선불 충전해야 하며, Google Cloud의 $300 무료 체험판도 적용되지 않습니다. Nano Banana 2.1은 1K 이미지 한 장에 $0.0336입니다. Orkas의 ImageStudio에는 내장 모델이 있고, 새 계정은 무료 크레딧 500을 받습니다.
어떤 Nano Banana 모델을 써야 하나요?
최신 모델인 Nano Banana 2.1(gemini-nano-banana-2.1)로 시작하세요. 가장 저렴한 1K 이미지에는 Nano Banana 2 Lite를, 복잡한 장면에는 Nano Banana Pro를 쓰세요. -preview로 끝나는 모델 ID는 피하세요. Google이 모두 서비스를 종료했습니다.
Nano Banana MCP 서버가 404 오류를 반환하는 이유는 무엇인가요?
Google이 서비스를 종료한 모델을 호출하고 있을 가능성이 높습니다. Google은 2026년 1월 15일에 gemini-2.5-flash-image-preview를, 2026년 6월 25일에 gemini-3.1-flash-image-preview와 gemini-3-pro-image-preview를 종료했습니다. 서버에 모델 설정이 있다면 현재 모델로 바꾸고, 없다면 모델을 고를 수 있는 도구로 바꾸세요.
Orkas에서 이미지를 만들려면 Gemini API 키가 필요한가요?
아니요. ImageStudio는 내장된 Seedream 5.5 모델을 사용하며, 새 계정은 무료 크레딧 500을 받습니다. 직접 Gemini API 키를 추가하면 ImageStudio가 대신 Nano Banana 2.1을 사용하고, 그 이미지 요금은 Google이 청구합니다.
Photoshop에서 이미지 작업을 이어 가려면 Photoshop에서 Claude를 사용하는 방법을 참고하세요. 더 많은 아이디어는 ImageStudio로 만들 수 있는 것에서 볼 수 있습니다. 내 사진으로 직접 해 보려면 Orkas를 다운로드하고 ImageStudio로 시작하세요.