Claude Code / Codex 怎么做 WordPress 网站?WordPress Studio 2.0 官方插件安装、本地建站到发布实测

Automattic 10 月 19 日发布 WordPress Studio 2.0 和 wp-studio 插件,Claude Code 和 Codex 都能装。我们用本站 Key 两端各装一次:插件安装 4 条命令合计约 4 秒;Claude Code 一句话建站、做 Cover 首页、发文章用了 119 秒;Codex 走插件自带的 MCP 卡住,改用 npm 版 Studio CLI 手动接入后 155 秒完成。附配置、命令和常见报错。

6 分钟阅读
Claude Code / Codex 怎么做 WordPress 网站?WordPress Studio 2.0 官方插件安装、本地建站到发布实测

一句话结论:WordPress Studio 2.0 的官方插件 wp-studio 把「建本地站、跑 WP-CLI、校验区块、截图」做成了 MCP 工具,Claude Code 和 Codex 装上后,一句话就能建出一个 WordPress 站点。我们用本站 Key 实测:插件安装 4 条命令合计约 4 秒;Claude Code 用 119 秒建好站、做好 Cover 首页并发布文章;Codex 走插件自带的 MCP 时卡住,改用 npm 版 Studio CLI 手动接入后 155 秒完成同样的任务。

创建 API Key,Claude Code 和 Codex 都能用 →

WordPress Studio 2.0 更新了什么

Automattic 在 10 月 19 日发布了 WordPress Studio 2.0.0,同一天又发了插件 2.0.1。和这篇文章有关的几点:

  • 新增 Codex 插件,插件里直接带了 Studio CLI,不装桌面版也能用。
  • 2.0.1 起,Claude Code 可以从同一个插件市场 Automattic/studio-plugins 安装。
  • 新增 studio mcp 命令,任何支持 MCP 的 AI 工具都能接。
  • 桌面版提供 Mac、Windows 和 Linux(DEB)安装包,详见 Studio 官网。
插件里的工具包括 studio_instructions(读取 Studio 的建站流程)、site_create(建站)、wp_cli(执行 WP-CLI)、validate_blocks(校验区块代码)、scaffold_theme(生成主题)、take_screenshot(截图)等。AI 会先读 studio_instructions,再按里面的流程操作。

适合谁

  • 想做官网、博客、落地页,但不想自己点 WordPress 后台的人。
  • 接 WordPress 外包的开发者:先让 AI 在本地搭出初版,再给客户看。
  • 已经在用 Claude Code 或 Codex 写代码,想把建站也交给它。

第一步:安装 Studio

有两种装法,二选一即可。

桌面版:到 Studio 官网 下载对应系统的安装包。

命令行版:npm 上的 wp-studio 包就是官方 Studio CLI,需要 Node 22 以上:

bash
npm i -g wp-studio

装好后确认版本,并试着建一个站:

bash
studio --version
studio create --path ~/Studio/my-site --name "My Site"

我们在 Linux 上实测:npm 安装 16 秒;第一次 studio create 会下载 PHP 8.4(约 28MB),连下载带启动共 10 秒,之后会打印站点地址(如 http://localhost:8881)和后台账号密码。Studio 自带 PHP 和 SQLite,不需要另装 MySQL 或 Docker。

第二步:把 Claude Code 和 Codex 接到本站

Claude Code 的安装见 Claude Code 接入教程。装好后写全局配置 ~/.claude/settings.json:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

Codex 的安装见 Codex 接入配置教程,全局配置写在 ~/.codex/config.toml:

toml
model_provider = "aicodewith"
model = "gpt-5.6-sol"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "sk-你的Key"
两端用同一个 Key 就行。实测时 Claude Code 跑的是 claude-opus-5-5,Codex 日志显示的是 model: gpt-5.6-sol。插件只负责操作 WordPress,模型调用走的就是上面配置的接口,第三方 API 下工具调用一切正常。

第三步:两端安装 wp-studio 插件

Claude Code 先加插件市场,再装插件:

bash
claude plugin marketplace add Automattic/studio-plugins
claude plugin install wp-studio@studio

装完开一个新会话,或在会话里运行 /reload-plugins。用下面的命令确认 MCP 已连上:

bash
claude mcp list

输出里出现 plugin:wp-studio:wordpress-studio ... ✔ Connected 就说明可以用了。

Codex 的命令几乎一样:

bash
codex plugin marketplace add Automattic/studio-plugins
codex plugin add wp-studio@studio

4 条命令我们实测合计约 4 秒,装上的插件版本是 2.0.1。插件在 Claude Code 和 Codex 里都是全局生效(Claude Code 显示 scope: user),任何项目目录都能用。

插件第一次启动时会解压自带的 Studio CLI(cli.tar.br)。插件的启动脚本会优先找 Studio 桌面版或系统里的 Node,找不到才回退到已安装的 studio 命令。

第四步:一句话建站、改首页、发文章

Claude Code:119 秒

我们给 Claude Code 的指令是:

text
用 WordPress Studio 工具新建一个本地站点,名字叫 Coffee Lab,一个精品咖啡店官网。然后:1) 把首页改成有一个 Cover 区块的 hero(标题"手冲咖啡实验室",一个按钮"查看菜单");2) 发布一篇文章《三款入门手冲器具对比》,正文 300 字左右。最后告诉我站点本地地址、文章链接,以及用了哪些 Studio 工具。

结果:119 秒、21 轮完成,中途没有报错。它的操作顺序是:

  1. 加载插件里的 wordpress-studio 技能,调用 studio_instructions 读流程;
  2. site_create 建站,站点跑在 http://localhost:8882;
  3. 用 wp_cli 查看当前主题(Twenty Twenty-Five)和已有内容;
  4. 写好首页、菜单页和文章三份区块代码,先用 validate_blocks 校验,三份都通过;
  5. 用 wp_cli 创建页面和文章,把首页设为静态首页,固定链接改成 /%postname%/;
  6. take_screenshot 截首页和文章页,最后用 curl 检查页面。

我们打开首页,全宽 Cover 区块、"手冲咖啡实验室"标题和"查看菜单"按钮都在,文章页返回 200。它还主动建了一个 /menu/ 菜单页让按钮有地方跳,并提醒菜单里的价格是占位数据,要换成真实的。

文章它写了 400 字左右,比要求的 300 字长,回复里自己说明了这一点。

Codex:155 秒(手动接入 MCP)

Codex 我们给了同样结构的任务:建一个叫 Trail Notes 的徒步博客,首页 Cover 标题"周末徒步笔记"、按钮"最新路线",再发一篇《新手第一次徒步要带的 10 件装备》。

第一次用插件自带的 MCP,Codex 调用 studio_instructions 后一直等不到返回,等了 5 分半自己放弃,回复是:

text
这次没能完成建站:WordPress Studio 的 `studio_instructions` 请求一直没有响应,我已停止等待,也没有创建站点或发布文章。

我们换成官方文档里的手动接法:先用第一步的 npm 命令装好 studio,再把它注册成 Codex 的全局 MCP:

bash
codex mcp add wordpress-studio -- studio mcp

为了不和插件里同名的服务冲突,同时在 ~/.codex/config.toml 里把插件关掉:

toml
[plugins."wp-studio@studio"]
enabled = false

再跑一次,155 秒完成。Codex 依次调用了 studio_instructions、site_create、scaffold_theme、wp_cli、validate_blocks、inspect_design、take_screenshot,站点在 http://localhost:8883,首页的 Cover 和按钮都在,文章页返回 200。中间有一次 wp_cli 调用失败,Codex 重新读了一遍说明后改了命令,第二次就成功了。

和 Claude Code 不同,Codex 用 scaffold_theme 生成了一个新主题,把 Cover 直接写进首页模板,还查看了桌面端和手机端的效果。Codex 的 MCP 配置方法可以参考 Codex MCP 最小闭环。

实测汇总

步骤Claude CodeCodex
安装插件2 条命令,约 2 秒2 条命令,约 2 秒
建站 + Cover 首页 + 发文章119 秒,21 轮插件 MCP 卡住;手动接入后 155 秒
报错无插件 MCP 无响应;1 次 wp_cli 失败后自己修正
首页 / 文章页200 / 200200 / 200

预览和发布

本地站点在浏览器里直接打开 http://localhost:端口 就能看,后台是 /wp-admin。要给别人看,可以让 AI 用 Studio 的预览功能,或者自己运行 studio preview 生成一个临时预览站点;要正式上线,用 studio push 推到 WordPress.com 站点。这两步都要先用 studio auth 登录 WordPress.com 账号。

AI 运行命令的权限要给够。Codex 怎么放开联网和执行权限,见 Codex 联网与执行环境安全设置。

常见报错

Node 版本太低

原因:Studio CLI 要求 Node 22 以上(wp-studio 的 engines 写的是 node >=22.0.0),版本低时 npm 安装或插件启动会失败。

解决:升级 Node,再确认版本:

bash
node -v

找不到 MCP 工具,或者调用一直没有返回

原因:插件的 MCP 没启动起来,或者启动后卡在第一步。我们在 Codex 里遇到的就是后一种:studio_instructions 一直没有返回。

解决:

  1. Claude Code 先运行 /reload-plugins 或开新会话,再用 claude mcp list 看状态;
  2. 还不行,就改用手动接入:npm i -g wp-studio,然后 codex mcp add wordpress-studio -- studio mcp(Claude Code 对应的是 claude mcp add wordpress-studio -- studio mcp),并关掉插件里的同名服务。

HTTPS 证书不受信任

原因:给站点设了自定义域名并打开 --https 后,Studio 用自己的根证书签发站点证书,系统还没信任这个根证书时,浏览器会提示不安全。

解决:Studio 2.0 的桌面版检测到证书不受信任时会提示,并给出一键信任的入口。只在本地开发的话,也可以不加 --https,直接用 http://localhost:端口。

想彻底离开 WordPress?

有人想反过来:让 AI 把整个 WordPress 站点改成 Astro 这样的静态站,再部署到 Vercel 或 Cloudflare。思路是先导出全部文章和页面,让 AI 生成 Astro 项目,按原来的链接结构生成页面。动手之前一定先做一份 301 跳转表,把旧链接一一对应到新链接,不然搜索排名会掉。

反过来也行,有人用 Claude Code 把 HubSpot 博客整站迁到了 WordPress,自动跑了大约 6 小时。

相关阅读

创建 API Key,让 Claude Code 和 Codex 帮你建 WordPress 网站 →