1. 终端里出图这件事卡在哪一步Claude Code 已经能在终端里读写文件、跑测试、改代码但它默认不会画画。你想让它顺手生成一张博客封面、一张架构示意图、一张 App 启动页草图它只能给你一段 SVG 或者干脆说“我无法生成图像”。Flux MCP 就是补上这块能力的东西它是一个遵循 Model Context Protocol 的服务把 Flux 系列图像模型包装成 Claude Code 可以直接调用的工具。配好之后你在 Claude Code 会话里说一句“用 flux-dev 生成三张开发者博客封面”终端里就会真的返回图片链接而不是文字描述。这篇面向三类人一是已经在用 Claude Code、想给它加图像能力的开发者二是做产品原型、需要快速出视觉稿的设计和前端三是写内容、经常要配图的创作者。核心链路只有三步——拿到可用的 API Key、把 Flux MCP 注册进 Claude Code、在会话里用自然语言触发图像生成。全程在终端完成不需要打开浏览器点来点去。下面按可复制的顺序走一遍包括配置骨架、验证命令和几个我实际踩过的坑。2. 前置准备TaoToken 的 Key 与 MCP 接入点Flux MCP 需要一个能调用模型的凭证。这里用 TaoToken 作为统一入口它把图像、文本等模型能力收敛到一套 API Key 上省得你为每个服务单独申请。你需要两样东西一个 API Key以及 MCP 服务的接入地址。先到官网注册并登录地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。登录后在控制台里找到 API Keys 页面新建一个 Key 并复制。这个 Key 就是后面配置里Authorization: Bearer后面那串字符。注意它只在创建时完整显示一次先存到安全的地方。MCP 的接入地址走 API 域名即 https://taotoken.net/api 不要带任何查询参数。Claude Code 注册 MCP 时填的是这个基础地址加对应路径。如果你后面要换模型或加别的 MCP 服务Key 是通用的不用重新申请。提示Key 属于敏感凭证不要直接写进会提交到公开仓库的配置文件。团队协作时用环境变量占位具体做法在配置章节展开。3. 把 Flux MCP 注册进 Claude CodeClaude Code 通过claude mcp add命令注册 MCP 服务。最简形式如下把你的Key替换成上一步复制的值claude mcp add flux --transport http https://taotoken.net/api/mcp \ -H Authorization: Bearer 你的Key这里有几个参数必须说清楚。--transport http表示走 HTTP 传输Flux MCP 是远程服务不用本地起进程。-H是大写用来附加请求头小写-h是帮助参数写错了命令行为会完全不一样这是新手最容易翻车的点。flux是你给这个 MCP 起的名字后面在会话里引用它、在list里查它都用这个名字。默认不加作用范围参数时配置只对当前目录生效存在~/.claude.json里。如果你希望全局可用加-s user如果想让整个项目组共享加-s project配置会写进项目根目录的.mcp.json。三种范围的对照如下范围命令参数配置文件生效范围local默认无 或-s local~/.claude.json仅当前目录user-s user~/.claude.json当前用户全局project-s project项目根.mcp.json当前项目可随 git 共享团队协作推荐-s project但.mcp.json里不要写真实 Key。用环境变量占位例如把请求头写成-H Authorization: Bearer ${TAOTOKEN_API_KEY}然后在各自的环境里导出这个变量。这样配置能进版本库Key 留在本地。注册完成后立刻验证连接状态claude mcp list输出里找到flux这一行如果状态是✓ Connected说明 Claude Code 已经能访问这个 MCP 服务。如果显示 failed 或超时先别急着改配置跳到第 5 节排查。4. 一行命令触发图像生成并验证结果连接正常后进入 Claude Code 会话直接用自然语言下指令。Flux 提供三种模式对应不同场景你可以按需切换。快速实验用 Dev 模式生成快、成本低适合试风格用 flux-dev 快速生成 3 张不同风格的开发者博客封面图分别试扁平、写实、抽象确定风格后要提升细节和分辨率切 Pro用 flux-pro 重新生成第二张提高细节和分辨率如果只想改已有图的局部用 Kontext不重绘整张编辑这张海报图把右下角的日期从 2024 改成 2025底层实际暴露给 Claude Code 的工具主要有两个flux_generate_image负责文生图flux_edit_image负责局部编辑。你在会话里说人话Claude Code 会自己决定调哪个工具、传什么参数。怎么判断图像真的生成成功了看返回内容里有没有可访问的图片 URL以及工具调用是否返回了成功状态。如果返回的是错误信息或空结果说明请求没走通。实测下来成功返回通常包含图片链接和尺寸、模型名等元数据失败则会给出一段错误描述比如鉴权失败或参数不合法。拿到 URL 后直接在浏览器打开确认图像内容这是最直接的验证方式。5. 常见报错与排查清单Token 无法连接。先检查-H Authorization: Bearer 你的Key这一整段Bearer和 Key 之间有一个空格Key 前后不能有多余空格或换行。再确认网络能访问https://taotoken.net/api公司内网或代理环境可能拦截。如果 Key 是刚创建的确认没有复制到隐藏字符。claude mcp list里 flux 状态不是 Connected。大概率是传输方式或地址写错。确认用的是--transport http地址是https://taotoken.net/api/mcp路径别漏。改完配置后重新执行add命令覆盖或者手动编辑对应配置文件。生成图像质量不理想。先切模式Dev 换 Pro 通常细节提升明显。再检查提示词把风格、构图、色调、用途写具体比如“扁平风格、蓝紫渐变、留白多、适合博客头图”比只写“生成一张封面”效果好得多。多人共享项目配置。用-s project写入.mcp.jsonKey 用${TAOTOKEN_API_KEY}占位提交前确认没有明文凭证。同事拉下代码后导出同名环境变量即可直接用。改了配置不生效。Claude Code 的 MCP 配置在会话启动时加载改完配置要重开会话。另外确认你改的是当前生效范围对应的那个文件local 和 user 都指向~/.claude.json容易混淆。6. 接下来怎么用得更顺图像能力接进终端后最省事的用法是把它嵌进你已有的工作流写博客时让 Claude Code 顺手生成头图做原型时让它按组件描述出草图改设计稿时用 Kontext 只动局部。Key 和 MCP 配置一次搞定后面都是自然语言调用。如果你还想把文本模型、其他多模态能力也接进来可以在控制台统一管理 Key接入文档在 https://taotoken.net/api 对应的说明页里。需要长期跑编码和 Agent 任务的话Coding Plan 会更合适模型对话入口则适合先验证生成效果再决定用哪个模式。配置骨架和验证命令都在上面照着走一遍终端里出图这件事就通了。