为 Claude Code 配置您的终端

修复 Shift+Enter 以插入新行、在 Claude 完成时获得终端铃声、配置 tmux、匹配颜色主题，以及在 Claude Code CLI 中启用 Vim 模式。

Claude Code 可以在任何终端中工作，无需配置。此页面适用于某些特定功能的行为不符合您预期的情况。在下方找到您的症状。如果一切都已按预期工作，您不需要此页面。

• Shift+Enter 提交而不是插入新行
• macOS 上的 Option 键快捷键无效
• Claude 完成时没有声音或警报
• 您在 tmux 内运行 Claude Code
• Windows 上的退格键删除整个单词
• 显示闪烁或滚动条跳跃
• 您想在提示符中使用 Vim 快捷键

此页面是关于让您的终端向 Claude Code 发送正确的信号。要更改 Claude Code 本身响应的快捷键，请参阅 快捷键 代替。

输入多行提示

按 Enter 键提交您的消息。要添加换行符而不提交，请按 Ctrl+J，或输入 \ 然后按 Enter。两种方法在每个终端中都可以工作，无需任何设置。

在大多数终端中，您也可以按 Shift+Enter，但支持因终端模拟器而异：

对于 VS Code、Cursor、Devin Desktop、Alacritty 0.16 之前版本和 Zed，/terminal-setup 会将 Shift+Enter 快捷键写入终端的配置文件。在第一次运行时，您会看到确认消息，例如 Installed VSCode terminal Shift+Enter key binding。现有绑定保持不变；如果您看到类似 VSCode terminal Shift+Enter key binding already configured 的消息，则未进行任何更改。在主机终端中直接运行 /terminal-setup，而不是在 tmux 或 screen 内运行，因为它需要写入主机终端的配置。

在 VS Code、Cursor 和 Devin Desktop 中，/terminal-setup 还会更新两个编辑器设置：它将 terminal.integrated.gpuAcceleration 设置为 "off" 以防止集成终端中的文本乱码，并设置 terminal.integrated.mouseWheelScrollSensitivity 以在全屏模式中实现更平滑的滚动。要撤销 GPU 加速更改，请将其设置回 "auto" 并重新加载编辑器窗口。

在 Zed 中，/terminal-setup 会就地更新您的 keymap.json：

• 如果 keymap 已有绑定且其中没有 Terminal shift-enter，Claude Code 首先会将其备份到同一目录中的副本，例如 keymap.json.1a2b3c4d.bak，然后将 Shift+Enter 绑定合并到您的 keymap 中，保留您的其他快捷键和注释
• 如果 Claude Code 无法读取或解析 keymap、无法备份或无法验证合并结果，它会保持文件不变并打印快捷键块供您自己添加

如果您在 tmux 内运行，即使外部终端支持，Shift+Enter 也需要下面的 tmux 配置。

要将换行绑定到不同的键，或交换行为使 Enter 插入换行而 Shift+Enter 提交，请在您的快捷键文件中映射 chat:newline 和 chat:submit 操作。

在 macOS 上启用 Option 键快捷键

某些 Claude Code 快捷键使用 Option 键，例如 Option+Enter 用于换行或 Option+P 用于切换模型。在 macOS 上，大多数终端默认不会将 Option 作为修饰符发送，因此这些快捷键在启用之前不会起作用。终端设置通常标记为"Use Option as Meta Key"；Meta 是现在标记为 Option 或 Alt 的键的历史 Unix 名称。

对于 Ghostty、Kitty 和其他终端，请在终端的配置文件中查找 Option-as-Alt 或 Option-as-Meta 设置。

获取终端铃声或通知

当 Claude 完成任务或暂停以等待权限提示，且您似乎离开了终端时，它会触发通知事件。请参阅每种通知类型何时触发以了解确切的时间。将其显示为终端铃声或桌面通知可让您在长任务运行时切换到其他工作。

默认情况下，Claude Code 仅在 Ghostty、Kitty 和 iTerm2 中发送桌面通知。在其他终端中，将 preferredNotifChannel 设置为 "terminal_bell" 以改为响铃终端铃声，或配置通知 hook 以获得自定义声音或命令。以下设置条目打开终端铃声：

{
  "preferredNotifChannel": "terminal_bell"
}

桌面通知通过 SSH 到达您的本地计算机，因此远程会话仍然可以提醒您。Ghostty 和 Kitty 将其转发到您的操作系统通知中心，无需进一步设置。iTerm2 要求您启用转发：

如果通知仍未出现，请确认您的终端应用程序在操作系统设置中具有通知权限，如果您在 tmux 内运行，请启用传递。

使用通知 hook 播放声音

在任何终端中，您可以配置通知 hook 以在 Claude 需要您的注意时播放声音或运行自定义命令。Hook 与内置通知一起运行，而不是替换它，因此不接收桌面通知的终端（如 Warp 或 VS Code 集成终端）可以使用 hook 或将 preferredNotifChannel 设置为 "terminal_bell"。

下面的示例在 macOS 上播放系统声音。链接的指南包含 macOS、Linux 和 Windows 的桌面通知命令。

{
  "hooks": {
    "Notification": [
      {
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      }
    ]
  }
}

配置 tmux

当 Claude Code 在 tmux 中运行时，默认情况下 Shift+Enter 提交而不是插入换行符，桌面通知和进度条永远无法到达外部终端。将这些行添加到 ~/.tmux.conf，然后运行 tmux source-file ~/.tmux.conf 将其应用到运行中的服务器：

set -g allow-passthrough on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

allow-passthrough 行允许通知和进度更新到达外部终端，而不是被 tmux 吞掉。extended-keys 行让 tmux 区分 Shift+Enter 和普通 Enter，这样换行快捷键就能工作。

修复 Windows 上 Backspace 删除整个单词的问题

在 Windows 上，Claude Code 将到达的 Backspace 读取为 ^H，将其解释为 Ctrl+Backspace，这会删除前一个单词，除非 TERM_PROGRAM 是 mintty 或 TERM 是 cygwin。在 macOS 和 Linux 上，Claude Code 将其读取为普通 Backspace。

如果每次按 Backspace 都会删除整个单词，说明你的终端为普通 Backspace 发送了 ^H。设置 CLAUDE_CODE_BS_AS_CTRL_BACKSPACE=0。此时 Backspace 和 Ctrl+H 将各删除一个字符。如果在 macOS 或 Linux 上 Ctrl+Backspace 仅删除一个字符，因为你的终端为它发送了 ^H，则改为将变量设置为 1。

匹配颜色主题

使用 /theme 命令或 /config 中的主题选择器，选择与您的终端相匹配的 Claude Code 主题。选择自动选项可检测您的终端的浅色或深色背景，因此主题会在您的终端跟随操作系统外观更改时进行更改。Claude Code 不控制终端本身的配色方案，该方案由终端应用程序设置。

要自定义界面底部显示的内容，请配置一个自定义状态行，显示当前模型、工作目录、git 分支或其他上下文。

创建自定义主题

除了内置预设外，/theme 还列出您定义的任何自定义主题以及由已安装的插件贡献的任何主题。选择列表末尾的**新建自定义主题…**以交互方式创建一个：您命名主题，然后选择要覆盖的各个颜色令牌。当自定义主题突出显示时，按 Ctrl+E 可编辑它。

每个自定义主题都是 ~/.claude/themes/ 中的一个 JSON 文件。不带 .json 扩展名的文件名是主题的 slug，选择主题会将 custom:<slug> 存储为您的主题偏好设置。该文件有三个可选字段：

颜色值接受 #rrggbb、#rgb、rgb(r,g,b)、ansi256(n) 或 ansi:<name>，其中 <name> 是 16 个标准 ANSI 颜色名称之一，例如 red 或 cyanBright。未知令牌和无效颜色值会被忽略，因此拼写错误不会破坏渲染。

以下示例定义了一个主题，该主题保留深色预设但重新着色提示符强调、错误文本和成功文本：

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555",
    "success": "#50fa7b"
  }
}

Claude Code 监视 ~/.claude/themes/ 并在添加或更改文件时重新加载，因此在编辑器中所做的编辑会应用到正在运行的会话，无需重启。如果 Claude Code 启动时 ~/.claude/themes/ 文件夹本身不存在，请在创建第一个主题文件后重启一次。之后，更改会应用而无需重启。

下面的参考涵盖了您可以在 overrides 中设置的令牌。/theme 中的交互式编辑器显示相同的令牌以及实时预览，加上一些单一用途的强调，例如此处省略的入门屏幕颜色。

{
"name": "Midnight",
"base": "dark",
"overrides": {
"claude": "#a78bfa",
"planMode": "#38bdf8",
"diffAdded": "#14532d",
"diffRemoved": "#7f1d1d",
"userMessageBackground": "#1e1b4b"
}
}

切换到全屏渲染

在屏幕阅读器模式中，本部分不适用。Claude Code 始终呈现为纯滚动文本，除非在附加的后台会话中，如果您在任何其他会话中运行 /tui fullscreen，Claude Code 会打印说明而不是切换。

如果显示闪烁或在 Claude 工作时滚动位置跳跃，请切换到全屏渲染模式。在此模式下，您可以使用鼠标或 PageUp 在 Claude Code 内滚动，而不是使用终端的原生回滚；请参阅全屏页面了解如何搜索和复制。

如果闪烁是唯一的问题，且您的终端支持同步输出但未被自动检测（例如 Emacs eat），请设置 CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 以停止闪烁而不更改渲染器。

运行 /tui fullscreen 以切换并保存偏好设置。您的对话将完整重新启动，未来的会话将以全屏启动，除非全屏启动失败。您也可以在启动 Claude Code 之前设置 CLAUDE_CODE_NO_FLICKER 环境变量：

CLAUDE_CODE_NO_FLICKER=1 claude

$env:CLAUDE_CODE_NO_FLICKER = "1"; claude

{
"env": {
"CLAUDE_CODE_NO_FLICKER": "1"
}
}

粘贴大型内容

当您粘贴超过 800 个字符或超过三行的内容到提示框时，Claude Code 会将输入折叠为占位符，例如 [Pasted text #1 +120 lines]，以保持输入框的可用性。在短于 12 行的终端窗口中，行限制会降低，因此 Claude Code 在 11 行时会折叠三行粘贴，在 10 行或更少行时会折叠任何多行粘贴。Claude Code 在您提交时仍会发送完整内容。

当您使用单词或行快捷键（如 Ctrl+W 或 Ctrl+K）删除，或通过 vim 删除（如 df] 这样的 f/t 动作），且删除范围到达占位符内部时，Claude Code 会完全移除占位符。您可以粘贴删除的内容来恢复它，在单词或行快捷键后使用 Ctrl+Y，或在 vim 删除后使用 p 在 NORMAL 模式下。

Claude Code 将折叠的内容保存在 ~/.claude/paste-cache/ 下，因此当您从命令历史中调用提示并重新提交时，Claude Code 会再次发送完整的粘贴内容，包括在后续会话中，直到保留扫描移除缓存文件。

Claude Code 删除早于 cleanupPeriodDays 的缓存文件，遵循保留扫描规则，因此调用的提示可能引用不再存在的粘贴文本。当您提交这样的提示时，Claude Code 永远不会发送字面上的 [Pasted text #N] 字符串，而是显示一个通知，命名缺失的粘贴：

• 在包含剩余文本的纯提示中，Claude Code 移除占位符并发送剩余文本。
• 在shell 模式命令或 / 命令中，其中移除会改变运行内容，以及在任何移除会留下空白的提示中，Claude Code 取消提交并在输入中保留原始文本，占位符仍在其中。删除占位符或编辑命令，然后重新提交。

VS Code 集成终端可能会在非常大的粘贴到达 Claude Code 之前丢弃字符，因此在那里更倾向于基于文件的工作流。对于非常大的输入（如整个文件或长日志），将内容写入文件并要求 Claude 读取它，而不是粘贴。这样可以保持对话记录的可读性，并让 Claude 在后续轮次中按路径引用文件。

使用 Vim 快捷键编辑提示词

Claude Code 包含用于提示词输入的 Vim 风格编辑模式。通过 /config → Editor mode 启用它，或在 ~/.claude/settings.json 中将 editorMode 设置为 "vim"。将 Editor mode 设置回 normal 以关闭它。

Vim 模式支持 NORMAL 和 VISUAL 模式动作和操作符的子集，例如 hjkl 导航、v/V 选择以及 d/c/y 与文本对象。有关完整的快捷键表，请参阅 Vim 编辑器模式参考。

Vim 动作无法通过快捷键文件重新映射。要将两个按键的 INSERT 模式序列（例如 jj）映射到 Escape，请在用户设置中设置 vimInsertModeRemaps。

在 INSERT 模式下按 Enter 仍会提交您的提示词，这与标准 Vim 不同。在 NORMAL 模式下使用 o 或 O，或使用 Ctrl+J 来插入新行。

相关资源

• 交互模式：完整的键盘快捷键参考和 Vim 快捷键表
• 快捷键：重新映射任何 Claude Code 快捷键，包括 Enter 和 Shift+Enter
• 全屏渲染：全屏模式下滚动、搜索和复制的详细信息
• 钩子指南：Linux 和 Windows 的更多通知钩子示例
• 故障排除：修复终端配置之外的问题