跳到正文
Codex DesignBETA

在 Codex 里怎么用 Figma

Codex 可以通过 Figma 的 MCP 服务器读取你的设计稿,也可以把内容写回画布。最简单的接法是在 Codex App 里装官方 Figma 插件;在 CLI 里只需要一条命令。下面讲清楚怎么配置、能做什么、额度是多少,以及 Figma 插件找不到或写不进去时该查什么。

更新于 2026年11月8日 · 阅读约 7 分钟

先说结论

  • Codex App: 点左上角的 Plugins,点 Figma 旁边的 +,再点 Install Figma,然后点 Allow access。这一步会顺带装好 Figma 的 skill。
  • Codex CLI: 运行 codex mcp add figma --url https://mcp.figma.com/mcp,按提示登录 Figma。Figma 的 skill 需要另外装。
  • 然后贴一个 Figma 链接,指向一个具体的 frame 或图层,让 Codex 把它做出来。Codex 也能把正在运行的页面送回 Figma,变成可编辑的图层。
  • 额度取决于你的 Figma 席位。 付费套餐的 Dev 或 Full 席位每天至少 200 次读取调用;Starter 套餐、View 或 Collab 席位每月 20 次。

Figma 和 OpenAI 在 2026 年 2 月 26 日宣布了 Codex 集成。下面的步骤来自 Figma 帮助文章 Codex and Figma: Set up the MCP server 和它的开发者文档,截至 2026 年 11 月 8 日。

Codex 能用 Figma 做什么

从 Figma 读取(设计稿转代码)。 Codex 可以拿到一个 frame 或选中内容的设计上下文:布局、组件、变量和样式、截图、素材、FigJam 图表和 Make 资源。如果团队用了 Code Connect,它还能看到每个 Figma 组件对应哪个代码组件,于是会复用你已有的组件,而不是重写一遍。

写入 Figma(代码转设计稿)。 在远程服务器上,Codex 可以新建文件,创建和修改 frame、组件、变量和自动布局,放入图片和 SVG,还能把一个在线网页转成可编辑的 Figma 图层。

最常见的几个工具:

工具作用类型
get_design_context获取图层或选中内容的设计上下文和代码读取
get_screenshot截取选中内容,用来对照读取
get_variable_defs列出选中内容用到的变量和样式读取
search_design_system在你的组件库里查找组件、变量和样式读取
use_figma在 Figma 文件里创建、编辑和检查内容写入
generate_figma_design把在线网页界面转成 Figma 设计图层写入
create_new_file新建空白的 Design、FigJam 或 Slides 文件写入
upload_assets把图片和 SVG 上传到文件里写入

所有写入工具,包括 use_figma,都只在 Figma 的远程服务器上可用,桌面服务器上没有。

怎么配置

在 Codex App 里(推荐)

  1. 打开 Codex App,点左上角的 Plugins。
  2. 点 Figma 旁边的 +,再点 Install Figma。
  3. 弹出提示时点 Allow access,允许 ChatGPT 访问你的 Figma 账号。

之后 Codex 会显示 Figma 插件已连接。这个插件把 MCP 服务器配置和 Figma 的 skill 打包在一起,比如用来实现设计稿的 figma-design-to-code、用来写入画布的 figma-use,以及根据代码在 Figma 里搭设计系统的 figma-generate-library。skill 很关键:它们告诉 Codex 该调哪些工具、按什么顺序调,能避开很多直接调用工具时会碰到的错误。

在 Codex CLI 里

codex mcp add figma --url https://mcp.figma.com/mcp

按提示登录 Figma 并允许访问,然后重启 Codex。这一步只加了服务器,没有 skill。需要的话,从 Figma 的 mcp-server-guide 仓库把要用的 skill 复制到 ~/.agents/skills,或者让 Codex 用 $skill-installer 安装。skill 放在哪里,见 Codex 插件和 skill 的区别。

用桌面服务器

桌面服务器跑在 Figma 桌面 App 里,适合有特殊需要的组织。它需要 Professional、Education、Organization、Government 或 Enterprise 套餐的 Dev 或 Full 席位,而且只有 App 开着时才能用。

  1. 在 Figma 桌面 App 里打开一个 Design 文件,不选中任何内容,按 Shift D 进入 Dev Mode。
  2. 在右侧边栏的 MCP server 区域,点 Enable desktop MCP server。
  3. 在 Codex 里打开 Settings,进入 MCP servers,点 Add server。
  4. 把类型从 STDIO 改成 Streamable HTTP,名称填 figma-desktop,地址填 http://127.0.0.1:3845/mcp,保存。

Figma 建议大多数人用远程服务器。桌面服务器不能写入画布。

套餐和额度

需要有 Codex;Figma 这边 Starter、Professional、Education、Organization 和 Enterprise 套餐都可以用。读取类工具有调用额度:

你的 Figma 套餐和席位读取调用次数
Starter 套餐,或 View、Collab 席位每月最多 20 次
Professional 或 Education,Dev 或 Full每天 200 次,每分钟 10 次
Organization,Dev 或 Full每天 200 次,每分钟 15 次
Enterprise,Dev 或 Full每天 600 次,每分钟 20 次

写入 Figma 的工具,比如 generate_figma_design、create_new_file 和 add_code_connect_map,不计入额度;消耗 Figma AI 积分的操作也不计入。Figma 说额度随时可能调整,规划前先看它的额度说明页。

如果每月只有 20 次,就贴单个 frame 的链接而不是整页,一次只做一个界面。

可以直接复制的提示词

把一个 frame 做进代码库

Figma frame 转代码
实现这个 Figma frame:[粘贴一个 frame 的链接]。
使用 src/components 里的组件和我们现有的 token。不要新增颜色或字体;如果设计稿用了我们没有的值,列出来,不要自己编。
间距、字号和各种状态都要对上。做完后截一张结果图,和 Figma 的截图对比,列出所有没能修好的差异。

把页面送回 Figma

代码转 Figma 图层
应用正在 http://localhost:3000 运行。把 /pricing 页面作为可编辑图层送到 Figma,放进一个新的 Design 文件,命名为「Pricing – from code」。桌面和手机两种宽度都要。最后告诉我新文件的链接。

让 token 保持一致

Figma 变量对照 token
读取这个 Figma frame 用到的变量和样式:[链接]。
和我们在 [主题文件或 CSS 变量的路径] 里的 token 对比。先给我一张不一致的表(名称、Figma 的值、代码里的值),不要改任何东西。我确认后,再把代码改成和 Figma 一致。

把设计系统写下来

设计系统规则
对我们的主组件库使用 Figma 的 create_design_system_rules 提示,把结果保存为项目根目录下的 DESIGN.md:颜色写成带 hex 值的 token,以及字号层级、间距、圆角,还有按钮、输入框和卡片的规则。只用 Figma 或代码里已有的值。

仓库里有一份 DESIGN.md,即使某次会话没有连 Figma,Codex 也能守住设计系统。

Figma 插件在 Codex 里找不到或不工作?

下面是最常见的原因,来自 Figma 的帮助文章和社区论坛:

  • 插件列表里没有 Figma,或者装不上。 ChatGPT Business 和 Enterprise 工作区可能关闭了第三方插件。请工作区管理员允许第三方插件并批准 Figma 的工具,或者用上面的 CLI 命令直接连 MCP 服务器。
  • Figma 是通过 ChatGPT 连的,而不是 Codex。 如果你把 Figma 作为 ChatGPT 应用连接过,先删掉那个连接,再从 Codex App 的 Plugins 安装 Figma。
  • 出现 401 或授权错误。 移除 Figma 插件,重新添加,再登录一次。
  • 能读 Figma 但写不进去。 看看你连的是哪个服务器。桌面服务器没有写入工具,所以 use_figma 永远不会出现。把 MCP 设置里旧的本地 figma 服务器删掉,添加远程服务器(https://mcp.figma.com/mcp),然后重启 Codex。
  • 用了几次就停了。 可能用完了 Starter 或 View 席位每月 20 次的额度。各席位的额度见上面的表。

Codex Design 适合放在哪一步

如果团队在 Figma 里做设计、以 Figma 为准,Figma 插件就是对的选择。Codex Design 负责的是那之前的一步,或者完全不用 Figma 的流程:它在 Codex 里加了一块画布,几个 UI 方向以实时 HTML 的形式并排摆着,你可以先对比,改字体、颜色和间距,再决定用哪个。选定之后,可以用 generate_figma_design 把它送到 Figma 给团队。想了解在 Figma 自己的画布上跑代码,见 Codex Design 和 Figma code layers 对比。

常见问题

Codex 的 Figma 插件免费吗?

插件本身免费安装。能用多少取决于你的 Figma 席位:Starter 套餐和 View、Collab 席位每月最多 20 次读取调用,付费套餐的 Dev 或 Full 席位每天 200 次以上。Codex 的用量照常计入你的 ChatGPT 套餐。

Codex 能修改我的 Figma 文件吗?

能,用远程服务器的时候。借助 use_figma 工具和 Figma 的 figma-use skill,Codex 可以创建和修改 frame、组件、变量和自动布局。通过桌面服务器不能写入。

用插件还是 MCP 服务器?

在 Codex App 里用插件:它配置的是同一个远程 MCP 服务器,还多了 Figma 的 skill。在 CLI 里用 codex mcp add 添加服务器,需要的 skill 自己装。

继续阅读

Codex Design 是独立开发的 Codex 插件,与 OpenAI 无关联,也未获 OpenAI 认可。