AIツール活用

Cursor CLIとは?使い方・料金とClaude Codeとの違いを解説

中島大介(なかじ)読了時間 約27分
Cursor CLIのアイキャッチ

Cursorのエディタは使っているものの、ターミナルから動かせるCursor CLIが出たと聞いて、何が変わるのか気になっていないでしょうか。Claude CodeやCodex CLIとの違いが分からず、いまの環境に追加する意味があるのか判断しにくいはずです。

本記事では、Cursorの公式ドキュメントに沿って、Cursor CLIの概要・インストールとログイン・基本的な使い方を解説します。スラッシュコマンド・非対話モードでの自動化・便利な機能・料金と、Claude CodeやCodex CLIとの違いも取り上げます。

この記事を読めば、Cursor CLIを自分の環境に入れて、最初の作業まで進められます。結論は、まず変更を加えないAskモードで、手元のプロジェクトを説明させるところから始めるのがおすすめです。Cursorをすでに契約している人なら、追加の準備なしで試せます。

目次

Cursor CLIとはターミナルでCursorのAIエージェントを使う機能

Cursor CLIは、Cursorのエディタと同じAIエージェントをターミナルで動かす道具です。エディタと共通する設定や起動のコマンドを先に知っておくと、いまの環境にどう組み込むかを決めやすくなります。

Cursor CLIの特徴は、以下の4つです。

  • ターミナルからAIエージェントと対話してコードを作成・変更できる
  • agentのコマンドで起動する
  • エディタと同じモデル・ルール・MCPの設定を使える
  • スクリプトやCIから対話なしで実行できる

ターミナルからAIエージェントと対話してコードを作成・変更できる

Cursor CLIは、ターミナルから直接AIエージェントと対話して、コードの作成・確認・変更を行える機能です。CLIはCommand Line Interfaceの略で、文字で命令を入力して操作する方式を指します。

Cursorの公式ブログによると、Cursor CLIはエディタの中で使えていたCursor Agentを、Web・スマートフォン・Slackに続いてCLIでも使えるようにしたものです。Cursor CLIのエージェントは、ファイルの操作・検索・シェルコマンドの実行・Webへのアクセスに使える道具を持っています。

agentのコマンドで起動する

Cursor CLIを起動するコマンドは「agent」です。ターミナルでagentと入力すると、対話型のセッションが始まります。

ベータ版のころの解説記事には、cursor-agentのコマンド名で紹介しているものがあります。現在のCursorの公式ドキュメントはすべてagentで説明しているため、古い記事の手順を試すときはcursor-agentをagentに読み替えてください。

エディタと同じモデル・ルール・MCPの設定を使える

Cursor CLIでは、/modelでモデルを切り替えられます。Cursorの公式サイトには、Anthropic・OpenAI・Gemini・Cursorなどのモデルをすぐに利用できると書かれています。

Cursor CLIは、ルールとMCPもエディタと同じ設定をそのまま使います。公式ドキュメントによると、Cursor CLIは.cursor/rulesのルールに加えて、プロジェクトのルートにあるAGENTS.mdとCLAUDE.mdも読み込んでルールとして適用します。

MCPサーバーとは?仕組みと安全な選び方・代表例を徹底解説!

スクリプトやCIから対話なしで実行できる

Cursor CLIには、人が対話しない非対話モードがあります。非対話モードをスクリプトやCIのパイプラインに組み込めば、コードのレビューやドキュメントの更新を自動で実行できます。

CIは、コードを変更するたびにテストなどを自動で走らせる仕組みです。公式ドキュメントには、GitHub ActionsでCursor CLIを使うための設定例も載っています。

Cursor CLIのインストールとログインの手順

Cursor CLIのインストールに使うコマンドは、MacやLinuxとWindowsで違います。自分のOSのコマンドを実行したら、動作の確認とCursorのアカウントへのログインまで済ませておきましょう。

Cursor CLIを使い始めるまでの流れは、以下の4ステップです。

  1. MacとLinuxはcurlの1行でインストールする
  2. WindowsはPowerShellでインストールする
  3. agent --versionで確認してPATHを設定する
  4. agent loginでCursorのアカウントにログインする

MacとLinuxはcurlの1行でインストールする

macOS・Linux・Windows上のWSLでは、ターミナルで次のコマンドを実行します。

curl https://cursor.com/install -fsS | bash

インストールが終わると「Installation Complete!」と表示されます。

Macのターミナルでインストールしたところ。PATHの設定が済んでいない場合は、続けて設定のしかた(Next Steps)が表示される

公式ドキュメントによると、Cursor CLIは既定で自動更新を試みます。手動で最新版にしたいときは、agent updateを実行してください。

「agent update」を実行したところ。最新版なら「Already up to date」と表示される

WindowsはPowerShellでインストールする

Windowsでは、PowerShellで次のコマンドを実行します。

irm 'https://cursor.com/install?win32=true' | iex

Cursor CLIは、WSLを使わないネイティブのWindowsにも対応しています。普段からWSLで開発している場合は、WSLのターミナルでcurlのコマンドを使う形です。

agent --versionで確認してPATHを設定する

インストールが終わったら、agent --versionを実行して動作を確かめます。コマンドが見つからない場合は、~/.local/binをPATHに追加してください。

バージョンが表示されれば、Cursor CLIは使える状態になっている

PATHは、コマンドを探す場所をOSに教える設定です。公式ドキュメントには、bashとzshそれぞれの設定方法が載っています。

Macの標準のzshでは、設定ファイル(~/.zshrc)にPATHの行を書き足してから「source ~/.zshrc」で読み込み直します。

「command not found」と表示されたときは、~/.zshrcに「export PATH="$HOME/.local/bin:$PATH"」を書き足して読み込み直す

agent loginでCursorのアカウントにログインする

Cursor CLIの認証の方法は、ブラウザでのログインとAPIキーの2つです。普段の利用では、agent loginを実行してブラウザでCursorのアカウントにログインする方法が推奨されています。

Cursor CLIの認証に使うコマンドは、以下のとおりです。

  • agent login:ブラウザでCursorのアカウントにログインする
  • agent status:ログインの状態を確認する
  • agent logout:保存された認証情報を削除する

スクリプトやCIでは、CursorのダッシュボードでAPIキーを作り、環境変数CURSOR_API_KEYに設定するのが基本です。

Cursor CLIの基本的な使い方

Cursor CLIは、作業したいプロジェクトのフォルダで起動し、入力欄に指示を書いて作業を進めます。モードの切り替えやコマンドの承認を先に覚えておくと、エージェントが何をするかを確かめながら作業できます。

Cursor CLIの対話型のセッションでの基本操作は、以下の5つです。

  • プロジェクトのフォルダでagentを起動する
  • Agent・Plan・Askの3つのモードを使い分ける
  • @でファイルを指定して/summarizeで会話を整理する
  • コマンドの実行はyとnで承認する
  • agent resumeで前回の会話を再開する

プロジェクトのフォルダでagentを起動する

作業したいプロジェクトのフォルダへ移動して、agentと入力します。agentの後に最初の指示を付けて起動することも可能です。

agent "認証の処理をJWTを使う形に書き換えて"

Cursor CLIのエージェントは、目標を伝えると変更を提案し、必要なコマンドの承認を求めてきます。公式ドキュメントは、最良の結果を得るために意図を明確に伝えることを勧めています。

Agent・Plan・Askの3つのモードを使い分ける

Cursor CLIには、エディタと同じ3つのモードがあります。各モードでできることと切り替え方は、以下の表のとおりです。

モードできること切り替え方
Agentすべての道具を使って作業する(既定)指定なし
Planコードを書く前に質問しながら進め方を設計するShift+Tab・/plan・--plan
Ask変更を加えずにコードを調べて答える/ask・--mode=ask

初めて触るプロジェクトでは、Askモードで構成を説明させると安全です。大きな変更を頼む前は、Planモードで方針を固めてから実装に進みます。

@でファイルを指定して/summarizeで会話を整理する

入力欄で@を使うと、エージェントに読ませるファイルやフォルダを選べます。関係するファイルを明示すると、的外れな変更を減らせます。

会話が長くなったときに使うのは、会話を要約して文脈の空きを作る/summarizeです。まったく別の作業に移るときは、/clearで新しいセッションを始めてください。

コマンドの実行はyとnで承認する

Cursor CLIの対話型のセッションでは、ターミナルのコマンドを実行する前に、承認(y)か拒否(n)を求められます。エージェントが何を実行しようとしているかを確かめてから承認できます。

ファイルの変更を確認するショートカットは、Ctrl+Rです。確認の画面でiを押すと、追加の指示を送れます。

agent resumeで前回の会話を再開する

Cursor CLIでは、以前の会話をあとから再開できます。会話の再開に使うコマンドとオプションは、以下のとおりです。

  • agent resume:最新の会話を再開する
  • agent ls:過去の会話の一覧から選ぶ
  • --continue:前のセッションを続行する
  • --resume:会話のIDを指定して再開する

--continueと--resumeは、agentの起動時に使えるオプションです。

Cursor CLIでよく使うスラッシュコマンドとショートカット

Cursor CLIでは、対話中に「/」で始まるスラッシュコマンドを入力すると、モデルやモードの切り替えなどをすぐに行えます。改行や終了のショートカットも覚えておくと、対話中の操作で迷わなくなります。

Cursor CLIの対話中によく使うスラッシュコマンドは、以下の表のとおりです。

コマンドできること
/modelモデルを選ぶ
/planPlanモードに切り替える
/askAskモードに切り替える
/clear新しいチャットを始める
/resume最近のチャットを開いて再開する
/summarize会話を要約して文脈を減らす
/rewind前のメッセージに戻る
/updateCursor Agentを最新版に更新する

Cursor CLIで覚えておくと便利な操作は、以下の3つです。

  • /modelで作業に合うモデルに切り替える
  • 改行はShift+EnterかCtrl+Jを使う
  • 終了はCtrl+Dを2回押す

/modelで作業に合うモデルに切り替える

/modelを実行すると、使えるモデルの一覧から選べます。起動時に--modelでモデルを指定することも可能です。

使えるモデルは、--list-modelsのオプションでも確認できます。複数の会社のモデルを1つのCLIで切り替えられる点は、Cursor CLIの特徴です。

改行はShift+EnterかCtrl+Jを使う

入力欄でEnterを押すと送信されるため、複数行の指示を書くときは改行の操作が必要です。Shift+Enterは、iTerm2・Ghostty・Kitty・Warp・Zedで使えます。

Ctrl+Jは、すべてのターミナルで使える改行の方法です。tmuxを使っている場合は、Ctrl+Jを使うよう公式ドキュメントに書かれています。

終了はCtrl+Dを2回押す

Cursor CLIを終了するには、Ctrl+Dを2回押します。

Cursor CLIで終了のほかに覚えておくと便利なショートカットは、以下のとおりです。

  • 上矢印キー:以前に送ったメッセージを順に呼び出す
  • Shift+Tab:Agent・Plan・Askのモードを順に切り替える

Cursor CLIの非対話モードで作業を自動化する方法

Cursor CLIの非対話モードを使うと、人が対話しなくてもエージェントに指示を実行させられます。ファイルを書き換える条件や出力の形式を先に押さえておくと、スクリプトやCIに組み込むときに意図しない変更を防げます。

Cursor CLIの非対話モードの使い方は、以下の4つです。

  • agent -pで指示を実行して結果を出力する
  • ファイルを変更するには--forceを付ける
  • --output-formatで出力の形式を選ぶ
  • GitHub Actionsでは権限を絞って使う

agent -pで指示を実行して結果を出力する

agentに-p(--print)を付けると、エージェントを対話なしで呼び出し、結果をコンソールに出力します。-pは、スクリプトやCIのパイプラインに組み込むためのオプションです。

agent -p "このコードベースが何をするものか説明して"

プロンプトにファイルのパスを含めれば、エージェントが指定されたファイルを読み取ります。画像のパスを書いて、画面のスクリーンショットを分析させることも可能です。

ファイルを変更するには--forceを付ける

Cursorの公式ドキュメントによると、非対話モードで--forceを付けない場合、変更は提案されるだけでファイルには適用されません。実際にファイルを書き換えさせるには、-pと--forceを組み合わせます。

--forceを付けると、確認なしでエージェントがファイルを直接変更します。最初は--forceなしで結果を確かめ、問題がないと分かってから付けるのが安全です。

--output-formatで出力の形式を選ぶ

--output-formatには、text・json・stream-jsonを指定できます。各形式で出力される内容は、以下のとおりです。

  • text:最終的な回答だけを出力する(既定)
  • json:スクリプトで読み取りやすい構造化された出力を返す
  • stream-json:処理の進み具合をメッセージ単位で受け取れる

長い処理の途中経過を画面に表示したい場合は、stream-jsonが向いています。

GitHub Actionsでは権限を絞って使う

GitHub ActionsでCursor CLIを動かすときに、ワークフローへ書く手順は以下のとおりです。

  1. Cursor CLIをインストールする
  2. APIキーを環境変数で渡してCursor CLIを実行する

APIキーはGitHubのシークレットに保存してください。

公式ドキュメントは、本番のCIでは権限の設定と組み合わせて、エージェントの操作を制限する方法を勧めています。ブランチの作成やプッシュなどの重要な操作は、エージェントではなくワークフローの別のステップで行う形です。

Cursor CLIの権限の設定では、.cursor/cli.jsonなどのファイルで、許可するコマンドやファイルの範囲を指定できます。

Cursor CLIの便利な機能

Cursor CLIには、作業をクラウドに引き継いだり、外部のツールとつないだりする機能もあります。使い方を知っておくと、手元の作業を止めずに、決めた範囲の中でエージェントに作業を任せられます。

Cursor CLIで知っておくと作業の幅が広がる機能は、以下の4つです。

  • &を付けてCloud Agentに作業を引き継ぐ
  • --worktreeで作業用の別フォルダを作って並行で進める
  • MCPで外部のツールとつなぐ
  • サンドボックスと権限設定で実行の範囲を制御する

&を付けてCloud Agentに作業を引き継ぐ

メッセージの先頭に&を付けて送ると、会話をクラウドのCloud Agentに引き継げます。Cloud Agentに引き継いだ作業は、席を離れている間もクラウドで処理が続きます。

引き継いだ作業の確認と再開は、Webやスマートフォンでcursor.com/agentsを開いて行う形です。

--worktreeで作業用の別フォルダを作って並行で進める

-wまたは--worktreeを付けて起動すると、いまの作業フォルダを直接編集せず、新しいGit worktreeでエージェントを動かせます。Git worktreeは、同じリポジトリの作業フォルダを別の場所にもう1つ作るGitの機能です。

--worktreeを使えば、手元の作業を止めずに、別の修正をエージェントに任せられます。

git worktreeとは?使い方とAIエージェントを並列で動かす方法

MCPで外部のツールとつなぐ

Cursor CLIは、MCPサーバーに対応しています。MCPの設定はエディタと共通で、設定したサーバーはエディタとCLIのどちらでも使えます。

設定済みのサーバーの一覧を確認するコマンドは、agent mcp listです。

サンドボックスと権限設定で実行の範囲を制御する

Cursor CLIでは、/sandboxまたは--sandboxで、コマンドの実行をサンドボックスの中に限定するかを設定できます。サンドボックスは、コマンドがアクセスできる範囲を制限して動かす仕組みです。

権限の設定では、Shell(git)のようにコマンドを指定したり、Read(.env*)のように読ませたくないファイルを指定したりできます。

管理者権限が必要なコマンドを実行するときは、パスワードの入力欄が表示されます。入力したパスワードは、AIのモデルには渡りません。

Cursor CLIの料金

Cursor CLIを使うときの費用は、契約しているCursorのプランで考えます。自動化で使うと使用量が増えやすいため、プランの内容と使用量の考え方を先に確かめておきましょう。

Cursorの公式料金ページの個人・チーム向けプランは、以下の表のとおりです(2026年10月4日時点)。

プラン月額主な内容
Hobby無料制限付きのエージェントリクエスト
Pro20ドルエージェントの利用上限を拡張・MCP・クラウドエージェント
Teams1人40ドルチームの請求と管理・利用状況の分析・SSO
企業個別見積もり使用量のプール・監査ログ・SCIM

Cursor CLIの料金について押さえたい点は、以下の3つです。

  • CLIだけの料金プランは用意されていない
  • 使った分はプランに含まれる使用量から消費される
  • 自動化で使うときは使用量の増え方に注意する

CLIだけの料金プランは用意されていない

Cursorの料金ページには、CLI専用の料金プランは載っていません。Cursor CLIはCursorのアカウントでログインして使う機能のため、契約しているプランの範囲で利用します。

すでにCursorを契約している人は、追加の契約なしで試せます。

使った分はプランに含まれる使用量から消費される

Cursorの料金ページによると、すべてのプランには一定量のモデルの使用量が含まれています。プランに含まれる量を使い切った後も使い続ける場合は、オンデマンドの使用として後払いで請求されます。

料金ページの案内では、日常的にエージェントを使う人向けがPro+、ヘビーユーザー向けがUltraです。

自動化で使うときは使用量の増え方に注意する

非対話モードをスクリプトやCIに組み込むと、人が操作しなくても使用量が増えていきます。繰り返し実行する処理では、実行の回数と対象のファイルを絞って始めましょう。

チームで使う場合は、管理者のダッシュボードで使用状況を確認できます。

Cursor CLIとClaude Code CLI・Codex CLIの違い

ターミナルで動くAIエージェントには、Cursor CLIのほかにClaude Code CLIやCodex CLIがあります。使えるモデルや無料で使える範囲が違うため、契約しているサービスや作業の内容に合わせて選ぶことが大切です。

Cursor CLI・Claude Code CLI・Codex CLIを各社の公式情報で比べると、以下の表のとおりです。

項目Cursor CLIClaude Code CLICodex CLI
提供元CursorAnthropicOpenAI
起動コマンドagentclaudecodex
使えるモデル複数社のモデルから選ぶClaudeのモデルOpenAIのモデル
無料での利用Hobbyで制限付き不可(Pro以上)公式料金表ではPlus以上が対象
読み込む指示ファイル.cursor/rules・AGENTS.md・CLAUDE.mdCLAUDE.md・AGENTS.mdAGENTS.md

Cursor CLIとClaude Code CLI・Codex CLIの違いと選び方のポイントは、以下の3つです。

  • Cursor CLIは複数社のモデルを切り替えられる
  • Cursorのエディタを使っている人は設定をそのまま生かせる
  • すでに契約しているサービスのCLIから試す

Cursor CLIは複数社のモデルを切り替えられる

Cursor CLIの特徴は、1つのCLIの中でAnthropic・OpenAI・Geminiなどのモデルを選べる点です。作業の内容に合わせて、/modelでモデルを切り替えられます。

Claude Code CLIはClaudeのモデル、Codex CLIはOpenAIのモデルを使います。特定のモデルに決めずに比べながら使いたい人には、Cursor CLIが有力な選択肢です。

Cursorのエディタを使っている人は設定をそのまま生かせる

Cursor CLIは、エディタと同じルール・MCP・モードを使います。エディタで整えた設定を、ターミナルやCIでもそのまま生かせます。

AGENTS.mdやCLAUDE.mdも読み込むため、Claude CodeやCodex向けに書いた指示のファイルがあるプロジェクトでもすぐに使い始められる点が利点です。

Claude CodeとCursorの違いを比較!料金・選び方と併用方法を解説

すでに契約しているサービスのCLIから試す

どのCLIも、基本の使い方は似ています。契約しているサービスごとに最初に試すCLIは、以下のとおりです。

  • Cursorの契約者:Cursor CLI
  • Claudeの契約者:Claude Code CLI
  • ChatGPTの契約者:Codex CLI

契約しているサービスのCLIから試すと、追加の費用をかけずに比べられます。

Claude Code CLIとは?インストールから使い方・コマンドまで解説

Cursor CLIに関するよくある質問

Cursor CLIを試す前によく出る疑問への答えを、Cursorの公式情報に沿ってまとめました。Cursor CLIに関するよくある質問は、以下の4つです。

  • Cursor CLIは無料で使えますか?
  • Cursorのエディタを入れていなくても使えますか?
  • Windowsでも使えますか?
  • cursor-agentとagentはどちらのコマンドを使えばいいですか?

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

無料のHobbyプランには、制限付きのエージェントリクエストが含まれています。本格的に使う場合は、エージェントの利用上限が広がる月20ドルのPro以上が目安です。

CLI専用の料金はなく、使うのは契約しているプランに含まれる使用量です。

Cursorのエディタを入れていなくても使えますか?

Cursor CLIは、エディタとは別に1行のコマンドでインストールできます。Cursorの公式サイトは、普段使っている開発ソフトの中のターミナルでも使えると案内しています。

Cursor CLIの利用には、Cursorのアカウントでのログインか、APIキーの設定が必要です。

Windowsでも使えますか?

使えます。PowerShellでインストール用のコマンドを実行すれば、ネイティブのWindowsに入れられます。WSLを使っている場合のインストールは、macOSやLinuxと同じcurlのコマンドです。

cursor-agentとagentはどちらのコマンドを使えばいいですか?

現在のCursorの公式ドキュメントは、agentコマンドで説明しています。インストール後にagent --versionを実行して、バージョンが表示されることを確かめてください。

古い解説記事の手順でcursor-agentと書かれている箇所は、agentに読み替えて試します。

まとめ

Cursor CLIは、ターミナルからCursorのAIエージェントを使える機能です。起動のコマンドはagentで、エディタと同じモデル・ルール・MCPの設定を使えます。非対話モードを使えば、スクリプトやGitHub Actionsから作業を自動化できます。

Cursor CLI専用の料金はなく、使うのはCursorのプランに含まれる使用量です。すでにCursorを契約している人は、追加の契約なしで試せます。

Cursor CLIを始めるときの流れは、以下のとおりです。

  1. 1行のコマンドでCursor CLIをインストールする
  2. 手元のプロジェクトでAskモードを使い、構成を説明させる
  3. 大きな変更を頼む前に、Planモードで方針を固める

まずは、手元のプロジェクトでAskモードを試してみましょう。

この記事の監修者

中島大介(なかじ)

中島大介(なかじ)

株式会社メリル 代表取締役 / 記事監修

株式会社メリル代表取締役。SEO歴20年以上。最新AIやセキュリティについて発信するYouTube「ウェブ職TV」は登録者15万人以上。著書「ChatGPT & Copilotの教科書」は10万部突破!

プロフィールを見る

関連する記事

Cursorのプラグイン「pstack」の使い方を解説する記事のアイキャッチ
AIツール活用

pstackの使い方|Cursor・Claude Codeへの入れ方と頼み方

pstackを使ってみたい方は必見!この記事では、pstackの入れ方と/poteto-modeでの頼み方を解説します。実は、pstackで最初に覚えるコマンドは2つだけです。記事を読めば、AIに確かめさせながら作業を任せられます。

中島大介(なかじ)監修 / Touch AI編集部25 分で読めます
MetaのAIエージェント「Muse」の使い方を解説する記事のアイキャッチ
AIツール活用

Museの使い方|Meta Museの始め方・初期設定・料金を解説

Museを使い始めたい方は必見!この記事では、Meta Museの始め方・初期設定・料金を解説します。実は、Museとのやり取りをAIの学習に使う設定は最初からオンです。記事を読めば、任せる範囲を決めてから使い始められます。

中島大介(なかじ)監修 / Touch AI編集部26 分で読めます
Claude Codeで複数ファイルを一括置換する方法を解説する記事のアイキャッチ
AIツール活用

複数ファイルの文字列を一括置換するには?Claude Codeで残す語を指定

製品名の変更で複数のファイルを直したい方は必見!この記事では、Claude Codeで複数のファイルの文字を一括置換する手順を解説します。実は、残す語を決めてから置き換えられます。記事を読めば、コピーから元に戻す方法も分かります。

中島大介(なかじ)監修 / Touch AI編集部19 分で読めます

次のステップ

最新動向を学びに変える

話題のAIアップデートを、現役講師が背景と実務への影響まで解きほぐします。Touch AI の最新講座で、変化に追いつくための視点を得てください。

受講できる講座を見る