Cursor CLI完全ガイド｜ターミナルからAI操作する方法【2026】

2026年4月27日 2026年4月28日

Shinomi

Cursor CLIとは？ターミナルからAIエージェントを操作できるツール

「Cursor使ってるけど、GUIを開くのが面倒…ターミナルからサクッとAIに指示できないの？」と思ったことありませんか。筆者もまったく同じ悩みを持っていて、Cursor CLIを知ったときは「これが欲しかった！」と声に出してしまいました。

Cursor CLIは、Cursor IDEのAIエージェント機能をターミナルから直接呼び出せるコマンドラインツールです。GUIを一切開かずに、コード生成・バグ修正・コードレビューをAIに依頼できます。ローカル環境はもちろん、CI/CDパイプラインやリモートサーバー、SSH接続先でも同一コマンドで動作するのが最大の強みです。

2026年4月時点では、Cursor 3のリリースに伴いクラウドエージェント機能も追加されました。OpenAI・Claude・Geminiといった最先端モデルに、サブスクリプション内でアクセスできます。Cursorそのものについては → Cursor とはを参照してください。

Cursor CLIでできること一覧

AIエージェントへの対話的な指示（コード生成・リファクタリング・バグ修正）
GUIなしで完結するヘッドレスモードでのバックグラウンド実行
ターミナルコマンドをAIに補助させるシェルモード
GitHub Actionsとの連携による自動レビュー・修正
MCP統合による外部ツール・データベース連携
拡張機能のインストール・管理

Cursor CLIが注目される背景【2026年最新】

AIエージェント時代になって、「IDEを開く」という動作自体がボトルネックになりつつあります。リモート開発や自動化ニーズが高まるなか、CLIファーストで動くツールへの需要は急増中です。Claude CodeやGitHub Copilot CLIといった競合が登場している今、Cursor CLIはIDEとの深い統合を武器に差別化を図っています。

Cursor CLIのインストール・セットアップ手順

前提として、Cursor IDE本体がインストール済みであることが必要です。対応OSはmacOS・Linux・Windowsで、Node.jsのバージョン要件については最新情報を公式サイトで確認してください。

インストール自体は非常にシンプル。ターミナルで以下を実行するだけです。

curl -fsSL https://cursor.com/install.sh | sh

npm install -g @cursor/cli

PATHの設定はmacOS/Linuxなら ~/.bashrc か ~/.zshrc に追記、Windowsならシステムの環境変数から編集します。筆者はmacでzshを使っていますが、インストール後に source ~/.zshrc を忘れて「コマンドが見つからない」とハマった経験があります。

認証とモデル確認の方法

cursor auth login   # ブラウザが開いてOAuth認証
cursor model list   # 利用可能なモデルを確認

認証後は利用中のプランによってアクセスできるモデルが変わります。Hobbyプランは月50回のプレミアムリクエスト制限があり、Proプランは$20/月（年払いなら$16/月）でエージェント上限が拡張されます。プラン詳細は → Cursor Pro の記事で詳しく扱っています。

セットアップ時のよくあるエラーと対処法

PATHが通らない：ターミナルを再起動するか、export PATH の記述が正しいか確認
認証トークン切れ：cursor auth logout してから再度 cursor auth login
プロキシ環境下：環境変数 HTTPS_PROXY を設定してから実行

Cursor CLIの基本的な使い方・主要コマンド

実際に使い始めると、コマンド体系はシンプルで覚えやすいです。筆者は最初の1週間で主要コマンドを全部ノートにまとめたのですが、結局よく使うのは5個くらいでした。

AIエージェントへの指示・対話方法

cursor agent "このファイルのバグを修正して" --file src/app.ts

cat error.log | cursor agent "このエラーの原因と修正方法を教えて"

cursor agent --interactive

単発実行モードはスクリプトへの組み込みに最適で、対話モードは複雑な指示を段階的に出したいときに便利です。「テスト書いて→カバレッジ確認して→足りない部分を追加して」という流れは対話モードで一気に進められます。

基本情報の確認・拡張機能の管理コマンド

cursor version          # バージョン確認
cursor status           # 接続・認証状態を確認
cursor ext list         # インストール済み拡張機能を一覧表示
cursor ext install <id> # 拡張機能をインストール

設定ファイル .cursorrc をプロジェクトルートに置くと、デフォルトモデルや出力フォーマットをプロジェクトごとにカスタマイズできます。

ヘッドレスCLI・シェルモードの活用法

GUIが不要なヘッドレスモードは、サーバー環境や自動化スクリプトの中で真価を発揮します。ディスプレイがないリモートサーバーでも問題なく動作するのが嬉しいところ。

ヘッドレスCLIの使い方と実行例

cursor agent --headless --output json "全テストを実行してエラーを修正して"

cursor agent --headless "リファクタリングして" > refactor.log 2>&1 &

JSON出力にしておくと、後続のシェルスクリプトで結果をパースしやすくなります。

シェルモードでターミナル操作をAIに補助させる

cursor shell  # シェルモード起動

シェルモードでは「Dockerコンテナのログを直近100行だけ出してフィルタして」のような自然言語でコマンドを生成してくれます。危険なコマンド（rm -rf 系など）は実行前に確認プロンプトが出るので、誤操作のリスクも低減されています。

GitHub Actionsとの連携・スクリプト自動化への応用

CI/CDへの組み込みがCursor CLIの最大の応用先です。筆者はPRを出すたびに手動でレビューコメントを書く時間が1件あたり15分かかっていましたが、自動化後は確認だけで済むようになりました。

GitHub ActionsでCursor CLIを使うワークフロー例

name: AI Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Install Cursor CLI
        run: npm install -g @cursor/cli
      - name: Run AI Review
        env:
          CURSOR_TOKEN: ${{ secrets.CURSOR_TOKEN }}
        run: |
          git diff origin/main...HEAD > diff.txt
          cursor agent --headless --output json \
            "このdiffをレビューして問題点を日本語で指摘して" \
            --file diff.txt > review.json

認証トークンは GitHub Secrets に CURSOR_TOKEN として登録するのが基本です。APIコール数の制限はプランによって異なるため、大規模リポジトリでは公式サイトで上限を確認してください。

シェルスクリプト・バッチ処理での活用パターン

複数ファイルを一括リファクタリングするなら、こういう構成がシンプルです。

#!/bin/bash
find ./src -name "*.ts" | while read file; do
  cursor agent --headless "このファイルをリファクタリングして" \
    --file "$file" --apply
done

MCP統合でデータベースや外部APIと連携する応用例については → Claude Code MCP も参考になります。

Cursor CLIとClaude Codeの違いを比較【2026年版】

「どっちを使えばいいの？」という質問をよくもらいます。正直、用途によって答えが変わります。

機能・対応モデル・料金の比較表

項目	Cursor CLI	Claude Code
料金	Cursorサブスクリプション内（Pro $20/月〜）	Anthropic API従量課金
対応モデル	OpenAI・Claude・Gemini（マルチモデル）	Claude系モデル特化
IDE連携	Cursor IDEと深く統合	エディタ非依存
MCP対応	◯	◯
自動化対応	◯（ヘッドレスモード）	◯

どちらを選ぶべき？ユースケース別の使い分け

Cursor IDEをすでに使っている人：Cursor CLIが統合的で断然便利
Claude特化の高精度コーディングが必要な人：Claude Codeに軍配
コスト予測を立てたい人：月額固定のCursor CLIが管理しやすい

両方を使い分けるなら「普段の開発はCursor CLI、重要なコードの精査はClaude Code」という分け方が現実的です。Claude Codeの詳細は → Claude Code 使い方をどうぞ。

【独自検証】Cursor CLIの実践的ワークフロー3選

実際に使い込んで、特に効果を感じた3つのワークフローを紹介します。

ワークフロー①：PR単位のAI自動コードレビュー

git diff main...feature/my-branch | \
  cursor agent --headless "セキュリティリスクとバグを指摘して" \
  --output json | jq '.comments[]'

このワークフローをチーム開発に導入する場合、レビューコメントの「トーン」をプロンプトで統一しておくと、チームメンバーへの違和感が減ります。「建設的なフィードバックとして日本語で」の一文を添えるだけで印象が変わります。

ワークフロー②：レガシーコードの段階的リファクタリング

ディレクトリ全体を分析して問題点を洗い出す
優先度付きの改善リストをJSON形式で出力
ヘッドレスモードで上位10件から逐次修正を適用

cursor agent --headless --output json \
  "このディレクトリの技術的負債を優先度高/中/低で分類して" \
  --dir ./legacy/src > issues.json

筆者がこのフローで3000行のレガシーコードを整理したとき、手作業なら2日かかる分析が30分で終わりました。

ワークフロー③：ドキュメント・テスト自動生成パイプライン

コード変更をトリガーにREADMEやAPIドキュメントを自動更新する仕組みを組めます。

cursor agent --headless \
  "変更されたファイルのユニットテストを生成してtest/ディレクトリに保存して" \
  --file "$CHANGED_FILE" --apply

カバレッジが低い関数に絞って実行することで、APIコールのムダ遣いを防げます。

他のカテゴリも見る

[AI議事録] 【2026年最新】AI議事録ツール比較|導入企業が選ぶおすすめ5選
[AI画像処理] AI画像高画質化【2026年】おすすめツール5選

まとめ：Cursor CLIでAI駆動の開発ワークフローを構築しよう

Cursor CLIの主要メリットをおさらいします。

GUIなしでAIエージェントを操作できるため、あらゆる環境で一貫した開発フローを実現
GitHub Actionsや自動化スクリプトに組み込みでき、手動作業を大幅に削減
Cursorサブスクリプション内でマルチモデル対応なので、コスト管理がシンプル

2026年4月に登場したCursor 3はクラウドエージェント機能も加わり、CLIからの操作範囲がさらに広がっています。今後の正式版リリースやCLI特化の新機能にも期待大です。

まずはインストールして cursor agent "Hello, Cursor CLI" と打ってみてください。その感触を確かめたら、GitHub Actionsへの組み込みに挑戦するのが次のステップとしておすすめです。

もっと詳しく知りたい方は → Cursor エディタの使い方完全ガイド

参考書籍

AIエディタCursor完全ガイドーやりたいことを伝えるだけでできる新世代プログラミング（木下雄一朗）
Cursor完全入門エンジニア&Webクリエイターの生産性がアップするAIコードエディターの操り方（リブロワークス）
Claude CodeによるAI駆動開発入門（平川知秀）

この記事を書いた人

Shinomi