Claude Code 运行在终端中,正确的终端配置可以大幅提升使用体验。本文涵盖主题、换行输入、桌面通知、大段输入处理和 Vim 模式的完整配置指南。
主题与外观
Claude Code 本身无法控制终端的配色方案,颜色由终端应用决定。但可以通过 /config 命令调整 Claude Code 界面自身的主题,使其与终端配色协调。
/config # 打开配置菜单
/themepicker # 直接进入主题选择如需在底部显示当前模型、工作目录、Git 分支等信息,可配置自定义 Status Line(独立功能页面)。
换行输入配置
在 Claude Code 中输入多行内容有三种方式:
| 方式 | 说明 |
|---|---|
\ + Enter | 通用方式,任何终端都支持 |
| Shift+Enter | 在 iTerm2、WezTerm、Ghostty、Kitty 原生支持 |
| Option+Enter | macOS 特有,需手动配置 |
自动配置(推荐)
在 Claude Code 内执行:
/terminal-setup自动为以下终端配置 Shift+Enter:
- VS Code 集成终端
- Alacritty
- Zed 终端
- Warp
注意:如果使用 iTerm2、WezTerm、Ghostty 或 Kitty,Shift+Enter 已原生支持,不会显示
/terminal-setup命令。
手动配置 Option+Enter
macOS Terminal.app:
- 打开「系统偏好设置」→「终端」→「描述文件」→「键盘」
- 勾选「将 Option 键用作 Meta 键」
iTerm2:
- 打开「设置」→「描述文件」→「按键」
- 将左/右 Option 键设为「Esc+」
VS Code 集成终端:
- 打开「设置」→ 搜索
terminal.integrated.macOptionIsMeta - 设为
true
桌面通知配置
Claude Code 完成任务并等待输入时,会触发通知事件。可以将其转化为系统桌面通知。
各终端通知支持情况
| 终端 | 通知支持 | 配置方式 |
|---|---|---|
| Kitty | ✅ 原生 | 无需配置 |
| Ghostty | ✅ 原生 | 无需配置 |
| iTerm2 | ⚠️ 需配置 | 见下方步骤 |
| macOS Terminal | ❌ | 使用 Notification Hooks 替代 |
| 其他终端 | ❌ | 使用 Notification Hooks 替代 |
iTerm2 通知配置
- 打开 iTerm2 →「设置」→「描述文件」→「终端」
- 启用「通知中心提醒」
- 点击「过滤提醒」,勾选「发送转义序列生成的提醒」
- 在 macOS 系统设置中确认 iTerm2 已获得通知权限
Notification Hooks(任意终端通用)
不支持原生通知的终端,可通过 Hooks 实现自定义通知逻辑:
{
"hooks": {
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"Claude Code 已完成\" with title \"Claude Code\"'"
}
]
}
]
}
}也可以用 Hooks 播放提示音:
# 在 hooks command 中
afplay /System/Library/Sounds/Glass.aiffHooks 与终端通知并行��行,不是替代关系——两者可以同时生效。
处理大段输入
直接在终端粘贴大量代码或长文本时,Claude Code 可能出现截断或性能问题:
不推荐:直接粘贴超长内容
推荐做法:
- 将内容写入文件
- 告诉 Claude 读取该文件:
echo "长代码内容" > /tmp/input.txt
# 然后在 Claude Code 中:
# 「请读取 /tmp/input.txt 文件并...」VS Code 特别说明:VS Code 集成终端在粘贴长内容时尤其容易截断,强烈建议使用文件方式传递大段内容。
Vim 模式
Claude Code 支持 Vim 键位,可以在不离开终端的情况下高效编辑输入内容。
启用方式
/vim # 临时切换开/关
/config # 在配置菜单中永久设置支持的 Vim 命令
模式切换:
| 按键 | 功能 |
|---|---|
Esc | 进入 NORMAL 模式 |
i / I | 在光标前/行首插入 |
a / A | 在光标后/行尾追加 |
o / O | 在下方/上方新建行插入 |
导航:
| 按键 | 功能 |
|---|---|
h/j/k/l | 左/下/上/右 |
w/e/b | 下个词首/词尾/上个词 |
0/$ | 行首/行尾 |
gg/G | 文件首/文件尾 |
f/F + 字符 | 正向/反向跳转到字符 |
编辑:
| 按键 | 功能 |
|---|---|
x | 删除字符 |
dd / D | 删除整行 / 删到行尾 |
dw/de/db | 删除到词首/词尾/上词 |
cc / C | 修改整行 / 修改到行尾 |
. | 重复上次操作 |
>>/<< | 增加/减少缩进 |
J | 合并下一行 |
复制粘贴:
| 按键 | 功能 |
|---|---|
yy/Y | 复制整行 |
yw/ye/yb | 复制到词首/词尾/上词 |
p/P | 在光标后/前粘贴 |
文本对象(非常实用):
| 按键 | 功能 |
|---|---|
iw/aw | 内部/外部单词 |
i"/a" | 引号内/含引号 |
i(/a( | 括号内/含括号 |
i{/a{ | 大括号内/含大括号 |
完整 Vim 参考见 Interactive Mode 文档。
原文:Optimize your terminal setup - Claude Code Docs | 来源:Anthropic 官方文档