Cursor Agent CLI は、Cursor が提供するコマンドライン版の AI エージェントです。MulmoTerminal は、Claude Code や OpenAI Codex CLI と並んで、この Cursor Agent CLI もコックピットから呼び出せます。MulmoTerminal 上で複数のエージェントを横並びに動かし、同じ課題を違う AI に投げて比較したい、といった使い方の中心にいるのが Cursor Agent CLI です。そのため、MulmoTerminal で Cursor を使いたい場合は、まず Cursor Agent CLI を自分のパソコンにインストールし、ログインを済ませておく必要があります。
Cursor には「エディタ版」と「CLI 版」があり、名前が似ているため混乱しがちです。この記事では、ターミナルで動く cursor-agent コマンドだけに絞って、必要なアカウントとログインの流れを、非エンジニアの方向けに解説します。インストールから初回の対話確認までを一通り押さえ、途中でつまずきやすい箇所にも触れていきます。
Cursor のエディタ版と CLI 版の違い
Cursor にはいくつか使い方があります。整理すると次のとおりです。
| 使い方 | 内容 | MulmoTerminal で使う？ |
|---|---|---|
| Cursor デスクトップアプリ（エディタ） | VS Code を拡張したエディタ。コードを開いて AI と対話する | − |
| Cursor Agents Window（Web） | ブラウザから Cursor のエージェントを使う | − |
| Cursor Agent CLI（ターミナル） | cursor-agent コマンドで動く CLI 版 |
○ ← これを使う |
エディタ版と CLI 版は別々のアプリで、インストール方法もログインの状態も別に管理されます。すでに Cursor のエディタを使っている方も、CLI は別途入れる必要があります。逆に、Cursor のエディタを使っていない方でも、CLI 単体で問題なく利用できます。
Cursor Agent CLI では、エディタ版と同じモデル（GPT-5、Claude、Grok など）が使えます。違いは「操作する場所」だけで、エディタの画面ではなく、ターミナル（Windows は PowerShell）で対話します。コマンドラインから直接呼び出せるので、スクリプトや他のツールと組み合わせるのが得意です。MulmoTerminal は複数の CLI エージェントをまとめて動かす仕組みなので、CLI 版を入れておけば他の AI コーディングエージェントと一緒に扱えるようになります。
CLI には「対話モード」と「非対話モード（-p オプション付き）」があり、ちょっとした質問から CI 環境での自動実行まで、同じ cursor-agent コマンドで切り替えて使えます。MulmoTerminal は内部的にこの CLI を呼び出すので、ユーザーが細かいオプションを覚えておく必要はありません。
必要なアカウント（料金）
Cursor Agent CLI を使うには、Cursor のアカウントが必要です。アカウントは cursor.com で作成できます。
| プラン | 内容 |
|---|---|
| Hobby（無料） | Agent リクエストの上限が小さい。試しに触るぶんには十分 |
| Pro（月額 $20、個人向け、おすすめ） | Agent の上限が大きく、各種モデルを快適に使える |
| Teams / Enterprise | チーム・組織向け。管理機能や請求がまとまる |
個人で MulmoTerminal と組み合わせて使うなら、Pro プランに加入しておくのが安心です。無料プランでもログインは通りますが、少し使うとすぐに上限に達して「待ち」が増えがちです。複数のエージェントを並行して動かす MulmoTerminal の使い方では、1 日のうちに Agent リクエストが積み上がるため、Pro の余裕があったほうが快適です。
ログインは、エディタ版と同じ Cursor アカウントがそのまま使えます。すでにエディタ版を使っている方は、新しく登録し直す必要はありません。チームで契約している方は、所属組織のアカウントでログインすれば Teams / Enterprise の枠がそのまま CLI でも利用できます。
インストール
ターミナル（Windows は PowerShell）を開き、OS に合わせて次のコマンドを 1 行実行します。
macOS / Linux / WSL の場合
curl https://cursor.com/install -fsS | bashWindows（PowerShell）の場合
irm 'https://cursor.com/install?win32=true' | iex実行すると ~/.local/bin/ に cursor-agent という実行ファイルが置かれます（短い別名として agent も同時に用意されますが、本記事では分かりやすいように cursor-agent を使います）。
インストール直後は、ターミナルから cursor-agent が見つからないことがあります。その場合は、~/.local/bin を PATH に追加します。macOS / Linux では、使っているシェルに合わせて次のどちらかを実行してください。
# zsh の場合（macOS の標準）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# bash の場合
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrcWindows の場合は、PowerShell を一度閉じて開き直すと PATH が反映されます。
ログイン
インストールが終わったら、ターミナル（Windows は PowerShell）で次を実行します。
cursor-agent login1. ブラウザが自動で開きます — Cursor のログイン画面が表示されるので、登録済みのメールアドレス、Google アカウント、または GitHub アカウントでログインします。
2. 「Authorize」をクリック — CLI からの接続を許可する画面が出たら「Authorize」を押します。すでに Cursor にログイン済みのブラウザでは、この画面が省略されることもあります。
3. ターミナルに戻ると完了メッセージ — 「ログインが完了しました」といった案内が表示されれば OK です。これで cursor-agent が自分のアカウントと紐づきました。
うまくいかないとき
- ブラウザが自動で開かない — ターミナルに URL が表示されるので、それをコピーしてブラウザのアドレスバーに貼り付けて開きます。あらかじめ自動で開かせたくない場合は、
NO_OPEN_BROWSER=1 cursor-agent loginのように環境変数を付けて実行すると、確実に URL が印字されます - ログイン状態を確認したい —
cursor-agent statusで、今どのアカウントでログインしているかが分かります - ログインし直したい —
cursor-agent logoutでログアウトし、もう一度cursor-agent loginを実行します - 「command not found」と出る — PATH への追加が反映されていないことが多いです。ターミナルを一度閉じてから開き直すか、インストール手順の
source ~/.zshrc（または~/.bashrc）をもう一度実行してください - 会社ネットワークでログインできない — プロキシやファイアウォールが Cursor の認証画面をブロックしていることがあります。社外のネットワーク（モバイル回線など）で一度試して、通れば原因はネットワーク側だと切り分けられます
- エラーで進めない — 表示されたメッセージをそのままコピーし、Cursor のサポートや AI チャットに貼り付けて「どうすればいい？」と聞くのが近道です
動作確認
ログイン後、次のコマンドでインストールの状態を確認できます。
cursor-agent --versionバージョン番号が表示されれば、CLI は正しく動いています。続けて、対話モードを開いてみます。
cursor-agent質問を入力して返事が返ってくれば、ログインと接続もきちんと通っています。試しに「こんにちは」「今日の天気を教えて」などの簡単な一言を入れると、応答のテンポや日本語の自然さが確かめられます。終了するときは Ctrl + C を押すか、画面の指示に従って抜けます。
ここまで動けば、Cursor Agent CLI 単体としての準備は完了です。あとは MulmoTerminal からコマンドを呼び出すだけで、他の AI エージェントと並べて使えるようになります。
Cursor Agent CLI は、既定では自動でアップデートされます。手動で最新版に揃えたい場合は次を実行します。
cursor-agent update次のステップ
Cursor Agent CLI が動くようになったら、あとは MulmoTerminal 側で呼び出す設定を行うだけです。MulmoTerminal は、Claude Code・OpenAI Codex CLI・Cursor Agent CLI といった複数の AI コーディングエージェントを 1 つの画面から並列で動かすためのコックピットです。同じ依頼を複数のエージェントに同時に投げて、結果を比べてから採用する、という使い方ができるようになります。設定方法は MulmoTerminal の紹介ページ をご覧ください。
Cursor Agent CLI 単体をもっと深く知りたい方は、公式ドキュメントが充実しています。使えるオプションや、CI 環境で API キーを使う方法、プロジェクトルールの書き方など、込み入ったところは公式を参照するのが確実です。日々のアップデートで新しいモデルやモードが増えていくので、半年に一度は公式ドキュメントの更新履歴に目を通しておくことをおすすめします。