前言：为什么要在 Codex 里配置公众号发布
写完公众号文章，还要切到微信公众平台后台、上传图片、填摘要、点发布——这套操作熟练了也要 5 分钟，不熟练则更久。
如果能把「从 Markdown 到公众号草稿」这个链路在 Codex 里一键跑通，效率提升是显而易见的。本文对比两种主流方案：wechat-publisher（轻快）和 mpa（完整），帮你选对适合自己的那条路。
前置条件（两者都绕不过）
不管你选哪个方案，以下三件事必须先搞定：
- 公众号 AppID 和 AppSecret——登录微信公众平台（mp.weixin.qq.com）→「设置与开发」→「基本配置」获取
- IP 白名单——在同一个页面找到「IP 白名单」，把访问微信接口时你电脑的公网 IP 加进去
- 重启 Codex——改完配置后必须完全退出再打开 Codex，否则新配置不会生效
⚠️ 最常见报错 40164：不是凭证错了，几乎都是因为 IP 白名单没配好。排查时优先检查这个。
方案一：wechat-publisher（适合快速发稿）
安装
在 Codex 对话中直接说：
请帮我安装 wechat-publisher 技能
Codex 会自动搜索并安装到 ~/.codex/skills/wechat-publisher/ 目录下。
配置文件
编辑配置文件（路径视系统而定）：
{
"appid": "wx你的公众号ID",
"appsecret": "你的AppSecret",
"author": "你的作者名"
}
路径参考：
~/.codex/skills/wechat-publisher/config.json
使用方法
配置好后，在 Codex 对话中说：
把这篇 Markdown 发到公众号草稿箱
或指定文件：
发布到微信：./articles/my-article.md
Codex 会自动完成：上传图片 → 生成封面 → 创建草稿。
适合场景
- 已经有一篇 Markdown，只想尽快发草稿
- 不想记太多命令，希望 Codex 多做事
- 链路越短越好，出了问题好排查
方案二：multi-platform-articles + mpa（适合长期工作流）
这个方案不是单纯装一个 Skill，而是给 Codex 接入了一个外部工具链 mpa（Multi-Platform Articles）。
第一步：安装 mpa CLI
不建议直接跑远端安装脚本（会悄悄改 PATH、复制 Skill）。推荐手动安装：
# 下载最新版（访问 GitHub Releases）
curl -LO https://github.com/badafans/mpa/releases/latest/download/mpa-linux-amd64
chmod +x mpa-linux-amd64
mv mpa-linux-amd64 ~/.local/bin/mpa
验证安装：
mpa --version
第二步：安装 Skill
在 Codex 中安装：
请帮我安装 multi-platform-articles 技能
第三步：配置公众号凭证
运行 TUI 配置界面：
mpa
配置文件默认在：~/Library/Application Support/mpa/config.json（macOS）或 ~/.config/mpa/config.json（Linux）
第四步：本地渲染 + 发布
先渲染看效果（推荐用 --mode local，不依赖外部 AI 生图服务）：
mpa convert ./articles/my-article.md \
--mode local \
--theme default \
-o ./output.html
预览 ./output.html，满意后再发布：
mpa publish wechat-draft \
--md ./articles/my-article.md \
--mode local \
--theme default \
--title "文章标题" \
--cover ./cover.jpg \
--author "作者名"
适合场景
- 想先挑主题再发，有多个主题可选
- 想在本地渲染 HTML 预览效果
- 想把发布流程脚本化、沉淀成长期工作流
一个真实踩坑记录
第一次跑 mpa publish wechat-draft 时，命令退出码是 1，看起来像失败了。但仔细看响应体，发现 media_id 已经有了——草稿其实创建成功了，只是 mpa 0.1.19 把微信的成功响应误判成了错误。
排查方法：别只看退出码，检查响应体里的关键字段（media_id、url 等）。
选哪个？
| 考量因素 | wechat-publisher | mpa + multi-platform-articles |
|---|---|---|
| 配置复杂度 | 低（填 3 个字段） | 中（需安装 CLI + 配置） |
| 发布速度 | 最快（一句话搞定） | 稍慢（可预览后发布） |
| 主题支持 | 无 | 多个主题可选 |
| 扩展性 | 弱 | 强（可对接其他平台） |
| 适合人群 | 只想发稿的用户 | 想沉淀工作流的玩家 |
我的建议：先用 wechat-publisher 跑通第一篇真实文章，确认公众号配置和白名单稳定后，再尝试 mpa 的主题和命令行工作流。
来源：itbug.shop《在 Codex 里跑通公众号发布：wechat-publisher 和 multi-platform-articles 教程》（2026-07）
资料最后核对日期：2026-08-30 · 内容整理自 CodexGuide 社区公开教程