1. 為什么我要在 Claude Code 里塞一個(gè)出圖 SkillClaude Code 本身是個(gè)終端里的編碼 Agent能讀文件、跑命令、改代碼但它默認(rèn)不會(huì)畫(huà)圖。Nano Banana Pro 是圖像生成模型出圖質(zhì)量不錯(cuò)尤其適合做封面、流程圖、信息圖這類設(shè)計(jì)物料。問(wèn)題在于每次出圖都要手動(dòng)拼提示詞、調(diào)參數(shù)、下載圖片、檢查文字有沒(méi)有寫(xiě)錯(cuò)改一版風(fēng)格全變?cè)俑奈淖殖蓙y碼來(lái)回折騰四五次才能用。我想要的不是「再打開(kāi)一個(gè)網(wǎng)頁(yè)工具」而是「在 Claude Code 里說(shuō)一句話圖就出來(lái)了」。這就需要 Skill 機(jī)制把 Nano Banana Pro 的 API 調(diào)用、提示詞模板、出圖后的自檢邏輯全部封裝成一個(gè) Claude Code 能識(shí)別的技能包。你說(shuō)「畫(huà)一張講 Skill 機(jī)制的封面圖」Claude Code 自動(dòng)讀 Skill 配置、調(diào) API、拿回圖片、檢查文字、不對(duì)就重試最后把成品路徑告訴你。適合誰(shuí)經(jīng)常寫(xiě)技術(shù)文章需要配圖的人、做產(chǎn)品文檔要出流程圖的人、以及想讓 Agent 幫自己跑完整設(shè)計(jì)鏈路的人。下面我從零開(kāi)始把 Skill 配置文件骨架、統(tǒng)一 Key/API 通道的 settings.json 片段、以及一句話觸發(fā)出圖的驗(yàn)證步驟全部給出來(lái)你復(fù)制配置就能跑通。2. 前置準(zhǔn)備TaoToken 統(tǒng)一 Key 與 API 通道Claude Code 調(diào)外部模型 API 時(shí)最煩的是每個(gè)模型一套 Key、一套 Base URL、一套鑒權(quán)頭。TaoToken 的作用是把這些統(tǒng)一成一個(gè)入口你拿一個(gè) Key配一個(gè) Base URL后面換模型只改模型名不用改鑒權(quán)邏輯。對(duì) Skill 來(lái)說(shuō)這意味著配置文件里只需要維護(hù)一份憑證出圖 Skill 和對(duì)話模型共用同一條通道。先拿 Key。打開(kāi) https://taotoken.net/api-keys 登錄后創(chuàng)建一個(gè) API Key復(fù)制出來(lái)。這個(gè) Key 同時(shí)用于 Claude Code 的模型對(duì)話和 Nano Banana Pro 的出圖調(diào)用。注意不要把它寫(xiě)進(jìn) Git 倉(cāng)庫(kù)后面我會(huì)用環(huán)境變量引用。TaoToken 的 API 入口是 https://taotoken.net/api 不帶任何多余路徑。Claude Code 的 settings.json 里配置ANTHROPIC_BASE_URL指向它模型名按你實(shí)際用的填。如果你還沒(méi)裝 Claude Code先按官方文檔裝好能正常對(duì)話后再往下走。注意Key 只顯示一次復(fù)制后存到密碼管理器或本地環(huán)境變量文件里。后面所有配置都通過(guò)$TAOTOKEN_API_KEY引用不硬編碼。3. Skill 配置文件骨架讓 Claude Code 認(rèn)識(shí)出圖能力Claude Code 的 Skill 放在~/.claude/skills/目錄下每個(gè) Skill 一個(gè)文件夾里面至少有一個(gè)SKILL.md描述技能用途和調(diào)用方式外加可選的腳本或配置文件。我這里的出圖 Skill 叫nano-banana-image目錄結(jié)構(gòu)如下~/.claude/skills/nano-banana-image/ ├── SKILL.md ├── config.json └── generate.pySKILL.md是給 Claude Code 看的說(shuō)明書(shū)告訴它這個(gè) Skill 能干什么、什么時(shí)候觸發(fā)、參數(shù)怎么傳。內(nèi)容骨架--- name: nano-banana-image description: 調(diào)用 Nano Banana Pro 生成圖像支持封面、流程圖、信息圖。當(dāng)用戶說(shuō)“畫(huà)一張”“出圖”“生成封面”時(shí)觸發(fā)。 --- # Nano Banana Pro 出圖 Skill ## 用途 根據(jù)自然語(yǔ)言描述生成圖像自動(dòng)檢查圖中文字是否正確不對(duì)則重試。 ## 調(diào)用方式 運(yùn)行 python generate.py --prompt 描述 --output 輸出路徑 ## 參數(shù) - prompt: 圖像描述必填 - output: 輸出文件路徑默認(rèn) ./output.png - size: 圖像尺寸默認(rèn) 1024x1024config.json存 API 通道和默認(rèn)參數(shù)Key 從環(huán)境變量讀{ api_base: https://taotoken.net/api, api_key_env: TAOTOKEN_API_KEY, model: nano-banana-pro, default_size: 1024x1024, max_retries: 3 }generate.py是實(shí)際干活的腳本負(fù)責(zé)拼請(qǐng)求、調(diào) API、保存圖片、返回結(jié)果。核心邏輯import os, json, requests, sys, argparse def load_config(): with open(os.path.join(os.path.dirname(__file__), config.json)) as f: return json.load(f) def generate(prompt, output, size): cfg load_config() api_key os.environ.get(cfg[api_key_env]) if not api_key: raise RuntimeError(缺少環(huán)境變量 cfg[api_key_env]) resp requests.post( cfg[api_base] /v1/images/generations, headers{Authorization: Bearer api_key}, json{model: cfg[model], prompt: prompt, size: size}, timeout120 ) resp.raise_for_status() data resp.json() img_url data[data][0][url] img requests.get(img_url, timeout120) with open(output, wb) as f: f.write(img.content) return output if __name__ __main__: p argparse.ArgumentParser() p.add_argument(--prompt, requiredTrue) p.add_argument(--output, default./output.png) p.add_argument(--size, default1024x1024) args p.parse_args() print(generate(args.prompt, args.output, args.size))這段腳本只做一件事拿 prompt 調(diào) API把返回的圖片 URL 下載到本地。重試邏輯放在 Skill 層面由 Claude Code 根據(jù)出圖結(jié)果決定是否再調(diào)一次。4. settings.json 片段把 Key 和通道接進(jìn) Claude CodeClaude Code 的配置文件在~/.claude/settings.json。你需要把 TaoToken 的 Base URL 和 Key 配進(jìn)去讓 Claude Code 的模型對(duì)話走這條通道。片段如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的TaoToken Key, TAOTOKEN_API_KEY: 你的TaoToken Key } }ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY讓 Claude Code 的對(duì)話模型走 TaoTokenTAOTOKEN_API_KEY是給上面generate.py讀的兩個(gè) Key 是同一個(gè)只是變量名不同。如果你不想把 Key 明文寫(xiě)在 settings.json 里可以改成從 shell 環(huán)境變量繼承{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: ${TAOTOKEN_API_KEY}, TAOTOKEN_API_KEY: ${TAOTOKEN_API_KEY} } }然后在~/.zshrc或~/.bashrc里加一行export TAOTOKEN_API_KEY你的Key重啟終端和 Claude Code。這樣 Key 不進(jìn)配置文件也不怕誤提交。配完后重啟 Claude Code輸入/skills看列表里有沒(méi)有nano-banana-image。沒(méi)有的話檢查目錄名和SKILL.md的name字段是否一致。5. 驗(yàn)證請(qǐng)求一句話觸發(fā)出圖并檢查結(jié)果配置就緒后在 Claude Code 里直接說(shuō)畫(huà)一張講 Claude Code Skill 機(jī)制的封面圖風(fēng)格簡(jiǎn)潔深色背景中間寫(xiě)“Skill”大字Claude Code 會(huì)識(shí)別到「畫(huà)一張」觸發(fā)詞讀取nano-banana-imageSkill調(diào)用generate.py把 prompt 傳進(jìn)去。你會(huì)在終端看到類似輸出正在調(diào)用 Nano Banana Pro... 圖片已保存到 ./output.png打開(kāi)output.png檢查。如果圖中文字寫(xiě)錯(cuò)比如「Skill」變成「Skil」直接在 Claude Code 里說(shuō)「文字錯(cuò)了改成 Skill其他不變」。Claude Code 會(huì)把修正后的 prompt 重新傳給 Skill再出一版。實(shí)測(cè)下來(lái)把「文字必須準(zhǔn)確」寫(xiě)進(jìn) prompt 模板后一次成功率明顯提高。如果你想一次出多張可以說(shuō)「畫(huà)三張不同風(fēng)格的封面圖」Claude Code 會(huì)并行調(diào)三次 API分別保存為output_1.png、output_2.png、output_3.png。這比一張張等快很多。驗(yàn)證成功的標(biāo)志終端返回圖片路徑打開(kāi)圖片內(nèi)容符合描述文字無(wú)誤。到這一步從描述到成圖的鏈路就通了。6. 本篇常見(jiàn)錯(cuò)排查報(bào)錯(cuò)缺少環(huán)境變量 TAOTOKEN_API_KEY說(shuō)明generate.py沒(méi)讀到 Key。檢查~/.zshrc里的 export 是否生效echo $TAOTOKEN_API_KEY有沒(méi)有輸出。如果用的是 settings.json 明文配置確認(rèn)TAOTOKEN_API_KEY字段拼寫(xiě)正確。報(bào)錯(cuò)401 UnauthorizedKey 無(wú)效或過(guò)期。去 https://taotoken.net/api-keys 重新生成一個(gè)替換配置后重啟 Claude Code。注意 Key 前后不要有空格。報(bào)錯(cuò)404 model not foundconfig.json里的model字段和 TaoToken 支持的模型名不一致。檢查模型名拼寫(xiě)確認(rèn) Nano Banana Pro 在當(dāng)前通道可用。Skill 不觸發(fā)Claude Code 沒(méi)識(shí)別到「畫(huà)一張」這類觸發(fā)詞。檢查SKILL.md的description里是否包含觸發(fā)詞或者手動(dòng)說(shuō)「用 nano-banana-image Skill 畫(huà)一張」。圖片保存成功但打不開(kāi)可能是下載了錯(cuò)誤響應(yīng)體。在generate.py里加一行打印resp.status_code和data確認(rèn)返回的是圖片 URL 而不是錯(cuò)誤 JSON。文字反復(fù)寫(xiě)錯(cuò)在 prompt 里明確寫(xiě)「圖中文字必須為XXX不要改動(dòng)」并在 Skill 里加自檢步驟——出圖后讓 Claude Code 讀圖確認(rèn)文字不對(duì)就重試。這是 Skill 相比手動(dòng)出圖最大的優(yōu)勢(shì)經(jīng)驗(yàn)可以沉淀下次不用重新踩坑。7. 把出圖能力接進(jìn)你的日常工作流配好這個(gè) Skill 后你可以把它和寫(xiě)作 Skill 組合。比如你說(shuō)「寫(xiě)一篇講 API 網(wǎng)關(guān)的文章配一張封面圖」Claude Code 先調(diào)寫(xiě)作 Skill 生成正文再調(diào)出圖 Skill 生成封面最后把兩個(gè)文件路徑一起給你。整個(gè)過(guò)程你只說(shuō)了一句話。長(zhǎng)期做編碼或 Agent 開(kāi)發(fā)的話建議把常用 Skill 統(tǒng)一管理Key 和通道走 TaoToken 一份配置。需要看模型對(duì)話效果就去 https://taotoken.net/model-chat 需要管理 Key 就去 https://taotoken.net/api-keys 接入文檔在 https://taotoken.net/doc 。如果你打算把出圖 Skill 用在持續(xù)集成或批量生成場(chǎng)景可以看看 Coding Planhttps://taotoken.net/coding-plan 把調(diào)用額度規(guī)劃好避免跑一半斷掉。我踩過(guò)的坑是一開(kāi)始把 Key 硬編碼在generate.py里換 Key 時(shí)改了三個(gè)文件。后來(lái)統(tǒng)一用環(huán)境變量只改一處。另外 Skill 的description要寫(xiě)清楚觸發(fā)詞不然 Claude Code 不知道什么時(shí)候該用它。把這兩點(diǎn)做好后面基本不用再動(dòng)配置。