xAI 文档
首页/Grok Build/终端支持

终端支持

Grok 使用终端转义序列绘制颜色、剪贴板、鼠标和全屏控制的界面。不同的终端、多路复用器和 SSH 会话处理方式不同。在 Grok 中运行 /terminal-setup（别名 /terminal-check、/terminal-info）查看检测到的内容、激活的剪贴板路由以及任何问题和修复。

颜色显示不正确

在 shell 配置文件中设置 COLORTERM=truecolor。在 tmux 中，还需启用 24-bit RGB：

# ~/.tmux.conf
set -g default-terminal "tmux-256color"
set -as terminal-features ",*:RGB"
set -g set-clipboard on
set -g allow-passthrough on

最后两行还修复了剪贴板和通知穿透；用 tmux source-file ~/.tmux.conf 重新加载。

复制无法到达剪贴板

Grok 写入原生 OS 剪贴板、tmux 内的 tmux 粘贴缓冲区，并为远程场景（SSH、容器、Linux）发出 OSC 52。两个常见阻碍：

  • iTerm2 在启用 Settings → General → Selection → "Applications in terminal may access clipboard" 之前忽略 OSC 52。
  • Apple Terminal 完全忽略 OSC 52，因此 SSH 上的复制无法到达本地剪贴板。改用 grok wrap ssh user@host 在本地 PTY 中运行，拦截 OSC 52 并写入剪贴板。同样适用于 grok wrap docker exec ... 和 grok wrap kubectl exec ...。grok wrap 是实验性功能。

键盘组合键不工作

  • WezTerm：在 wezterm.lua 中添加 config.enable_kitty_keyboard = true，然后重启 — 修复 Ctrl+Enter（插话）和 Shift+Enter（换行）。
  • VS Code、Cursor、Windsurf 和 Zed 终端无法区分 Shift+Enter 和 Enter；使用 Alt+Enter 换行。VS Code over SSH 同样适用。
  • Zellij拦截许多 Ctrl 组合键。在 Zellij 0.41+ 上，切换到 "Unlock-First (non-colliding)" 预设（Ctrl+O → c → Change Mode Behavior），然后需要时 Ctrl+G 临时解锁 Zellij。
  • Apple Terminal：Ctrl+O 插话（缺少 Ctrl+Enter 的 Kitty 键盘协议）。

无全屏或鼠标滚动停止

Grok 在 Zellij 和 tmux 控制模式（tmux -CC）下有意内联运行；通过 ~/.grok/pager.toml 中 [terminal] 下的 alt_screen = "always" 强制全屏，或通过 --no-alt-screen 在任何地方禁用。

如果终端原生滚动条接管，鼠标报告关闭：Apple Terminal 在 View → Allow Mouse Reporting（Cmd+R）下重新启用；iTerm2 在 Settings → Profiles → Terminal → "Enable mouse reporting" 下。

仍然有问题？运行 /feedback。