ガイド

Cursor CLIとは?インストール・使い方・料金・Claude Codeとの違いを完全解説【2026年最新】

室谷東吾
監修者室谷東吾(@0x__tom

株式会社MYUUU 代表取締役 / 日本最大級AIコミュニティ「.AI」創設者(累計2,000名超)/ セプテーニ・ホールディングス(電通グループ)と資本業務提携 / 著書「お金を使わず、AIを働かせる『Dify』活用」(ぱる出版、3刷)/ Xフォロワー約2万人

テキトー教師
監修者テキトー教師(@tekitoo_T_cher

.AI 認定講師 / 教育×AIの専門家 / 累計300名以上にAI活用を指導 / 「テキトーに学ぶ」がモットーの実践派講師 / Xアカウント

Cursor CLIとは?インストール・使い方・料金・Claude Codeとの違いを完全解説【2026年最新】

Cursor CLIとは?ターミナルからAIエージェントを動かす新機能

Cursor Agent CLI公式ブログページ(公式サイトより)

室谷室谷
今回はCursor CLIについて深掘りしていきます。前回のCursor Agent回でも少し触れましたが、このCLI版が想像以上にパワフルなんですよね・・・
テキトー教師テキトー教師
.AI(ドットエーアイ)のコミュニティでも最近話題になってますね。「ターミナルから直接AIエージェントを動かせるってどういうこと?」という質問が増えてきました。
室谷室谷
簡単に言うと、Cursorのエディタを開かなくても、ターミナルのコマンドラインからCursor Agentのフル機能を使えるようになった、ということです。2025年8月にAnysphere社が公式ブログで発表しました。
テキトー教師テキトー教師
講座の受講生さんからすると「なぜエディタがあるのにわざわざターミナルで使うの?」って疑問が出るんですけど、ここには明確な理由があるんですよね。
室谷室谷
そうなんですよ。大きく3つあって、まずリモートサーバーやDocker環境でGUIなしで使いたい場合

次にCI/CDパイプラインに組み込んで自動化したい場合。そしてNeovim、JetBrains、Emacsなど他のエディタのユーザーがCursor Agentだけ活用したい場合です。
テキトー教師テキトー教師
3つ目は盲点ですよね。IntelliJやJetBrainsをメインで使っている人にとっては、エディタを乗り換えずにCursorのAI機能だけ使えるのは大きいです。
室谷室谷
MYUUUのエンジニアでも、Neovimから離れられない人がCursor CLIを併用して「最強の環境ができた」って言ってましたw
テキトー教師テキトー教師
Cursor CLIの公式ブログにも「Neovim や JetBrains、その他の IDE を利用しているユーザーの方は、お気に入りのツールと並行して Cursor Agent の持つすべての機能を活用できるようになります」と書かれてますね。
室谷室谷
今日はそのCursor CLIのインストールから使い方、料金、MCP連携、さらにはClaude Codeとの違いまで一気にカバーしていきましょう。

インストール方法を環境別に解説

室谷室谷
まずインストールからですね。OS別に微妙にやり方が違うので整理しておきましょう。
テキトー教師テキトー教師
講座でも最初のつまずきポイントなので、丁寧に見ていきましょう。

macOSへのインストール

室谷室谷
macOSが一番シンプルです。公式のインストールスクリプト一発で入ります。
curl https://cursor.com/install -fsSL | bash
テキトー教師テキトー教師
Homebrewでもインストールできますよね?
室谷室谷
はい、Homebrewユーザーならbrewでも入れられます。ただし公式のインストールスクリプトの方が最新版が確実に入るので、まずはそちらがおすすめです。
brew install --cask cursor
テキトー教師テキトー教師
受講生さんに教えるときは、まずcurlのワンライナーを案内してます。Homebrewだとバージョンが少し遅れることがあるので・・・
室谷室谷
インストール後、ターミナルでcursor --versionと打ってバージョンが表示されればOKです。
cursor --version

Windowsへのインストール

テキトー教師テキトー教師
Windowsの場合はどうでしょう?
室谷室谷
Windowsはまずからデスクトップ版をダウンロードしてインストールします。その後、CLIのパスを通す設定が必要です。
テキトー教師テキトー教師
具体的には、Cursorを開いてCtrl+Shift+Pでコマンドパレットを出して「Install 'cursor' command in PATH」を実行する流れですね。
室谷室谷
PowerShellやコマンドプロンプトでcursor --versionが通れば完了です。WSL2環境でLinux版を入れる方法もありますが、まずはWindows native版から試すのがいいですね。

Linuxへのインストール

室谷室谷
Linuxもmacと同じくcurlのワンライナーでいけます。
curl https://cursor.com/install -fsSL | bash
テキトー教師テキトー教師
ヘッドレスサーバー、つまりGUIのない環境でも動くのがCursor CLIの強みですよね。リモートのLinuxサーバーにSSHで入って、そこでcursor agentを実行する使い方です。
室谷室谷
Docker環境でも同じインストールスクリプトが使えるので、CIパイプラインに組み込む場合にも便利です。

基本的な使い方を完全ガイド

Cursor CLIのインストールコマンドと使い始め方(公式サイトより)

室谷室谷
インストールが終わったら、まず認証からですね。

ログインと認証

テキトー教師テキトー教師
最初にcursor agent loginでCursorアカウントにログインします。
cursor agent login
室谷室谷
ブラウザが開いてCursorアカウントでログインすると、認証トークンが保存されます。一度やれば以降は自動でログイン状態が維持されるので、毎回やる必要はありません。
テキトー教師テキトー教師
受講生さんから「ログインしたのに使えない」という相談があるんですが、大抵は無料プラン(Hobby)の利用制限に引っかかってるケースですね。Proプラン以上だとエージェントの上限が拡張されるので、本格的に使うならProがスタートラインです。

対話モードの起動

室谷室谷
基本の使い方はcursor agentをそのまま実行するだけです。
cursor agent
テキトー教師テキトー教師
これで対話モードが起動して、プロンプトの入力待ちになります。Autoモードがデフォルトで、タスクに応じて最適なモデルを自動選択してくれます。
室谷室谷
プロンプトを直接引数に渡すこともできます。ワンショットで質問したいときに便利ですね。
cursor agent "このプロジェクトのファイル構造を分析して"
テキトー教師テキトー教師
初回実行時には「ワークスペースの信頼確認」というダイアログが出ます。Cursor Agentがファイルの読み書きやコマンド実行をする前に、そのディレクトリを信頼するかどうかの確認です。
室谷室谷
セキュリティ的に大事なステップです。MCPサーバーを含めて信頼するか、MCPは無効にするかも選べます。

対話モード内のスラッシュコマンド

テキトー教師テキトー教師
対話モードに入った後は、スラッシュコマンドが使えます。整理するとこうなります。
コマンド機能
/model <モデル名>使用モデルを切り替え
@ファイル名ファイルをコンテキストに追加
!コマンドシェルコマンドを実行
/planプランモードに切り替え
室谷室谷
/でコマンド、@でファイル参照、!でシェルコマンド。Cursor IDEのチャットと同じ感覚で使えるのがいいんですよね。
テキトー教師テキトー教師
IDEで設定したカスタムスラッシュコマンドもCLIからそのまま使えるんですよ。これ、地味にありがたいポイントです。
室谷室谷
設定のIDE-CLI共有はCursor CLIならではの強みです。

プランモードの活用

室谷室谷
--planオプションを付けると、コードを変更せずに計画だけを立ててくれるモードになります。
cursor agent --plan "このプロジェクトのリファクタリング方針を提案して"
テキトー教師テキトー教師
エージェントが自動でTo-Doリストを作成して順次分析を進めてくれます。プロジェクト全体を俯瞰してから作業に入りたいときに重宝します。
室谷室谷
実際に使ってみると、ファイルの読み取り、シェルコマンドの実行、Grepによる検索を自動で行って、最終的にMarkdownのレポートまで作ってくれます。
テキトー教師テキトー教師
注意点としては、Cursor CLIの自律性はかなり高いので、「何を重視してほしいか」を最初にプロンプトで伝えた方がいい結果になります。

非対話モード(スクリプト・CI向け)

室谷室谷
--printオプションを使うと、対話UIなしで結果を標準出力に出力できます。スクリプトやCI/CDでの自動化に便利です。
cursor agent --print "このコードのテストを書いて"
テキトー教師テキトー教師
ストリーミング出力をJSON形式で取得したい場合は、オプションを組み合わせます。
cursor agent --print --stream-partial-output --output-format stream-json "詳細な分析をして"
室谷室谷
--stream-partial-outputを使う場合は--output-format stream-jsonが必須です。単独で使うとエラーになるので注意してください。
テキトー教師テキトー教師
CIパイプラインでCursor Agentにコードレビューやテスト生成を自動でやらせる、みたいなワークフローが組めるわけですね。

エージェント機能 — Cursor CLIの核心

室谷室谷
ここからがCursor CLIの本領発揮です。エージェント機能について詳しく見ていきましょう。
テキトー教師テキトー教師
「エージェント」って言葉だけ聞いてもピンと来ない人が多いので、まず何ができるのかを具体的に説明しますね。

エージェントができること

室谷室谷
Cursor CLIのエージェントは、ターミナル上でファイルの生成・編集、シェルコマンドの実行、コードベースの検索を自律的に行えます。IDEのAgent Chatと全く同じ能力がターミナルで使えるイメージです。
テキトー教師テキトー教師
具体的にはこんなことができます。
  • ファイルの作成・編集・削除
  • ターミナルコマンドの自動実行
  • コードベース全体の検索・分析
  • Git操作(コミット、ブランチ作成など)
  • テストの自動生成・実行
  • プロジェクト構造の分析とレポート作成
室谷室谷
僕が実際にやって便利だったのは、複数のターミナルウィンドウでエージェントを並列実行するパターンです。1つ目のターミナルでフロントエンドの修正、2つ目でバックエンドのAPI修正、みたいな使い方ですね。
テキトー教師テキトー教師
IDEだとこういう使い方は難しいですから。Cursor CLIだからこそ、複数プロセスを同時に走らせられる。
室谷室谷
海外では「Claude CodeをCursorで動かすのはメモリ効率が悪い」って議論があって、ターミナル完結派が増えてるんですよね。Cursor CLIもその文脈で注目されてます。

ヘッドレスモードで自動化する

テキトー教師テキトー教師
ヘッドレスモードについても触れておきましょう。これがCI/CDや自動化で使える機能です。
室谷室谷
--printフラグに加えて、Cursor Agentはヘッドレスモードでの実行をサポートしています。GUIを一切立ち上げずに、バックグラウンドでエージェントを動かせます。
cursor agent --print --model auto "全テストを実行して結果をレポートして"
テキトー教師テキトー教師
CI/CDパイプラインに組み込むと、プルリクエストごとに自動でコードレビューやテスト生成をエージェントにやらせる、みたいなワークフローが実現できますね。
室谷室谷
Docker環境での実行例はこんな感じです。
docker run -it --rm \
  -v $(pwd):/workspace \
  cursor-cli-image \
  cursor agent --print "ワークスペースのセキュリティチェックを実行して"
テキトー教師テキトー教師
企業でCursorを導入している場合、このヘッドレスモードを使ったCI統合は大きな差別化になりますね。

対応モデルを一覧で紹介

室谷室谷
Cursor CLIで使えるモデルの話をしましょう。これがかなり充実してるんですよ。
テキトー教師テキトー教師
利用可能なモデルは--list-modelsで確認できます。
cursor agent --list-models
室谷室谷
2026年時点で22種類以上のモデルが利用可能です。主要なものをまとめるとこうなります。
プロバイダーモデル特徴
AnthropicClaude 4.5 Opus (Thinking)デフォルトモデル。高精度
AnthropicClaude 4.5 Sonnet高速・コスパ良好
AnthropicClaude 4.5 Sonnet (Thinking)思考プロセス付きSonnet
OpenAIGPT-5.2最新のOpenAIモデル
OpenAIGPT-5.2 Codexコーディング特化
GoogleGemini 3 ProGoogleの最新モデル
GoogleGemini 3 Flash高速応答
xAIGrokxAIのモデル
CursorAutoタスクに応じて自動選択
テキトー教師テキトー教師
特筆すべきはAutoモードですよね。タスクの内容に応じて最適なモデルを自動的に選んでくれるので、モデル選びに悩む必要がないです。
室谷室谷
Gemini CLIと連携する文脈で「cursor gemini cli」と検索する人もいますが、Cursor CLI自体がGemini 3 ProやGemini 3 Flashに対応しているので、別途Gemini CLIを入れる必要はありません。
テキトー教師テキトー教師
モデルを指定して実行したい場合は--modelオプションを使います。
cursor agent --model gpt-5.2 "この関数のパフォーマンスを最適化して"
室谷室谷
対話モード内でも/modelコマンドでリアルタイムに切り替えられるので、「この作業はGPT-5.2で、次はClaude 4.5 Opusで」みたいな使い分けも簡単です。
テキトー教師テキトー教師
受講生さんにはまずAutoモードで始めることをおすすめしてます。慣れてきたら、コーディングにはClaude 4.5 Opus、調査にはGemini 3 Pro、みたいに使い分けるのが効率的です。

MCP連携 — 外部ツールとの統合

室谷室谷
次はMCP連携ですね。Model Context Protocolの話です。
テキトー教師テキトー教師
MCPって何ですか?という受講生さんも多いので、まず簡単に説明すると、AIモデルが外部のツールやデータソースにアクセスするための標準プロトコルです。
室谷室谷
Cursor CLIでは、IDEで設定したMCPサーバーをそのまま使えるのが大きな強みです。

MCPサーバーの管理

テキトー教師テキトー教師
CLIからMCPサーバーの状態を確認するコマンドがあります。
cursor agent mcp list
室谷室谷
このコマンドで、設定されているMCPサーバーとその状態(ready / requires_authentication)が一覧表示されます。
テキトー教師テキトー教師
特定のMCPサーバーが提供するツールの一覧も確認できます。
cursor agent mcp list-tools file-system
室谷室谷
file-systemサーバーなら、ファイルの読み書き、ディレクトリ操作、検索など11個のツールが利用可能です。SlackやGoogle Calendar、NotionなどのMCPサーバーも同じ要領で管理できます。
テキトー教師テキトー教師
Cursor IDE側で一度設定すれば、CLIでもそのまま使える。この手間の少なさが魅力です。

設定を二重に管理する必要がないです。
室谷室谷
この辺りはClaude Codeだと独自の設定ファイルで管理するので、IDEとCLIで設定が分かれるんですよね。Cursor CLIは統一されていて楽です。

Hooksとの連携

テキトー教師テキトー教師
Cursor CLIはHooks機能にも対応しています。特定のアクションの前後に自動的にスクリプトを実行させる仕組みです。
室谷室谷
たとえば「ファイル保存時に自動でlintを走らせる」「コミット前にテストを実行する」みたいなワークフローを設定できます。MCP、スキル、フックはProプラン以上で利用可能です。

他のエディタ・IDEとの連携

室谷室谷
Cursor CLIの大きな売りの1つが、Cursor以外のエディタやIDEからも使えるということです。
テキトー教師テキトー教師
ここは受講生さんから質問が集中するポイントです。「JetBrainsから乗り換えたくないけど、AIエージェントは使いたい」というニーズです。

Neovimとの併用

室谷室谷
Neovimユーザーは、Neovimでコードを書きながら、隣のターミナルでcursor agentを走らせるのが定番の使い方です。
テキトー教師テキトー教師
Neovimのターミナル分割機能と組み合わせると、1画面でコード編集とAIエージェントの対話を同時に進められますね。
室谷室谷
LSPとの連携も視野に入ってきます。Cursor CLIがLSP(Language Server Protocol)をサポートしているので、エディタ側のコード解析結果をエージェントに渡す、みたいな高度な使い方も将来的には可能になるかもしれません。

JetBrains・IntelliJ IDEAとの併用

テキトー教師テキトー教師
JetBrains系のIDE(IntelliJ IDEA、WebStorm、PyCharmなど)を使っている方も、ターミナルタブからCursor CLIを直接起動できます。
室谷室谷
JetBrainsのターミナルタブでcursor agentを実行するだけです。IntelliJ IDEAのプロジェクトディレクトリがそのままワークスペースとして認識されます。
テキトー教師テキトー教師
エンタープライズ環境ではJetBrainsが標準IDEになっているケースも多いので、そこにCursor CLIを足すだけでAIエージェント機能が手に入るのは導入ハードルが低いですね。

Emacsとの併用

室谷室谷
Emacsユーザーにも同じアプローチが使えます。Emacsのshellモードやvtermからcursor agentを起動する形です。
テキトー教師テキトー教師
エディタを選ばないというのは、チームで統一ツールを導入するときに障壁が下がります。

GitHub・GitLab連携

室谷室谷
Cursor CLIはGitHubやGitLabとの連携も意識されています。リポジトリのクローンからブランチ作成、プルリクエスト作成までをエージェントに指示できます。
テキトー教師テキトー教師
たとえばこんな使い方です。
cursor agent "mainブランチから新しいフィーチャーブランチを作って、ログイン画面のバリデーションを追加して、コミットまでやって"
室谷室谷
エージェントがGit操作も含めて自律的に進めてくれるので、GitHub Flowに沿った開発がターミナルだけで完結します。

料金プランと利用制限

Cursor料金プラン一覧 — Hobby、Pro、Pro+、Ultraの比較(公式サイトより)

室谷室谷
料金の話をしましょう。これ、コミュニティでも毎週聞かれるんですよね・・・
テキトー教師テキトー教師
講座でも初日に必ず出る質問です。「CLI使うのに追加料金かかりますか?」と「どのプランがいいですか?」の2つが鉄板ですね。

CLIは追加料金なし

室谷室谷
結論から言うと、Cursor CLIはCursorのサブスクリプションに含まれています。追加料金は一切かかりません。
テキトー教師テキトー教師
IDEで使っているプランのまま、CLIも同じモデルが使えるということですね。

プラン別の比較

室谷室谷
2026年時点のCursor料金プランを整理するとこうなります。
プラン月額エージェント利用主な特徴
Hobby無料制限ありクレジットカード不要
Pro$20/月上限拡張MCP・スキル・フック対応
Pro+$60/月3倍の使用量全モデルで使用量3倍
Ultra$200/月20倍の使用量新機能優先アクセス
Teams$40/ユーザー/月チーム機能付きSAML/OIDC SSO対応
Enterpriseカスタムフル機能監査ログ・管理者制御
テキトー教師テキトー教師
受講生さんには「まずProから始めて、2〜3週間使ってから判断しましょう」とアドバイスしてます。いきなりPro+にして使い切れない人もいますから。
室谷室谷
MYUUUのエンジニアはほぼProかPro+で回してます。CLIでヘッドレスモードをガンガン使うヘビーユーザーならPro+の3倍枠が必要になりますが、普通に使う分にはProで十分です。
テキトー教師テキトー教師
エンタープライズ向けにはTeamsプランがあって、SAML/OIDC SSOやロールベースのアクセス制御、使用量のレポート機能などがつきます。
室谷室谷
企業導入の場合は、EnterpriseプランでAIコード追跡APIや監査ログが使えるのがポイントですね。セキュリティ要件の厳しい企業でも安心です。

利用制限と回数

テキトー教師テキトー教師
Hobbyプラン(無料)だとエージェントのリクエスト数に制限があります。具体的な回数は公式には明記されていませんが、1日に数回使うと制限に達する印象です。
室谷室谷
Proプランだと「エージェントの上限拡張」と書かれていて、日常的に使う分には困らないレベルです。ただし、CLIのヘッドレスモードで大量のタスクを回すような使い方だと、Pro+の3倍枠やUltraの20倍枠が欲しくなります。
テキトー教師テキトー教師
「回数制限に引っかかった」という相談の大半は、Hobbyプランのまま使い続けているケースですね。本気で開発に使うなら、Proプランへのアップグレードが必須です。

Claude Codeとの違いを徹底比較

室谷室谷
ここは読者が一番気になるポイントだと思います。Cursor CLIとClaude Code、どっちを使えばいいのか問題。
テキトー教師テキトー教師
両方使い倒した上で比較してみましょう。

基本設計の違い

室谷室谷
根本的な違いは、Cursor CLIがCursor IDEの拡張であるのに対し、Claude CodeはAnthropicが作ったスタンドアロンのターミナルツールだということです。
テキトー教師テキトー教師
この違いが使い勝手に大きく影響します。Cursor CLIはIDEの設定を全部引き継げるけど、Claude CodeはClaude Codeで独自の世界を持っている。

機能比較表

室谷室谷
主要な違いを表にまとめてみましょう。
項目Cursor CLIClaude Code
基本設計Cursor IDEの拡張スタンドアロン
エディタ統合Cursor IDEと密結合任意のエディタと連携可能
利用可能モデル22種類以上(GPT, Claude, Gemini, Grok)Claude専用
非対話モード--printフラグ-pフラグ
モデル自動選択Autoモードなし
MCP統合IDE設定を共有独自設定
プランモード--planオプションなし(会話内で提案)
料金Cursorサブスクリプションに含むAnthropic API / Claude Pro等
テキトー教師テキトー教師
モデルの選択肢の幅が決定的に違いますよね。Cursor CLIはOpenAI、Google、xAIのモデルも使えるけど、Claude CodeはClaude一択です。
室谷室谷
ただし、Claude Codeの方がClaude特化で最適化されているので、Claudeを使う前提ならClaude Codeの方がレスポンスが良い場面もあります。

どっちを選ぶべき?

室谷室谷
僕の使い分けはこうです。普段Cursor IDEを使っていて、IDEの設定やMCPサーバーをそのまま活用したいならCursor CLI。

Claudeの最新機能をフルに使いたい場合や、ターミナル完結で軽量に動かしたいならClaude Code。
テキトー教師テキトー教師
講座では「どっちも試して自分に合う方を選んでください」と言ってますが、Cursorユーザーならまず迷わずCursor CLIから入るのが自然ですね。
室谷室谷
MYUUUのエンジニアの中には、Cursor CLI(指揮者的な役割)で全体を管理しつつ、具体的なコーディングはClaude CodeやCodexに任せる、というオーケストレーター的な使い方をしている人もいます。
テキトー教師テキトー教師
「全部1つのツールでやる」時代から、それぞれの強みを活かして組み合わせる時代に変わってきています。

拡張機能とコマンドリファレンス

室谷室谷
Cursor CLIで使えるコマンドをもう少し深掘りしておきましょう。

拡張機能の管理

テキトー教師テキトー教師
CLIから拡張機能(エクステンション)の一覧を確認したり、インストール・アンインストールができます。
cursor --list-extensions --show-versions
室谷室谷
VS Code互換の拡張機能がそのまま使えるのはCursorの強みですね。CIで特定の拡張機能がインストールされているかの確認にも活用できます。

主要コマンド一覧

テキトー教師テキトー教師
Cursor CLIの主要コマンドを整理するとこうなります。
コマンド説明
cursor agentエージェントモードを起動
cursor agent login認証(ログイン)
cursor agent --list-models利用可能なモデル一覧
cursor agent --model <id>モデルを指定して起動
cursor agent --planプランモード
cursor agent --print非対話モード
cursor agent mcp listMCPサーバー一覧
cursor agent mcp list-tools <name>MCPツール一覧
cursor --versionバージョン確認
cursor --statusシステム診断情報
cursor --list-extensions拡張機能一覧
cursor serve-webWeb版を起動
cursor tunnelリモートアクセス
室谷室谷
--statusコマンドはトラブルシューティングの必須ツールです。OS、CPU、メモリ、GPU状態に加えて、起動中のMCPサーバーのプロセスまで確認できます。

Changelogと最新情報の追い方

テキトー教師テキトー教師
Cursor CLIはベータ版からスタートして、継続的にアップデートされています。最新情報はやChangelogで確認できます。
室谷室谷
ちなみに、Cursor CLIのセキュリティ保護機能はまだ発展途上だと公式ブログに書かれています。「自己責任で使い、信頼できる環境でのみ使用してください」とのことなので、本番環境での自動化は慎重に進めた方がいいですね。

よくある質問(FAQ)

室谷室谷
ここからは.AIコミュニティやSNSで多い質問に答えていきましょう。

Cursor CLIは無料で使えますか?

テキトー教師テキトー教師
Cursor CLIはHobbyプラン(無料)でも使えます。ただし、エージェントのリクエスト数に制限があります。
室谷室谷
無料で「お試し」する分には問題ないですが、業務で使うならProプラン(月$20)以上が現実的です。MCP連携やHooks機能もProプラン以上で使えるようになります。

スマホやアプリから使えますか?

テキトー教師テキトー教師
Cursor CLIはターミナルベースのツールなので、スマホの通常のアプリとしては使えません。
室谷室谷
ただし、スマホからSSHでサーバーに接続して、そこでCursor CLIを実行するという方法はあります。iOSならTermiusやBlink Shell、AndroidならTermuxなどのSSHクライアントアプリ経由ですね。

Cursor IDEがなくてもCLIだけ使えますか?

室谷室谷
はい、Cursor CLIはインストールスクリプトで単体導入できます。ただし、Cursorのアカウントとサブスクリプションは必要です。
テキトー教師テキトー教師
IDEを一度も開かなくても、CLIだけでアカウント認証からエージェント利用までできます。IDE不要でCLIだけ使いたいユーザーには嬉しいポイントですね。

表示されない・使えない場合の対処法

テキトー教師テキトー教師
「cursor agentコマンドが見つからない」という問題は、パスが通っていないケースが多いです。
室谷室谷
macOSやLinuxなら以下を確認してみてください。
which cursor
テキトー教師テキトー教師
パスが通っていない場合は、インストールスクリプトをもう一度実行するか、~/.bashrc~/.zshrcにパスを追加します。
室谷室谷
cursor --statusコマンドでシステム診断情報が確認できるので、トラブルシューティングの第一歩はこれを実行することですね。

APIとして使えますか?

室谷室谷
Cursor CLI自体はAPIではありませんが、--printオプションと--output-format stream-jsonを組み合わせることで、プログラムから呼び出してJSON出力を受け取ることができます。
テキトー教師テキトー教師
つまり、シェルスクリプトやPythonからCursor Agentの能力を呼び出すラッパーを作れるわけですね。
室谷室谷
CursorはAPIを別途提供しているわけではないので、CLI経由でのプログラマティックな利用が現時点でのベストプラクティスです。

定期実行はできますか?

テキトー教師テキトー教師
cronやGitHub Actionsと組み合わせてCursor CLIの定期実行は可能です。
室谷室谷
たとえば毎朝9時にコードベースのセキュリティチェックを走らせる、みたいな自動化ですね。--printモードで実行して結果をSlackに飛ばす、みたいなワークフローが組めます。
# cronの例
0 9 * * * cd /path/to/project && cursor agent --print "セキュリティチェックを実行してレポートして" > /tmp/security-report.txt
テキトー教師テキトー教師
ただし、認証トークンの有効期限には注意が必要です。長期間の自動実行では、トークンの更新が必要になる場合があります。

送信できない・エラーが出る場合

室谷室谷
「cursor agent」を実行してもレスポンスが返ってこない、またはエラーが出る場合の主な原因を整理しておきましょう。
  • 認証切れ: cursor agent loginで再認証する
  • プランの利用制限: 無料プランの上限に達している。Proプランにアップグレードする
  • ネットワーク問題: Cursorのサーバーに接続できない。プロキシ設定を確認する
  • バージョンの問題: cursor --versionで古いバージョンでないか確認。最新版にアップデートする
テキトー教師テキトー教師
大抵のエラーは「再認証」か「プランのアップグレード」で片付きます。

まとめ

室谷室谷
今回はCursor CLIについて一通りカバーしました。改めてポイントを整理しましょう。
テキトー教師テキトー教師
Cursor CLIのメリットをまとめるとこうなりますね。
  • ターミナルからCursor Agentのフル機能が使える — エディタを開かずにAIエージェントと対話できる
  • 22種類以上のモデルを選択可能 — Claude、GPT、Gemini、Grokを1つのツールから使い分け
  • Autoモードで最適なモデルを自動選択 — モデル選びに悩む必要がない
  • MCP連携でIDE設定を共有 — Cursor IDEで設定したMCPサーバーがそのまま使える
  • ヘッドレスモードでCI/CD統合--printオプションで自動化パイプラインに組み込み可能
  • 他のIDEと併用可能 — Neovim、JetBrains、Emacsユーザーもエージェント機能を活用できる
  • 追加料金なし — Cursorのサブスクリプションに含まれる
室谷室谷
一方で注意点もあります。セキュリティ保護機能はまだ発展途上であること、Hobbyプランだと利用制限がきついこと、そしてベータ版として発展中の機能もあることです。
テキトー教師テキトー教師
「Cursorをすでに使っている人がCLIを追加で活用する」というのが最もスムーズな導入パターンですね。逆に「CLI目当てで初めてCursorに入る」場合は、Claude Codeとの比較もした上で判断した方がいいです。
室谷室谷
AIコーディングツールは日々進化しているので、「1つに絞る」よりも「複数を使い分ける」方が結果的に生産性が上がります。Cursor CLIはそのツールボックスの中の強力な選択肢の1つですね。
テキトー教師テキトー教師
詳しい使い方はで最新情報を確認してみてください。

出典

.AI TIMES一覧に戻る