supacms Docs

CLI の使いかた

supacms CLI のインストールから APIキーの設定まで

supacms CLI を使うと、コンテンツタイプ・フィールド・エントリをコマンドラインから操作できます。 AI エージェント（Claude など）による自動化にも適しています。

インストール

macOS / Linux

curl -fsSL https://cli.supa.ai/cms/install.sh | sh

Windows

supacms-windows.exe をダウンロードし、PATH の通ったフォルダに移動してください。

アップデート

インストールと同じコマンドを再実行するとバイナリが上書きされます。

macOS / Linux

curl -fsSL https://cli.supa.ai/cms/install.sh | sh

Windows

supacms-windows.exe を再ダウンロードして置き換えてください。

APIキーの取得と設定

CLIの認証にはプロジェクトの APIキー が必要です。APIキーはウェブUIから発行します。

  1. cms.supa.ai にサインインし、対象のプロジェクトを開く

  2. 左サイドバーの 設定 → APIキー に移動

  3. 「新規APIキー」 をクリックし、表示名を入力して作成

  4. 表示されたキー（sk-...）をコピーして安全な場所に保管する

キーは作成時にしか表示されません。画面を閉じると二度と確認できないので、必ずコピーしてから閉じてください。

APIキーの渡し方

方法 A — --api-key フラグ（推奨）

各コマンドに --api-key を直接渡します。AI エージェントや会話形式のワークフローに最適です。

supacms content-type list --project myproject --api-key sk-...

方法 B — 環境変数

export SUPACMS_API_KEY=sk-...

フラグが指定された場合は環境変数より優先されます。CI/CD 環境では環境変数をシークレットとして登録してください。

次のステップ