Claude Code viết được code và văn bản, cũng xem được ảnh, nhưng không tự vẽ ảnh. Muốn có ảnh, bạn cần kết nối một mô hình tạo ảnh. Nano Banana, mô hình ảnh Gemini của Google, là lựa chọn của đa số: Claude Code gọi nó qua một máy chủ MCP hoặc một skill gửi prompt của bạn tới Gemini API bằng khóa của chính bạn. Hướng dẫn này trình bày cả hai cách thiết lập, chi phí cho mỗi ảnh, một vấn đề về mô hình đang khiến nhiều công cụ loại này bị hỏng hiện nay, và một cách hoàn toàn không cần khóa.
Trả lời ngắn gọn: nếu bạn muốn có ảnh hoàn chỉnh mà không phải thiết lập khóa API, hãy dùng ImageStudio trong Orkas. Đây là tác tử tạo ảnh có sẵn mô hình tạo ảnh tích hợp, và tài khoản mới được tặng 500 điểm tín dụng miễn phí. Nếu bạn muốn dùng đúng Nano Banana, hãy thêm khóa Gemini vào Orkas, khi đó ImageStudio sẽ dùng Nano Banana 2.1. Để gọi Nano Banana ngay trong Claude Code, hãy thêm một máy chủ MCP Nano Banana, nhưng tự đặt mô hình: tính đến ngày 8 tháng 11 năm 2026, các máy chủ phổ biến mặc định dùng những ID mô hình mà Google đã ngừng hoạt động.
Claude Code có tạo được ảnh không?
Tự nó thì không. Trung tâm trợ giúp của Anthropic cho biết Claude không tạo ảnh chụp hay tranh minh họa theo cách các công cụ tạo ảnh vẫn làm. Claude có thể viết SVG, HTML và code biểu đồ, đủ cho biểu tượng, sơ đồ, banner đơn giản và biểu đồ. Còn ảnh chụp, tranh minh họa, ảnh sản phẩm và các phong cách hội họa thì cần một mô hình tạo ảnh. Codex của OpenAI có sẵn tính năng tạo ảnh với gpt-image-2; Claude Code không có gì tương tự.
Điều Claude Code làm được là đọc tệp ảnh. Sau khi mô hình tạo ảnh lưu ảnh vào dự án của bạn, Claude có thể mở ảnh, so với yêu cầu của bạn và viết lại prompt. Chính vòng lặp này là lý do người ta kết hợp hai bên: Claude lên kế hoạch và kiểm tra, còn mô hình tạo ảnh thì vẽ.
Kho plugin của Anthropic không có plugin Nano Banana chính thức. Người dùng kết nối nó theo một trong ba cách, và cách nào cũng gọi Gemini API của Google bằng khóa bạn tạo trong Google AI Studio:
- Máy chủ MCP cung cấp cho Claude Code một công cụ mới để gọi bất cứ khi nào tác vụ cần đến ảnh.
- Skill là một thư mục chứa hướng dẫn, đôi khi kèm script. Claude Code nạp skill khi yêu cầu của bạn liên quan đến ảnh, hoặc khi bạn gọi nó theo tên.
- Tiện ích mở rộng nanobanana của Google cho Gemini CLI bổ sung các lệnh tạo ảnh cho Gemini CLI. Một skill của Claude Code có thể chạy nó thay bạn.
Không cần thiết lập: ImageStudio trong Orkas
Chúng tôi khuyên bạn bắt đầu với ImageStudio, tác tử tạo ảnh có sẵn trong Orkas. Hãy đưa cho nó bản brief, ảnh, logo và nội dung chữ chính xác, rồi mô tả kết quả bạn muốn. Nó làm ảnh cho mạng xã hội, ảnh sản phẩm, ảnh bìa, poster, infographic, biểu đồ và tranh minh họa. Tiêu đề, giá và nhãn được dàn bằng chữ thật, nên chữ hiện ra đúng như bạn viết. Để sửa ảnh, hãy nói điều cần thay đổi, chẳng hạn nền hoặc ánh sáng, và nó chỉ thay đổi phần đó. Khi ảnh cần pixel mới, nó dùng mô hình tích hợp Seedream 5.5, tốn 13–23 điểm tín dụng / ảnh đầu ra + 5 / ảnh đầu vào. Các việc bố cục như đổi kích thước, cắt ảnh và đặt chữ không gọi đến mô hình tạo ảnh.
Nếu bạn thích Nano Banana hơn, hãy thêm khóa Gemini vào Orkas: mở Cài đặt, chọn Mô hình, rồi Ảnh và Thêm dịch vụ ảnh, chọn Google · Nano Banana 2.1 và dán khóa vào. Khóa mới được đưa lên đầu danh sách, nên ImageStudio sẽ tạo ảnh bằng Nano Banana 2.1, mô hình hiện hành. Google tính phí những ảnh này, còn Orkas không trừ điểm tín dụng. Nếu một yêu cầu gửi tới Google bị lỗi, ImageStudio có thể chuyển sang mô hình tích hợp, vốn tốn điểm tín dụng.
- Cài Orkas và đăng nhập. Tài khoản mới được tặng 500 điểm tín dụng miễn phí cho các mô hình tích hợp, nên bạn có thể bắt đầu mà không cần khóa API.
- Chọn ImageStudio và thêm ảnh cùng logo của bạn.
- Mô tả kết quả: kích thước hoặc nền tảng, nội dung chữ chính xác, những gì phải giữ nguyên và loại tệp bạn muốn.
- Xem lại ảnh và yêu cầu chỉnh sửa cụ thể, chẳng hạn tiêu đề to hơn hoặc đổi nền khác. Mặc định, mỗi yêu cầu nó chỉ tạo một ảnh mới, và chỉ tạo thêm khi bạn yêu cầu.
Bạn nhận được tệp PNG, JPG, WEBP, AVIF hoặc TIFF lưu trên máy tính. ImageStudio không tạo tệp PSD nhiều lớp hay tệp vector.
Một yêu cầu để thử
Thêm ảnh sản phẩm và logo của bạn, thay phần trong ngoặc vuông rồi gửi nội dung này cho ImageStudio:
Tạo một bài đăng [1080×1350] cho [Instagram] về [đợt sale mùa xuân của chúng tôi].
Dùng [ảnh sản phẩm của tôi] làm ảnh chính và giữ nguyên sản phẩm như hiện tại.
Đặt sản phẩm trên nền [studio màu be dịu], ánh sáng tự nhiên.
Ghi đúng tiêu đề này: "[Sale mùa xuân — giảm 20%]".
Để [logo của tôi] ở góc dưới bên phải.
Xuất ra tệp PNG.Khi ảnh xong, hãy yêu cầu chỉnh sửa cụ thể, ví dụ: "Phóng to tiêu đề và chuyển logo lên góc trên bên phải." ImageStudio sẽ thay đổi phần đó và giữ nguyên phần còn lại.
Các mô hình Nano Banana và giá
Nano Banana là tên Google dùng cho tính năng tạo ảnh của Gemini. Đây là các mô hình trong Gemini API, kèm giá niêm yết của Google cho mỗi ảnh ở gói trả phí:
| Mô hình | ID mô hình | Giá mỗi ảnh | Ghi chú |
|---|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 | $0.0336 (1K), $0.0504 (2K), $0.113 (4K) | Mô hình mới nhất, phát hành chính thức từ ngày 6 tháng 10 năm 2026. Nên bắt đầu từ đây. |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | $0.0336, chỉ 1K | Nhanh nhất và rẻ nhất. Không dành cho việc dùng nhiều ảnh tham chiếu hay chỉnh sửa từng bước. |
| Nano Banana Pro | gemini-3-pro-image | $0.134 (1K hoặc 2K), $0.24 (4K) | Cho cảnh phức tạp; mô hình suy luận trước khi vẽ. |
| Nano Banana 2 | gemini-3.1-flash-image | $0.067 (1K), $0.101 (2K), $0.151 (4K) | Đã lỗi thời; Google khuyên dùng 2.1 cho dự án mới. |
| Nano Banana | gemini-2.5-flash-image | $0.039 | Mô hình gốc. Google sẽ ngừng mô hình này vào ngày 15 tháng 3 năm 2027. |
Ba điều khiến nhiều người vấp phải:
- Không có gói miễn phí cho ảnh. Để tạo ảnh bằng khóa API, bạn phải liên kết tài khoản thanh toán và trả trước ít nhất $5. Gói dùng thử miễn phí $300 của Google Cloud không áp dụng cho Gemini API.
- Các ID mô hình preview không còn hoạt động. Google đã ngừng gemini-2.5-flash-image-preview vào ngày 15 tháng 1 năm 2026, và gemini-3.1-flash-image-preview cùng gemini-3-pro-image-preview vào ngày 25 tháng 6 năm 2026. Công cụ nào vẫn gọi một trong các ID đó sẽ bị lỗi.
- Mọi ảnh đều mang thủy vân SynthID vô hình. Điều này áp dụng cho tất cả các mô hình ở trên.
Giá và ID lấy từ trang giá của Google và hướng dẫn tạo ảnh, tính đến ngày 8 tháng 11 năm 2026.
So sánh các máy chủ MCP và skill cho Nano Banana
Đây là những dự án được nhắc đến nhiều nhất khi dùng với Claude Code. Tất cả đều miễn phí và mã nguồn mở; tiền ảnh thì bạn trả cho Google. Hãy kiểm tra mô hình trước khi cài:
| Dự án | Đây là gì | Mô hình mặc định | Cần đổi gì |
|---|---|---|---|
| nanobanana-mcp-server | Máy chủ MCP, chạy bằng uv | Một ID preview của Nano Banana 2 đã bị ngừng | Đặt NANOBANANA_MODEL thành flash, tức dùng Nano Banana gốc |
| Tiện ích mở rộng nanobanana | Tiện ích mở rộng của Google cho Gemini CLI | Một ID preview của Nano Banana 2 đã bị ngừng | Đặt NANOBANANA_MODEL thành gemini-nano-banana-2.1 |
| cc-nano-banana | Skill cho Claude Code, chạy tiện ích mở rộng ở trên | Mặc định của tiện ích mở rộng | Cùng thiết lập như tiện ích mở rộng |
| Nano-Banana-MCP | Máy chủ MCP, chạy bằng npx | Một ID preview của Nano Banana, viết cứng trong code | Không có thiết lập nào cho việc này; tạm bỏ qua cho đến khi dự án được cập nhật |
Chúng tôi đã kiểm tra code của từng dự án vào ngày 8 tháng 11 năm 2026. Hãy đọc README trước khi cài một dự án: nó chạy code trên máy tính của bạn và gửi prompt cùng ảnh của bạn tới Google.
Cách thêm Nano Banana vào Claude Code bằng máy chủ MCP
- Tạo khóa Gemini API trong Google AI Studio, rồi liên kết thanh toán và nạp tiền trả trước.
- Cài uv, công cụ này sẽ tải và chạy máy chủ giúp bạn.
- Thêm máy chủ trong terminal:
claude mcp add --env GEMINI_API_KEY=your-key --env NANOBANANA_MODEL=flash --transport stdio nanobanana -- uvx nanobanana-mcp-server@latest. Giữ--transport stdiongay trước tên; nếu không, Claude Code sẽ hiểu tên đó là một biến khác. - Kiểm tra kết nối: khởi động Claude Code và gõ
/mcp. - Yêu cầu ảnh như một phần của tác vụ, ví dụ: "Tạo một ảnh hero 16:9 cho landing page này, lưu vào public/images, rồi mở ra và cho tôi biết cần sửa gì."
Máy chủ lưu ảnh vào thư mục nanobanana-images trong thư mục home của bạn, trừ khi bạn đặt IMAGE_OUTPUT_DIR. Mặc định, lệnh trên chỉ thêm máy chủ cho riêng bạn, trong dự án hiện tại. Thêm --scope user để dùng nó trong mọi dự án. Đừng thêm với phạm vi project: cách đó ghi khóa vào tệp .mcp.json mà bạn có thể commit lên.
Thiết lập flash dùng Nano Banana gốc, mô hình duy nhất trong danh sách của máy chủ này mà Google vẫn còn phục vụ, và Google sẽ ngừng nó vào ngày 15 tháng 3 năm 2027. Nano Banana 2.1 mới chỉ nằm trong một pull request chưa được phát hành. Để dùng 2.1 ngay hôm nay, hãy đi theo cách dùng tiện ích mở rộng bên dưới, hoặc dùng ImageStudio với khóa Gemini của bạn.
Dùng skill thay thế
Skill giữ các quy tắc làm ảnh của bạn ở một chỗ, chẳng hạn các kích thước bạn hay dùng và cấu trúc prompt bạn thích. Skill nổi tiếng nhất, cc-nano-banana, hoạt động qua tiện ích mở rộng Gemini CLI của Google:
- Cài Gemini CLI và tiện ích mở rộng:
npm install -g @google/gemini-cli, sau đógemini extensions install https://github.com/gemini-cli-extensions/nanobanana. - Đặt hai biến trong shell profile:
NANOBANANA_API_KEYchứa khóa Gemini của bạn, vàNANOBANANA_MODEL=gemini-nano-banana-2.1. - Thêm skill:
git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana - Yêu cầu Claude Code tạo ảnh, hoặc gọi skill theo tên bằng
/nano-banana.
Hãy đọc tệp SKILL.md của skill này trước. Tệp này bảo Claude chạy Gemini CLI với cờ --yolo, cờ này tự duyệt mọi thao tác của Gemini CLI mà không hỏi. Một số người dùng còn báo rằng tiện ích mở rộng không nhận được khóa từ shell. Nếu bạn tự viết skill, hãy ghi ID mô hình vào đó và giữ khóa trong biến môi trường, đừng để trong tệp skill.
Chạy Claude Code từ Orkas
Bạn không cần chọn giữa Orkas và thiết lập sẵn có của mình.
- Máy chủ MCP và skill của bạn vẫn hoạt động. Trong thanh bên, chọn Kết nối tác tử rồi chọn Claude Code. Orkas chạy bản Claude Code đã cài trên máy tính của bạn, với tài khoản bạn đã đăng nhập. Orkas thêm công cụ riêng bên cạnh các máy chủ MCP của bạn chứ không thay thế chúng, nên máy chủ Nano Banana và các skill bạn đã thiết lập vẫn được nạp.
- Để mỗi tác tử làm phần việc của mình. Nhờ Claude Code dựng trang hoặc ứng dụng, và nhờ ImageStudio tạo những ảnh cần thiết. ImageStudio lưu tệp trên máy tính của bạn, nên Claude Code có thể đưa chúng vào dự án.
Nên chọn cách nào?
| Mục tiêu của bạn | Bắt đầu với | Bạn nhận được |
|---|---|---|
| Bài đăng mạng xã hội, ảnh sản phẩm hoặc poster có chữ chính xác, không cần thiết lập | ImageStudio trong Orkas | Tệp PNG, JPG, WEBP, AVIF hoặc TIFF; mô hình tích hợp, tặng 500 điểm tín dụng miễn phí để bắt đầu |
| Nano Banana 2.1 mà không cần script hay tệp cấu hình | ImageStudio với khóa Gemini của bạn | Ảnh từ Nano Banana; Google tính phí, không tốn điểm tín dụng Orkas |
| Có ảnh ngay khi đang code, không rời Claude Code | Một máy chủ MCP Nano Banana, đã đặt mô hình | Ảnh lưu trên máy tính của bạn; Google tính phí từng ảnh |
| Quy trình làm ảnh lặp lại được, theo quy tắc của riêng bạn | Một skill Nano Banana | Một skill bạn tự cài, tự đọc và tự cập nhật |
| Biểu tượng, sơ đồ và biểu đồ | Chỉ cần Claude Code | SVG hoặc code biểu đồ; không cần mô hình tạo ảnh |
Câu hỏi thường gặp
Claude Code có tự tạo ảnh được không?
Không. Anthropic cho biết Claude không tạo ảnh chụp hay tranh minh họa theo cách các công cụ tạo ảnh vẫn làm. Claude Code có thể viết SVG, HTML và code biểu đồ, đồng thời mở tệp ảnh để kiểm tra, nên nó kết hợp tốt với một mô hình tạo ảnh như Nano Banana.
Dùng Nano Banana trong Claude Code có miễn phí không?
Không. Gemini API không có gói miễn phí cho các mô hình ảnh: bạn phải liên kết thanh toán và trả trước ít nhất $5, và gói dùng thử miễn phí $300 của Google Cloud không áp dụng cho khoản này. Nano Banana 2.1 có giá $0.0336 cho mỗi ảnh 1K. ImageStudio trong Orkas có mô hình tích hợp, và tài khoản mới được tặng 500 điểm tín dụng miễn phí.
Nên dùng mô hình Nano Banana nào?
Hãy bắt đầu với Nano Banana 2.1 (gemini-nano-banana-2.1), mô hình mới nhất. Dùng Nano Banana 2 Lite cho ảnh 1K rẻ nhất, và Nano Banana Pro cho cảnh phức tạp. Tránh mọi ID mô hình kết thúc bằng -preview; Google đã ngừng các mô hình đó.
Vì sao máy chủ MCP Nano Banana của tôi trả về lỗi 404?
Nhiều khả năng nó đang gọi một mô hình mà Google đã ngừng. Google đã tắt gemini-2.5-flash-image-preview vào ngày 15 tháng 1 năm 2026, và gemini-3.1-flash-image-preview cùng gemini-3-pro-image-preview vào ngày 25 tháng 6 năm 2026. Hãy chuyển máy chủ sang một mô hình hiện hành nếu nó có thiết lập cho việc này, hoặc đổi sang công cụ cho phép bạn chọn mô hình.
Có cần khóa Gemini API để tạo ảnh trong Orkas không?
Không. ImageStudio dùng mô hình tích hợp Seedream 5.5, và tài khoản mới được tặng 500 điểm tín dụng miễn phí. Nếu bạn thêm khóa Gemini của riêng mình, ImageStudio sẽ chuyển sang dùng Nano Banana 2.1, và Google tính phí những ảnh đó.
Để tiếp tục chỉnh ảnh trong Photoshop, xem Cách dùng Claude với Photoshop. Muốn có thêm ý tưởng, xem những gì bạn có thể làm với ImageStudio. Để thử với ảnh của chính bạn, hãy tải Orkas và bắt đầu với ImageStudio.