在 Codex 里使用 Tripo
像跟人说话一样对 Codex 下指令。你描述想要的 3D 模型，Tripo 3D 插件会生成它，并把文件存进你的项目。不需要懂 API、终端，也不需要会 3D 软件。
这是一份从零开始的逐步说明。请按顺序做；某一步没成功，先解决再往下。
开始前你需要准备什么
- 一台电脑（Mac 或 Windows）。
- Codex：OpenAI 的编程助手。它在 ChatGPT 桌面应用或 Codex CLI 里，不是普通的 ChatGPT 对话窗口。
- Node.js 20 或更高版本。插件会在后台用到它，你不用写 Node 代码。
- 一个 Tripo 账号。新账号会送免费积分。没有账号就先到 developers.tripo3d.ai 注册。
先检查 Node.js。打开「终端」（Mac）或 PowerShell（Windows），输入：
node -v
应看到类似 v20.11.0 或更高的版本号。如果提示找不到命令，到 nodejs.org 安装 LTS 版本，然后关掉终端再打开，再试一次。
安装插件和登录都是免费的。真正生成模型时会消耗 Tripo 积分。
第 1 步：打开 Codex，不要留在 ChatGPT 对话里
这是最常见的踩坑点。
- 打开 ChatGPT 桌面应用（或 Codex CLI）。
- 切换到 Codex。
- 打开你希望 3D 文件出现的那个文件夹。还没有项目的话，新建一个空文件夹并打开它。
如果一直停在普通 ChatGPT 对话里，Tripo 插件不会出现。这是正常的：这个插件只在 Codex 里生效。
第 2 步：安装 Tripo 3D 插件
- 在 Codex 里打开 Plugins（插件）。
- 打开 Plugins Directory（插件目录）。
- 搜索 Tripo 3D。
- 安装，并确认它是 enabled（已启用）。
安装成功后，你会看到两类能力：生成 3D 资产，以及制作游戏向资产。不需要逐个开关，保持插件启用不关即可。
遇到问题？ 找不到 Tripo 3D
- 确认你在 Codex 里，而不是 ChatGPT 对话。
- 完全退出 ChatGPT 桌面应用再打开，然后重新搜索。
- 如果仍然没有，改用 Tripo CLI。那是同一套生成引擎，只是在终端里操作。
第 3 步：发送第一条消息
把下面整段复制进 Codex：
我想要一个带贴图的低多边形宝箱，把 GLB 文件存到 ./assets 文件夹。
如果 Tripo 还没配置好，请按我完全没接触过的程度，一步一步带我做完。
不要让我把 API Key 粘贴到对话里。
发送。接下来 Codex 通常会：
- 检查这台电脑上 Tripo 是否就绪。
- 如果你还没登录，给出一个验证链接和一组一次性验证码。
- 等你在浏览器里完成登录。
- 生成模型，并写入
./assets。
永远不要把 API Key 粘到对话里。 插件不需要你这么做。如果 Codex 向你要密钥，回复：请用浏览器登录。不要向我要 Key。
第 4 步：在浏览器里完成登录（只需第一次）
当 Codex 给出链接和验证码时，请你自己完成下面点击。不要关掉 Codex，也不要中止它正在跑的命令。
- 在浏览器中打开那条验证链接。
- 如果页面要求登录，先到 developers.tripo3d.ai 登录或注册，再回到验证页。
- 把一次性验证码填进 Verification code（验证码） 输入框。必须和 Codex 里显示的完全一致。
- 如果账号里已经有 API Key，任选一把即可；如果还没有，系统会自动创建，不用选。
- 点击 Authorize（授权）。
授权成功后，Codex 会自己继续，你不用把任何内容复制回对话。
验证码过一段时间会失效。失败了就对 Codex 说：请重新登录 Tripo。
遇到问题？ 浏览器没打开，或登录没完成
- 把 Codex 给出的链接复制到浏览器地址栏打开。
- 页面上的验证码必须和 Codex 里的一致。拿不准就让 Codex 重新登录，换一组新码。
- 让 Codex 继续等待。登录最长可能要几分钟；中途停掉等于作废这组码。
第 5 步：等文件生成，然后打开看看
保持 Codex 开着。第一次生成常常要几分钟。Codex 是在等 Tripo 做完，不是卡死。
完成后，Codex 一般会：
- 告诉你文件保存在哪里（通常是
./assets） - 说明这次花了多少积分
- 如果有预览图，会看一眼效果
打开那个文件夹，通常能看到：
- 模型文件，例如
model.glb preview.png：模型的预览图task.json：这次任务的记录
预览图不对的话，对 Codex 说：这不是我想要的，换个种子再试一次。
接下来可以这样说
用日常语言即可。下面几条可以直接复制。
把图片变成 3D（先把 concept.png 放到项目文件夹里）：
把 concept.png 变成 3D 模型，保存到 ./assets。
接着上一次的模型继续做（不会从头再生成一遍，更省积分）：
基于刚才那个模型，再做一个 1500 面的 LOD，保存到 ./assets。
游戏占位道具，并写进代码：
给我的场景做三个占位道具，存成 ./assets 里的 GLB，然后在项目代码里加载它们。
一次要好几个模型时，Codex 应先问你确认再花积分。这是正常行为。
出问题了怎么办
| 你看到的情况 | 怎么处理 |
|---|---|
| 插件根本不出现 | 你还在 ChatGPT 对话里。切到 Codex。 |
| Codex 让你粘贴 API Key | 拒绝。回复：请用浏览器登录，不要向我要 Key。 |
| 登录页没有反应 | 把 Codex 里的链接粘到浏览器。核对验证码是否一致。 |
| 提示积分不足 | 模型没有生成完。到 控制台 充值后，让 Codex 再试。 |
| 生成做到一半失败 | 失败任务的积分会自动退回。让 Codex 再试一次。 |
| 文件不在项目里 | 明确告诉它路径，例如 保存到 ./assets。 |
| 效果不好 | 让 Codex 重做。不要让它一声不响地连着重试很多遍。 |