Appearance
本文介绍在主流终端（iTerm2、VS Code、Ghostty、WezTerm 等）中让 Claude Code 体验最佳的配置方法：Shift+Enter 多行输入、Option 键作为 Meta 键、tmux passthrough、大段文本粘贴优化、桌面通知、暗色/亮色主题切换，以及 Vim 模式开关。正确配置终端环境能显著提升使用流畅度，尤其对多行提示词输入和快捷键的影响最大。
终端优化配置
Claude Code 在正确配置的终端中体验最佳。本文介绍针对各主流终端的优化配置。
主题和外观
Claude 无法控制终端主题，主题由终端应用自身管理。可以通过 /config 命令随时同步 Claude Code 界面主题与终端主题。
还可以配置自定义状态栏，在终端底部显示当前模型、工作目录或 git 分支等上下文信息。
多行输入
多行输入有几种方式可选：
| 方式 | 说明 |
|---|---|
\ + Enter | 快速转义：输入 \ 后按 Enter |
Ctrl+J | 发送换行符，任何终端无需配置都能用 |
Shift+Enter | 在 iTerm2、WezTerm、Ghostty、Kitty 中开箱即用 |
| 键盘快捷键 | 在其他终端中通过 /terminal-setup 配置 |
用 /terminal-setup 配置 Shift+Enter
在 Claude Code 中运行 /terminal-setup 可以为 VS Code、Alacritty、Zed、Warp 等终端自动配置 Shift+Enter 绑定。
配置 Option 作为 Meta 键（macOS）
某些快捷键（Alt+B、Alt+F、Alt+Y、Alt+M、Alt+P）需要将 Option 键配置为 Meta 键：
macOS Terminal.app
- 打开设置 → Profiles → Keyboard
- 勾选 "Use Option as Meta Key"
iTerm2
- 打开设置 → Profiles → Keys
- 在 General 下，将左/右 Option 键设为 "Esc+"
VS Code 终端
在 VS Code 设置中添加：
json
"terminal.integrated.macOptionIsMeta": true桌面通知
Claude 完成工作等待你输入时，会触发通知事件。可以通过终端或通知 Hooks 将其变成桌面通知。
各终端通知支持
| 终端 | 支持方式 |
|---|---|
| Ghostty | 无需配置，原生支持 |
| Kitty | 无需配置，原生支持 |
| iTerm2 | 需要手动配置（见下方） |
| macOS Terminal（默认） | 不支持，使用 Hooks 代替 |
| 其他终端 | 使用通知 Hooks |
iTerm2 通知配置
- 打开 iTerm2 设置 → Profiles → Terminal
- 启用 "Notification Center Alerts"
- 点击 "Filter Alerts"，勾选 "Send escape sequence-generated alerts"
验证通知权限：确认系统设置中已允许 iTerm2 显示通知。
在 tmux 中启用通知
在 tmux 中运行时，通知默认被 tmux 拦截，无法到达外部终端（iTerm2、Kitty 等）。在 tmux 配置中启用 passthrough：
bash
# ~/.tmux.conf
set -g allow-passthrough on没有此设置，tmux 会拦截转义序列，通知将无法到达终端应用。进度条（terminal progress bar）同样需要此配置才能传递。
自定义通知行为（Hooks）
配置通知 Hook 可以实现播放声音、发送消息等自定义行为（与终端通知并行运行）：
json
{
"hooks": {
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"Claude 已完成\" with title \"Claude Code\"'"
}
]
}
]
}
}详见 Hooks 文档。
减少闪烁和内存占用
长时间会话中如果出现闪烁，或者 Claude 工作时终端滚动位置跳到顶部，可以尝试全屏渲染模式。全屏模式使用另一种渲染路径，可以让内存用量保持平稳，同时增加鼠标支持。启用方式：
bash
CLAUDE_CODE_NO_FLICKER=1 claude处理大段输入
处理大量代码或长指令时的建议：
- 避免直接粘贴：Claude Code 可能无法处理非常长的粘贴内容
- 使用文件工作流：将内容写入文件，然后让 Claude 读取
- VS Code 限制：VS Code 集成终端特别容易截断长粘贴内容
推荐做法：
bash
# 将内容保存到文件
cat > /tmp/big-prompt.txt << 'EOF'
（大段内容在这里）
EOF
# 让 Claude 读取
claude "请读取 /tmp/big-prompt.txt 并..."Vim 模式
通过 /vim 命令启用，或在 /config 中配置。
要直接在配置文件中设置，在 ~/.claude.json 中将 editorMode 设为 "vim"。
Vim 模式支持的功能子集：
- 模式切换：
Esc（进入 NORMAL）、i/I、a/A、o/O（进入 INSERT） - 导航：
h/j/k/l、w/e/b、0/$/^、gg/G、f/F/t/T加;/,重复 - 编辑：
x、dw/de/db/dd/D、cw/ce/cb/cc/C、.（重复） - 复制/粘贴：
yy/Y、yw/ye/yb、p/P - 文本对象：
iw/aw、iW/aW、i"/a"、i'/a'、i(/a(、i[/a[、i{/a{ - 缩进：
>>/<< - 行操作：
J（合并行）
完整参考见 交互模式文档。
相关资源
常见问题
Q: Shift+Enter 多行输入在我的终端不起作用，怎么配置？
A: 不同终端配置方式不同。iTerm2 需要在 Profiles → Keys 中把 Shift+Return 映射为发送 \033[13;2u；VS Code 终端需在 settings.json 中启用 terminal.integrated.sendKeybindingsToShell；Ghostty 已内置支持。具体配置见本文各终端章节。
Q: Claude Code 在 tmux 中显示异常，怎么解决？
A: 常见问题是 256 色或 true color 支持未开启。在 ~/.tmux.conf 中添加 set -g default-terminal "screen-256color" 和 set -ga terminal-overrides ",xterm-256color:Tc"，然后重启 tmux。另外确保 tmux passthrough 配置正确。
Q: 桌面通知不工作，是哪里的问题？
A: macOS 需要在"系统偏好设置 → 通知"中允许终端应用的通知权限。Linux 需要安装 libnotify-bin（notify-send 命令）。另外检查 Hooks 配置中的通知脚本路径是否正确。