一、先把三件必做的前提说清楚
用 Codex 把 Markdown 发进微信公众号草稿箱，不管走哪条路，下面这三件事一件都绕不开：
- 你得有公众号的 AppID 和 AppSecret（在微信公众平台「设置与开发 → 基本配置」里复制）。
- 必须把微信接口看到的公网出口 IP 加进 IP 白名单。
- 每改一次 skill 或配置，重启一次 Codex。
绝大多数人卡在第 2 步。报错码通常是
40164，看上去像 AppSecret 填错了，其实十有八九是 IP 白名单没配对。如果你的网络是分流的（国内走一条线、国外走另一条），两个出口可能是两个不同的公网 IP，而微信只认它自己看到的那个。判断方法：在你要跑发布命令的机器上，直接查它对外暴露的 IP，再去白名单里加。
二、路线 A：wechat-publisher（只想尽快发）
这个 skill 链路最短，适合「我已经写好一篇 Markdown，现在就发草稿」，不想记一堆命令的场景。
- 配置文件路径：
~/.codex/skills/wechat-publisher/config.json - 内容示例：
{
"appid": "wx...",
"appsecret": "...",
"author": "你的作者名"
}
appid 一般是 wx 开头的 18 位字符串，appsecret 直接从微信公众平台复制。填完加好白名单、重启 Codex，然后在对话里直接说：
发布到微信
或「把这篇文章推送到公众号」就够了。它会自动帮你上传图片、生成封面、创建草稿，你少碰命令。
三、路线 B：multi-platform-articles + mpa（想要主题/脚本化）
这一套自身很薄，真正干活的是 mpa 这个 CLI。它更适合：要先挑主题、要在本地先渲染 HTML 看效果、想把整条发布路径沉淀成可复用工作流的人。
安装别图省事用文档里的 curl | sh，那会顺手改 PATH、复制 skill。更稳的手动流程是：
- 先审源码，再下载 GitHub release 的二进制。
- 核对 SHA-256 校验值。
- 只把
mpa放进~/.local/bin。
装好先确认命令在、看下可用主题：
mpa --version
mpa themes list
配置文件默认在 ~/Library/Application Support/mpa/config.json（macOS）。
- 只渲染成本地 HTML 预览：
mpa convert your_article.md --mode local --theme default -o out.html
- 直接推送到微信草稿箱：
mpa publish wechat-draft \
--md your_article.md \
--mode local \
--theme default \
--title "文章标题" \
--cover cover.jpg \
--author "作者名"
默认用
--mode local。原因是工程上更稳：本地渲染已足够支撑草稿发布，只有你主动启用 AI 生图或 API 渲染时才会去调 OpenAI / OpenRouter / Gemini 这些外部接口。目标只是「发出去」就别给链路平白添变量。
四、真实踩坑：mpa 把成功的微信响应误判成失败
这是最误导人的一类 bug，值得单独记下来。第一次跑 mpa publish wechat-draft 时，命令退出码是 1，终端还打印「解析微信 draft/add 响应失败」，看着像失败了。
但去看响应体，里面其实已经有 media_id 了——也就是说草稿早就创建成功了，只是 CLI 自己把成功当成了错误。
根因很具体：mpa 0.1.19 把微信返回里的 errcode 当成了必填字段来处理，而微信成功时并不一定总带这个字段。
现象：退出码 1 + 报错
真相：响应体里已有 media_id（草稿成功）
根因：响应解析把 errcode 写死为必填
修复：把 errcode 改成可选字段，重新编译
排查口诀：先别信退出码，先看响应体。如果是权限 / 白名单 / 内容问题，微信不会返回 media_id；只有响应体里有 media_id 却报失败，才是这类「响应解析写死」的问题。
五、怎么选
- 只在乎发稿、想少碰命令、配置尽量简单 → wechat-publisher。
- 要主题、要本地渲染 HTML、要把发布脚本化、以后扩展更多平台 → multi-platform-articles + mpa。
两条路不是互斥的。作者给的建议顺序很实在：
- 先用 wechat-publisher 跑通第一篇真实文章；
- 确认公众号配置和白名单都稳了，再上 mpa 挑主题、跑脚本；
- 发现自己越来越依赖主题和本地渲染，再把重心转到 multi-platform-articles。
先让链路跑通，再谈优雅。很多工具看起来功能越多越强，但真正长期好用的，往往是路径最短、最少添堵、出问题最好查的那个。
来源：https://itbug.shop/blog/codex-wechat-publisher-mpa-guide
资料最后核对日期：2026-10-07 · 内容整理自 CodexGuide 社区公开教程