Cursor CLI チュートリアル — 概要
3 min read
Cursor CLI を使えば、Cursor のAI機能をターミナルから直接呼び出せます。Cursor ウィンドウを開かなくても、コードを書いたり・編集したり・質問したりできます。ターミナルを常用するエンジニアにとって、いつでも呼び出せるアシスタントが増えるようなものです。
なぜ CLI を学ぶのか？
| シナリオ | Cursor ウィンドウ | Cursor CLI |
|---|---|---|
| サーバー上でコードを編集 | SSH + リモート設定や同期が必要 | ターミナルで直接コマンドを実行 |
| スクリプト・CI の自動化 | パイプラインへの統合が難しい | 非インタラクティブモードで一発実行 |
| すでにターミナルで作業中 | IDE に切り替えてまた戻る必要 | 同じウィンドウで AI に質問できる |
| キーボード中心の操作が好き | マウス操作が避けられない | すべてコマンドで完結 |
一言で言えば：CLI は AI をあなたのワークフローに合わせてくれます。あなたが IDE に合わせる必要はありません。
コースマップ
| ファイル | トピック | 所要時間 |
|---|---|---|
| 01-install | インストールと検証 | 5 分 |
| 02-basic-usage | 基本操作：コマンドと会話 | 10 分 |
| 03-modes | 3つのモード：Agent / Plan / Ask | 8 分 |
| 04-non-interactive | 非インタラクティブモードとスクリプト | 8 分 |
| 05-tips | ヒントとよくある質問 | 5 分 |
| 06-cursor-cli-with-worktree | CLI + Worktree で並行開発 | 8 分 |
| 07-unlimit-loop-debug | 無限デバッグループ：テストが通るまで実行 | 10 分 |
前提条件
- Cursor がインストール済み（またはログインできる Cursor アカウント）
- Cursor サブスクリプション（CLI の使用にはサブスクリプションが必要）
- 基本的なターミナル操作ができること
まずは 01-install から CLI をセットアップしましょう。