这次我们来看一个能让你用自然语言控制 Blender 进行 3D 建模和动画制作的项目：Codex 连接 Blender。这本质上是一个 AI 代理（AI Agent）应用，它通过一个名为 MCP（Model Context Protocol）的插件，将大型语言模型（如 Claude、GPT）的“大脑”与 Blender 这个强大的 3D 创作工具“双手”连接起来。

简单来说，你不再需要手动点击复杂的菜单或编写 Python 脚本，只需用文字描述你的想法，比如“创建一个带纹理的立方体”或“让这个球体沿着曲线弹跳”，AI 就能理解并自动在 Blender 中执行相应的操作。这对于快速原型设计、自动化重复性建模任务、甚至辅助学习 Blender 工作流都极具价值。

本文的核心是带你走通从环境准备到实际命令下发的全流程。我们会重点关注几个关键问题：这个方案对硬件要求高吗？是否需要本地部署大模型？启动和配置过程是否复杂？以及，它到底能稳定、准确地执行哪些类型的建模指令？如果你对 AI 驱动的自动化 3D 内容创作感兴趣，或者想探索 AI Agent 在专业软件中的应用，这篇文章将提供一份可直接操作的实践指南。

1. 核心能力速览

在深入细节之前，我们先通过一个表格快速了解 Codex 连接 Blender 方案的核心特性和门槛。

2. 适用场景与使用边界

在投入时间部署之前，明确它能做什么、不能做什么，以及潜在的风险，至关重要。

它非常适合以下场景：

• 快速原型与构思可视化：当你有一个模糊的创意（如“一个未来主义的悬浮汽车”），可以用语言描述让 AI 生成基础模型和场景布局，加速构思过程。
• 自动化繁琐操作：对大量物体进行相同的操作，如“选中所有立方体，将其材质基础色改为红色”。用 AI 驱动比手动或写临时脚本更直观。
• 脚本学习与生成：对于不熟悉 Blender Python API 的用户，可以通过“用 Python 创建一个螺旋线”这样的指令，让 AI 生成可学习和修改的代码。
• 工作流探索：你可以询问“如何用几何节点创建一个随机的城市布局？”，AI 可以分步骤指导或直接尝试创建节点树。

它的局限与不适用场景：

• 高精度与复杂艺术创作：对于需要毫米级精度、复杂拓扑布线或高度依赖艺术家主观审美的模型（如角色建模），当前 AI 的掌控力不足，更适合作为辅助工具。
• 完全离线/无网络环境：默认配置依赖云端大模型 API（如 Claude）。若要完全离线使用，需本地部署兼容 MCP 的大模型，技术门槛较高。
• 实时交互与低延迟操作：由于涉及网络通信（云端 API）或多进程通信（本地），指令执行有延迟，不适合需要实时、高频交互的雕刻或动画调整。
• 替代系统学习：它不能替代你对 Blender 基本操作、3D 概念（如轴、缩放、修改器）的理解。错误或模糊的指令会导致不可预知的结果。

安全与合规边界：

• 软件授权：确保你使用的 Blender 和其插件是合法获取的。
• API 使用：使用 Claude、GPT 等云端 API 时，需遵守其服务条款，注意费用、速率限制和数据隐私政策。避免发送敏感或私有模型数据到云端。
• 产出物版权：AI 驱动生成的 3D 模型、动画的版权归属需根据具体用途和所使用 AI 服务的协议进行判断，在商用前务必厘清。

3. 环境准备与前置条件

为了让 Codex 顺利连接并控制 Blender，你需要准备好以下软件环境。请按顺序检查和安装。

1. 基础软件环境：

• Blender：推荐使用较新的稳定版本（如 3.6 LTS, 4.0+）。从 Blender 官网 下载安装。
• Python：系统需要安装 Python（推荐 3.9-3.11）。Blender 自带内置 Python，但 Codex 客户端通常需要系统 Python。确保python和pip命令在终端中可用。
• Git：用于克隆 Codex 及其他可能的仓库。

2. 获取 MCP 服务器插件（用于 Blender）：Blender 需要扮演一个 MCP 服务器，暴露其功能给 AI 调用。你需要获取blender-mcp插件。

• 来源：通常是一个开源项目，例如sshh12/blender-mcp（请以实际搜索到的可靠仓库为准）。你可以通过 Git 克隆或直接下载 ZIP 包。

  # 示例：克隆插件仓库（假设仓库地址为 https://github.com/sshh12/blender-mcp） git clone https://github.com/sshh12/blender-mcp.git

• 位置：记住克隆或解压后的插件目录路径，例如C:\projects\blender-mcp或/home/user/projects/blender-mcp。

3. 获取 Codex 客户端（MCP 客户端）：Codex 是 Anthropic 官方提供的一个 MCP 客户端，用于连接大模型和各类 MCP 服务器（包括我们的 Blender）。

• 安装方式：通过pip安装是最简单的方式。

  # 使用 pip 安装 codex 客户端 pip install anthropic-codex

• 验证安装：安装后，在终端运行codex --help，应能看到命令帮助信息。

4. 大模型 API 密钥：Codex 本身不含模型，它需要配置一个后端大模型。最常用的是Anthropic Claude API。

• 获取 Claude API Key：访问 Anthropic 控制台 ，注册账号并创建 API Key。
• 设置环境变量：将 API Key 设置为系统环境变量，这是 Codex 读取配置的标准方式。

  # Linux/macOS export ANTHROPIC_API_KEY=你的_claude_api_key_sk-xxx # Windows (PowerShell) $env:ANTHROPIC_API_KEY="你的_claude_api_key_sk-xxx" # Windows (CMD) set ANTHROPIC_API_KEY=你的_claude_api_key_sk-xxx

  注意：为了安全，切勿将真实的 API Key 提交到版本控制系统或分享给他人。

4. 安装部署与启动流程

环境就绪后，我们分两步启动整个系统：先启动 Blender 端的 MCP 服务器，再启动 Codex 客户端并建立连接。

4.1 在 Blender 中安装并启动 MCP 服务器插件

1. 打开 Blender，进入编辑(Edit)->偏好设置(Preferences)。
2. 在偏好设置窗口中，切换到插件(Add-ons)选项卡。
3. 点击右上角的安装(Install...)按钮。
4. 在弹出的文件浏览器中，导航到你之前下载或克隆的blender-mcp插件目录。你需要选择的是该目录下的__init__.py文件（通常位于blender-mcp/src或类似子目录中）。选中后点击安装插件。
5. 安装成功后，在插件列表的搜索框中输入 “mcp” 进行过滤。找到名为 “MCP Server” 或类似的插件，勾选其左侧的复选框以启用它。
6. 关键配置：启用插件后，插件面板会展开。你需要关注一个关键信息：MCP 服务器的通信地址。
   • 通常，插件启动后会在 Blender 的系统控制台（Window -> Toggle System Console）或插件界面显示一行日志，例如：

     MCP Server started on stdio

     或

     MCP Server started on http://127.0.0.1:8000

   • stdio（标准输入输出）模式：这是最常见且简单的模式。插件作为一个子进程，通过管道与 Codex 客户端通信。你不需要手动做任何事，保持 Blender 开启即可。
   • HTTP 模式：如果显示 HTTP 地址，则表示插件启动了一个本地 Web 服务器。记下这个地址（如http://127.0.0.1:8000），后续 Codex 配置会用到。
7. 保持 Blender 运行，不要关闭。

4.2 配置并启动 Codex 客户端连接 Blender

打开一个新的系统终端（命令行窗口），我们将在此启动 Codex。

情况一：Blender 插件使用stdio模式这是最直接的连接方式。你需要在启动codex时，通过--mcp-server参数指定一个特殊的命令，这个命令会启动 Blender 的 MCP 服务器进程。

# 假设你的 Blender 可执行文件路径是 /Applications/Blender.app/Contents/MacOS/Blender (macOS) # 或 C:\Program Files\Blender Foundation\Blender 4.0\blender.exe (Windows) # 或 /usr/bin/blender (Linux) # macOS/Linux 示例 codex --mcp-server “/Applications/Blender.app/Contents/MacOS/Blender --python-expr ‘import bpy; bpy.ops.preferences.addon_enable(module=\“blender_mcp\“); bpy.ops.wm.mcp_start()’” # Windows (PowerShell) 示例 - 注意路径和引号转义 codex --mcp-server “C:\Program Files\Blender Foundation\Blender 4.0\blender.exe --python-expr \“import bpy; bpy.ops.preferences.addon_enable(module=‘blender_mcp’); bpy.ops.wm.mcp_start()\””

• 原理：--python-expr参数让 Blender 启动后立即执行一段 Python 代码：启用blender_mcp插件并启动 MCP 服务器。Codex 会启动这个命令行进程，并与其标准输入输出对接。

情况二：Blender 插件已启动 HTTP 服务器（显示如 http://127.0.0.1:8000）如果插件界面或日志显示 HTTP 地址，你可以让 Codex 以 HTTP 方式连接。

# 在终端中直接启动 codex，并通过环境变量或参数指定 MCP 服务器 # 方法1：通过环境变量（推荐，便于管理多个服务器） export MCP_SERVER_BLENDER="http://127.0.0.1:8000" codex # 方法2：通过命令行参数 codex --mcp-server http://127.0.0.1:8000

启动成功标志： 成功启动 Codex 后，终端会进入一个交互式会话，提示符可能变为>或显示Codex。同时，Blender 的插件控制台或系统控制台可能会打印出连接成功的日志，如Client connected。

5. 功能测试与效果验证

连接建立后，就可以开始用自然语言给 Blender 下命令了。我们通过几个由简到繁的测试来验证系统的可用性和能力边界。

5.1 测试1：基础对象创建与操作

测试目的：验证 AI 能否理解基本建模指令并正确执行。操作步骤：

1. 在启动的 Codex 交互式终端中，直接输入指令。
2. 观察 Blender 视图的变化。

输入指令示例：

在原点创建一个立方体，并将其缩放为 (2, 1, 0.5)。

预期结果与验证：

• 成功：Blender 3D 视图中出现一个被拉长的立方体。在物体属性面板中，其缩放值应近似为 (2, 1, 0.5)。
• 可能的问题：
  • AI 可能创建了立方体但缩放值不精确。
  • 立方体可能不在原点。可以继续指令：“将其移动到世界原点 (0,0,0)”。
  • 如果无任何反应，检查 Codex 终端是否有错误输出，或 Blender 插件日志。

5.2 测试2：复杂操作与修改器应用

测试目的：验证 AI 能否执行涉及多个步骤和 Blender 特定功能（修改器）的指令。输入指令示例：

选中刚才创建的立方体，为其添加一个“倒角”修改器，并设置“宽度”为 0.1m。然后再添加一个“阵列”修改器，设置“数量”为 3，“相对偏移”的 X 为 2.0。

预期结果与验证：

• 成功：立方体的修改器属性栏中依次出现“倒角”和“阵列”修改器，且参数已按指令设置。视图中应看到三个并排的、带有圆角的立方体。
• 观察点：
  • AI 是否准确找到了“倒角”和“阵列”修改器（英文界面可能是 Bevel, Array）。
  • 参数设置是否正确。这是检验 AI 对 Blender API 理解深度的关键。
  • 如果指令过长或复杂导致 AI 困惑，可以尝试拆分成多条指令分步发送。

5.3 测试3：场景查询与信息获取

测试目的：验证 AI 能否通过 MCP 工具“读取”当前 Blender 场景的状态，而不仅仅是“写入”操作。输入指令示例：

当前场景中有多少个网格物体？列出它们的名字。

预期结果与验证：

• 成功：Codex 终端应返回一个文本列表，例如：“场景中有 2 个网格物体：Cube, Cube.001”。
• 重要性：这个能力使得 AI 可以进行条件判断和更复杂的自动化，例如“选中所有名字包含‘Window’的物体”。

5.4 测试4：批量任务模拟

测试目的：验证系统处理连续、批量指令的能力。操作步骤：在 Codex 交互终端中，连续输入以下一组指令（可以复制粘贴）。

# 这是一组连续的指令，可以一次性粘贴到 Codex 交互界面 创建10个球体，沿X轴等距排列，间距为3米。 选中所有这些球体，将它们组成一个集合，命名为“BallArray”。 为“BallArray”集合中的所有球体添加一个“实体化”修改器。

预期结果与验证：

• 成功：场景中出现 10 个排成一列的球体，它们被归入一个名为 “BallArray” 的集合，并且每个球体都添加了“实体化”修改器。
• 性能与稳定性观察：
  • 观察执行这组指令的总耗时。延迟主要来自：1) 网络与 AI API 交互时间；2) Blender 执行操作的时间。
  • 指令是否全部成功执行？有无某个球体被遗漏？
  • 这是评估该方案能否用于生产环境批量自动化的重要测试。

6. 接口 API 与批量任务

虽然交互式终端很方便，但真正的自动化力量来自于以编程方式调用。Codex 和 MCP 协议支持这种方式。

6.1 非交互式（脚本）调用

你可以不进入交互模式，而是通过管道（pipe）或子进程直接向codex命令发送指令并获取结果。这对于集成到其他脚本中非常有用。

# 示例：通过 echo 传递指令并执行 echo “在原点创建一个经纬球” | codex --mcp-server “你的_blender_mcp_server启动命令” # 更实用的方式：将指令写入文件，然后通过管道执行 cat commands.txt | codex --mcp-server “你的_blender_mcp_server启动命令” > output.log

其中，commands.txt文件内容可以是多行指令：

创建平面。 将其细分10次。 应用细分曲面修改器。

6.2 通过 HTTP 接口调用（如果服务器支持）

如果 Blender MCP 插件以 HTTP 模式运行（例如http://127.0.0.1:8000），理论上你可以直接向其发送结构化的 HTTP 请求来调用工具。这需要你了解 MCP 协议的具体请求格式。

更常见的做法是，仍然使用codex客户端作为中间件，但以守护进程模式运行，并让 Codex 暴露一个 HTTP 接口。不过，标准的anthropic-codex包主要设计为 CLI 工具。对于生产级批量任务，你可能需要：

1. 编写包装脚本：用 Python 的subprocess模块启动并控制codex进程，模拟终端交互。

   import subprocess import time # 启动 codex 进程 proc = subprocess.Popen( [‘codex’, ‘--mcp-server’, ‘你的_blender_server命令’], stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True ) # 发送指令 commands = [“创建立方体\n”, “将其沿Z轴旋转45度\n”] for cmd in commands: proc.stdin.write(cmd) proc.stdin.flush() time.sleep(2) # 等待执行和AI响应 # 可以读取 stdout 来获取AI的回复或错误信息 # output = proc.stdout.readline() # print(output) proc.stdin.close() proc.terminate()

2. 任务队列与错误处理：在脚本中实现一个任务队列，顺序发送指令。对于每条指令，检查 Codex 的输出或 Blender 的状态（可通过查询指令），如果失败则记录日志、重试或跳过。
3. 结果验证：在批量任务中，不能完全依赖 AI。关键步骤后，应插入查询指令进行验证，例如在“创建100个柱子”后，执行“当前场景有多少个柱状物体？”，确保数量正确。

7. 资源占用与性能观察

这个方案的性能瓶颈和资源占用点非常明确：

1. 大模型 API 调用延迟：这是最主要的“性能”影响因素。每次指令执行都需要经过：你的指令 -> Codex -> 云端 Claude/GPT API -> 生成工具调用序列 -> Codex -> Blender。网络往返和 AI 思考时间会带来显著的延迟（通常几秒到十几秒）。这不是一个实时交互系统。
2. Blender 进程资源：运行 Blender 本身会占用 CPU、GPU（视口和渲染）和内存。复杂的操作（如细分曲面、粒子系统）会消耗更多资源。这与是否使用 AI 驱动无关。
3. Codex 客户端资源：Codex 进程本身占用资源极少，主要是处理文本和进程间通信。
4. 稳定性观察：
   • 长时运行：保持 Blender 和 Codex 进程长时间运行，观察是否有内存泄漏（Blender 内存缓慢增长）或连接断开的情况。
   • 复杂指令压力测试：发送一系列非常复杂或模糊的指令，观察 AI 是否会开始产生错误或无法理解的工具调用，甚至导致 Blender 无响应（例如，AI 错误地发起一个无限循环的复制操作）。

如何降低延迟/提升体验？

• 使用更快的模型：Claude Haiku 比 Claude Sonnet 响应更快，成本更低，适合简单指令。
• 优化指令：清晰、简洁、使用 Blender 标准术语的指令解析成功率更高，思考时间更短。
• 本地模型：如果能成功部署本地大模型（如通过 Ollama 运行 CodeLlama 等）并使其兼容 MCP，则可彻底消除网络延迟，但需要较强的本地算力。

8. 常见问题与排查方法

在部署和使用过程中，你可能会遇到以下问题。这里提供系统的排查思路。

9. 最佳实践与使用建议

为了更高效、稳定地使用这套 AI 驱动 Blender 的方案，遵循以下实践建议：

1. 从简到繁，迭代验证：不要一开始就让它创建复杂场景。从“创建立方体”、“移动物体”开始，逐步增加“添加修改器”、“使用几何节点”等复杂度，摸清当前配置下 AI 的能力边界。
2. 指令清晰、具体、分步：
   • 差：“做一个房子。”
   • 佳：“创建一个立方体，作为房子主体。在其顶部添加一个棱柱，作为屋顶。在立方体正面创建一个门洞。”
3. 利用查询功能进行状态校验：在关键的批量操作前后，插入查询指令来验证状态，例如在“删除所有选中的物体”之前，先执行“列出当前选中的物体”。
4. 环境隔离与配置保存：
   • 为这个项目创建独立的 Python 虚拟环境（venv）来安装anthropic-codex，避免依赖冲突。
   • 将成功的、复杂的指令序列保存为脚本文件（commands.txt），方便复现和分享。
5. 关注成本与安全：
   • 使用云端 API 时，在 Anthropic 控制台设置用量提醒和预算限制。
   • 切勿在指令中发送机密信息、个人隐私数据或受版权保护的专有模型数据。
6. 将其作为增强工具，而非替代品：最有效的使用方式是“人机协作”。你用 AI 生成基础结构或处理繁琐步骤，然后手动进行精细调整和艺术化创作。或者，让 AI 为你生成实现某个效果的 Python 脚本，你再来学习和修改这个脚本。

10. 总结与下一步

Codex 连接 Blender 通过 MCP 协议，为我们打开了一扇用自然语言操控专业 3D 软件的大门。它的最大价值在于降低自动化门槛和激发创作流程。你不需要是 Python 专家，就能驱动 Blender 完成一系列操作；你也可以通过对话的方式，探索实现某种效果的不同路径。

最值得尝试的起点：在你的机器上成功运行起 Blender 和 Codex，然后让它执行“创建一个球体，并为其添加波浪形变形动画”这样的指令。看到 Blender 视窗自动开始操作时，你就能切身感受到这种工作流的潜力。

最容易踩的坑：环境变量设置、Blender 插件安装路径、以及--mcp-server启动命令的格式（特别是 Windows 下的路径和转义符）。耐心按照日志报错信息排查，大部分问题都能解决。

后续探索方向：

1. 探索更多 MCP 工具：深入研究blender-mcp插件暴露了哪些具体的工具（Tools），这决定了 AI 能操作的范围。尝试让 AI 进行材质编辑、灯光设置甚至渲染输出。
2. 尝试其他 MCP 客户端与模型：除了anthropic-codex，可以尝试其他兼容 MCP 的客户端，或者配置 Codex 使用本地部署的模型（如通过 Ollama），以获得更快的响应速度和完全的隐私控制。
3. 构建自定义工作流：将这套流程与你自己的脚本结合。例如，用 Python 脚本批量处理一批描述文本，生成对应的基础 3D 场景文件，然后再由艺术家进行深化。这可能是当前阶段最具实用价值的落地方式。