Claude Codeでブログ原稿やコードを書いていて、「ちょっとWeb検索したい」「アイキャッチ画像が欲しい」「この数字、本当に合ってるか確認したい」——そのたびにブラウザや別ツールに切り替えていないだろうか。Genspark公式のCLIツール「gsk」をsubagentとして組み込めば、これらの作業がClaude Codeの中で完結する。本記事ではインストールから認証、Gemini CLI・Cursorへの展開、Claude Codeへの組み込み3パターン、コストを抑える使い分け、エラー対処法まで実装コード付きで解説する。
📌 この記事でわかること
- Genspark CLI（gsk）の位置づけと、Genspark Web版・Clawとの違い
- インストールから認証までの具体的な手順（コピペ可）
- Gemini CLI・Cursorなど他のエージェントへの展開方法
- Claude Codeにsubagentとして組み込む3つの実装パターンと、実際の話しかけ方
- 「Claude×Claude」の入れ子構造による二重課金を避けるコスト設計
- 現時点でできないこと・よくあるエラーと対処法
1. Genspark CLI（gsk）とは何か——Claude Codeに足りない機能を補う存在
1-1. Claude Codeが標準で持っていない機能
Claude Codeはコーディングエージェントとして非常に優秀だが、標準では次の機能を持たない。
- 学習カットオフ以降のリアルタイムWeb検索（複数URLの一括処理は特に弱い）
- 画像生成・動画生成・音声生成
- 複数ソースを横断したファクトチェック
- Gmail・カレンダー・SNSデータへの直接アクセス
MCPサーバーやWebFetchツールで個別に補う方法もあるが、機能ごとに別々の契約・インストール・認証が必要になりがちだ。ここにGenspark公式CLI「gsk」を1本挟むことで、検索・画像・動画・音声・ファクトチェックを1つの認証・1つのJSON仕様でまとめて呼び出せるようになる。
1-2. gsk・Genspark Web版・Clawの違い
Gensparkには性質の異なる3つの入り口があり、ここを混同すると正しい手順に辿り着けない。
| 入り口 | 形態 | 向いている用途 |
|---|---|---|
| Genspark Web版 | ブラウザの対話UI | スライド作成・対話的なリサーチ |
| Genspark Claw | デスクトップ常駐アプリ | ローカルファイル操作・画面操作 |
| Genspark CLI（gsk） | ターミナルコマンド・JSON出力 | スクリプト統合・他のAIエージェントからの呼び出し |
2. 導入手順——インストールから認証まで5分
- Node.js 18以上を確認し、gskをインストールする
npm install -g @genspark/cli
gsk –version - 認証する——個人利用はブラウザログイン、CI・自動化ならAPIキーの環境変数がおすすめ
# 個人開発向け
gsk login# CI・スクリプト向け
export GSK_API_KEY=”gsk_xxxxxxxx”# 認証状態とプランの確認
gsk login-info - 設定ファイルの権限を絞る——認証情報は
~/.genspark-tool-cli/config.jsonに保存されるため、複数人が使う環境では権限を制限するchmod 600 ~/.genspark-tool-cli/config.json - 自動更新の扱いを決める——gskは一定間隔でバックグラウンド更新を確認する。CI環境で挙動を固定したい場合は無効化する
export GSK_NO_AUTO_UPDATE=1
gsk_から始まる文字列で、GitHubに誤ってコミットすると外部から検出されやすい。.gitignoreに.genspark-tool-cli/を追加し、コミット前チェックでgsk_プレフィックスを検出する仕組みを入れておくことを推奨する。2.5 他のエージェントに組み込む場合——Gemini CLI・Cursor
本記事はClaude Code中心に解説しているが、gskはinit-skillsコマンドで他のエージェント向けの設定も自動生成できる。
2.5-1 Gemini CLIの場合
実行するとGemini CLI向けのスキルドキュメントが自動生成され、Claude Codeと同じ考え方でgskの機能をGemini CLIから呼び出せるようになる。--agent claudeを指定すればClaude Code向け、対応エージェントの一覧はgsk init-skills --helpで確認してほしい。
2.5-2 Cursorの場合
Cursorは Claude Code の.claude/agents/のようなsubagent専用の仕組みを持たない。そのため、Cursor Agentモードのターミナルツール経由でgskコマンドを実行させる形になる。.cursor/rules/genspark.mdcのようなルールファイルに、以下のような指示を記載する。
description: 検索・画像生成・ファクトチェックが必要なときに使うルール
—
Web検索・画像生成・ファクトチェックが必要な場合は、ターミナルツールで `gsk` コマンドを実行すること。
– 最新情報が必要 → gsk search “<クエリ>”
– 画像生成 → gsk img “<英語プロンプト>” -m <モデル名> -o <パス>
– ファクトチェック → gsk task cross_check –query “<主張>”
出力は必ずJSON形式で返るため、必要な部分だけ抽出して報告すること。
.claude/agents/ほど公式に整備された仕組みではない。ターミナルツールの実行権限をAgentモードに与えたうえでのルール運用になるため、まずはClaude Codeで試してから、必要に応じてCursorに展開する順番が安全だ。3. Claude Codeにsubagentとして組み込む——3つの実装パターン
Claude Codeは.claude/agents/配下にMarkdownファイルを置くことで、特定の役割を持ったsubagentを定義できる。gskをここに組み込む代表的な3パターンを紹介する。
パターン1：画像生成専任のサブエージェント
ブログのアイキャッチ画像だけを担当させる、最小構成。.claude/agents/genspark-img.mdを作成する。
name: genspark-img
description: 画像生成が必要なときに使う。Genspark CLI（gsk img）を呼び出す。
tools: [Bash]
—
あなたは画像生成の専任エージェントです。
`gsk img “<英語プロンプト>” -m <モデル名> -o <保存先パス>` を実行し、保存先を報告してください。
ルール：
– プロンプトは英語で書く（公式仕様により日本語は精度が落ちる）
– 出力先は ./assets/images/ 配下に統一する
– モデル名は必ず明示する（省略時のデフォルトは変更される可能性があるため）
Claude Codeで「この記事のアイキャッチを作って」と依頼するだけで、このsubagentがgsk imgを実行するようになる。
パターン2：ファクトチェックの自動化
原稿を保存するたびに自動でファクトチェックが走る構成。.claude/agents/genspark-fact.mdを作成する。
name: genspark-fact
description: 原稿のファクトチェックが必要なときに使う。
tools: [Bash, Read]
—
`gsk task cross_check –task_name “factcheck” –query “<検証したい主張>” –instructions “信頼できるソース3つ以上で確認する”` を実行する。
出力されたJSONからEvidenceセクションを抽出し、Support（裏付けあり）とAgainst（反証あり）に整理して報告する。
.claude/hooks/配下のafterFileEditフックにこのsubagentの呼び出しを仕込んでおけば、原稿を保存するたびに自動でファクトチェックが走り、結果を別ファイルに書き出す運用が組める。
パターン3：オーケストレーター型——万能ツール箱として使う
用途を限定せず、gskの全機能をメインエージェントの判断で使い分けさせる構成。
name: genspark
description: Web検索・画像生成・ファクトチェック・文字起こしなどが必要なときに使う。
tools: [Bash]
—
gskは90以上のAIツールを統合したCLIです。状況に応じて適切なサブコマンドを選び、結果をJSONで返してください。
使い分けの目安：
– 最新情報が必要 → gsk search
– 特定URLの本文抽出 → gsk crawl
– 複数URLの一括処理 → gsk batch-crawl
– 画像生成 → gsk img -m <モデル名>
– ファクトチェック → gsk task cross_check
– 文字起こし → gsk transcribe
すべて –output json で取得し、必要な部分だけメインエージェントに返すこと。
この構成にしておけば、Claude Codeに「これファクトチェックして」「アイキャッチ作って」と自然言語で頼むだけで、subagentが適切なgskコマンドを自動選択して実行する。
3-4 Claude Codeへの実際の話しかけ方（コピペ可）
subagentを設置した後、実際にClaude Codeへどう指示すればよいかの例。
① アイキャッチ画像がほしいとき
テーマは「AIエージェントとターミナルの連携」、16:9、写実的なタッチで。
② 執筆中の主張をファクトチェックしたいとき
本当に合っているかファクトチェックして。
③ 最新情報を調べながら書きたいとき
この記事の該当セクションに反映して。
④ オーケストレーター型に複合タスクを頼むとき
アイキャッチ画像も作って。両方終わったら報告して。
4. 主要コマンド一覧と、二重課金を避ける使い分け
4-1 コマンドの全体像（30以上のうち代表例）
| カテゴリ | コマンド例 | 担当 |
|---|---|---|
| 検索・調査 | gsk search / gsk crawl / gsk summarize / gsk task deep_research | gsk |
| ファクトチェック | gsk task cross_check | gsk（重め） |
| 画像生成 | gsk img（16モデル対応） | gsk |
| 動画・音声生成 | gsk video（14モデル）／gsk audio（14モデル） | gsk |
| 文字起こし | gsk transcribe | gsk |
| 資料生成 | gsk task slides／gsk task docs | gsk（重め） |
| メール・カレンダー | gsk gmail／gsk google_calendar／gsk outlook_calendar | gsk |
| 開発・ナレッジ連携 | gsk github／gsk notion／gsk slack／gsk drive | gsk |
| SNSデータ取得 | gsk social twitter／gsk social reddit | gsk |
| 株価等の情報取得 | gsk stock | gsk |
| 文章執筆・コード生成・リファクタ | — | Claude Code本体 |
gsk login-infoで残高を確認する習慣をつけておくと安心だ。出力はデフォルトでJSON形式のため、jqで必要な部分だけ取り出して後続処理に渡せる。画像・動画・音声などのバイナリを扱うコマンドは-o ファイル名で保存先を指定するのが基本。
4-2. 「Claude×Claude」の入れ子構造に注意
4-3. よくある失敗パターン
- 古いモデル名をそのまま使う：ブログ記事などで見かける古いモデル名は動かないことがある。
gsk img --helpで現在のデフォルトモデル名を都度確認する - 自動更新を放置してCIが不安定になる：「昨日まで動いていたのに突然失敗する」の典型パターン。本番運用では
GSK_NO_AUTO_UPDATE=1でバージョンを固定する - 何でもgskでやろうとする：コーディングはClaude Code、検索・生成系はgskという役割分担を崩すと、subagentのコストとLLMのコストが両方膨らむ
- 軽い検索にファクトチェックを使う：cross_checkは複数ソースを横断する分、実行に時間がかかる重いタスク。単に最新情報が欲しいだけならgsk searchで十分
5. 記事制作の現場での活用シーン
LIFRELLでの記事制作を例に、実際の活用イメージを整理する。
| 作業 | 導入前 | gsk連携後 |
|---|---|---|
| アイキャッチ画像の作成 | 別ツールを開いてプロンプトを入力 | Claude Codeに「作って」と頼むだけ |
| 最新情報の確認 | ブラウザでの手動検索 | 執筆中にsubagentが自動検索 |
| 数値・固有名詞のファクトチェック | 手作業で1件ずつ検索して確認 | 保存時にフックで自動チェック |
6. 現時点でできないこと・向かない使い方
- チャットのような対話的な使い方には向かない：gskの出力は基本的にJSON形式。スクリプトやパイプライン処理には最適だが、人間がターミナルで直接会話するような使い方をすると、生のJSONが返ってきて逆に読みにくい
- 多くのコマンドがクレジットを消費する：gsk search・gsk img・gsk stock等は実行のたびにアカウントのクレジットを消費する。Claude Code経由で頻繁に呼び出す設計にすると、想定より早くクレジットが尽きることがある
- Cursorでの組み込みは非公式寄り：Claude Codeの
.claude/agents/のような専用の仕組みがなく、ターミナルツール経由のルール運用になる。挙動の安定性はClaude Codeほど保証されない - エンタープライズ環境でのカスタマイズには制限がある可能性：独自のプロキシ経由でClaude Code等を運用している環境では、gsk経由のセットアップだと接続先のカスタマイズに制約が出る場合がある（要：自社環境での事前確認）
7. よくあるエラーと対処法
| 症状 | 主な原因 | 対処法 |
|---|---|---|
| コマンドが「command not found」になる | グローバルインストールのパスが通っていない | npm install -g @genspark/cliの実行結果とnpmのグローバルパス設定を確認 |
| 認証エラーが出る | gsk loginの認証切れ、またはAPIキーの入力ミス | gsk loginを再実行するか、GSK_API_KEYの値を再確認 |
| gsk imgで指定したモデルが動かない | ブログ等で見た古いモデル名が現行バージョンで廃止されている | gsk img --helpで現在のデフォルト・対応モデル名を確認 |
| CIジョブが急に失敗するようになった | 自動更新でgskのバージョンが変わり挙動が変化した | GSK_NO_AUTO_UPDATE=1を設定してバージョンを固定 |
| subagentがgskを呼び出してくれない | .claude/agents/配下の設定ファイルのtools指定にBashが含まれていない | frontmatterのtools: [Bash]を確認 |
| クレジットが急に減った | gsk search・gsk img等の消費系コマンドを多用 | gsk login-infoで残高を確認し、消費量の大きいコマンドの呼び出し頻度を見直す |
8. まとめ：どこから始めるか
| 対象 | 推奨する始め方 | 最初のステップ |
|---|---|---|
| まず試したい個人 | パターン1（画像生成専任）から | gsk imgだけ試す |
| 記事制作を効率化したいチーム | パターン2（ファクトチェック自動化） | 1本の記事で試験導入 |
| Claude Codeをフル活用したい開発者 | パターン3（オーケストレーター型） | agents配下に1ファイル設置 |
最後のアドバイス：最初から全機能を組み込もうとせず、画像生成かファクトチェックのどちらか一方から試すのが現実的だ。効果を確認してから、オーケストレーター型に発展させる進め方が失敗しない。
よくある質問
Q. gskはGensparkの有料プランでないと使えませんか？
A. 認証さえ済ませればアカウントのプランに応じたクレジットの範囲で利用できる。無料プランでも基本的な検索・画像生成は試せるが、業務での継続利用にはPlus以上を前提にしたほうが安定する。
Q. Claude Code以外のエージェントでも使えますか？
A. 使える。gsk init-skills --agent geminiのようにGemini CLI向けの設定を自動生成できるほか、Cursorでもターミナルツール経由のルール運用で組み込める。ただしClaude Codeの.claude/agents/ほど公式に整備された仕組みが用意されているわけではない。
Q. プログラミング未経験でも導入できますか？
A. インストールと初回認証はコマンドをコピー＆ペーストするだけで完了する。初期設定だけ詳しい人に依頼し、日常の利用はClaude Codeへの自然言語の指示だけで完結させる分業が現実的だ。
Q. 生成した画像や記事の著作権・利用範囲はどうなりますか？
A. Gensparkアカウント側の利用規約が適用される。商用利用の可否やプランごとの権利範囲は変更されることがあるため、業務利用の前にGenspark公式の最新情報を確認してほしい。
Q. 料金体系についてもっと詳しく知りたいです
A. Gensparkの料金プラン・クレジット消費の仕組みについてはGenspark料金プラン完全ガイドで詳しく解説している。gskのクレジット消費もアカウント全体のクレジットプールと共有される点は事前に押さえておくとよい。
Claude Code・Genspark等のAIツール選定・subagent設計・社内展開まで、貴社の状況に合わせた導入支援を提供しています。
導入について相談する →
本記事の情報は2026年7月時点のものです。Genspark CLI（gsk）のコマンド仕様・モデル名・料金体系は予告なく変更される場合があります。実装前にgsk --helpおよび公式ドキュメントで最新の仕様をご確認ください。
