Shopify CLI 4.0：SemVer対応・自動更新・破壊的変更まとめ

8月 11, 2026

DEV UPDATE

Shopify CLI 4.0：SemVer対応・自動更新・破壊的変更まとめ

バージョニングが明確に。CI/CDパイプラインの見直しが必要な変更点を整理

Shopify CLI 4.0は2026年5月21日にリリース。セマンティックバージョニングの採用により破壊的変更の告知が明確化され、自動アップグレード機能でCLIの保守負担が軽減されます。一方、--forceフラグをはじめとする複数の非推奨コマンド・フラグが削除されており、既存のCI/CDパイプラインの修正が必要になる可能性があります。

1SemVer採用：バージョニングの意味が明確に

これまで曖昧だったShopify CLIのバージョン管理に、セマンティックバージョニング（SemVer）が正式導入されました。

MAJORバージョンが上がるタイミング＝破壊的変更の告知として機能するため、アップグレード計画が立てやすくなります。

2自動アップグレード：仕組みと無効化の方法

無効化したい場合は以下のコマンドを実行します。

shopify config autoupgrade off

3--forceフラグの廃止と代替フラグ

shopify app deployおよびapp releaseコマンドの--forceフラグが削除されました。このフラグは「拡張機能の追加・更新（低リスク）」と「拡張機能の削除（高リスク・不可逆）」を区別せずに実行するため、誤操作のリスクがありました。

4その他の廃止コマンド・フラグ一覧

廃止されたコマンド / フラグ	移行先
`shopify webhook trigger`	`shopify app webhook trigger`
`shopify theme serve`	`shopify theme dev`
`shopify app generate schema`	`shopify app function schema`
`shopify app webhook trigger --shared-secret`	`--client-secret`
`shopify app generate extension --type`	`--template`

5業務に活かせるユースケース

課題: 複数プロジェクトのCLIバージョン管理が属人化しており、メンバーによって異なるバージョンで作業しトラブルが発生している
打ち手: 自動アップグレードを有効のまま運用し、全員が同じパッチ・マイナーバージョンを自動追従。MAJORバージョンアップ時はチームで計画的に対応
効果: 「自分の環境だけ動く」問題を削減。バージョン差異起因のバグ調査コストを低減できる
技術メモ: プロジェクトローカルインストール環境では自動更新がスキップされるため、package.json の @shopify/cli バージョン指定を定期的に見直すことが必要

課題: CI/CDパイプラインで--forceフラグを使っており、誤って本番の拡張機能を削除するリスクを抱えていた
打ち手: --forceを削除し、通常のデプロイには--allow-updatesのみ、削除が必要な場合にのみ--allow-deletesを明示的に追加するよう変更
効果: 意図しない拡張機能削除（不可逆操作）を防ぎ、CI/CDの無人実行を安全に継続できる
技術メモ: --allow-updatesと--allow-deletesフラグは2026年3月のchangelogで先行リリース済み。CLI 4.0へのアップグレード前に動作確認可能

課題: スクリプト内にshopify theme serveやshopify webhook triggerなどの旧コマンドが残っており、4.0移行後にエラーが発生する
打ち手: リポジトリ内のシェルスクリプト・Makefileをgrepで洗い出し、廃止コマンド一覧を元に移行先コマンドへ一括置換
効果: CLI 4.0へのアップグレードをスムーズに完了でき、チーム全体の開発フローを止めずに移行できる
技術メモ: shopify app generate extension --type → --template、--shared-secret → --client-secret など、引数名レベルの変更も含まれる点に注意