命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
交互式调整鼠标滚轮滚动速度
/scroll-speed 是一个交互式命令,用于实时调整鼠标滚轮在会话视区内的滚动速度。它持久化写入 ~/.claude/settings.json,与 CLAUDE_CODE_SCROLL_SPEED 环境变量等价。该命令在全屏渲染(fullscreen rendering)语境下介绍——全屏渲染才会拦截并处理鼠标滚轮事件。
全屏渲染模式要求 Claude Code v2.1.89 或更高版本,通过 /tui fullscreen 开启;也可设置 CLAUDE_CODE_NO_FLICKER=1(官方说明该环境变量仅适用于 v2.1.110 之前的版本,新版请用 /tui fullscreen)。
/scroll-speed在 JetBrains IDE 终端中不可用。
在已启用全屏渲染的会话中,直接输入:
/scroll-speed
界面会弹出一个带刻度尺的对话框。你可以在对话框打开期间直接滚动鼠标轮以实时感受速度变化。
| 键 | 动作 |
|---|---|
← | 降低滚动速度 |
→ | 提高滚动速度 |
r | 重置为自动检测的默认值 |
Enter | 保存并关闭对话框 |
/scroll-speed 将结果写入 ~/.claude/settings.json,键名与环境变量 CLAUDE_CODE_SCROLL_SPEED 对应。两者等价:在对话框保存的值与手动设置环境变量的效果完全相同。
export CLAUDE_CODE_SCROLL_SPEED=3
1–200.5)用于减慢经过终端放大的触控板或滚轮事件3 与 vim 等应用的默认行为接近在 ~/.claude/settings.json 中加入:
{
"wheelScrollAccelerationEnabled": false
}
关闭后,每个滚轮格产生恒定的滚动距离,不再因快速旋转而加速。
| 约束 | 说明 |
|---|---|
| 滚轮拦截依赖全屏渲染 | 经典渲染器把会话留在终端原生 scrollback,鼠标滚轮由终端处理,该速度设置无从介入 |
| JetBrains IDE 终端不可用 | JetBrains 终端使用自有滚动处理,忽略 CLAUDE_CODE_SCROLL_SPEED,同时 /scroll-speed 命令在该环境下不可用 |
| 依赖终端鼠标事件转发 | 终端必须将鼠标事件转发给应用(iTerm2 需在 Settings → Profiles → Terminal 开启 Enable mouse reporting) |
| 方式 | 作用范围 | 持久化 | 实时预览 |
|---|---|---|---|
/scroll-speed | 当前用户全局(~/.claude/settings.json) | 是 | 是 |
CLAUDE_CODE_SCROLL_SPEED=N | 当前进程 / shell 会话 | 取决于 shell 配置 | 否 |
wheelScrollAccelerationEnabled | 全局加速行为开关 | 是(settings.json) | 否 |
/scroll-speed 提高倍率可恢复正常手感。0.5 等小数值减慢。~/.claude/settings.json 后可通过 dotfiles 同步到其他机器。JetBrains 终端中命令不可用:/scroll-speed 在 JetBrains IDE 终端不可用。若要调整 JetBrains 下的滚动体验,需在 IDE 层面或系统层面配置,Claude Code 在该环境中有独立的滚动处理逻辑,不读取 CLAUDE_CODE_SCROLL_SPEED。
鼠标滚轮无响应但键盘滚动正常:说明终端未将鼠标事件转发给 Claude Code。调整 /scroll-speed 不会解决问题——需先在终端侧开启鼠标上报(如 iTerm2 的 Enable mouse reporting,或 tmux 的 set -g mouse on)。
以为是全局 CLI 配置:该命令写入的是用户级 ~/.claude/settings.json,不是项目级 .claude/settings.json。速度设置对当前系统账户下所有 Claude Code 项目生效。