用 Claude AI 和 Blender 创建 3D 模型——从对话到 .blend 文件

从 blender.org 下载 Blender：它免费、开源（GPL 许可证），可在 Windows、macOS 和 Linux 上运行。请安装 4.0 或更新的版本。Blender 内置完整的 Python 解释器和全面的 Python API，程序中的每一项操作都能用脚本完成。Claude 正是用它来创建 3D 模型：Blender 中的每个按钮、菜单和工具在 Python 里都有对应的命令。

安装后，先打开一次 Blender，确认它能正常启动。你会看到带有一个立方体、一台摄像机和一盏灯的默认初始场景。然后关闭它：在与 AI 协作的流程中，Blender 将被远程控制。

把 Claude 连接到 Blender 有两种方式，请选择适合你环境的一种：

方式 A——Blender MCP 服务器（Claude Desktop）：在 Blender 中安装一个 Model Context Protocol（MCP）插件，把它变成本地服务器。Claude Desktop 直接连接到它，可以运行 Python 代码、截取视口画面、读取场景信息，而你可以在 Blender 窗口中实时看到模型逐步成形。

方式 B——无界面的 Blender API（Claude Code）：以无界面模式（没有 GUI）运行 Blender，并用 FastAPI 服务器包装。Claude Code 通过 HTTP 发送 Python 脚本，Blender 执行后返回输出文件。这种方式批量处理更快，并可在远程服务器上运行，但你无法实时看到视口：完成的 .blend 文件要事后再检查。

如果想看到每一处改动，方式 A 更适合交互式设计。方式 B 更适合自动化流程、服务器端生成以及没有显示器的工作环境。

从 GitHub 安装 Blender MCP 插件（'blender-mcp' 项目，项目中称它为 MCP for Blender；该插件在 Blender 内运行一个可以与 Claude 通信的服务器）。下载它的 addon.py 文件。在 Blender 中：Edit → Preferences → Add-ons → Install… → 选择 addon.py，然后启用 'Interface: MCP for Blender'。在 3D 视口中按 N 打开侧边栏，选择 MCP for Blender 标签页。

点击 'Start MCP Server'。现在 Blender 正在等待来自 Claude 的连接。在 Claude Desktop 的设置中，把 Blender MCP 服务器添加为工具来源（配置片段见项目的 README）。连接后，Claude 就能使用 execute_blender_code、get_scene_info 和 get_viewport_screenshot 等工具：通过对话设计 3D 模型所需的一切都具备了。

创建一个包装无界面 Blender 的 FastAPI 服务器。服务器通过 POST /execute 端点接收 Python 脚本，在 Blender 的后台模式（blender --background --python）中运行，并返回输出文件。最简单的服务器只需要一个端点：

把从 Claude 收到的 Python 代码写入任务目录中的一个文件，例如 job.py，然后用以下命令运行：blender --background --python job.py。把生成的 .blend 文件保存到任务目录，并通过 GET /files 端点提供下载。Claude Code 调用这些 HTTP 端点来发送脚本并取回成品模型文件。

这与 AI 图像生成流程（ComfyUI）所用的架构相同：一个用 API 包装的无界面创作工具，运行在可以使用 GPU 的服务器上。

用平实的语言告诉 Claude 你想做什么。尺寸、材料和物理特性要说得具体。例如：

'设计一个重 1 kg 的横锤铁匠锤头。打击面是圆角正方形，锤尖要水平（Z 方向薄、Y 方向宽），用来推展金属。在两个平面侧刻上老弗萨克如尼文字 ᚦᛟᚱ（TOR），深 3 mm。缩放几何体，使体积正好为 127.4 cm³（1 kg 密度为 7850 kg/m³ 的淬火钢）。再开一个装锤柄用的椭圆形孔。'

Claude 会把这段描述转换成一系列 Blender 的 Python 操作。描述越精确，第一版就越接近你想要的结果。请使用真实的数值（毫米、克、度），而不是'做大一点'这样的相对说法。

Claude 编写一个 Python 脚本，用 Blender 的 Python API（bpy 模块）构建模型。锤头的典型步骤如下：

1. 创建一个立方体基本体，并缩放到锤子的大致尺寸
2. 细分网格，增加用于塑形的几何体
3. 逐个处理顶点，塑造横向锤尖的收窄、打击面的轮廓和中部的隆起
4. 应用 Subdivision Surface 修改器，得到平滑的曲面
5. 用圆柱体做布尔 DIFFERENCE 运算，开出锤柄孔
6. 计算网格体积，并在各方向施加相同的缩放系数，使其达到 1 kg 钢
7. 为如尼文字的每一笔创建小的切割立方体，并用布尔运算从表面减去

Claude 把这个脚本发送给 Blender（通过 MCP 或 API）。Blender 执行脚本并生成 3D 几何体。使用 MCP（方式 A）时，你能看到模型实时出现在视口中。

检查模型。使用方式 A 时，在 Blender 视口中环绕模型查看。使用方式 B 时，下载 .blend 文件并在 Blender 中打开，或者请 Claude 渲染一张视口截图。检查尺寸、比例和细节精度。第一版中的常见问题以及如何引导 Claude 修正：

• 某一面的文字看起来是反的 → 指明哪个面（+Y 或 -Y）需要镜像
• 模型太小或太大 → 以 mm 为单位给出目标尺寸
• 曲面上的雕刻消失了 → Claude 需要在每个雕刻位置查询表面的实际位置
• 布尔运算破坏了网格 → 告诉 Claude 每一笔使用单独的切割物体，而不是合并后的几何体
• 特征位于错误的轴上 → 始终用轴向标记（+X、-Y、+Z）来沟通，绝不要用在 3D 中含义模糊的'前面'或'后面'

每次修正都是对话中的一轮：你描述问题，Claude 调整脚本并重新运行，然后你再次审查。通常两到五轮就能得到完成的模型。

旋转模型，检查每一个面。确认两个平面侧的如尼文字雕刻都能正确阅读：+Y 面上的文字从 +Y 方向看应自然地呈镜像，-Y 面上的文字从 -Y 方向看应能正确阅读。检查锤柄孔是否干净且居中。确认横向锤尖平滑收窄，没有锯齿状边缘。

在 Blender 中，按 Numpad 1 查看前视图（-Y 视图），Ctrl+Numpad 1 查看后视图（+Y 视图），Numpad 3 查看右视图（+X 视图），Numpad 7 查看顶视图（+Z 视图）。这些正交视图能暴露透视视图所掩盖的对齐问题。

把模型保存为 .blend 文件（File → Save As，或用脚本：bpy.ops.wm.save_as_mainfile(filepath='model.blend')）。.blend 是 Blender 的原生格式，是存档和分享的最佳选择：

• 保留所有修改器堆栈、材质、场景设置和编辑历史
• 完全可编辑：其他 maker 可以打开它，修改如尼文字、按不同重量调整尺寸，或调整任何参数

.blend 文件是该模型唯一的权威来源。

在 Youblob 上创建或编辑 blueprint 时，添加一个设计步骤（内容类型：'design'）并上传 .blend 文件。Youblob 会在浏览器中把 .blend 文件显示为可交互的 3D 预览，提供下载，并且无需转换成其他格式即可直接为 3D 打印做准备。

在步骤说明中写明模型的尺寸、重量和材料密度，让其他 makers 了解准确的规格。对于参数化模型（比如这个按重量缩放的锤子），请记录定制时需要修改哪些变量：其他 makers 应当能够按自己的需要修改设计，而不必从头开始。

与 Claude 一起设计北欧锤头及其他模型时总结的经验：

• 用轴向标记，而不是方位词：说'+Y 面'和'-Z 轴'，绝不要说'前面'或'上面'：这些说法在 3D 中含义模糊，会导致镜像的结果。
• 布尔运算需要单独的切割物体：在布尔运算前把多个基本体合并，会产生非流形（non-manifold）几何体。让每个切割物体保持为独立对象。
• 查询实际表面：经过细分和修改器之后，网格表面并不在原始尺寸所暗示的位置。放置雕刻或切口之前，Claude 应先测量顶点位置。
• 按体积缩放，而不是按尺寸：要达到目标重量，用有符号四面体法计算网格体积，然后施加统一的缩放系数：(target_vol / current_vol) ^ (1/3)。
• 分 2-5 轮迭代：第一个脚本能做对 80%。每一轮审查和修正都会找出剩下的问题。通常五轮就能得到可投入生产的模型。