跳转到内容
Claudex

终端超链接

Claudex 支持 OSC 8 终端超链接，使 Claude Code 输出中的文件路径、URL 和引用在支持的终端中可点击。

概述

Section titled “概述”

OSC 8 是一种终端转义序列标准，可在终端输出中直接嵌入超链接。支持时，点击链接会在默认处理程序中打开（浏览器打开 URL，编辑器打开文件路径）。

转义序列格式：

\x1b]8;;URL\x07DISPLAY_TEXT\x1b]8;;\x07

配置

Section titled “配置”
# 在 config.toml 中（全局设置）
hyperlinks = "auto"    # "auto" | true | false
值行为
"auto"自动检测终端支持（默认）
true强制启用超链接
false强制禁用超链接

也可以通过 CLI 参数在每次会话中启用超链接：

Terminal window
claudex run grok --hyperlinks

终端检测

Section titled “终端检测”

当 hyperlinks = "auto" 时，Claudex 按以下顺序检查：

优先级检查项结果
1FORCE_HYPERLINKS=1 环境变量启用
2非 TTY禁用
3DOMTERM 环境变量已设置启用
4TERM_PROGRAM = iTerm.app启用
5TERM_PROGRAM = WezTerm启用
6TERM_PROGRAM = vscode启用
7TERM_PROGRAM = Tabby启用
8TERM_PROGRAM = Hyper启用
9TERM_PROGRAM = mintty启用
10TERM_PROGRAM = WarpTerminal启用
11TERM = xterm-kitty启用
12TERM = xterm-ghostty启用
13VTE_VERSION >= 5000启用
14WT_SESSION 环境变量已设置（Windows Terminal）启用
15以上均不匹配禁用（安全默认值）

支持的终端

Section titled “支持的终端”
终端平台检测方式
iTerm2macOSTERM_PROGRAM
WezTerm跨平台TERM_PROGRAM
Kitty跨平台TERM (xterm-kitty)
Ghostty跨平台TERM (xterm-ghostty)
VS Code Terminal跨平台TERM_PROGRAM
Windows TerminalWindowsWT_SESSION
GNOME TerminalLinuxVTE_VERSION
Tabby跨平台TERM_PROGRAM
Hyper跨平台TERM_PROGRAM
mintty (Git Bash)WindowsTERM_PROGRAM
WarpTerminalmacOSTERM_PROGRAM
DomTerm跨平台DOMTERM

PTY 代理模式

Section titled “PTY 代理模式”

在 Unix 系统上启用超链接时，Claudex 在 PTY（伪终端）代理下启动 Claude Code 进程。这允许 Claudex 拦截并增强终端输出，添加超链接的同时保留完整的终端体验（颜色、光标移动等）。

PTY 代理对用户完全透明。仅在交互式会话中激活（使用 --print 的非交互模式跳过 PTY）。

强制启用/禁用

Section titled “强制启用/禁用”

对于不在自动检测列表中的终端，可以强制启用超链接：

Terminal window
# 通过环境变量
FORCE_HYPERLINKS=1 claudex run grok


# 通过配置
hyperlinks = true


# 通过 CLI 参数
claudex run grok --hyperlinks

强制禁用（例如管道输出时）：

hyperlinks = false