/scroll-speed
交互式调整鼠标滚轮的滚动速度。
/scroll-speed 用来交互式地调整鼠标滚轮的滚动速度。这个命令只在全屏渲染模式下可用——这是一种可选的、实验性的显示模式,需要先通过 /tui fullscreen 开启——而且在这种模式下,JetBrains IDE 终端中并不可用。 对话框会显示一把标尺,你可以在窗口打开的状态下滚动它,立即感受到变化。用 ←/→ 可以整数档调整速度,最高到 10;在支持更精细控制的终端上,还可以从 0.25 开始以四分之一为单位微调。按 r 会重置为自动检测到的默认值,按 Enter 保存。保存的值对应环境变量 CLAUDE_CODE_SCROLL_SPEED,并会永久写入 ~/.claude/settings.json;高于 10 的数值只能通过该环境变量设置。无论基础速度如何,Claude Code 都会自动对快速滚动进行加速——可以在设置中通过 wheelScrollAccelerationEnabled: false 关闭这一行为。
✅ 什么时候用？
永久调整滚动速度
在全屏终端中打开 /scroll-speed,用 ←/→ 调到想要的速度,再按 Enter 保存——该值会写入 ~/.claude/settings.json。
重置为自动检测到的默认值
打开 /scroll-speed 并按 r,纠正设置过高或过低的速度。
⛔ 什么时候不该用？
经典渲染模式或 JetBrains IDE 终端
根据文档,/scroll-speed 只在通过 /tui fullscreen 开启的可选全屏渲染模式下可用,在 JetBrains IDE 终端中则完全不存在。
更好的选择: 先启用 /tui fullscreen;在 JetBrains 终端中则改用 IDE 自带的滚动设置(从 JetBrains 2025.3 起,Claude Code 还会针对已知的滚动相关 Bug 提供自动修复)
终端没有转发鼠标滚轮事件
根据文档,标尺中的实时预览只会响应终端转发给 Claude Code 的鼠标滚轮事件——例如 iTerm2 默认就会通过配置文件设置阻止这一转发。
更好的选择: 在 iTerm2 中依次进入 Settings → Profiles → Terminal,启用 "Enable mouse reporting",然后重新打开 /scroll-speed
来源
- Claude Code 文档（官方） ↗ code.claude.com