Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

上流のxterm.jsバグにより、CursorおよびVS Code 1.92〜1.104でマウスホイールのスクロールが速すぎる問題を修正しました。

原文（英語） ​

Fixed mouse wheel scrolling being too fast in Cursor and VS Code 1.92–1.104 due to an upstream xterm.js bug

概要 ​

VS Code（バージョン1.92から1.104）およびCursorエディタの統合ターミナルでClaude Codeを使用する際、マウスホイールのスクロール速度が異常に速くなる問題がありました。これはxterm.js（VS CodeおよびCursorが使用するターミナルエミュレータライブラリ）の上流バグが原因でした。この修正により、これらのエディタでもマウスホイールのスクロールが適切な速度で動作するようになります。

基本的な使い方 ​

この修正は自動的に適用されます。VS CodeまたはCursorの統合ターミナルでClaude Codeを使用する際のスクロール動作が改善されます。

# VS CodeまたはCursorの統合ターミナルでClaude Codeを起動
# ターミナルを開く: Ctrl+` (バッククォート)
claude

# マウスホイールのスクロールが適切な速度で動作することを確認
# （修正後）

実践例 ​

VS Codeでのスクロール動作確認 ​

# VS Codeの統合ターミナルでClaude Codeを使用する場合

# 1. ターミナルを開く（Ctrl+` または表示 > ターミナル）
# 2. Claude Codeを起動
claude

# 3. 長い出力を生成してスクロールをテスト
> プロジェクトの全ファイルを一覧表示してください

# 修正前: マウスホイールを少し回すだけで大量にスクロールしてしまう
# 修正後: 通常の速度でスクロールする

Cursorでの使用 ​

# Cursorエディタでもスクロール問題が修正されます

# Cursorを開いてターミナルパネルに切り替え
# Claude Codeを起動
claude

# 長い会話履歴やコード出力をスクロールして確認
# 修正後は適切な速度でスクロールできる

影響を受けるVS Codeバージョンの確認 ​

bash
# VS Codeのバージョンを確認
code --version

# 影響を受けるバージョン: 1.92 〜 1.104
# 例: 1.95.0 → 影響あり（修正が適用される）
#     1.105.0 → 上流で修正済みの可能性あり

# VS Codeのバージョンを更新する場合
# Linux
sudo snap refresh code --classic
# または
sudo apt update && sudo apt upgrade code

# macOS
# VS Codeのメニューから: ヘルプ > 更新を確認

スクロール設定のカスタマイズ（VS Code） ​

json
// VS Codeのsettings.jsonでターミナルのスクロール速度を調整
{
  "terminal.integrated.mouseWheelScrollSensitivity": 1,
  "terminal.integrated.fastScrollSensitivity": 5
}

// 設定ファイルの場所
// Windows: %APPDATA%\Code\User\settings.json
// macOS: ~/Library/Application Support/Code/User/settings.json
// Linux: ~/.config/Code/User/settings.json

注意点 ​

  • この問題はVS Code 1.92から1.104のバージョンで発生していました。他のバージョンでは発生しない場合があります。
  • Cursorエディタはvs Codeをベースにしているため、同様の問題が発生していました。
  • VS Code 1.105以降では上流のxterm.jsが修正されている場合がありますが、本修正では下位互換性も保っています。
  • スタンドアロンのターミナルエミュレータ（iTerm2、Windows Terminal、Alacrittyなど）では、この問題は発生しません。

関連情報 ​