Orkas Orkas
首頁 博客 Claude Code + Nano Banana
產品

如何在 Claude Code 中用 Nano Banana 生成圖片

Claude Code 自己不會畫圖,但可以呼叫圖片模型。本文說明如何用 MCP 伺服器或 skill 接入 Google 的 Nano Banana、每張圖要花多少錢,以及如何不用 Gemini 金鑰就在 Orkas 裡產生圖片。

Claude Code 會寫程式和文字,也看得懂圖片,但它不會畫圖。想讓它產出圖片,就要幫它接上一個圖片模型。多數人選的是 Nano Banana,也就是 Google 的 Gemini 圖片模型:Claude Code 透過 MCP 伺服器或 skill 呼叫它,再由它們用你自己的金鑰把提示詞送到 Gemini API。本文說明這兩種設定方式、每張圖的費用、一個讓許多這類工具目前無法使用的模型問題,以及一條完全不需要金鑰的做法。

簡單來說:如果你想直接拿到成品圖,又不想設定 API 金鑰,就用 Orkas 裡的 ImageStudio。它是內建圖片模型的圖片智慧代理,新帳號可免費獲得 500 點數。如果你就是想用 Nano Banana,把你的 Gemini 金鑰加到 Orkas,ImageStudio 就會用 Nano Banana 2.1 產生圖片。如果想在 Claude Code 裡直接呼叫 Nano Banana,就加入一個 Nano Banana MCP 伺服器,但模型要自己指定:截至 2026 年 11 月 8 日,幾個熱門伺服器預設使用的模型 ID 都已被 Google 停用。

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 新增一個工具,任務需要圖片時就能呼叫。
  • skill:一個放著說明、有時還附帶腳本的資料夾。當你的要求和圖片有關,或你直接指名呼叫時,Claude Code 會載入它。
  • Google 為 Gemini CLI 推出的 nanobanana 擴充功能:為 Gemini CLI 加入圖片相關指令。Claude Code 的 skill 可以替你執行它。

免設定:Orkas 裡的 ImageStudio

我們建議從 ImageStudio 開始,它是 Orkas 內建的圖片智慧代理。把你的需求說明、照片、logo 和要用的原文交給它,再描述你想要的成果。它能製作社群圖片、商品圖、封面、海報、資訊圖表、圖表和插畫。標題、價格和標籤都以真正的文字排版,所以文字會和你寫的一字不差。要修改照片時,告訴它要改哪裡,例如背景或光線,它只會改那個部分。需要產生新的像素時,它會使用內建的 Seedream 5.5 模型,輸出 13–23 積分/張;輸入 5 積分/張。調整尺寸、裁切、放置文字這類版面工作不會呼叫圖片模型。

如果你比較想用 Nano Banana,就在 Orkas 裡加入 Gemini 金鑰:開啟設定,選擇模型,接著選圖片和新增圖片服務,選取 Google · Nano Banana 2.1 並貼上金鑰。新加入的金鑰會排在清單最上方,所以 ImageStudio 會用目前的模型 Nano Banana 2.1 來產生圖片。這些圖片由 Google 計費,Orkas 不會為此扣點數。如果 Google 的請求失敗,ImageStudio 可以改用內建模型,這部分會消耗點數。

  1. 安裝 Orkas 並登入。新帳號可免費獲得 500 點數,用於內建模型,所以不需要 API 金鑰就能開始。
  2. 選擇 ImageStudio,加入你的照片和 logo。
  3. 描述你要的成果:尺寸或發布平台、要用的原文、哪些地方必須維持不變,以及想要的檔案格式。
  4. 檢查圖片,並提出聚焦的修改,例如把標題放大或換個背景。預設每次請求只產生一張新圖,你開口要求時才會再做一張。

你會拿到儲存在自己電腦上的 PNG、JPG、WEBP、AVIF 或 TIFF 檔案。ImageStudio 不會產生含圖層的 PSD 檔或向量檔。

用 ImageStudio 製作 不必設定 MCP 伺服器,直接拿到成品圖。 Orkas 在 macOS 和 Windows 上免費。新帳號可獲得 500 點數用於內建模型,你也可以加入自己的 Gemini 金鑰。
免費下載 Orkas

試試這個需求

加入你的商品照片和 logo,替換方括號裡的內容,然後把下面這段傳給 ImageStudio:

為[我們的春季特賣]做一張 [1080×1350] 的 [Instagram] 貼文圖。
用[我的商品照片]當主圖,商品必須和原圖完全一樣。
背景用[柔和的米色攝影棚],自然光。
標題照原樣使用:「[春季特賣——8 折]」。
把[我的 logo]放在右下角。
交付 PNG 檔案。

圖片完成後,可以提出具體的修改,例如:「把標題放大,把 logo 移到右上角。」ImageStudio 只會改這個部分,其餘維持不變。

Nano Banana 各模型與價格

Nano Banana 是 Google 對 Gemini 圖片生成功能的稱呼。下面是 Gemini API 中的各個模型,以及 Google 公布的付費方案單張定價:

模型模型 ID單張價格說明
Nano Banana 2.1gemini-nano-banana-2.11K $0.0336,2K $0.0504,4K $0.113最新的模型,2026 年 10 月 6 日起正式推出。建議從這個開始。
Nano Banana 2 Litegemini-3.1-flash-lite-image$0.0336,僅支援 1K最快也最便宜。不適合多張參考圖或逐步編輯。
Nano Banana Progemini-3-pro-image1K 或 2K $0.134,4K $0.24適合複雜場景;會先推理再作畫。
Nano Banana 2gemini-3.1-flash-image1K $0.067,2K $0.101,4K $0.151已淘汰;Google 建議新專案改用 2.1。
Nano Bananagemini-2.5-flash-image$0.039初代模型。Google 將於 2027 年 3 月 15 日停用。

有三件事很容易踩雷:

  • 圖片生成沒有免費方案。要用 API 金鑰產生圖片,必須連結帳單帳戶,並預付至少 $5。Google Cloud 的 $300 免費試用不涵蓋 Gemini API。
  • 預覽版(preview)模型 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 取自 Google 的定價頁面和圖片生成指南,資料截至 2026 年 11 月 8 日。

Nano Banana MCP 伺服器與 skill 比較

下面是搭配 Claude Code 時最常被提到的幾個專案。它們都是免費的開放原始碼專案,圖片費用付給 Google。安裝前請先確認模型:

專案類型預設模型需要改什麼
nanobanana-mcp-serverMCP 伺服器,用 uv 執行已停用的 Nano Banana 2 preview ID把 NANOBANANA_MODEL 設為 flash,也就是使用初代 Nano Banana
nanobanana 擴充功能Google 為 Gemini CLI 推出的擴充功能已停用的 Nano Banana 2 preview ID把 NANOBANANA_MODEL 設為 gemini-nano-banana-2.1
cc-nano-banana執行上述擴充功能的 Claude Code skill沿用擴充功能的預設值和擴充功能相同的設定
Nano-Banana-MCPMCP 伺服器,用 npx 執行寫死在程式碼裡的 Nano Banana preview ID沒有可調整的設定;在專案更新前先別用

以上是我們在 2026 年 11 月 8 日檢查各專案程式碼的結果。安裝任何專案前請先讀它的 README:它會在你的電腦上執行程式碼,並把你的提示詞和圖片傳送給 Google。

如何用 MCP 伺服器把 Nano Banana 接入 Claude Code

  1. 建立 Gemini API 金鑰:在 Google AI Studio 建立,然後連結帳單並預付儲值。
  2. 安裝 uv,它會替你下載並執行這個伺服器。
  3. 加入伺服器,在終端機執行: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 會把名稱當成另一個變數。
  4. 確認已連線:啟動 Claude Code,輸入 /mcp。
  5. 把要圖片寫進任務裡,例如:「幫這個登陸頁做一張 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 的支援目前還在一個尚未發布的 pull request 裡。現在就想用 2.1,可以改走下面的擴充功能做法,或在 ImageStudio 裡使用你的 Gemini 金鑰。

改用 skill

skill 能把你的出圖規則集中在一個地方,例如常用的尺寸和你偏好的提示詞結構。最知名的 cc-nano-banana 是透過 Google 的 Gemini CLI 擴充功能來運作:

  1. 安裝 Gemini CLI 和擴充功能:先執行 npm install -g @google/gemini-cli,再執行 gemini extensions install https://github.com/gemini-cli-extensions/nanobanana。
  2. 設定兩個變數,寫進你的 shell 設定檔:NANOBANANA_API_KEY 填入你的 Gemini 金鑰,以及 NANOBANANA_MODEL=gemini-nano-banana-2.1。
  3. 加入 skill:git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana
  4. 直接請 Claude Code 產生圖片,或用 /nano-banana 指名呼叫這個 skill。

請先讀它的 SKILL.md。它會要求 Claude 帶著 --yolo 參數執行 Gemini CLI,這個參數會在不詢問的情況下核准 Gemini CLI 的每一個動作。另外也有使用者回報,擴充功能拿不到 shell 裡設定的金鑰。如果你自己寫 skill,請把模型 ID 寫進去,金鑰則放在環境變數裡,不要寫進 skill 檔案。

從 Orkas 執行 Claude Code

Orkas 和你現有的設定不必二選一。

  • 你的 MCP 伺服器和 skill 照樣能用。在側邊欄選擇接入智慧代理,再選 Claude Code。Orkas 會用你的登入身分,執行你電腦上安裝的那份 Claude Code。它會把自己的工具加在你的 MCP 伺服器旁邊,而不是取代它們,所以你設定好的 Nano Banana 伺服器和 skill 仍然會載入。
  • 讓每個智慧代理各司其職。請 Claude Code 建置網頁或應用程式,請 ImageStudio 製作需要的圖片。ImageStudio 會把檔案存在你的電腦上,Claude Code 就能把它們放進你的專案。

該選哪一種做法?

你的目標從這裡開始你會得到什麼
免設定做出文字精準的社群貼文、商品圖或海報Orkas 裡的 ImageStudioPNG、JPG、WEBP、AVIF 或 TIFF 檔案;內建模型,起步免費送 500 點數
不寫腳本、不碰設定檔就用上 Nano Banana 2.1在 ImageStudio 中使用你的 Gemini 金鑰Nano Banana 產生的圖片;由 Google 計費,不扣 Orkas 點數
寫程式時順手出圖,不必離開 Claude CodeNano Banana MCP 伺服器,並設定好模型圖片存在你的電腦上;Google 按張計費
依照你自己的規則、可重複使用的出圖流程Nano Banana skill一個由你自己安裝、閱讀和更新的 skill
圖示、示意圖和圖表單用 Claude CodeSVG 或圖表程式碼;不需要圖片模型

常見問題

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 金鑰,ImageStudio 會改用 Nano Banana 2.1,這些圖片由 Google 計費。

想在 Photoshop 裡繼續處理圖片,請參閱如何在 Photoshop 中使用 Claude。想找更多靈感,可以看看用 ImageStudio 能做出什麼。想用自己的照片試試看,下載 Orkas,從 ImageStudio 開始。