Codex 必装插件零基础实战教程：从安装到精通，30 分钟搭建你的 AI 超级工作台 - 微元算力(weytoken)

摘要：Codex 上手后，90+ 插件让人眼花缭乱。本文提供一份零基础实战教程，手把手带你安装和配置 6 个必装插件 + 3 个核心 Skills，包含完整的环境配置、权限授予、常见坑解决方案，以及企业级多模型协作的进阶配置。

目录

• 一、环境准备与前置条件
• 二、6 大插件安装与配置
• 三、3 大 Skills 使用指南
• 四、自定义 Skill 创建实战
• 五、企业级进阶：多模型协作配置
• 六、常见问题排错手册

一、环境准备与前置条件

1.1 版本要求

# 检查 Codex 版本
# Codex → 设置 → 关于
# 最低版本要求：2026 年 4 月桌面版（含插件商店）

# 操作系统支持：
# macOS：完整支持（Computer Use 需要屏幕录制 + 辅助功能权限）
# Windows：完整支持

1.2 插件入口

Codex 侧边栏 → Plugins
├── 插件商店（Discover）：浏览和安装新插件
├── 已安装（Installed）：管理已装插件
└── Skills：管理 Skills 列表

Skills 面板：
Codex 左上角 → Skills
├── 官方 Skills（默认已安装）
└── 自定义 Skills（通过 skill-installer 安装）

1.3 重要前提

Skills 安装后必须重启 Codex 才能生效！ 这不是 bug，是设计如此——Skills 的加载发生在应用初始化阶段。

二、6 大插件安装与配置

2.1 办公四件套（Documents + Presentations + Spreadsheets + PDF）

安装步骤：

1. 打开 Plugins → 搜索 "Documents" → 点击安装
2. 同样方式安装 Presentations、Spreadsheets、PDF
3. 无需额外配置，安装即用

使用方法：

@Documents 把这篇会议纪要生成正式 Word 文档
@Presentations 把这篇文章拆成 10 页汇报 PPT
@Spreadsheets 整理这份数据表，建好公式和筛选
@PDF 提取这份合同的关键条款

注意事项：
– 需要 Office 365 或 Google Workspace 账号连接
– 首次使用 @ 时需要授权
– 生成的文件是原生 .docx / .pptx / .xlsx 格式，
可以直接在 Office 套件中编辑

验证安装成功：

测试用例：
输入：@Documents 生成一份包含标题、摘要和三个段落的测试文档
预期：生成一个 .docx 文件，格式完整
如果失败：检查 Office 365 / Google 账号授权

2.2 Browser

安装步骤：

1. Plugins → 搜索 "Browser" → 安装
2. 无需额外配置

使用方法：

@Browser 打开 http://localhost:3000
@Browser 检查这个页面的响应式布局
@Browser 截图并对比设计稿

高级用法（标注修改）：

1. @Browser 打开页面
2. 在页面上圈出一块区域
3. 写修改意见：「这里间距太挤了，加大 8px」
4. Codex 自动修改代码 → 自动刷新页面

验证安装：
输入：@Browser 打开 https://example.com 并截图
预期：在 Codex 内看到打开的页面
如果失败：检查 Codex 版本

2.3 Computer Use

安装步骤：

1. 设置 → Computer Use → Install

macOS 权限配置（必须！）：
系统设置 → 隐私与安全性 →
├── 屏幕录制 → 允许 Codex
└── 辅助功能 → 允许 Codex

⚠️ 不授予这两个权限 = 白装！

Windows 权限配置：
设置 → 隐私 → 屏幕录制 → 允许 Codex

使用方法：

@Computer 打开 Excel，把网页上的数据录入进去
@Chrome 打开这个页面，截图前三屏
@Computer 打开系统设置，把分辨率调到 1920×1080

高级用法：
– Computer Use 使用独立的后台光标
– 不抢占前台焦点
– Mac 锁屏后仍可运行

验证安装：
输入：@Computer 打开计算器，算一下 1234 × 5678
预期：看到光标自动打开计算器并输入
如果失败：检查屏幕录制 + 辅助功能权限

2.4 Figma

安装步骤：

1. Plugins → 搜索 "Figma" → 安装
2. 打开 Figma 桌面 app（必须！）
3. Figma → Plugins → 搜索 "Codex" → 安装 Figma 端插件
4. 授权 Codex 访问 Figma 文件

配套 Skills 安装：
$skill-installer figma-design-system
$skill-installer figma-component-library
（共 8 个官方 Figma Skills，按需安装）

使用方法：

正向（设计 → 代码）：
@Figma 根据这个设计稿链接生成前端页面

反向（代码 → 设计）：
@Figma 把当前页面写回 Figma 画布

验证安装：
输入：@Figma 读取这个 Figma 链接中的设计稿信息
预期：Codex 返回设计稿的布局和样式信息
如果失败：
1. 确认 Figma 桌面 app 已打开
2. 确认已授权 Codex 访问权限
3. 确认 Figma 链接有查看权限

2.5 Product Design

安装步骤：

1. Plugins → 搜索 "Product Design" → 安装
2. 无需额外配置

使用方法：

@Product 我想做一个个人记账 App，帮我生成交互原型
@Product 把这个注册流程做成可点击的原型
@Product 分析这个页面的用户体验问题

工作流程：
想法 → 需求分析 → 信息架构 → 交互流程
→ 可点击原型 → 导出 Figma/Canva

验证安装：
输入：@Product 设计一个简单的待办事项 App 原型
预期：生成可交互的原型文件

2.6 Superpowers

安装步骤：

1. Plugins → 搜索 "Superpowers" → 安装
2. 开源项目地址：github.com/obra/superpowers

使用方法：

# 头脑风暴模式
@Superpowers 用 brainstorming 和我讨论这个架构方案

# 系统化调试
@Superpowers 用 debugging 排查这个内存泄漏问题

# 测试驱动开发
@Superpowers 用 tdd 写一个用户认证模块

核心工作流：
brainstorming → 需求讨论、方案探索
planning → 任务拆分、计划制定
tdd → 写测试 → 验证失败 → 写实现 → 验证通过
debugging → 复现 → 隔离 → 假设 → 验证 → 修复

注意事项：
– 这是第三方开源插件，非 OpenAI 官方
– 每次新会话开始时会自动注入方法论文档
– 可以配合 skill-creator 自定义团队的开发规范

三、3 大 Skills 使用指南

3.1 imagegen

底层模型：gpt-image-2（DALL-E 系列）

使用方法：

# 直接对话
「给这篇文章生成一张封面图，蓝色科技风」

# $ 唤起
$imagegen 生成一张 SaaS dashboard 的 mockup

能力边界：
✅ 擅长：PNG 像素图、配图、mockup、抠图、改图
❌ 不擅长：SVG 矢量图、图标系统
→ 矢量图直接让 Codex 写代码画，效果更好

示例：
「把这张图的背景换成白色，做成透明底素材」
→ imagegen 会自动抠图并替换背景

3.2 skill-installer

使用方法：

# 安装官方 Skills
$skill-installer pdf
$skill-installer markdown

# 安装 GitHub 上的 Skills
$skill-installer github.com/username/awesome-skill

# 安装私有仓库 Skills
$skill-installer github.com/your-company/internal-skills

注意事项：
⚠️ 安装后必须重启 Codex！
⚠️ 私有仓库需要有访问权限

安装验证：
重启 Codex → Skills 面板 → 确认新 Skill 在列表中
→ 输入 $<skill-name> 测试

3.3 skill-creator

使用方法：

$skill-creator

交互流程：
skill-creator 会逐步询问：
1. 这个 Skill 叫什么名字？
2. 适用于什么场景？（触发条件）
3. 需要哪些步骤？（执行流程）
4. 有哪些输入和输出？
5. 有哪些边界条件？

然后自动生成：
SKILL.md → 主文件（触发条件 + 执行步骤）
scripts/ → 辅助脚本
references/ → 参考文档和模板

生成后：
1. 推送到 GitHub 仓库
2. 团队成员用 $skill-installer 安装
3. 记得重启 Codex！

四、自定义 Skill 创建实战

4.1 案例：创建一个「代码审查」Skill

$skill-creator

# 交互过程：

Q: 这个 Skill 叫什么？
A: code-review-checklist

Q: 适用场景？
A: 当用户要求审查代码时自动激活

Q: 执行步骤？
A:
1. 检查代码结构和命名规范
2. 检查错误处理和边界条件
3. 检查安全漏洞（SQL 注入、XSS、敏感信息泄露）
4. 检查性能问题（N+1 查询、内存泄漏、不必要的循环）
5. 生成结构化的审查报告

Q: 输入/输出？
A: 输入：代码片段或文件路径
输出：结构化的审查报告（严重/中等/建议 三级分类）

Q: 边界条件？
A:
– 超过 500 行代码时，先做整体结构审查，再逐模块深入
– 如果代码中包含第三方依赖，先检查依赖版本

4.2 生成的 SKILL.md 结构

# code-review-checklist

## 触发条件
当用户请求中包含「代码审查」「code review」「审查代码」「review code」时激活。

## 执行步骤

### 1. 结构审查
– 检查模块划分是否合理
– 检查命名是否规范（变量、函数、类）
– 检查是否有重复代码

### 2. 安全检查
– SQL 注入检查
– XSS 检查
– 敏感信息泄露检查
– 权限校验检查

### 3. 性能检查
– N+1 查询检查
– 内存泄漏检查
– 不必要的循环检查

### 4. 边界条件
– 输入验证
– 空值处理
– 异常处理

### 5. 输出格式
生成结构化报告：
– 严重问题（必须修复）
– 中等问题（建议修复）
– 建议（可选优化）

4.3 团队分发

# 1. 推送到企业私有 GitHub
git add .
git commit -m "添加代码审查 Skill"
git push

# 2. 团队成员安装
$skill-installer github.com/your-company/codex-skills/code-review-checklist

# 3. 重启 Codex（必须！）

# 4. 验证
输入：「审查这段代码」
预期：按自定义的 checklist 流程执行审查

五、企业级进阶：多模型协作配置

5.1 Codex + 后端推理模型的协作架构

Codex 的插件体系解决了本地桌面 Agent的问题，但企业的复杂后端推理需求需要更强的推理模型。

from openai import OpenAI

# 通过微元算力统一 API 层接入所有主流模型
client = OpenAI(
api_key="wt-your-api-key",
base_url="https://api.weytoken.com/v1"
)

# Codex 负责本地 Agent 操作（Browser / Computer Use / Figma）
# 复杂推理任务按场景选最佳模型

TASK_ROUTING = {
"security_audit": "claude-opus-4-8", # 安全审计 → Claude
"deep_research": "gpt-5.5", # 深度研究 → GPT
"long_document": "gemini-3.5-pro", # 长文档 → Gemini
"cn_compliance": "glm-5.2", # 国产合规 → GLM
}

def execute_with_best_model(task_type: str, prompt: str):
model = TASK_ROUTING.get(task_type, "claude-sonnet-4-20250514")
return client.chat.completions.create(
model=model,
messages=[{"role": "user", "content": prompt}],
)

5.2 为什么需要统一 API 层

微元算力(weytoken)聚合平台 的企业级价值：

六、常见问题排错手册

Q1：装完 Skill 后不生效

原因：Skills 不是热加载，需要重启。

解决：完全退出 Codex → 重新打开 → 在 Skills 面板中确认已加载。

Q2：Computer Use 没反应

原因：未授予屏幕录制和辅助功能权限。

解决：

macOS：系统设置 → 隐私与安全性 →
屏幕录制 → 开启 Codex
辅助功能 → 开启 Codex

Windows：设置 → 隐私 → 屏幕录制 → 开启 Codex

Q3：Figma 连接失败

排查步骤：

Q4：@Browser 打开的页面样式不对

原因：Browser 跑在 Codex 内置浏览器中，与系统浏览器可能有差异。

解决：在 Browser 中直接标注修改区域，让 Codex 针对性修复。

Q5：插件安装后找不到了

解决：

Q6：Superpowers 每次会话都在重复注入文档

现象：这是正常行为。Superpowers 的设计就是在每次新会话开始时注入方法论文档，确保 AI 遵循规范。