← inaro.devShopify学習ツール
05-03

Shopify CLIのインストールと認証

Shopify CLIをインストールし、対象ストアに認証してコマンドを実行できる

最終確認: 2026-09

解説

受託の現場でなぜ必要か: この回では、Shopify CLI(ターミナルからテーマを操作する公式ツール)を入れて、ストアに認証して使えるようになります。
受託では、テーマの取得・ローカルプレビュー・反映・Lintをすべてshopify theme ...で行うので、ここが動かないと何も始まりません。

Shopify CLIとは、テーマを操作する公式のコマンドラインツール

Shopify CLIは、ターミナルからテーマを取得・プレビュー・反映する公式ツールです。
管理画面のコードエディタで直接編集するのは、緊急時の閲覧用と考えます。
入れ方は、Node.js(LTS)を入れてからnpm install -g @shopify/cli@latestを実行し、shopify versionで確認します。
Ruby版やTheme Kitといった旧世代の情報と混同しないでください。
執筆時点のCLIは4.x系で、必要なNode.jsのバージョンは公式で確認します。

認証はどう行うか

コマンドに--store <ストア名>.myshopify.com-s)を付けると、ブラウザが開きます。
そのストアのスタッフかコラボレーターとしてログインすれば、認証は完了です。
認証はストアごとに保持され、次回からは聞かれません。
最初の認証は自分の開発ストアで行い、クライアントのストアで初めて試すことは避けます。

クライアントのストアに入る方法は2通り

1つ目は、コラボレーターアカウント(Partner経由。ログインで認証)です。
2つ目は、Theme Accessアプリが発行するパスワード(--password)です。
後者はテーマの権限だけを渡せるので、権限を最小にしたいクライアントに提案できます。
どちらもオーナー権限は要りません。

発展:トークンはファイルに置かない

Theme Accessのパスワードや認証トークンを、README・.env・Gitに置きません。
CLIの認証ストアか、シェルの環境変数に留めます。
トークンは資格情報なので、チャットにも残しません。

ステップ1 / 2

ShopifyはShopify Inc.の商標です。本サイトは個人が制作した非公式の学習教材であり、同社の承認・提携・後援を受けていません。記載内容は2026-09時点のものです。料金・上限値・管理画面のラベルは変わるため、作業の前に公式ドキュメントで確認してください。