Common Issues

Solutions for common problems and FAQs

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

Networking Issues

まずはネットワーク接続を確認しよう。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 の使用を強制して問題を解消できる。

自動検出とフォールバックは今後追加予定だよ。

Resource Issues (CPU, RAM, etc.)

CPU や RAM の使用率が高いと、マシンが重くなったりリソース警告が出たりする。

大規模なコードベースではリソース消費が増えるけど、高使用率の原因はたいてい拡張機能や設定の問題だよ。

MacOS で低 RAM 警告が出る場合、一部ユーザーで極端に不正確な値が表示されるバグがあるよ。もし表示されていたら、アクティビティモニタを開いて「Memory」タブで正しいメモリ使用量を確認してね。

CPU や RAM の使用率が高いときは、次を試してみて:

Check Your Extensions

拡張機能はパフォーマンスに影響することがある。

Extension Monitor では、インストール済みおよび内蔵の拡張機能が消費するリソースを確認できる。

Settings > Application > Experimental から Extension Monitor を有効にして、Extension Monitor: Enabled をトグル。すると Cursor の再起動を求められる。

開く: Cmd/Ctrl + Shift + P → Developer: Open Extension Monitor。

Cursor は拡張機能を 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 を試して問題のある拡張を特定してね。詳しくはこちら。注意: これは段階的な劣化ではなく、その場で再現する問題に最適だよ。

Use the Process Explorer

Process Explorer は、どのプロセスがリソースを消費しているかを可視化する。

開く: Command Palette (Cmd/Ctrl + Shift + P) → Developer: Open Process Explorer。

次のプロセスを確認してね:

• extensionHost: 拡張機能関連の問題
• ptyHost: ターミナルのリソース消費

Process Explorer は各ターミナルと、その診断に役立つ実行中のコマンドを表示する。

ほかの高負荷プロセスについては、forum に報告してね。

Monitor System Resources

OS の監視ツールを使って、問題が Cursor 特有かシステム全体かを切り分けよう。

Testing a Minimal Installation

それでもダメなら、最小構成の Cursor をクリーンインストールしてテストしよう。

一般的なFAQ

変更履歴にアップデートがあるのにCursorが更新されない

アップデートは段階的にロールアウトしてるよ。ランダムに選ばれたユーザーから先に配信されるから、数日以内に届くはず。

CursorでGitHubログインに問題がある / CursorでGitHubからログアウトするには？

コマンドパレット Ctrl/⌘ + Shift + P で Sign Out of GitHub を実行して。

GitHub Codespacesが使えない

GitHub Codespaces はまだサポートしてないよ。

Remote SSH への接続でエラーが出る

Mac や Windows への SSH はサポートしてないよ。その他の問題は、ログを添えて forum に報告してね。

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 マーケットプレイスを開く
   • “SSH” を検索
   • Anysphere Remote SSH 拡張機能をインストール

3. インストール後:

   • アクティブな SSH 接続がある VS Code のインスタンスをすべて閉じる
   • Cursor を再起動
   • SSH で再接続

SSH の設定と鍵が正しくセットアップされているか確認してね。

社内プロキシ配下で Cursor Tab と Inline Edit が動かない

Cursor Tab と Inline Edit は低遅延・低リソース化のために HTTP/2 を使ってるよ。一部の企業プロキシ（例: Zscaler）が HTTP/2 をブロックすることがある。設定で "cursor.general.disableHttp2": true を指定して回避してね（Cmd/Ctrl + , で設定を開き、http2 を検索）。

今Proに加入したのに、アプリではまだ無料プランのまま

Cursor の設定から一度サインアウトして、再度サインインしてみて。

利用上限はいつリセットされる？

Pro の人: Dashboard の Manage Subscription をクリックすると更新日が確認できるよ。

無料ユーザー: 最初に届いた Cursor のメールの日付を確認して。その日付を起点に毎月リセットされるよ。

アップデート後に Chat/Composer の履歴が消えた

ディスク空き容量が少ないと、アップデート時に履歴データがクリアされることがあるよ。防ぐには:

1. アップデート前に十分な空きディスク容量を確保する
2. 不要なシステムファイルを定期的にクリーンアップする
3. 重要な会話はアップデート前にバックアップしておく

Cursor をアンインストールするには？

このガイド に従ってね。“VS Code” や “Code” は “Cursor” に、“.vscode” は “.cursor” に置き換えて実行して。

アカウントを削除するには？

Dashboard の Delete Account をクリックしてね。アカウントと関連データは完全に削除されるよ。

コマンドラインから Cursor を開くには？

ターミナルで cursor を実行して。コマンドが見つからない場合は:

1. コマンドパレットを開く ⌘⇧P
2. install command と入力
3. Install 'cursor' command を選択（必要なら VS Code を上書きするために code コマンドもインストール）

Cursor にサインインできない

Sign In をクリックすると cursor.com にリダイレクトされるのにサインインできない場合は、ファイアウォールやウイルス対策ソフトを無効化してみて。サインイン処理がブロックされている可能性があるよ。

不審なアクティビティのメッセージ

最近の不正利用増加により、セキュリティ対策としてリクエストがブロックされることがあるよ。解決手順は次のとおり:

まずは VPN を確認して、使っているならオフにしてみて。VPN がセキュリティシステムをトリガーすることがあるよ。

それでもダメなら次を試してみて:

• 新しいチャットを作成
• 少し待ってから再試行
• Google または GitHub 認証で新しいアカウントを作成
• Cursor Pro にアップグレード