Shopify CLIのインストールと使い方(Mac/Windows)

Shopify CLIのインストールと使い方(Mac/Windows)

| 更新日
LESSON 19Shopify基礎講座段階:カスタマイズ・開発読む時間の目安:約10分対象:テーマ開発やアプリ開発を始めたい運営者(非エンジニア可)
コマンドラインの画面を操作する人のイメージ
Shopify CLIは、手元のパソコンからストアの開発作業を行うためのコマンドラインツール

この記事で分かること

  • Shopify CLIが何のためのツールか
  • Mac・Windowsでのインストール方法と、前提になる環境
  • インストール後の確認方法と、更新の仕組み

Shopify CLIは、テーマやアプリの開発を手元のパソコンから進めるための公式ツールです。この回ではコマンドの詳しい使い方には立ち入らず、「何のためのツールか」「どう用意するか」を中心に整理します。

01Shopify CLIとは何か

用語メモ | CLI

Command Line Interface(コマンドライン・インターフェース)の略。文字でコマンドを入力してソフトウェアを操作する画面のことです。マウスでクリックする代わりに、キーボードで命令文を打ち込んで操作します。

Shopify CLIは、Shopify公式が提供するコマンドラインツールです。公式開発者ドキュメントには、アプリ・テーマ・カスタムストアフロント(独自に作るお店の画面)の生成と操作、一般的な開発作業の自動化に使うツールだと説明されています(2026年10月時点で確認)。

コマンドは shopify [トピック] [コマンド] という形式になっていて、shopify help を実行すると使えるコマンドの一覧が表示されます。テーマを編集する・アプリのひな形を作る・ストアに対して操作を行う、といった作業ごとにトピックが分かれているイメージです。

補足

このブログで過去に扱ったテーマのカスタマイズ記事やTIPSの中にも、Shopify CLIのコマンドを使って作業しているものがあります。自分でコードを書く予定がなくても、依頼先の制作会社やエンジニアとのやり取りで名前が出てくることがあるツールです。

02前提になる環境

公式開発者ドキュメントによると、Shopify CLIを使うには先に次のソフトウェアが入っている必要があります(2026年10月時点)。

前提ソフト 条件
Node.js 22.12以上
Git 2.28.0以上
パッケージマネージャー npm・Yarn(1.x)・pnpmのいずれか

用語メモ | Node.js

JavaScriptというプログラミング言語を、ブラウザの外(パソコン上)で動かすための実行環境です。多くの開発ツールが、この上で動きます。

用語メモ | パッケージマネージャー

ソフトウェアの部品(パッケージ)を自動でダウンロード・管理してくれる仕組みです。npmはNode.jsに標準で付属しており、最初の一歩としては迷わず使えます。

Node.jsとGitは、Shopify CLI専用のものではなく、ソフトウェア開発全般でよく使われる基盤です。開発を外部に依頼する場合は、担当者がすでに用意していることがほとんどです。自分で初めて環境を作る場合は、先にNode.jsをインストールしておく必要があります。

03インストール方法(Mac・Windows共通の考え方)

Node.js等の準備→パッケージマネージャーでのインストール→バージョン確認、の3ステップ図
図1:インストールまでの流れ

公式開発者ドキュメントには、次のいずれかのコマンドで、パソコン全体で使える形(グローバルインストール)で入れる方法が示されています。

方法 コマンド
npm npm install -g @shopify/cli@latest
Yarn yarn global add @shopify/cli@latest
pnpm pnpm install -g @shopify/cli@latest
Homebrew(Macのみ) brew tap shopify/shopify の後に brew install shopify-cli

Windows専用の手順は公式ドキュメントに個別には示されていませんが、npm・Yarn・pnpmはいずれも前提条件(Node.js・Git)を満たせばWindowsでも使えるツールです。Homebrewは公式ドキュメントで「Macのみ」と明記されているため、Windowsでは使えません。npm等でのインストールが共通の方法になります。

04インストール後の確認と更新

インストールができたかどうかは、次のコマンドで確認します。

shopify version

実行するとバージョン番号が表示されます。公式ドキュメントの実行例では「4.0.0」と表示されており、2026年10月時点では4系のバージョンが提供されています。

バージョンの更新については、公式ドキュメントに次のような仕組みが説明されています。

  • 自動更新:バージョン4.0以降は、インストールに使ったパッケージマネージャーを通じて自動的に更新される
  • 自動更新の対象外になるケース:CI環境(自動テスト等の実行環境)、プロジェクトローカルへのインストール、メジャーバージョンをまたぐ更新
  • 手動更新:shopify upgrade を実行する
  • 自動更新の切り替え:shopify config autoupgrade off(無効化)/on(有効化)/status(状態確認)。無効にしている場合、新しいバージョンがあると毎日通知が表示されるが、自動では更新されない

ここがポイント

  • インストール確認は shopify version
  • 困ったときの更新は shopify upgrade
  • 自動更新をオフにしている場合、通知は来るが自動では更新されない

05Shopify CLIでできることの全体像

app(アプリ開発)・theme(テーマ開発)・store(ストア操作)などのトピックが並ぶ図
図2:主なトピックの分かれ方

shopify [トピック] [コマンド] という形式のうち、トピックにあたる部分で作業の種類が分かれます。公式ドキュメントのコマンド一覧から、代表的なものを挙げます(2026年10月時点)。

トピック 主な用途 代表的なコマンドの例
app アプリ開発 shopify app init(ひな形の作成)、shopify app dev(開発用の起動)
theme テーマ開発 shopify theme pull(ストアからテーマファイルを取得)、shopify theme push(手元のファイルをストアへアップロード)、shopify theme dev(ストア上でプレビューしながら開発)
store ストアの直接操作 shopify store auth(ストアへの認証)、shopify store execute(Admin APIのクエリを実行)
hydrogen カスタムストアフロント関連 Hydrogen(Shopify公式の、独自ストアフロントを作るためのフレームワーク)のデプロイや環境変数・連携先の管理。開発サーバーの起動やビルドなど一部のコマンドは、2026年10月時点の公式ドキュメントでは Hydrogen 側のコマンドで行うとされている

各トピックのコマンドは、公式ドキュメントの themeコマンド一覧、storeコマンド一覧、appコマンド一覧 で確認できます。

個別のコマンドやオプションは数が多く、このブログでも過去にテーマカスタマイズの文脈で部分的に扱っています。本記事では「作業の種類ごとにコマンドが分かれている」という全体像だけ押さえておけば十分です。実際に使う場面になったら、shopify help やそのときの公式ドキュメントで該当コマンドを確認する、という進め方になります。

06自分で使わない場合でも知っておきたいこと

テーマのカスタマイズやアプリ開発を外部に依頼する場合でも、Shopify CLIの存在を知っておくと会話がスムーズになることがあります。たとえば「CLIでテーマをダウンロードして編集する」「CLIでアプリをデプロイする」といった説明を受けたときに、それが何を指しているかのイメージがつきやすくなります。

07まとめ

ここがポイント

  • Shopify CLIは、テーマ・アプリ・カスタムストアフロントの開発を手元のパソコンから進めるための公式コマンドラインツール
  • 前提になるのはNode.js 22.12以上・Git 2.28.0以上・npm等のパッケージマネージャー。Windows専用の手順はなく、これらの前提を満たせば利用できる
  • インストール確認は shopify version、更新は shopify upgrade。バージョン4.0以降は基本的に自動更新される

理解度チェック

質問をクリックすると答えが開きます

Q1. Shopify CLIをインストールする前に、パソコンに用意しておく必要があるものは何ですか?

Node.js(22.12以上)とGit(2.28.0以上)、そしてnpm・Yarn・pnpmのいずれかのパッケージマネージャーです。

Q2. Macで使えるインストール方法のうち、Windowsでは使えないものはどれですか?

Homebrewです。公式ドキュメントで「Macのみ」と明記されています。npm・Yarn・pnpmはWindowsでも前提条件を満たせば利用できます。

Q3. インストール後にバージョンを確認するコマンドは何ですか?

shopify version です。