Linux下Figma插件报错根源是未启用沙盒模式，需执行figma --enable-features=Plugins启动，并设PluginCache权限为700，再通过MCP协议（CLI或config.toml配置）连接Codex，且设计稿须公开可读、启用精确尺寸与布局、用相对路径导入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Linux系统装Codex Figma插件报错，导致设计稿还原卡在授权环节或页面读取失败，根本原因不是权限不足，而是Figma桌面端在Linux上默认不加载第三方插件沙盒环境——它压根没启动PluginCache服务进程，后续所有“授权失败”“链接无效”“页面空白”都是这个底层缺失引发的连锁反应。
Figma插件在Linux上根本没运行
第一步：确认Figma是否以完整沙盒模式启动。打开终端，执行：figma --enable-features=Plugins。这一步必须加参数，否则Figma会跳过插件初始化流程，连PluginCache目录都不会创建。
第二步：强制触发插件缓存重建。退出Figma后，手动创建缓存目录并赋权：mkdir -p ~/.cache/figma/PluginCache && chmod 700 ~/.cache/figma/PluginCache。Linux下默认权限太松，Figma会拒绝写入，【不设700权限会导致后续所有插件安装静默失败】。
第三步：验证插件进程是否存活。重启Figma，打开开发者工具（Ctrl+Shift+I），切换到Console标签页，输入window.FigmaPluginBridge。如果返回undefined，说明插件桥接未加载，立刻回到第一步检查启动参数；如果返回对象，则继续下一步。
Codex侧必须用MCP协议对接
方法一：CLI直连（推荐）
在Codex项目根目录下，执行codex figma connect --mcp-port 8080。这会启动本地MCP代理服务，Figma插件通过HTTP而非WebSocket连接Codex，绕过Linux下Electron对WebSocket的权限拦截。
方法二：配置文件硬编码
编辑~/.codex/config.toml，在[figma]区块下添加：mcp_enabled = truemcp_host = "127.0.0.1"mcp_port = 8080
注意：不要删掉已有[model]区块，否则模型调用会失效。
方法三：禁用自动重定向
某些Linux发行版（如Fedora 39）的NetworkManager会劫持localhost请求。在Codex配置中加入disable_local_redirect = true，强制使用IP而非域名通信。
设计稿还原前必须做的三件事
① 在Figma中右键目标页面 →「Share」→ 勾选「Anyone with the link can view」→ 复制链接。私有链接在Linux下会被Codex解析为403错误，【必须公开可读，且不能是组织内受限链接】。
② 打开Figma右侧代码面板（图标），确认已勾选「保留精确PX尺寸」和「保留原始Flex/Grid布局」。这两项一旦关闭，Codex生成的CSS会把44px按钮缩成1.25rem，导致UI比例全乱。
③ 在Codex中执行codex figma import --url <粘贴的链接> --output ./src/pages/login。路径必须用相对路径，绝对路径（如/home/user/project）会导致Linux文件系统权限校验失败，生成的组件无法被VSCode识别。
