COURSE 01 · Harness Engineering
Cursor の内部アーキテクチャ
AnysphereのAIコードエディタCursorを、同じ軸で見る。Run Modesによる段階的な自動実行とallowlist、Rulesとオンデマンドの文脈取得、MCP、そしてエディタ統合(Tab・Agent・Composer)という固有の構造。公式ドキュメントの範囲で中立に整理する。
これは詳細編「各ハーネスの中身」のレッスンです。Claude Code・Codexと同じ軸で見るので、並べて比べられます。
このレッスンの見方と、断り書き
Cursorは、AnysphereのAIコードエディタです。ひとつ断っておきます。Claude Code(厚い公式ドキュメント)やCodex(OSS)と違い、Cursorはクローズドな製品で、内部実装は公開されていません。そのためこのレッスンは、公式ドキュメントに書かれた機能と、観察できる設計に限ります。推測で内部を描くことはしません。記述は調査時点(2026年11月)のものです。
同じ5つの軸(ループと権限、コンテキストとセッション、ツールと拡張、実行環境とサンドボックス、固有の構造)で見ます。
1. ループと権限(Run Modes)
Cursorのエージェントもエージェントループで動きます。ツール実行の止め方は、公式の Run Modes で決まります。公式ドキュメントによると、3つあります。
| モード | 挙動 |
|---|---|
| Auto-review | allowlistのものは即実行。ほかのシェルコマンドは可能ならサンドボックスで実行。それ以外は分類器(classifier)のレビューへ |
| Allowlist | allowlistのものだけ承認なしで実行。サンドボックスは任意 |
| Run Everything | すべてのツール呼び出しを自動実行。承認なし、サンドボックスなし |
allowlistは permissions.json で定義し、ターミナルコマンド(前方一致)やMCPツール(server:tool)を指定します。ここで重要な注意が公式に書かれています。allowlistやautoRunはあくまで利便性のためのもので、安全の保証ではない。プロンプトインジェクションなどで突破されうるため、フックなど別の制御と組み合わせる前提です。
2. コンテキストとセッション
Cursorは、Rules でエージェントへの指示を持ちます。公式では4種類です。プロジェクトルール(.cursor/rules の .mdc ファイル、バージョン管理できる)、ユーザールール(環境全体)、チームルール(ダッシュボード管理)、そして AGENTS.md。
文脈は、必要に応じて取りにいく設計です。公式ドキュメントによると、エージェントはgrepと意味検索でコードベースから関連ファイルを引き、プロンプトに同じ単語がなくても該当箇所を見つけます。このためにコードベースを理解するモデルも使われます。
3. ツールと拡張
Cursorは、MCP(Model Context Protocol)で外部のツールやデータ源をつなぎます。MCPツールの自動実行も、ターミナルと同じRun Modesに従います。このほか、Rules、スキル、CLIで使い方を広げられます。
4. 実行環境とサンドボックス
シェルコマンドは、可能な場合にサンドボックスで実行されます。ただし前述のとおり、allowlistは安全境界ではないと公式に明言されています。Run Everythingではサンドボックスはかかりません。実行環境の一般論は実行環境とサンドボックスの基本で扱っています。
5. 固有の構造:エディタ統合
Cursorの個性は、エージェントがエディタの中にいることです。コードを書くその場所に、補完や変更の仕組みが組み込まれています。公式が挙げる主な面は、Tab(学習済みモデルによる補完とジャンプ)、Agent(自律的に作業する)、Composer(対話しながら変更する)、そしてCLIです。
Claude Codeがサブエージェントで中の分業を、Codexが埋め込み性を重心に持つのに対し、Cursorは「開発者が実際に編集するエディタに溶け込む」ことに重心があります。
まとめ:Cursorの重心
Cursorは、エディタ統合(Tab・Agent・Composer)を土台に、Run Modesとallowlistで自動実行を段階的に調整します。allowlistは安全境界ではないと明言され、フック等との併用が前提です。どれが優れているという話ではありません。内部実装が非公開な分、ここで言えるのは公式に文書化された範囲まで、という点も含めてCursorの姿です。
次に読む
同じ軸で、次はDevinの内部を見ます(順次公開)。概観の比較はハーネス比較、複数を束ねる話はMeta-Harnessコースにあります。