API Console

CLI

Terminal 支持

查看 Markdown
创建 API Key 了解 Grok 4.5

Grok 使用 terminal escape sequences 绘制界面的颜色、clipboard、mouse 和全屏控制；不同 terminal、multiplexer 和 SSH session 对这些功能的处理方式不同。在 Grok 内运行 /terminal-setup（别名 /terminal-check、/terminal-info），查看检测结果、活动 clipboard route 以及问题和修复方法。

颜色显示异常

在 shell profile 中设置 COLORTERM=truecolor。在 tmux 中，还要启用 24-bit RGB：

Text

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

最后两行还会修复 clipboard 和 notification passthrough；使用 tmux source-file ~/.tmux.conf 重新加载。

复制内容没有进入剪贴板

Grok 会写入操作系统原生 clipboard、tmux 内的 tmux paste buffer，并针对 remote 情况（SSH、containers、Linux）发出 OSC 52。两个常见阻碍因素：

  • iTerm2 会忽略 OSC 52，直到启用 Settings → General → Selection → “Applications in terminal may access clipboard”。

  • Apple Terminal 会完全忽略 OSC 52，因此通过 SSH 复制的内容无法进入本地 clipboard。请改为包装 remote command：grok wrap ssh user@host 会在拦截 OSC 52 并写入 clipboard 的本地 PTY 中运行它。同样适用于 grok wrap docker exec ... 和 grok wrap kubectl exec ...。grok wrap 是实验性功能。

组合键无法使用

  • WezTerm：将 config.enable_kitty_keyboard = true 添加到 wezterm.lua，然后重启；这会修复用于插话的 Ctrl+Enter 和用于换行的 Shift+Enter。

  • VS Code、Cursor、Windsurf 和 Zed terminal 无法区分 Shift+Enter 与 Enter；请使用 Alt+Enter 换行。通过 SSH 使用 VS Code 时同样如此。

  • Zellij 会拦截许多 Ctrl 组合键。在 Zellij 0.41+ 上，切换到 “Unlock-First (non-colliding)” preset（Ctrl+O → c → Change Mode Behavior），需要时使用 Ctrl+G 暂时解锁 Zellij。

  • Apple Terminal：Ctrl+O 用于插话（它不具备用于 Ctrl+Enter 的 Kitty keyboard protocol）。

无全屏，或鼠标滚动停止

Grok 在 Zellij 和 tmux control mode（tmux -CC）下会有意以内联方式运行；设置 alt_screen = "always" 强制全屏，该值位于 [terminal] 下的 ~/.grok/pager.toml 中；或在任意位置使用 --no-alt-screen 禁用全屏。

如果 terminal 原生 scrollbar 接管滚动，则 mouse reporting 已关闭：Apple Terminal 可通过 View → Allow Mouse Reporting（Cmd+R）重新启用；iTerm2 可通过 Settings → Profiles → Terminal → “Enable mouse reporting” 启用。

仍然遇到问题？运行 /feedback。