Ghostty 终端
简介
Ghostty 是 Anthropic 官方推荐的 Claude Code 终端
Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.
优势:
- 速度飞快,GPU 加速渲染,比 Terminal 和 iTerm 快约 100 倍,Claude 输出再长也不卡
- 原生平台体验,原生平台的 UI 界面,在 mac 上体验极佳
- 丰富的窗口功能,支持多窗口、标签页、分屏,同时开多个 Claude 分屏窗口,效率大大提升
- 零配置可用,上手成本低,易用性强,默认配置可以满足大多数需求
- 纯文本配置文件,方便版本控制和同步,有需求可以让 Claude 直接给你改配置
- AI工具友好:完美支持 Claude、Cursor 等工具,支持 Kitty 图形协议,图片直接在终端显示
配置
配置文件位置:~/Library/Application Support/com.mitchellh.ghostty/config.ghostty
修改后按 Cmd+Shift+, 热重载,部分配置需要完全重启。
配置参考
bash
# ========================================
# 字体
# ========================================
font-family = "JetBrains Mono Nerd Font" # 默认 JetBrains Mono
font-size = 14 # 默认 14
font-thicken = true # 默认 false。Retina 屏幕加粗提升可读性
adjust-cell-height = 8 # 默认 0。增加行间距
theme = Kanagawa Wave # 默认 空。用【ghostty +list-themes】查看所有支持的主题
# 浅色/深色自动切换:theme = light:catppuccin-latte,dark:kanagawa
# ========================================
# 窗口与外观
# ========================================
macos-titlebar-style = transparent # 默认 transparent。全屏时顶部显示标签标题。可选:native transparent tabs hidden
window-padding-x = 10 # 默认 0。窗口内边距
window-padding-y = 8 # 默认 0
window-padding-balance = true # 默认 false。内容自动居中
window-colorspace = display-p3 # 默认 srgb。广色域渲染
background-opacity = 0.95 # 默认 1.0。轻微透明
background-opacity-cells = false # 默认 false。设为 true 可让 Neovim/tmux 等程序的单元格背景色也透明
background-blur = 20 # 默认 0。毛玻璃效果
window-save-state = always # 默认 default。关闭后恢复窗口状态
unfocused-split-opacity = 0.7 # 默认 1.0。未聚焦分屏的不透明度,视觉区分焦点
unfocused-split-fill = # 默认 空。未聚焦分屏的填充色,如 #000000
split-divider-color = #555555 # 默认 空。分屏分割线颜色
# ========================================
# 光标与交互
# ========================================
cursor-style = bar # 默认 block。可选:bar block underline block_hollow
cursor-style-blink = true # 默认 null(自动)。光标闪烁
mouse-hide-while-typing = true # 默认 false。打字时隐藏鼠标
mouse-scroll-multiplier = 2 # 默认 3。每次滚动几行
link-url = true # 默认 true。Cmd+点击打开 URL
macos-option-as-alt = true # Option 键作为 Alt,支持 Alt+F/B 等 bash 快捷键
minimum-contrast = 1.3 # 默认 1.0。强制最低对比度,1.1 避免不可见,1.3 比较平衡
# ========================================
# 剪贴板与安全
# ========================================
copy-on-select = clipboard # 默认 true。true 只复制到选择剪贴板(中键粘贴),clipboard 还可复制到系统剪贴板
clipboard-paste-protection = true # 默认 true。粘贴含换行内容时确认
clipboard-trim-trailing-spaces = true # 默认 true。复制时去除尾部空格
macos-auto-secure-input = true # 默认 true。检测密码输入时自动启用安全输入
confirm-close-surface = false # 默认 true。关闭标签页不弹确认框
scrollback-limit = 10000 # 默认 10000。回滚缓冲区字节数
focus-follows-mouse = true # 默认 false。鼠标移到哪个分屏就自动聚焦
# ========================================
# Shell 集成
# ========================================
shell-integration = detect # 默认:detect
shell-integration-features = cursor, sudo, title # 启用后:Cmd+Up/Down 按命令提示符跳转,标签页标题显示当前命令
window-inherit-working-directory = true # 默认 true。新建分屏/标签页时自动继承当前工作目录
快捷键
常用快捷键
| 快捷键 | 功能 |
|---|---|
Cmd+D |
右侧添加分屏 |
Cmd+Shift+D |
下方添加分屏 |
Cmd+[ / Cmd+] |
切换分屏焦点 |
Cmd+Shift+Enter |
当前分屏最大化/还原 |
Cmd+T |
新建标签页 |
Cmd+W |
关闭标签页 |
Cmd+num |
切换到第 num 个标签 |
Cmd+Shift+, |
热重载配置,有些配置需要重启才生效 |
Cmd+F |
搜索历史输出,包括 claude 内部内容 |
Enter |
搜索模式下,跳到下一个匹配项 |
Shift+Enter |
搜索模式下,跳到上一个匹配项 |
Esc |
搜索模式下,关闭搜索 |
Cmd+K |
清屏,也可以清除 claude 内部内容 |
keybind 语法说明
格式:keybind = 修饰键+按键=动作
注意:
按键和动作之间的=前后不能加空格,否则会报错
- 修饰键:
shift、ctrl、alt(别名opt/option)、super(别名cmd/command) - 可选动作:
ignore--- 忽略按键unbind--- 移除绑定text:\x17--- 发送指定字符,如\x17=Ctrl+Wnew_split:right/new_split:down--- 分屏close_surface--- 关闭当前面板reload_config--- 重载配置toggle_quick_terminal--- 切换 Quake 终端global:ctrl+x=...--- 全局快捷键
- 查看所有动作:
ghostty +list-actions
自定义快捷键示例
bash
# 标签页
keybind = cmd+shift+left=previous_tab # 切换到上一个标签页
keybind = cmd+shift+right=next_tab # 切换到下一个标签页
# 分屏
keybind = cmd+d=new_split:right # 右侧新建垂直分屏
keybind = cmd+shift+d=new_split:down # 下方新建水平分屏
keybind = cmd+alt+left=goto_split:left # 切换焦点到左侧分屏
keybind = cmd+alt+right=goto_split:right # 切换焦点到右侧分屏
keybind = cmd+shift+e=equalize_splits # 均等调整所有分屏大小
keybind = cmd+shift+f=toggle_split_zoom # 当前分屏最大化/还原
# 字体大小
keybind = cmd+equal=increase_font_size:1 # 放大字体
keybind = cmd+minus=decrease_font_size:1 # 缩小字体
keybind = cmd+0=reset_font_size # 重置字体为默认大小
# 行首/行尾
keybind = cmd+left=text:\x01 # Ctrl+A
keybind = cmd+right=text:\x05 # Ctrl+E
# 删除光标前到行首的内容
keybind = cmd+backspace=text:\x15 # Ctrl+U
# 全局快捷键(任何应用中都能呼出 Quake 终端)
keybind = global:ctrl+grave_accent=toggle_quick_terminal # 呼出/收起 Quick Terminal
Quick Terminal
Quick Terminal 是 Ghostty 内置的下拉式终端,按一个全局快捷键,终端会从屏幕边缘滑出,再按一次收起。不需要切换窗口,在任何应用中都能快速执行命令。
绑定全局快捷键(任何应用中按 Ctrl+~ 呼出/收起):
bash
keybind = global:ctrl+grave_accent=toggle_quick_terminal
配置示例:
bash
quick-terminal-position = center # 默认 top。弹出位置:top bottom left right center
quick-terminal-screen = mouse # 默认 main。在鼠标所在屏幕弹出
quick-terminal-autohide = true # 默认 true。失焦自动隐藏
quick-terminal-animation-duration = 0 # 默认 0.15。动画时长(秒)
quick-terminal-size = 0.5 # 默认 0.5。终端高度/宽度,支持小数(0.5)、百分比(50%)、像素(500px)
quick-terminal-space-behavior = move # 默认 move。move=切到终端所在 Space,remain=在当前 Space 弹出
我的配置
bash
# 启动默认目录
working-directory = /Users/bqt/project/idea/qtNotes
# 选中文字会同时复制到系统剪贴板
copy-on-select = clipboard
# Option 键作为 Alt,支持 Alt+F/B 等 bash 快捷键
macos-option-as-alt = true
# 呼出/收起 Quick Terminal
keybind = global:cmd+grave_accent=toggle_quick_terminal
# 弹出位置,默认 top,可选 top bottom left right center
quick-terminal-position = center
# 动画时长,默认 0.15 秒
quick-terminal-animation-duration = 0
# 删除前一个单词而不是关闭标签页
keybind = cmd+w=text:\x17
# 新建右分屏【Ctrl+Shift+D】
keybind = cmd+shift+d=new_split:right
# 关闭当前分屏【Ctrl+Shift+Alt+D】
keybind = cmd+shift+alt+d=close_surface
# 背景透明度
background-opacity = 0.95
# 重载配置 Ctrl+Shift+,
keybind = cmd+shift+,=reload_config
2026.05.23