它到底是什么

/focus 是 Claude Code 全屏渲染模式下的一条内置 slash 命令,用于切换焦点视图(focus view)。

启用后,屏幕只保留三样内容:

• 你上一条输入的 prompt
• 每个工具调用的单行摘要,附带文件编辑的 diffstat
• Claude 的最终回复

其余中间过程(流式工具输出、多轮 tool call 展开内容等)全部隐藏。该设置会持久化到下次会话,再次执行 /focus 可关闭。

/focus 仅在**全屏渲染模式(fullscreen rendering)**下可用。全屏渲染需要 Claude Code v2.1.89 或更高版本,/focus 命令本身随 v2.1.110 随全屏 TUI 重构一同引入。

怎么触发 / 怎么使用

1. 开启焦点视图

在会话中直接输入:

/focus

CLI 立即切换到焦点视图,无需确认。

2. 关闭焦点视图

再次执行相同命令即可关闭(toggle 行为):

/focus

3. 确认全屏渲染已启用

/focus 依赖全屏渲染。若尚未启用,先运行:

/tui fullscreen

或在启动 Claude Code 前设置环境变量:

CLAUDE_CODE_NO_FLICKER=1 claude

监控 / 控制 / 键位

/focus 与 Ctrl+O(transcript mode)是两个独立控件。Source 3 暗示 v2.1.110 对相关功能做了分离/澄清,但没有来源明确表述两者此前合并在 Ctrl+O 里,故此处不对「合并」做断言:

官方文档将 /focus 与 Ctrl+O transcript 模式描述为两个独立控件,但未说明二者同时启用时的行为(能否叠加),此处不作断言。

保存 / 配置 / 集成

/focus 的开关状态自动持久化,跨会话保留,无需手动配置。下次启动会话时,上次的焦点视图状态会自动恢复。官方文档仅说明 "The setting persists across sessions",未指定具体存储路径(~/.claude/settings.json 仅在 /scroll-speed 语境下被提及,不应套用到 /focus)。

运行约束 / 限制

跟同类原语对比

经典使用场景

• 长时间并行任务:subagent 或 workflow 运行期间,中间工具输出量极大,用 /focus 只看最终进度而非逐行 tool output。
• 读回会话结果:任务结束后快速浏览最后几轮 prompt-response,不被中间 tool call 展开内容淹没。
• 向他人展示会话:截图或录屏分享时,焦点视图提供更干净的视觉呈现。

常见坑

1. 在 classic 渲染器下执行 /focus 无效:若未启用全屏渲染,命令可能被忽略或报错。先运行 /tui fullscreen 切换渲染器再使用 /focus。
2. 状态持久化导致意外:重新开启 Claude Code 时焦点视图可能已处于开启状态(上次遗留),若发现视图异常"简洁",执行一次 /focus 关闭即可。
3. 误把 Ctrl+O 当作 /focus:Ctrl+O 是 transcript 模式,/focus 是焦点视图,二者职责不同,混用会得到非预期结果(有来源暗示 v2.1.110 对相关功能做过分离/澄清,但此前是否合并于 Ctrl+O 缺乏明确出处)。

关闭 / 退出 / 卸载

由于 /focus 状态持久化,有两种方式关闭:

/focus

再次执行命令即可切换回正常视图。若要完全退出全屏渲染(同时 /focus 也随之失效):

/tui default

或设置环境变量强制使用 classic 渲染器:

CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 claude

来源

• Fullscreen rendering — Claude Code Docs
• /focus: The Claude Code Command That Strips Tool Noise — vibe.cerridan.com
• Claude Code 2.1.110: Fullscreen TUI and Push Notifications — claudecodeexamples.com