Claude Code × WordPress完全ガイド【2026年最新】：REST API連携・プラグイン開発・Local環境まで徹底解説

curl -u "api@yourcompany.com:aBcD eFgH iJkL mNoP qRsT uVwX" \
  https://yoursite.com/wp-json/wp/v2/users/me

curl -u "api@yourcompany.com:xxxx xxxx xxxx xxxx xxxx xxxx" \
  https://yoursite.com/wp-json/wp/v2/posts?per_page=5

{
  "sites": [
    {
      "name": "メインブログ",
      "url": "https://www.example.com/",
      "credentials": {
        "username": "api@yourcompany.com",
        "application_password": "xxxx xxxx xxxx xxxx xxxx xxxx"
      },
      "theme": "Twenty Twenty-Five",
      "builder": "Gutenberg",
      "hosting": "エックスサーバー"
    },
    {
      "name": "クライアントサイトA",
      "url": "https://www.clientsite.com/",
      "credentials": {
        "username": "api@yourcompany.com",
        "application_password": "yyyy yyyy yyyy yyyy yyyy yyyy"
      },
      "theme": "Kadence",
      "builder": "Kadence Blocks",
      "notes": "カテゴリページはh3見出しを使う運用ルール"
    }
  ]
}

echo "wordpress-sites.json" >> .gitignore

# WordPress Site Management

WordPressサイトの認証情報と詳細は `wordpress-sites.json` に記録されている。

## API リクエストの注意点

JSON本文に日本語の括弧・ダッシュ・アポストロフィなど特殊文字を含めて
WordPress REST APIに送る際、bashのheredocを使うとクォート問題で失敗する。
代わりに以下の手順で送ること:

1. Writeツールで一時JSONファイルを書き出す
2. `curl -d @filename` でファイルから読み込む
3. リクエスト後に一時ファイルを削除する

## 記事を投稿するときのルール

- featured_imageは投稿本文には含めない。テーマが自動で上部に表示するため、
  二重表示になる
- カテゴリは事前にIDを取得してから投稿する:
  `curl -u "user:pass" https://site.com/wp-json/wp/v2/categories`
- タグが存在しない場合は新規作成してから割り当てる
- 記事下書き時は `status: "draft"` を明示する

## キャッシュ運用

スニペット配信後やフロントエンド変更後は以下でキャッシュをクリアする:
curl -u "user:pass" "https://site.com/?breeze_purge=1&breeze_action=breeze_purge_all"

## Gutenbergブロックのルール

全コンテンツを Section パターンでラップする:

<!-- wp:group {"tagName":"section"} -->
<!-- wp:group {"metadata":{"name":"Section inner container"}} -->
[CONTENT]
<!-- /wp:group -->
<!-- /wp:group -->

「draft-post.md」というファイルの内容を、メインブログサイトに下書きとして投稿して。
カテゴリは「ニュース」、タグは「AI」「Claude」で。

# まずカテゴリIDを取得
curl -u "api@yourcompany.com:xxxx xxxx xxxx xxxx xxxx xxxx" \
  "https://www.example.com/wp-json/wp/v2/categories?search=ニュース"

# 記事を作成
curl -u "api@yourcompany.com:xxxx xxxx xxxx xxxx xxxx xxxx" \
  -H "Content-Type: application/json" \
  -d @draft-post.json \
  "https://www.example.com/wp-json/wp/v2/posts"

We are in the root of the WordPress site folder. 
I want a simple plugin that prints out "Hello [Your Name]" in the admin of the site.

# ~/.claude/commands/wordpress-local.md

Local（by Flywheel）でWordPress開発をしています。環境はWP-CLIが使える状態。

## 重要: 現在のセットアップ

- 現在地: プロジェクトルート（WordPressディレクトリの1つ上）
- WordPressインストール先: `./app/public/`
- PHPエラーログ: `./logs/php/error.log`
- WP-CLI実行には以下のどちらかが必要:
  a) `cd app/public && wp [command]`
  b) `(cd app/public && wp [command])`

## ディレクトリ構造

.
├── app/
│   └── public/         # WordPressルート（WP-CLIはここで動く）
│       ├── wp-content/
│       ├── wp-config.php
│       └── ...
├── logs/
│   ├── nginx/
│   └── php/
│       └── error.log   # PHPエラー
└── conf/               # Local設定

## WP-CLI実行例

プロジェクトルートからはサブシェルでWP-CLIを実行:
- `(cd app/public && wp plugin list)`
- `(cd app/public && wp cache flush)`
- `(cd app/public && wp db query "SELECT * FROM wp_options LIMIT 5")`

## エラーログの確認

`cat logs/php/error.log`

上記を踏まえて、作業前に「プロジェクトルートにいる」「WP-CLIはapp/public経由で叩く」ことを認識してから応答してください。

{
  "permissions": {
    "allow": [
      "Read(./**)",
      "Bash(curl -u *:* https://staging.example.com/*)"
    ],
    "deny": [
      "Bash(curl -u *:* https://www.example.com/*)"
    ]
  }
}