以下はよくある問題とその解決策だよ。

ネットワークの問題

まずはネットワーク接続を確認しよう。Cursor Settings > Network に移動して Run Diagnostics をクリック。Cursor のサーバーへの接続をテストして、AI 機能、アップデート、その他のオンライン機能に影響してるネットワーク起因の問題を特定できる。 Cursor はストリーミング応答を効率よく扱えるため、AI 機能に HTTP/2 を使ってる。ネットワークが HTTP/2 をサポートしていない場合、インデックス失敗や AI 機能の不具合が起きることがある。 これは企業ネットワーク、VPN、Zscaler のようなプロキシを使ってると起きやすい。 解決するには、アプリ設定(Cursor の設定ではない)で HTTP/1.1 フォールバックを有効化しよう。CMD/CTRL + , を押して HTTP/2 を検索し、Disable HTTP/2 を有効にする。これで HTTP/1.1 の使用を強制して問題を回避できる。 自動検出と自動フォールバックは今後追加予定。

リソースの問題(CPU、RAM など)

CPU や RAM の使用率が高いと、マシンが重くなったりリソース警告が出たりする。 大規模なコードベースではリソースを多く使うけど、高負荷の原因はたいてい拡張機能や設定まわりだよ。
MacOS で低 RAM 警告が出る場合、一部ユーザーで大きく誤った値が表示されるバグがあるので注意してね。もし表示されていたら、アクティビティモニタを開いて「メモリ」タブで正しい使用量を確認しよう。
CPU や RAM の使用率が高い場合は、次を試してみて:
拡張機能はパフォーマンスに影響する。Extension Monitor では、インストール済みおよび組み込みのすべての拡張機能のリソース消費を確認できる。Settings > Application > Experimental から Extension Monitor を有効化し、Extension Monitor: Enabled をオンにしよう。この操作のあと Cursor の再起動を求められるよ。開く: Cmd/Ctrl + Shift + PDeveloper: Open Extension MonitorCursor は拡張機能を 1 つ以上の extension host で実行する。通常は多くの拡張機能が同じ extension host 上で動くため、ある拡張が大量の CPU 時間を消費すると、隣の拡張機能の首を絞めてしまうことがある!Extension Monitor では次を確認できる:
  • 拡張機能が起動した長寿命プロセスの一覧(MacOS と Linux のみ)
  • % Ext Host: その拡張機能が消費した extension host 全体時間の割合。他と比べてどの拡張が時間を多く使っているかの特定に役立つ。
  • Max Blocking: 監視間隔ごとに計測される、その拡張機能の最長連続ブロック時間。
  • % CPU:
    • 拡張機能: 拡張機能のコードに起因する CPU 使用率の割合。
    • プロセス: 起動されたプロセスに起因する CPU 使用率の割合(MacOS と Linux のみ)。
  • Memory:
    • 拡張機能: 拡張機能のコードが使用している JS ヒープメモリ量(外部割り当ては含まない)。
    • プロセス: 起動されたプロセスが使用しているシステムメモリ量(MacOS と Linux のみ)。
コマンドラインで cursor --disable-extensions を実行してテストしてみよう。パフォーマンスが改善するなら、拡張機能を一つずつ再有効化して問題のあるものを特定してね。Extension Bisect を試して問題のある拡張機能を特定しよう。詳しくはこちら。注意: 段階的な性能劣化より、即時に発生する問題の切り分けに向いているよ。
Process Explorer はリソースを消費しているプロセスを可視化する。開く: Command Palette(Cmd/Ctrl + Shift + P)→ Developer: Open Process Explorer次のプロセスをチェック:
  • extensionHost: 拡張機能関連の問題
  • ptyHost: ターミナルのリソース消費
Process Explorer には各ターミナルと、その診断用の実行中コマンドが表示される。その他の高負荷プロセスについては、forum に報告してね。
OS の監視ツールを使って、問題が Cursor 特有かシステム全体かを見極めよう。
問題が続く場合は、最小構成の Cursor インストールで試してみよう。

よくある質問

アップデートは段階的にロールアウトされるため、ランダムに選ばれたユーザーから順に配信される。数日以内に反映されるはず。
コマンドパレット Ctrl/⌘ + Shift + P から Sign Out of GitHub を実行。
GitHub Codespacesはまだ非対応。
MacやWindowsマシンへのSSHは非対応。その他の問題はログを添えてフォーラムに報告してね。
“SSH is only supported in Microsoft versions of VS Code” と表示される場合:
  1. Remote-SSHをアンインストール:
    • 拡張機能ビューを開く (Ctrl + Shift + X)
    • “Remote-SSH” を検索
    • 歯車アイコン → “Uninstall”
  2. Anysphere Remote SSHをインストール:
    • Cursor marketplaceを開く
    • “SSH” を検索
    • Anysphere Remote SSH拡張機能をインストール
  3. インストール後:
    • アクティブなSSH接続のあるVS Codeインスタンスをすべて閉じる
    • Cursorを再起動
    • SSHで再接続
SSHの設定や鍵が正しく構成されているかも確認してね。
Cursor TabとInline Editは低レイテンシと低リソース消費のためHTTP/2を使用している。一部の企業プロキシ(例: Zscaler)はHTTP/2をブロックすることがある。設定で "cursor.general.disableHttp2": true を有効化して回避(Cmd/Ctrl + , で設定を開き、http2 を検索)。
Cursor Settingsから一度サインアウトし、再度サインインしてね。
Pro購読者: DashboardManage Subscription で更新日を確認。無料ユーザー: 最初に受け取ったCursorのメール日付を確認。その日付を起点に毎月リセットされる。
空きディスク容量が不足していると、アップデート時に履歴データがクリアされることがある。防ぐには:
  1. アップデート前に十分な空きディスク容量を確保する
  2. 不要なシステムファイルを定期的にクリーンアップする
  3. アップデート前に重要な会話をバックアップする
このガイドに従って作業し、“VS Code” または “Code” を “Cursor” に、“.vscode” を “.cursor” に読み替える。
DashboardDelete Account をクリック。アカウントと関連データは完全に削除される。
ターミナルで cursor を実行。コマンドが見つからない場合:
  1. コマンドパレットを開く ⌘⇧P
  2. install command と入力
  3. Install 'cursor' command を選択(必要に応じてVS Codeを上書きするため code コマンドもインストール)
サインインをクリックするとcursor.comにリダイレクトされるのにサインインできない場合、ファイアウォールやウイルス対策ソフトを一時的に無効化してみてね。サインイン処理がブロックされている可能性がある。
直近の不正利用増加に伴い、セキュリティ対策としてリクエストがブロックされた可能性がある。解決手順:まずVPNを確認。使っている場合は一度オフにしてみてね。VPNがセキュリティシステムをトリガーすることがある。それでも解決しない場合は次を試してみて:
  • 新しいチャットを作成
  • 少し時間をおいて再試行
  • GoogleまたはGitHub認証で新しいアカウントを作成
  • Cursor Proにアップグレード