Skip to content

宽屏别再一行拖到天边:maxProseWidth 怎么卡散文宽度 ​

超宽显示器或并排两个终端时,Claude Code 的说明文字常会「一行拖到天边」:眼睛要横扫很远才能读完一句。CLI 2.1.282 加了设置项 maxProseWidth:给 Claude 的散文 加行宽上限,表格和代码块仍用满屏宽,读说明更轻松,diff / 表格又不被挤扁。

全屏与鼠标交互见 全屏鼠标能点了;本文只盯「散文宽度」这一条。

它管什么、不管什么 ​

内容行为(公开描述)
Claude 的散文(说明、步骤、闲聊)宽度被 maxProseWidth 卡住
表格仍可占满终端宽度
代码块仍可占满终端宽度

设计意图很明确:可读性给自然语言,保真度给结构化输出。别指望它把整屏 UI(侧栏、状态行、权限弹窗)统一缩到同一列宽——那是另一套布局问题。

什么时候值得开 ​

适合:

  1. 物理屏很宽,或终端窗几乎拉满 4K / 带鱼屏。
  2. 长期盯着「长段解释 + 偶尔一张表 / 一段 diff」——散文变窄后,扫读成本立刻下降。
  3. 演示或录屏时,希望观众不用跟着光标左右甩。

不太需要:

  • 本来就半宽窗、或竖屏分栏。
  • 会话几乎只有短句确认,没有长 prose。

具体默认值与配置入口以你本机 claude 设置界面 / 文档为准;changelog 只保证「有这个设置、且散文与表格/代码分流」。

怎么验证生效 ​

升级到 2.1.282+ 后:

  1. 把终端拉到明显宽于日常阅读宽度。
  2. 让 Claude 输出一段较长说明,再夹一段代码或一张表。
  3. 观察:说明列看起来有上限;代码/表仍能贴到窗口边缘。

若 prose 仍贴边:确认版本号(claude --version)、设置是否写进了当前 profile(用户 / 项目 / 托管策略谁覆盖谁),以及是否在看别的渲染层(例如 IDE 面板自己的换行,而不是 CLI TUI)。

和全屏、鼠标列表的关系 ​

2.1.280 起全屏模式里 /skills 等列表支持更多鼠标操作;2.1.282 还给 /feedback 草稿列表加了全屏滚动条(鼠标悬停列表时出现)。这些是交互面;maxProseWidth 是排版面。可以同时开:列表照样点、说明照样限宽。

同版本还修了非全屏渲染在「内容高度仍高于终端、窗口又变矮」时的错行,以及 diff 重绘时 CJK / emoji 折行留下的脏字符。若你升级是为了「宽屏好看」,建议顺手确认这两类显示毛刺是否也消失。

实践建议 ​

  1. 宽屏主力机:打开 maxProseWidth,先用几天再调数字(若界面允许)。
  2. 窄窗笔记本:保持默认或关掉,少一层「为什么突然换行」。
  3. 团队录屏规范:统一限宽,观众焦点更稳。
  4. 别用它代替「让 Claude 写短一点」——限宽是排版,控篇幅仍靠提示与 简洁输出 一类习惯。

宽屏是生产力,不是惩罚阅读。maxProseWidth 把「好看」和「看清代码」拆开处理,正是日常该有的默认。

Claude-cn.org,专注于 Claude Code 中文教程