1. 为什么要在 Claude Code 里直接生成视频写代码写到一半突然需要一段演示视频放进 README 或者发到社交平台这个场景你大概率遇到过。传统做法是切到浏览器打开某个视频生成网站登录、上传参考图、调参数、等渲染、下载再切回编辑器。思路被打断不说来回折腾十几分钟就没了。我想要的是一种更顺滑的方式在终端里用一句自然语言让 Claude Code 直接调用视频生成能力把结果文件落到本地。这就是 Claude Code 配合 Luma MCP 能做的事。MCP 全称 Model Context Protocol你可以把它理解成给 AI 助手插上「外部工具接口」的插座——Claude Code 本身只会读写代码和跑命令一旦挂上 Luma 这个 MCP 服务它就多了一个「生成视频」的工具能听懂「帮我生成一段视频」这种指令并真正执行。这套链路适合几类人独立开发者要给项目做动态演示、做产品的人要快速产出推广素材、写技术文章的人需要配图配视频。核心检索词就是Claude Code 调用 Luma MCP 生成 AI 视频关键词是命令行、MCP 配置、统一 Key。整条链路只有三步注册拿到一个统一 Key、把 Luma MCP 注册进 Claude Code、用自然语言触发。下面我把每一步拆到能直接复制粘贴的程度。需要先说明一点MCP 服务需要一个能鉴权的入口这里我用 TaoToken 的统一 Key 来接入一个 Key 覆盖多个模型服务省得每个服务单独申请。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 地址是 https://taotoken.net/api 。下面所有配置里的 Key 都替换成你自己在控制台生成的那一串。2. TaoToken 统一 Key 的前置准备与接入位置在动手配 MCP 之前先把「钥匙」准备好。很多人卡在第一步不是因为不会配而是不知道 Key 该填在哪、填成什么格式。这一节把前置动作讲清楚。2.1 注册与生成 API Key打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 用邮箱或者常用账号登录。登录后进入控制台找到 API Keys 页面deep linkhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。点「创建新的 Key」起个能认出来的名字比如claude-code-luma生成后立刻复制——多数平台只在创建时完整显示一次关掉就看不到了。这个 Key 的形态通常是一串以固定前缀开头的长字符串。它就是你后面所有配置里Authorization: Bearer后面那一段。把它先存到本地环境变量里别直接写死在会提交到 git 的文件里# macOS / Linux写入 shell 配置 echo export TAOTOKEN_API_KEYsk-你的真实Key ~/.zshrc source ~/.zshrc # 验证是否生效 echo $TAOTOKEN_API_KEYWindows PowerShell 用这个setx TAOTOKEN_API_KEY sk-你的真实Key # 重开一个终端后验证 echo $env:TAOTOKEN_API_KEY2.2 统一 Key 到底统一了什么传统做法是视频生成服务一个 Key、对话模型一个 Key、代码补全又一个 Key每个都要单独注册、单独充值、单独记。TaoToken 的思路是一个 Key 打通多个模型服务入口你在控制台充一次值后面接 Claude Code、接 Luma MCP、接其他工具都用同一串 Key。对个人开发者来说最直接的好处是配置心智负担下降——不用维护一张「哪个服务对应哪个 Key」的表格。这里要区分两个地址别搞混用途地址说明官网/控制台https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end注册、充值、看用量API 基址https://taotoken.net/api代码里请求的 Base URLAPI Keys 管理https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite生成/吊销 Key注意API 地址不要加 UTM 参数那是给网页统计用的写进代码里会变成非法路径。只有网页链接才带utm_source这类参数。2.3 确认 Claude Code 已就绪Luma MCP 是挂在 Claude Code 上的所以先确认 Claude Code 本身能跑。终端里执行claude --version能打印出版本号就说明装好了。如果提示 command not found先去装 Claude Code 本体官方文档有各平台安装方式这一步不展开。装好后随便进一个项目目录跑一次claude进入交互模式确认能正常对话再退出。基础环境没问题我们再往上挂 MCP。3. 可复制的 Luma MCP 配置片段这一节是全文的核心配置写对了后面就顺。Claude Code 注册 MCP 服务用的是claude mcp add命令关键参数有三个服务名、传输方式、服务地址外加一个鉴权头。3.1 一行命令注册 Luma MCP在终端里执行下面这行把你的Token换成第 2 节里拿到的真实 Keyclaude mcp add luma \ --transport http \ https://taotoken.net/api/mcp/luma \ -H Authorization: Bearer 你的Token拆开看每个部分luma是你给这个服务起的名字后面调用时会用到--transport http表示走 HTTP 传输中间那串是 MCP 服务端点-H是加请求头把 Key 以 Bearer 形式带上。注意-H必须大写。小写的-h在多数命令行工具里是--help会直接打印帮助信息然后退出配置根本不会写入。这个坑我第一次配的时候踩过命令看着执行了claude mcp list里却什么都没有。3.2 用 settings 片段固定配置推荐命令行注册适合快速试但团队协作或者换机器时把配置写进文件更稳。Claude Code 支持项目级的.mcp.json放在项目根目录可以提交到 git 让团队共享。内容长这样{ mcpServers: { luma: { type: http, url: https://taotoken.net/api/mcp/luma, headers: { Authorization: Bearer ${TAOTOKEN_API_KEY} } } } }注意这里用了${TAOTOKEN_API_KEY}占位符而不是把 Key 明文写进去。这样文件可以安全提交真实 Key 从环境变量读。如果你更习惯用 TOML 风格的配置部分工具链支持等价写法是[mcp_servers.luma] type http url https://taotoken.net/api/mcp/luma [mcp_servers.luma.headers] Authorization Bearer ${TAOTOKEN_API_KEY}3.3 作用域怎么选claude mcp add默认写入 local 作用域只在当前目录生效。三种作用域的区别如下作用域命令参数配置文件生效范围local默认无 或-s local~/.claude.json仅当前项目目录user-s user~/.claude.json全局所有项目可用project-s project项目根.mcp.json当前项目可提交共享个人开发建议用-s user一次配置到处能用团队协作建议-s project配置跟着仓库走。要共享给团队时命令改成claude mcp add luma -s project \ --transport http \ https://taotoken.net/api/mcp/luma \ -H Authorization: Bearer ${TAOTOKEN_API_KEY}3.4 三件套要写全不管用哪种方式接入一个模型服务永远绕不开三件套Base URL、Key、Model ID。在 Luma MCP 这个场景里Base URL 是https://taotoken.net/api/mcp/lumaKey 是TAOTOKEN_API_KEYModel ID 则由 MCP 服务内部映射到具体的视频生成模型你在调用时用工具名比如luma_generate_video来指定不需要手填模型字符串。如果你后面接的是 Codex 这类需要auth.json的工具三件套就要显式写进配置文件{ base_url: https://taotoken.net/api, api_key: ${TAOTOKEN_API_KEY}, model: 你的模型ID }配置写完后别急着生成视频先验证连接。4. 验证请求与一次完整的生成任务配置写完不代表能用得先确认 MCP 服务真的连上了再跑一次真实生成任务看结果回传。4.1 确认 MCP 连接状态终端执行claude mcp list预期输出里应该能看到luma这一行后面跟着✓ Connected。如果显示✗ Failed或者干脆没出现先别往下走回到第 5 节排查。连接正常的话输出大概长这样Checking MCP server health... luma: https://taotoken.net/api/mcp/luma (HTTP) - ✓ Connected4.2 在会话里触发一次生成进入 Claude Code 交互模式claude然后用自然语言描述你要的视频。比如给项目做演示用 luma 生成一个视频一台笔记本电脑屏幕显示代码 旁边放一杯冒热气的咖啡柔和的晨光从窗户照进来Claude Code 会识别出你调用了 luma 工具自动组装参数发请求。它内部调用的工具名是luma_generate_video从文本生成视频。如果你想基于已有截图做动画用带参考图的工具使用这张 UI 截图生成视频给界面元素添加细微的动画这时走的是luma_generate_video_with_reference接受图像或视频作为参考。视频太短想续上用luma_extend_video把这个视频延长 10 秒保持相同风格三个工具的分工整理成表工具名作用典型场景luma_generate_video从文本生成视频纯文字描述出片luma_generate_video_with_reference基于参考图/视频生成截图转动画演示luma_extend_video从视频末尾续接时长不够风格延续4.3 结果回传与文件落地生成任务提交后MCP 服务会返回一个任务标识和状态。视频渲染需要时间Claude Code 会轮询状态完成后把视频 URL 或本地路径回传给你。预期输出类似✓ Video generation completed Task ID: luma-task-xxxx Output: ./outputs/luma_xxxx.mp4 Duration: 5s拿到本地文件后直接拖进 README 或者上传到社交平台就行。整个过程你没离开终端思路没断。如果返回的是远程 URL用curl拉下来curl -o demo.mp4 返回的视频URL4.4 用 API 直接验证可选如果你想脱离 Claude Code 单独测一下 Key 和端点通不通可以直接打 APIcurl -X POST https://taotoken.net/api/mcp/luma \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d {jsonrpc:2.0,method:tools/list,id:1}返回里能看到可用工具列表说明鉴权和端点都没问题。这一步能帮你快速区分是「Key 的问题」还是「Claude Code 配置的问题」。5. 本篇常见报错排查配置和调用过程中报错基本集中在鉴权、连接、响应解析三类。下面按真实报错对照排查。5.1 401 Unauthorized最常见。原因通常是 Key 没带对或者过期。检查三处环境变量TAOTOKEN_API_KEY是否真的导出成功echo $TAOTOKEN_API_KEY看有没有值-H里的Bearer和 Key 之间有没有多余空格Key 是不是在控制台被吊销了。重新生成一个 Key再跑一次claude mcp add覆盖旧配置。5.2 local proxy failed / connection refused这个报错说明 Claude Code 连不上 MCP 端点。先确认网络能通curl -I https://taotoken.net/api/mcp/luma如果这里就失败检查地址有没有写错——特别注意别把网页链接的 UTM 参数抄进 API 地址。如果curl通但 Claude Code 报错多半是--transport类型写错了HTTP 服务必须用--transport http。5.3 reading choices / 响应解析失败这类报错通常出现在服务返回了非预期格式时。检查你的请求是不是被中间层改写了或者 Key 对应的额度是否耗尽。去控制台看用量额度用完会返回错误而不是正常结果。充值入口在控制台里支持常见支付方式。5.4 OAuth 相关报错如果你用的是 claude.ai 网页版或 Claude 桌面版它们支持 OAuth 一键授权不需要手动填 Key。但 Claude Code 命令行走的是手动 Bearer 鉴权两者配置方式不同。别把网页版的 OAuth 流程套到命令行上命令行就老老实实配-H Authorization: Bearer ...。5.5 配置没生效claude mcp list里看不到 luma八成是作用域问题。默认 local 只在当前目录生效你换个目录就没了。改成-s user全局生效或者确认你在正确的项目目录里。另外.mcp.json如果放在子目录而不是项目根也不会被读取。排查顺序建议先curl测端点通不通 → 再claude mcp list看连接状态 → 最后进会话触发工具。一层层缩小范围比盲目改配置快得多。6. 把这条链路用起来配置跑通之后真正有价值的是把它嵌进日常工作流。我自己的习惯是项目写到阶段性节点直接在 Claude Code 里让 luma 生成一段演示视频落到outputs/目录然后顺手写进 README 的演示区。整个过程不用切窗口思路连贯。几个实用技巧提示词里把镜头、光线、主体写具体生成结果更可控需要风格统一时用参考图工具而不是纯文本视频时长不够就用续接工具别重新生成。Key 统一放在环境变量里换机器只改一处。如果你还没开始从注册拿 Key 到跑通第一次生成按第 2 到第 4 节的顺序走一遍大概十分钟。API Keys 在 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 想先试试模型对话可以去 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。长期做编码和 Agent 的话Coding Plan 更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。