用 Claude Code 写 Blender Python

scene.py · empty scene to MP4, all in code (tested on Blender 5.3)

# scene.py: build a small animated scene entirely in code and render it.
# usage:
#   blender -b -P scene.py -- --preview      # 3 key frames at 25% size, as PNG
#   blender -b -P scene.py -- --final        # every frame at full size, as MP4
import sys, math, os
import bpy

args = sys.argv[sys.argv.index("--") + 1:] if "--" in sys.argv else []
PREVIEW = "--preview" in args
OUT = os.path.abspath(os.path.join(os.path.dirname(__file__), "out"))

bpy.ops.wm.read_factory_settings(use_empty=True)  # start from an empty scene
scene = bpy.context.scene
scene.frame_start, scene.frame_end = 1, 72          # 3 seconds at 24 fps
scene.render.fps = 24

def material(name, rgb, rough=0.5, metal=0.0):
    m = bpy.data.materials.new(name)
    p = m.node_tree.nodes["Principled BSDF"]
    p.inputs["Base Color"].default_value = (*rgb, 1)
    p.inputs["Roughness"].default_value = rough
    p.inputs["Metallic"].default_value = metal
    return m

# ground and a bouncing ball, all generated in code
bpy.ops.mesh.primitive_plane_add(size=20)
bpy.context.object.data.materials.append(material("Ground", (0.08, 0.09, 0.12), rough=0.9))
bpy.ops.mesh.primitive_uv_sphere_add(radius=0.6, segments=64, ring_count=32)
ball = bpy.context.object
bpy.ops.object.shade_smooth()
ball.data.materials.append(material("Ball", (0.95, 0.45, 0.15), rough=0.25))

# keyframes: three bounces, squashed on contact
for f in range(scene.frame_start, scene.frame_end + 1):
    t = (f - 1) / 24
    phase = (t % 1.0)
    height = 4 * phase * (1 - phase) * 2.0          # parabola per bounce
    ball.location = (t * 1.2 - 1.8, 0, 0.6 + height)
    squash = 1 - 0.25 * max(0.0, 1 - height / 0.4)
    ball.scale = (1 / math.sqrt(squash), 1 / math.sqrt(squash), squash)
    ball.keyframe_insert("location", frame=f)
    ball.keyframe_insert("scale", frame=f)

# light, camera, world
bpy.ops.object.light_add(type="SUN", location=(4, -4, 8))
bpy.context.object.data.energy = 3.0
bpy.context.object.rotation_euler = (math.radians(50), 0, math.radians(35))
bpy.ops.object.camera_add(location=(0, -10, 2.4), rotation=(math.radians(84), 0, 0))
scene.camera = bpy.context.object
scene.world = bpy.data.worlds.new("World")
scene.world.node_tree.nodes["Background"].inputs["Color"].default_value = (0.02, 0.025, 0.035, 1)

# render settings
scene.render.engine = "BLENDER_EEVEE"
scene.render.resolution_x, scene.render.resolution_y = 1280, 720
scene.render.resolution_percentage = 25 if PREVIEW else 100

if PREVIEW:
    scene.render.image_settings.file_format = "PNG"
    for f in (1, 18, 36):
        scene.frame_set(f)
        scene.render.filepath = os.path.join(OUT, f"preview_{f:03d}.png")
        bpy.ops.render.render(write_still=True)
else:
    scene.render.image_settings.media_type = "VIDEO"
    scene.render.image_settings.file_format = "FFMPEG"
    scene.render.ffmpeg.format = "MPEG4"
    scene.render.ffmpeg.codec = "H264"
    scene.render.filepath = os.path.join(OUT, "ball_")
    bpy.ops.render.render(animation=True)

Terminal · preview, then final (tested on Blender 5.3, Apple M4)

# macOS path; on Linux use "blender", on Windows the full path to blender.exe
BLENDER=/Applications/Blender.app/Contents/MacOS/Blender

$BLENDER -b -P scene.py -- --preview   # 3 frames at 25% size -> out/preview_*.png  (~26 s)
$BLENDER -b -P scene.py -- --final     # 72 frames at 1280x720 -> out/ball_0001-0072.mp4  (77 s, EEVEE)

~/.claude/skills/blender-scene/SKILL.md (ours)

---
name: blender-scene
description: Build, preview and render Blender scenes and animations with Python from the command line. Use when the user asks for a 3D scene, model, animation or rendered video made in Blender.
---

# Blender scenes from the command line

Blender: /Applications/Blender.app/Contents/MacOS/Blender   (edit for your machine)

1. Never open the Blender window. Run: BLENDER -b -P scene.py -- <args>.
2. At the start of a session, print bpy.app.version and the available render
   engines; do not rely on memory for API names.
3. Start from bpy.ops.wm.read_factory_settings(use_empty=True). Generate all
   geometry, materials, keyframes, camera and lights in code. No downloaded
   models, textures or HDRIs unless the user supplies them.
4. Compute every keyframe from the frame number so the animation is
   deterministic. Write reusable generator functions before assembling.
5. Keep two modes: --preview renders 3-6 key frames at 25% size as PNG;
   --final renders the whole animation.
6. After every change, run --preview, open the PNGs, list what looks wrong
   (out of frame, clipping, flat light, stiff motion), fix, and repeat.
7. Before --final, measure seconds per frame on the preview and tell the user
   how long the full render will take.
8. Video in Blender 5.x: image_settings.media_type = "VIDEO", then
   file_format = "FFMPEG", ffmpeg.format = "MPEG4", ffmpeg.codec = "H264".

Prompt template · Blender shot (ours)

Make a [length]-second Blender shot at [1280x720, 24fps]: [subject],
[camera move], [light and time of day], [mood].
Follow the blender-scene skill: command line only, everything generated in
code, deterministic keyframes. Show me the --preview frames and what you
fixed before you run --final, and tell me the expected render time first.

cURL

curl https://api.apimodels.app/v1/messages \
  -H "x-api-key: $APIMODELS_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5-2",
    "max_tokens": 64000,
    "messages": [{"role": "user", "content": "Write a Blender 5.3 Python script, run with blender -b -P, that builds a lighthouse at dusk entirely in code and renders 3 preview frames at 25% size."}]
  }'

Claude Code 能用 Blender 吗?

能。Claude Code 写一个 Python 脚本,用 blender -b -P scene.py 运行,不需要开窗口;然后打开渲染出来的 PNG 或 MP4 检查效果。想让它操作你正看着的 Blender 窗口,也可以用 Blender 的 MCP 服务器。

怎么用命令行渲染 Blender 动画?

运行 blender -b -P scene.py,在脚本里设好帧范围、分辨率和输出,再调用 bpy.ops.render.render(animation=True)。Blender 5.x 里要直接出 MP4,先把输出的 media_type 设成 VIDEO,再选 FFMPEG。我们 72 帧 1280×720 的测试用 EEVEE 在 Apple M4 上渲了 77 秒。

Claude 写的 Blender 脚本为什么报属性错误?

最常见的原因是 Blender API 版本之间有变化:引擎标识符、输出设置、节点选项每个版本都可能改。先让 Claude 打印 bpy.app.version 和可用的引擎名;在 Blender 5.x 上别再写 Material.use_nodes 和 World.use_nodes,它们已经弃用,节点树默认就有。

用 Blender 选哪个 Claude 模型最好?

最难的公开 Blender 作品是 Claude Fable 5.2 做的,比如在 Claude Code 里花了将近三小时做出来的写实骑车鹈鹕。简单场景和修改阶段,用 apimodels.app 上每百万 token $2.40 / $12 的 Opus 5.5,价格是 Fable 5.2 的一半;小改动用 $1.20 / $6 的 Sonnet 5.5。

用 Claude 做一个 Blender 动画要多少钱?

一次长的写实任务可能用掉约 100 万输出 token:公开的鹈鹕会话在 Fable 5.2 上用了约 110 万,按 apimodels.app 的价格光输出约 $26.40,还没算输入和缓存读。简单场景只要其中一小部分,修改阶段换成 Opus 5.5 单价减半。