Higgsfield CLIコマンド完全リファレンス

【PR】本記事はHiggsfieldからの提供です。

Higgsfield CLIは、Claude CodeやCodexなどのコーディングエージェントから、Higgsfieldの画像・動画生成や関連機能を操作するためのコマンドライン環境です。この記事では、動画で実際に確認した操作と、2026年8月時点のHiggsfield公式情報を分けて整理します。

1. まずは公式手順でセットアップする

2026年8月時点のHiggsfield公式CLIページでは、次の流れが案内されています。

npm i -g @higgsfield/cli
higgsfield auth login
npx skills add higgsfield-ai/skills

auth loginを実行するとブラウザが開くので、Higgsfieldアカウントで認証します。認証自体はエージェント任せにせず、人がブラウザ上で完了させます。

Higgsfield公式では、CLI + SkillsはClaude Code・Cursor・Codexなどのコーディングエージェント向けとして案内されています。チャット型エージェントではMCP、コーディングエージェントではCLI + Skillsを使う、という役割分担です。

ブラウザUIを開かずに生成を実行できるため、複数の画像や動画をまとめて作る、自動処理の中にHiggsfieldを組み込む、といった用途と相性があります。

動画では、CLI導入後にエージェントへ「何ができるか」を確認しながら、次のような操作を試しています。

注意：以前の本文では「全コマンドを実際に叩いて確認」としていましたが、動画では一覧を確認しただけの機能もあります。ここでは実際に触れた機能と、画面上で確認した機能をまとめています。

CLIをエージェントへ導入した後は、「この画像を参照して16:9で画像を作る」「この画像から動画を作る」といった自然文で依頼できます。裏側ではCLIがモデル・参照素材・出力設定を使って生成処理を実行します。

動画では、GPT Image 2でウォータースライダーのおにぎり画像を作り、それを参照して別バージョンの画像や動画を生成しました。生成物をローカルへ保存できる点も、ブラウザUI中心の作業と比べて便利です。

CLIを使うと生成が速いため、設定ミスもそのまま実行されやすくなります。特にモデル名、縦横比、参照画像、開始・終了フレーム、omni_referenceのようなモードは、生成前に必ず確認してください。

動画では、エージェントがエラー時に同じ処理を複数回実行し、結果として複数回分のクレジットを消費した経験も紹介しています。操作ミスや意図しない生成のクレジットが必ず返金されるとは限りません。そのため、生成前の最終確認が重要です。

動画ではCLI経由でクレジット残高を確認し、残りクレジット数をエージェントから取得しています。大量生成を行う前に、残高とモデルごとのコストを確認しておくと安全です。

Higgsfield公式ヘルプでも、CLIとMCPは同じHiggsfieldアカウント・プランのクレジットを使うと説明されています。Unlimitedモデルや無料生成枠はCLI/MCPには適用されないため、Web版と同じ感覚で大量生成しない方が安全です。

Higgsfield公式のSkillsページでは、CLI向けに次の3つのSkillsが案内されています。

これらはnpx skills add higgsfield-ai/skillsで追加できます。CLI自体のコマンド一覧とSkillsは同じものではないため、用途に応じて使い分けます。

2026年8月時点の公式ヘルプでは、Claude Code・Cursor・CodexなどのコーディングエージェントにはCLI + Skills、Claude Webなどのチャット型エージェントにはMCPが向くと整理されています。

動画撮影時にはMCPで環境依存のエラーが出るケースがあり、実演ではCLIを中心に使いました。MCP/CLIはいずれも更新が速いため、導入時は公式ページの最新手順を確認してください。

実際のセットアップと画像・動画生成の流れはこちらの動画で確認できます。

Higgsfield CLIの強みは、ブラウザUIを開かずに、コーディングエージェントから生成処理を実行できることです。まずは公式手順でCLIとSkillsを導入し、モデル・コスト・参照素材を確認したうえで、小さな生成から試すのがおすすめです。

Higgsfieldをご自身の環境でも試してみたい人はこちらからどうぞ。

本記事はHiggsfieldの提供・依頼により作成しています。